1LFC_READDIRC(3)                   LFC      Library      Functions
2LFC_READDIRC(3)
3
4
5
6[1mNAME[0m
7       lfc_readdirc   ‐    read    LFC    directory   opened   by
8[1mlfc_opendir [22min the name
9       server
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "lfc_api.h"[0m
14
15       [1mstruct     lfc_direncomm     *lfc_readdirc     (lfc_DIR
16*[4m[22mdirp[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mlfc_readdirc [22mreads  the  LFC  directory  opened  by
20[1mlfc_opendir [22min the  name
21       server.    This   routine returns a pointer to a structure
22containing the
23       current directory entry including the comment  associated.
24[1mlfc_readdirc[0m
25       caches  a  variable  number  of such entries, depending on
26the filename
27       size, to minimize the number of requests to the name serv‐
28er.
29
30       [4mdirp[24m    specifies  the  pointer  value  returned by
31[1mlfc_opendir[22m.
32
33[1mRETURN VALUE[0m
34       This routine returns a pointer to a structure   containing
35the  current
36       directory   entry  if the operation was successful or NULL
37if the end of
38       the directory was reached or if the operation failed. When
39the  end  of
40       the   directory  is encountered, serrno is not changed. If
41the operation
42       failed, [1mserrno [22mis set appropriately.
43
44       As lfc_readdirc returns a null pointer both at the end  of
45the directory
46       and  on  error,  an  application  wishing to check for er‐
47ror situations
48       should set [1mserrno [22mto  0,  then  call  lfc_readdirc,
49then check  [1mserrno  [22mand
50       if it is non‐zero, assume an error has occurred.
51
52[1mERRORS[0m
53       [1mEBADF         [22mFile  descriptor  in DIR structure is
54invalid.
55
56       [1mEFAULT       [4m[22mdirp[24m is a NULL pointer.
57
58       [1mSECOMERR     [22mCommunication error.
59
60       [1mENSNACT      [22mName server is not running or is being
61shutdown.
62
63[1mSEE ALSO[0m
64       [1mlfc_closedir(3)[22m,            [1mlfc_opendirg(3)[22m,
65[1mlfc_rewinddir(3)[22m, [1mlfc_setcomment (3)[0m
66
67[1mAUTHOR[0m
68       [1mLCG Grid Deployment [22mTeam
69
70
71
72LFC                                                        $Date$
73LFC_READDIRC(3)
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132