NAME
getconfent, getconfent_r - Get configuration entry
SYNOPSIS
char * getconfent (
const char *category,
const char *name,
int flags);
char * getconfent_r (
const char *category,
const char *name,
int flags,
char *buffer,
int bufsiz);
DESCRIPTION
getconfent() get the name entry from the configuration file. Every
entry in the configuration file is categorized. The category parameter
is its specifier. The getconfent_r() function is a re-entrant version
of getconfent() using the passed buffer parameter instead of an
internal static buffer.
If threads are created usint the Cthread_create() interface, it is not
mandatory to call getconfent_r() in order to assure thread-safe code.
In that case getconfent() calls the re-entrant version internally using
a buffer allocated in thread local storage.
RETURN VALUE
getconfent() and getconfent_r() return NULL if the entry is not found.
Otherwise, it returns the matched entry. If flags is not null, the
return value is a pointer to the full string matched in the
configuration file. Otherwise, only the pointer to the first blank
separated token is returned.
ERRORS
If the getconfent(), getconfent_r() function fail, serrno may be set to
one of the following values:
SENOCONFIG
configuration file not found.
SEE ALSO
shift.conf(4), Cthread_create(3)
AUTHOR
LCG Grid Deployment Team