1RFIO_OPENDIR(3)                  Rfio      Library      Functions
2RFIO_OPENDIR(3)
3
4
5
6[1mNAME[0m
7       rfio_opendir ‐ open a directory
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "rfio_api.h"[0m
12
13       [1mRDIR *rfio_opendir (const char *[4m[22mpath[24m[1m);[0m
14
15[1mDESCRIPTION[0m
16       [1mrfio_opendir  [22mopens  a  directory  to  be  used  in
17subsequent [1mrfio_readdir[0m
18       operations.   A  [1mRDIR  [22mstructure and  a  buffer  to
19cache  the  directory
20       entries are allocated in the client API.
21
22       [4mpath[24m   specifies the logical pathname  relative  to
23the current directory
24              or the full pathname.
25
26[1mNOTES[0m
27       For  LCG  directories,  a  multi‐threaded application will
28need to initial‐
29       ize itself the Cthread (LCG Thread  Interface)  library  ;
30this is done by
31       including  "shift/Cthread_api.h"  and calling the function
32Cthread_init()
33       at  the  beginning.  Otherwise  accessing   LCG   directo‐
34ries will not be
35       thread‐safe. See [1mCthread[22m(3).
36
37[1mRETURN VALUE[0m
38       This  routine  returns a pointer to be used in the  subse‐
39quent  directory
40       function calls if the operation was successful or NULL  if
41the operation
42       failed. In the latter case, [1mserrno [22mis set appropri‐
43ately.
44
45[1mERRORS[0m
46       [1mENOENT       [22mA component of [4mpath[24m prefix does
47not exist  or  [4mpath[24m  is  a
48                    null pathname.
49
50       [1mEACCES        [22mSearch   permission  is  denied  on a
51component of the [4mpath[0m
52                    prefix  or  read  permission  is  denied   on
53[4mpath[24m.
54
55       [1mEFAULT       [4m[22mpath[24m is a NULL pointer.
56
57       [1mENOTDIR       [22mA  component of [4mpath[24m prefix is
58not a directory.
59
60       [1mENAMETOOLONG  [22mThe  length  of  [4mpath[24m  exceeds
61[1mCA_MAXPATHLEN [22mor the length  of
62                    a  [4mpath[24m  component  exceeds [1mCA_MAX‐
63NAMELEN[22m.
64
65       [1mSENOSHOST    [22mHost unknown.
66
67       [1mSENOSSERV    [22mService unknown.
68
69       [1mSECOMERR     [22mCommunication error.
70
71[1mSEE ALSO[0m
72       [1mCastor_limits(4)[22m,  [1mrfio_closedir(3)[22m,   [1mr‐
73fio_readdir(3)[22m, [1mrfio_rewinddir(3)[0m
74
75[1mAUTHOR[0m
76       [1mLCG Grid Deployment [22mTeam
77
78
79
80LCG                         $Date:    2005/03/31    13:13:03    $
81RFIO_OPENDIR(3)
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