bionic (3) getconfent.3.gz

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