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