Icon OMA Resources
 

This helpfile has been contributed by Billy Constantine (SysAdmin at University of Adelaide, Mech Eng). This file describes how to get the Unix version of OMA-X running on Microsoft Windows, using the Cygwin compatibility layer.


The system used was an HP Compaq D530 SFF, Pentium 4 2.7GHz with 512MB RAM. Pre-installed software consisted of Microsoft Windows 2000 SP4, Internet Explorer 6.0 SP1, all relevant hotfixes from MS03-041 to MS04-028 (most recent at install time) and Symantec Antivirus 8.1.

The process consists of three main steps:

  1. - installation of Cygwin
  2. - compilation and installation of XForms
  3. - compilation of OMA-X

1) Installation of Cygwin

- Download the current Cygwin installer from http://www.cygwin.com/
- setup.exe v2.427

- Run the installer, and select the following packages to install (versions I used are parenthesised):

ash            (20040127-1)
base-files        (3.0-3)
base-passwd        (2.0-1)
bash            (2.05b-16)
binutils        (20040725-2)
bzip2            (1.0.2-6)
cygwin            (1.5.11-1)
diffutils        (2.8.7-1)
editrights        (1.01-1)
expat            (1.95.7-1)
fileutils        (4.1-2)
findutils        (4.1.7-4)
fontconfig        (2.2.2-1)
freetype2        (2.1.5-1)
gawk            (3.1.4-3)
gcc            (3.3.3-3)
gcc-core        (3.3.3-3)
gcc-g++            (3.3.3-3)
gcc-mingw-core        (20040810-1)
gcc-mingw-g++        (20040810-1)
gdbm            (1.8.3-7)
gettext            (0.14.1-1)
grep            (2.5-1)
groff            (1.18.1-2)
gzip            (1.3.5-1)
jpeg            (6b-11)
less            (381-1)
libbz2_1        (1.0.2-6)
libcharset1        (1.9.2-1)
libfontconfig-devel    (2.2.2-1)
libfontconfig1        (2.2.2-1)
libfreetype2-devel    (2.1.5-1)
libfreetype26        (2.1.5-1)
libgdbm            (1.8.0-5)
libgdbm-devel        (1.8.3-7)
libgdbm3        (1.8.3-3)
libgdbm4        (1.8.3-7)
libgettextpo0        (0.14.1-1)
libiconv        (1.9.2-1)
libiconv2        (1.9.2-1)
libintl            (0.10.38-3)
libintl1        (0.10.40-1)
libintl2        (0.12.1-3)
libintl3        (0.14.1-1)
libjpeg62        (6b-11)
libjpeg6b        (6b-8)
libncurses5        (5.2-1)
libncurses6        (5.2-8)
libncurses7        (5.3-4)
libpcre            (4.1-1)
libpcre0        (4.5-1)
libreadline4        (4.1-2)
libreadline5        (4.3-5)
libXft            (2.1.6-1)
libXft-devel        (2.1.6-1)
libXft1            (1.0.0-1)
libXft2            (2.1.6-1)
login            (1.9-7)
make            (3.80-1)
man            (1.5o-1)
mingw-runtime        (3.5-1)
mktemp            (1.5-3)
ncurses            (5.3-4)
pcre            (4.5-1)
pcre-doc        (4.5-1)
readline        (4.3-5)
sed            (4.1.2-1)
sh-utils        (2.0.15-4)
tar            (1.13.25-5)
termcap            (20021106-2)
terminfo        (5.3_20030726-1)
texinfo            (4.2-4)
textutils        (2.0.21-1)
w32api            (3.1-1)
which            (1.5-2)
X-startup-scripts    (1.0.9-1)
XFree86-lib-compat    (4.3.0-2)
xorg-x11-base        (6.8.1.0-1)
xorg-x11-bin        (6.8.1.0-1)
xorg-x11-bin-dlls    (6.8.1.0-1)
xorg-x11-bin-lndir    (6.8.1.0-1)
xorg-x11-devel        (6.8.1.0-1)
xorg-x11-etc        (6.8.1.0-1)
xorg-x11-fenc        (6.8.1.0-2)
xorg-x11-fnts        (6.8.1.0-2)
xorg-x11-libs-data    (6.8.1.0-1)
xorg-x11-xwin        (6.8.1.0-3)
xterm            (185-4)
zlib            (1.2.1-2)
_update-info-dir    (00228-1)



This represents a minimal Cygwin install, plus C compiler, JPEG development libraries, X development libraries and an X server.

  • Once installed, run the batch file <CYGWIN>\usr\X11R6\bin\startxwin.bat; this should give you a running X server and an xterm.



2) Compilation and installation of XForms

- Download the XForms source package from
                      http://savannah.nongnu.org/download/xforms/

-xforms-1.0.90.tar.gz

- In the Cygwin xterm, unpack the xforms archive, cd to the directory that was created, and execute

      ./configure --prefix=/usr/X11R6 --with-extra-inc=/usr/X11R6/include
    make
    make install


This will install a GL-aware XForms package under /usr/X11R6
(instead of /usr/local - this will simplify the OMA build procedure).

3) Compilation of OMA

- Download the "OMA for Unix X-windows Bundle" from
                    http://oma-x.org/download.htm

       
xoma.tgz v1.0b

- In the Cygwin xterm, unpack the xoma archive and cd to the directory that was
created.

- Edit the Makefile so that the linker will search /usr/X11R6/bin in addition to /usr/X11R6/lib, ie:
    

    gcc -L/usr/X11R6/bin -L$(LIBX) -o $(EXEC1) $(OBJECTS1) -lX11 -lm -lforms

- Edit the file uxdisplay.c and comment out line 1260:

    *(cp + strlen(cp)-1) = 0;    // get rid of echoed character

which causes a fatal compile error when left in (assignment of read-only
location)

- Execute:
    

    make oma
    ./oma.exe

This will compile and run the OMA binary that was just built. To check that it
works, hit a key (eg Enter or Space) in the "OMA Commands" window, and once
the "OMA>" prompt has appeared, do:

        get test
    displa

This should open a window displaying the test data, found in the build
directory.


BUGS

- The OMA Commands window isn't active until a key has been pressed.
- The location of cursor within the OMA Commands window is important. Hitting
keys when the cursor does not immediately follow the prompt can have
unexpected effects.



Billy Constantine

8 October 2004