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)