DLFIND C-3

NAME

dlfind - get named logical RMSfile description

SYNOPSIS

#include <cbase/dbase.h>

LF *dlfind (dbname, lfname)

char *dbname, *lfname;

DESCRIPTION

Dlfind searches the C/Base database catalog for the given logical RMSfile within the named database. If found, a pointer to a structure describing the logical RMSfile is returned. If the logical RMSfile is not defined within the named database, a NULL pointer is returned and the RMS error message is set describing the reason for not finding the logical RMSfile.

Dbname is the name of the database. If dbname is a NULL pointer or an empty string, the default database name is used.

Lfname is the name of the logical RMSfile within the database.

The structure returned by dlfind is defined in the include file <cbase/dbase.h>.

SEE ALSO

dlfindn(C-3), dlopen(C-3)

DIAGNOSTICS

A value of NULL is returned if the logical RMSfile is not defined in the C/Base database catalog.

NOTES

The returned value points to static data whose contents are overwritten with every call.