SISYPHOS is written in ANSI-C and should run on every UNIX system (and some non-UNIX systems) that provides an ANSI-C Compiler, e.g., the GNU C compiler. SISYPHOS has been ported to IBM RS6000 running AIX 3.2, HP9000 7xx running HP-UX 8.0/9.0, PC 386/486 running Linux, PC 386/486 running DOS or OS/2 with emx and ATARI ST/TT running TOS.
In the example we will assume that you, as user gap, are installing the
SISYPHOS package for use by several users on a network of two
DECstations, called bert and tiffy, and a 486 PC, called waldorf.
We assume that GAP is also installed on these machines following the
instructions given in Installation of GAP for UNIX.
Note that certain parts of the output in the examples should only be taken as rough outline, especially file sizes and file dates are not to be taken literally.
First of all you have to get the file sisyphos.zoo (see Getting GAP).
Then you must locate the GAP directories containing lib/ and doc/,
this is usually gap3r4p0 where 0 is to be be replaced by the patch
level.
gap@tiffy:~ > ls -l
drwxr-xr-x 11 gap 1024 Nov 8 1991 gap3r4p0
-rw-r--r-- 1 gap 245957 Dec 27 15:16 sisyphos.zoo
gap@tiffy:~ > ls -l gap3r4p0
drwxr-xr-x 2 gap 3072 Nov 26 11:53 doc
drwxr-xr-x 2 gap 1024 Nov 8 1991 grp
drwxr-xr-x 2 gap 2048 Nov 26 09:42 lib
drwxr-xr-x 2 gap 2048 Nov 26 09:42 src
drwxr-xr-x 2 gap 1024 Nov 26 09:42 tst
Unpack the package using unzoo (see Installation of GAP for UNIX).
Note that you must be in the directory containing gap3r4p0 to unpack
the files. After you have unpacked the source you may remove the
archive-file.
gap@tiffy:~ > unzoo x sisyphos.zoo
gap@tiffy:~ > ls -l gap3r4p0/pkg/sisyphos
-rw-r--r-- 1 gap 9496 Feb 11 1993 README
drwxr-xr-x 3 gap 512 Oct 19 10:24 doc
drwxr-xr-x 2 gap 512 Oct 15 14:30 groups
drwxr-xr-x 2 gap 512 Apr 1 1993 ideal
-rw-r--r-- 1 gap 22072 Oct 19 10:23 init.g
drwxr-xr-x 2 gap 1536 Oct 15 14:49 src
Switch into the directory src/. It contains the makefile for SISYPHOS.
gap@tiffy:../src > make
usage: 'make <target>' where target is one of
'hp700-hpux-gcc2' for HP 9000/7xx under HP-UX with GNU cc 2
'hp700-hpux-cc' for HP 9000/7xx under HP-UX with cc
'hp700-hpux-cci' for HP 9000/7xx under HP-UX with cc -
generate version for profile dependent optimization
'hp700-hpux-ccp' for HP 9000/7xx under HP-UX with cc -
relink with profile dependent optimization
'ibm6000-aix-cc' for IBM RS/6000 under AIX with cc
'ibmpc-linux-gcc2' for IBM PCs under Linux with GNU cc 2
'ibmpc-emx-gcc2' for IBM PCs under DOS or OS/2 2.0 with emx
'generic-unix-gcc2' for other UNIX machines with GNU cc 2
this should work on most machines
Select the target you need. In our case we first
compile the DECstation version. We assume that the command to start
GAP is /usr/local/bin/gap for tiffy and waldorf and
/rem/tiffy/usr/local/bin/gap for bert.
gap@tiffy:../src > make generic-unix-gcc2
# you will see a lot of messages and maybe a few warnings
You should test the standalone now. The following command should run without any comment. This will work, however, only for UNIX machines.
gap@tiffy:../src > testsis
The executables will be collected in the /bin directory, so we move that
for the DECstation there.
gap@tiffy:../src > mv sis ../bin/sis.ds
Now repeat the compilation for the PC. Do not forget to clean up.
gap@tiffy:../src > rlogin waldorf
gap@waldorf:~ > cd gap3r4p0/pkg/sisyphos/src
gap@waldorf:../src > make clean
gap@waldorf:../src > make generic-unix-gcc2
# you will see a lot of messages and maybe a few warnings
Test the executable (under UNIX only), and move it to the right place.
gap@waldorf:../src > testsis
gap@waldorf:../src > mv sis ../bin/sis.386bsd
gap@waldorf:../src > exit
gap@tiffy:../src >
Switch into the subdirectory bin/ and create a script which will call
the correct binary for each machine.
gap@tiffy:../src > cd ..
gap@tiffy:../sisyphos > cat > bin/sis
#!/bin/csh
switch ( `hostname` )
case 'bert':
case 'tiffy':
exec ~gap/3.2/pkg/sisyphos/bin/sis.ds $* ;
breaksw ;
case 'waldorf':
exec ~gap/3.2/pkg/sisyphos/bin/sis.386bsd $* ;
breaksw ;
default:
echo "sis: sorry, no executable exists for this machine" ;
breaksw ;
endsw
ctr-D
gap@tiffy:../sisyphos > chmod 755 bin/sis
GAP 3.4.4