56.15 Installing the Vector Enumeration Package

The Vector Enumerator (VE) is written in C and the package can only be installed under UNIX. It has been tested on DECstation running Ultrix, a 486 running NetBSD, and SUNs running SunOS.

The parts of the package that deal with rationals require the GNU multiple precision arithmetic library GMP. Make sure that this library is installed before trying to install VE.

If you got a complete binary and source distribution for your machine, nothing has to be done if you want to use the VE for a single architecture. If you want to use the VE for machines with different architectures skip the extraction and compilation part of this section and proceed with the creation of shell scripts described below.

If you got a complete source distribution, skip the extraction part of this section and proceed with the compilation part below.

In the example we will assume that you, as user gap, are installing the VE package for use by several users on a network of two DECstations, called bert and tiffy, and a NeXTstation, called bjerun. 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 ve.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      gap          1024 Nov  8  1991 gap3r4p0
    -rw-r--r--   1 gap      gap        106307 Jan 24 15:16 ve.zoo
    gap@tiffy:~ > ls -l gap3r4p0
    drwxr-xr-x   2 gap      gap          3072 Nov 26 11:53 doc
    drwxr-xr-x   2 gap      gap          1024 Nov  8  1991 grp
    drwxr-xr-x   2 gap      gap          2048 Nov 26 09:42 lib
    drwxr-xr-x   2 gap      gap          2048 Nov 26 09:42 src
    drwxr-xr-x   2 gap      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 ve.zoo
     gap@tiffy:~ > ls -l gap3r4p0/pkg/ve
     -rw-r--r--  1 sam         16761 May 10 17:39 Makefile
     -rw-r-----  1 sam          1983 May  6  1993 README
     drwxr-xr-x  2 sam           512 May 10 17:41 bin
     drwxr-xr-x  2 sam           512 May 10 17:34 docs
     drwxr-xr-x  2 sam           512 May 10 17:34 examples
     drwxr-xr-x  3 sam           512 Mar 28 17:55 gap
     -rw-r--r--  1 sam           553 Mar 24 18:18 init.g
     drwxr-xr-x  5 sam          1024 May 10 17:36 src 

Switch into the directory ve/ and type make to see a list of targets for compilation; then type make target to compile VE, where target is the target that is closest to your machine. If the header files for the GNU multiple precision arithmetic are not in /usr/local/include you must set INCDIRGMP to the correct directory. If the library for the GNU multiple precision arithmetic is not /usr/local/lib/libgmp.a you must set LIBDIRGMP. In this case we first compile the DECstation version.

    gap@tiffy:~ > cd gap3r4p0/pkg/ve
    gap@tiffy:../ve > make INCDIRGMP=/usr/gnu/include \
                       LIBDIRGMP=/usr/gnu/lib/ dec-mips-ultrix-gcc2
    
# you will see a lot of messages

Now repeat the compilation for the NeXTstation. Do not forget to clean up.

    gap@tiffy:../ve > mv bin/me.exe bin/me.dec
    gap@tiffy:../ve > mv bin/qme.exe bin/qme.dec
    gap@tiffy:../ve > rlogin bjerun
    gap@bjerun:~ > cd gap3r4p0/pkg/ve
    gap@bjerun:../ve > make clean
    
#
 you will see some messages
    gap@bjerun:../ve > make next-m68k-mach-gcc2
    
#
 you will see a lot of messages
    gap@bjerun:../ve > mv bin/me.exe bin/me.next
    gap@bjerun:../ve > mv bin/qme.exe bin/qme.next
    gap@bjerun:../ve > exit
    gap@tiffy:../ve > 

Switch into the subdirectory bin/ and create scripts which will call the correct binary for each machine. The shell scripts that are already contained in `bin/me.sgl` and `bin/qme.sgl` are suitable only for a single architecture installation.

    gap@tiffy:../ve > cat > bin/me
    
#
!/bin/csh
    switch ( `hostname` )
      case 'bert':
      case 'tiffy':
        exec $0.dec $* ;
        breaksw ;
      case 'bjerun':
        exec $0.next $* ;
        breaksw ;
      default:
        echo "me/qme/zme: sorry, no executable exists for this machine" ;
        breaksw ;
    endsw
    
ctr-D
    gap@tiffy:../ve > chmod 755 bin/me
    gap@tiffy:../ve > ln bin/me bin/qme 

Previous Up Top Next
Index

GAP 3.4.4
April 1997