Poster of Linux kernelThe best gift for a Linux geek
GETCONFENT

GETCONFENT

Section: Common Library Functions (3) Updated: $Date: 2005/03/29 09:27:19 $
Local index Up
 

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 21:46:40 GMT, April 16, 2011