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