gfinstal(5)

NAME
GFI Installation - Installing directives

DESCRIPTION
This manual page describes how to install the GFI CODAS distribution. GFI extensions support small modifications of the original CODAS package. You must decide at compile time if you want to enable or disable these modifications. Furthermore, some GFI extensions need these modifications, so that you will have to recompile the CODAS package, even though if you already have one installed. However, compiling the package should not be too difficult. The original CODAS package is supported by a lot of architectures, and GFI extensions come with Makefiles that should be portable on many systems.

INSTALLING THE FILES
First of all, you will need to create a directory where you want to install the package. Then you will need to decompress the archive and extract the files from it:

cd somewhere
mkdir codas
cd codas
gzip -d the_archive
tar xvf the_archive

where somewhere is the directory where you want to install the package and the_archive is the name (with path) of the downloaded archive. Archives are currently compressed with gzip(1). Other compressions can be performed on demand.

BUILDING THE ORIGINAL CODAS PACKAGE
Information about compiling the main CODAS files can be found in file compile.txt (file: ../../../../doc/compile.txt) . The following description is just a shorter version of it. From the root directory of the package, set the host type of your platform:

cd somewhere/codas/codas3c    # or what ever
mkdir lib
mkdir bin
make/sethost.prl hh

where hh is the host type. If directories lib and/or bin are not present, you will have to create them yourself. Running sethost.prl without arguments will give you a list of possibilities. Running this script will install the host specific configuration files and create missing directories, if any. Check the file include/dbhost.h for definitions that are compatible with your platform. Several dbhost.HOST files for different HOST types are available in the same directory. Script sethost.prl will install the adequate for you as the dbhost.h file. However, it is not a bad idea to check its content before compiling the package. Edit the file makefile.dep and adjust eventually the definitions to your own system. Additionnal GFI compile time options must also be listed in this file. As an example, see the DFLAGS variable at the beginning of file makelnx/makefile.dep/. Possible options are:

DEFAULT_SCREEN_SIZE=n
    This option specifies the default screen size of showdb(1). The default is 25 lines. However, if working on larger windows, increasing this value is quite convenient.

DEFAULT_PAPER_SIZE=paper
    This option specifies the paper type for vector plots (see vector). The default is letter. However europeans will probably prefer a4.

USE_GFI_OPTIONS
    This option will include additional control file parsing functions into the original CODAS libraries. See also ioserv(3). This option is required if you want to compile the GFI extensions.

USE_GFI_C78_FORMAT
    This is a plugin for reading CTD files in C78 format. See also load_ctd(3).

USE_GFI_PUTNAV
    This is a plugin for putnav(1). It adds keyword nav_pos to the list of navigation sources, and is used for loading positions into a CODAS database from a file with only time, longitude and latitude, as the one output by getnav(1). This is useful for fast checks of the database content using adcpsect. Decide the options you want and list them as a list of additional flags for the C compiler (usually the -D option). Define variable DFLAGS in your makefile.dep file, and do not forget to add this list to the compiler flags (variable CFLAGS). When this is done, you may build the libraries and binaries of the CODAS package:

    make libs
    make bins

    And hopefully, you won't get into troubles.

BUILDING THE GFI EXTENSIONS
The GFI extensions are built from sub-directory gfi. More definitions for specific GFI targets can be found in file gfi/make/HOST/makefile.dep, where HOST should be the host type of your system. However, you won't have to edit it in most cases. GFI extensions are currently compiled on lnx and sgi platforms. If your host type is not listed above, you should do the following:

cd gfi
cd make
mkdir hh
cp sgi/* hh
cd ..

In other words, create a subdirectory in gfi/make for your host type (replace hh above with the host type), and copy the definitions file from the sgi platform. To build the GFI libraries and binaries, execute

make libs
make bins

from the gfi sub-directory.

CONFIGURING YOUR SYSTEM
Once the package is built, you will need to configure your system. This step is required for each user. Information on how to do it can be found in gficfg(5). This file is located in directory gfi/doc/txt/etc.

AUTHOR
Manual page written by Pierre Jaccard, Geophysical Institute, University of Bergen, 1999.