1GETCONFENT(3)              Common Library Functions              GETCONFENT(3)
2
3
4

NAME

6       getconfent, getconfent_r - Get configuration entry
7

SYNOPSIS

9       char * getconfent (
10                      const char *category,
11                      const char *name,
12                      int flags);
13
14       char * getconfent_r (
15                      const char *category,
16                      const char *name,
17                      int flags,
18                      char *buffer,
19                      int bufsiz);
20

DESCRIPTION

22       getconfent()  get  the  name entry from the  configuration file.  Every
23       entry in the configuration file is categorized. The category  parameter
24       is  its  specifier. The getconfent_r() function is a re-entrant version
25       of getconfent() using the passed buffer parameter instead of an  inter‐
26       nal static buffer.
27
28       If  threads are created usint the Cthread_create() interface, it is not
29       mandatory to call getconfent_r() in order to assure  thread-safe  code.
30       In that case getconfent() calls the re-entrant version internally using
31       a buffer allocated in thread local storage.
32

RETURN VALUE

34       getconfent() and getconfent_r() return NULL if the entry is not  found.
35       Otherwise,  it  returns  the  matched entry.  If flags is not null, the
36       return value is a pointer to the full string matched in the  configura‐
37       tion  file.  Otherwise,  only  the pointer to the first blank separated
38       token is returned.
39

ERRORS

41       If the getconfent(), getconfent_r() function fail, serrno may be set to
42       one of the following values:
43
44       SENOCONFIG
45              configuration file not found.
46

SEE ALSO

48       shift.conf(4), Cthread_create(3)
49

AUTHOR

51       LCG Grid Deployment Team
52
53
54
55LCG                      $Date: 2005/03/29 09:27:19 $            GETCONFENT(3)