SDFOPEN(3SDF)

NAME
sdfopen - function to open a seadif data base.

SYNOPSIS
 #include <sealib.h>
 int sdfopen(void)

DESCRIPTION
This function obtains the table of contents of the seadif data base (see sealib(3SDF)) and stores this information in in-core hash tables. Subsequent calls to other sealib function use these hash tables to get information about the data base and to administrate some of their actions. The environment variable SEALIB specifies a colon-separated list of directories to be searched for seadif files. It is not an error if one or more directories do not exists. If SEALIB is not set in the environment then the default value is ".:/usr/local/lib/seadif". The variable SEALIBWRITE can be set to a colon-separated list of directories containing the seadif files that are allowed to be modified. Directories that appear in the SEALIBWRITE list and that do not occur in the SEALIB list are ignored. If SEALIBWRITE is not set, then all (writable) seadif files found through SEALIB can be written with the sdfwrite(3SDF) functions.

RETURN VALUE
Sdfopen() returns SDF_NOERROR on success. If parts of the database are found to be locked SDFERROR_FILELOCK is returned. Other failures cause SDFERROR_SEADIF to be returned.

AUTHOR
Paul Stravers, Delft University of Technology. E-mail address is ocean@donau.et.tudelft.nl.

SEE ALSO
sealib(3SDF), sdfwrite(3SDF), sdfread(3SDF), seadif(4SDF), sdfclose(3SDF), cs(3SDF), sdfattachlib(3SDF), sdfexists(3SDF), memman(3SDF), sdfimage(4SDF).