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

LCG                                       $Date: 2005/03/29 09:27:19 $                             GETCONFENT(3)