1RFIO_READDIR(3)                  Rfio      Library      Functions
2RFIO_READDIR(3)
3
4
5
6[1mNAME[0m
7       rfio_readdir ‐ read directory opened by [1mrfio_opendir[0m
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include <dirent.h>[0m
12       [1m#include "rfio_api.h"[0m
13
14       [1mstruct        dirent        *rfio_readdir         (RDIR
15*[4m[22mdirp[24m[1m);[0m
16
17[1mDESCRIPTION[0m
18       [1mrfio_readdir   [22mreads  the directory opened by [1mr‐
19fio_opendir[22m.  This routine
20       returns a pointer to  a  structure  containing  the   cur‐
21rent  directory
22       entry.
23
24       [4mdirp[24m    specifies  the  pointer  value  returned by
25[1mrfio_opendir[22m.
26
27[1mNOTES[0m
28       Only  the  fields  d_name,  d_reclen and on some platforms
29d_namlen are
30       filled.  For LCG directories, a multi‐threaded application
31will need to
32       initialize  itself the Cthread (LCG Thread Interface)  li‐
33brary ; this is
34       done   by   including  "shift/Cthread_api.h"  and  calling
35the  function
36       Cthread_init()  at  the   beginning.  Otherwise  accessing
37LCG directories
38       will not be thread‐safe. See [1mCthread[22m(3).
39
40[1mRETURN VALUE[0m
41       This  routine returns a pointer to a structure  containing
42the  current
43       directory  entry  if the operation was successful or  NULL
44if the end of
45       the directory was reached or if the operation  failed.  In
46the  latter
47       case, [1mserrno [22mis set appropriately.
48
49[1mERRORS[0m
50       [1mEBADF        [22mFile descriptor in  DIR  structure  is
51invalid.
52
53       [1mEFAULT       [4m[22mdirp[24m is a NULL pointer.
54
55       [1mSENOSHOST    [22mHost unknown.
56
57       [1mSENOSSERV    [22mService unknown.
58
59       [1mSECOMERR     [22mCommunication error.
60
61[1mSEE ALSO[0m
62       [1mrfio_closedir(3)[22m,   [1mrfio_opendir(3)[22m,   [1mr‐
63fio_rewinddir(3)[22m, [1mdirent[0m
64
65[1mAUTHOR[0m
66       [1mLCG Grid Deployment [22mTeam
67
68
69
70LCG                                                        $Date$
71RFIO_READDIR(3)
72
73
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