getconfent man page

GETCONFENT(3) Common Library Functions GETCONFENT(3)

[1mNAME[0m
getconfent, getconfent_r - Get configuration entry

[1mSYNOPSIS[0m
[1mchar * getconfent ([0m
[1mconst char *[4m[22mcategory[24m[1m,[0m
[1mconst char *[4m[22mname[24m[1m,[0m
[1mint [4m[22mflags[24m[1m);[0m

[1mchar * getconfent_r ([0m
[1mconst char *[4m[22mcategory[24m[1m,[0m
[1mconst char *[4m[22mname[24m[1m,[0m
[1mint [4m[22mflags[24m[1m,[0m
[1mchar *[4m[22mbuffer[24m[1m,[0m
[1mint [4m[22mbufsiz[24m[1m);[0m

[1mDESCRIPTION[0m
[1mgetconfent() [22mget the [4mname[24m entry from the configuration file. Every
entry in the configuration file is categorized. The [4mcategory[24m parameter
is its specifier. The [1mgetconfent_r() [22mfunction is a re-entrant version
of [1mgetconfent() [22musing the passed [4mbuffer[24m parameter instead of an inter-
nal static buffer.

If threads are created usint the [1mCthread_create() [22minterface, it is not
mandatory to call [1mgetconfent_r() [22min order to assure thread-safe code.
In that case [1mgetconfent() [22mcalls the re-entrant version internally using
a buffer allocated in thread local storage.

[1mRETURN VALUE[0m
[1mgetconfent() [22mand [1mgetconfent_r() [22mreturn NULL if the entry is not found.
Otherwise, it returns the matched entry. If [1mflags [22mis not null, the
return value is a pointer to the full string matched in the configura-
tion file. Otherwise, only the pointer to the first blank separated
token is returned.

[1mERRORS[0m
If the [1mgetconfent(), getconfent_r() [22mfunction fail, [1mserrno [22mmay be set to
one of the following values:

[1mSENOCONFIG[0m
configuration file not found.

[1mSEE ALSO[0m
[1mshift.conf(4), Cthread_create(3)[0m

[1mAUTHOR[0m
[1mLCG Grid Deployment [22mTeam

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

Info