  1.  NAME

  GFI Installation - Installing directives

  2.  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.

  3.  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.

  4.  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 pre-
  sent, 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.

  5.  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.

  6.  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.

  7.  AUTHOR

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

