DtDbLoad(3) UNIX System V (1 August 1995) DtDbLoad(3)
NAME
DtDbLoad - load actions and data types database
SYNOPSIS
#include <Dt/Action.h>
void DtDbLoad(void);
DESCRIPTION
The DtDbLoad() function loads the actions and data types
database into the application. When the function returns,
the database has been loaded.
An environment variable determines the set of directories to
be searched. The DtDbLoad() function loads all actions and
data types defined in files with a .dt suffix located in
these directories.
The directory search path is based on the value of the
DTDATABASESEARCHPATH environment variable and internal
defaults. DTDATABASESEARCHPATH contains a comma-separated
list of directories in [host:]/path format. The application
must call DtDbLoad() before calling any of the routines that
query either the action or data type databases. If called
multiple times, the old databases are freed before the new
ones are created.
RETURN VALUE
The DtDbLoad() function returns no value.
APPLICATION USAGE
If this function is used in a long-lived application, the
application must dynamically reload the databases when they
are modified. To do this, the client must register to
receive notification whenever the actions and data types
database needs to be modified. It is up to the application
to recall DtDbLoad() after receiving notification. This is
done with a call to DtDbReloadNotify(3).
If errors are encountered when reading the database files,
error messages are written to the user's errorlog file
($HOME/.dt/errorlog). Records containing errors are not
incorporated into the internal database.
SEE ALSO
DtAction(5), DtDbReloadNotify(3), dtdtfile(4).
Page 1 (printed 9/3/04)