debian man page for getconfent

GETCONFENT(3)						     Common Library Functions						     GETCONFENT(3)

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)