1DPNS_OPENDIRG(3)            DPNS Library Functions            DP‐
2NS_OPENDIRG(3)
3
4
5
6[1mNAME[0m
7       dpns_opendir ‐ open a DPNS directory, having the specified
8GUID, in the
9       name server
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "dpns_api.h"[0m
14
15       [1mdpns_DIR *dpns_opendir (const char *[4m[22mpath[24m[1m,
16const char *[4m[22mguid[24m[1m)[0m
17
18       [1mdpns_DIR *dpns_opendirxg  (char  *[4m[22mserver[24m[1m,
19const char  *[4m[22mpath[24m[1m,  const  char[0m
20       [1m*[4m[22mguid[24m[1m)[0m
21
22[1mDESCRIPTION[0m
23       [1mdpns_opendir   [22mopens  a  DPNS directory, having the
24specified GUID, in the
25       name server to  be  used  in  subsequent   [1mdpns_readdir
26[22moperations.   A
27       [1mdpns_DIR   [22mstructure   and  a  buffer  to cache the
28directory entries are
29       allocated in the client API.
30
31       [4mguid[24m   specifies the Grid Unique IDentifier.
32
33       [4mpath[24m   specifies the logical pathname  relative  to
34the  current  DPNS
35              directory or the full DPNS pathname.
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
47does not exist or [4mpath[24m is a
48                    null pathname.
49
50       [1mEACCES       [22mSearch permission is denied on a  com‐
51ponent  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       [1mEINVAL        [22mThe  length of the [4mguid[24m compo‐
58nent exceeds [1mCA_MAXGUIDLEN.[0m
59
60       [1mENOTDIR      [22mA component of [4mpath[24m  prefix  is
61not a directory.
62
63       [1mENAMETOOLONG  [22mThe   length  of  [4mpath[24m exceeds
64[1mCA_MAXPATHLEN [22mor the length of
65                    a [4mpath[24m  component  exceeds  [1mCA_MAX‐
66NAMELEN.[0m
67
68       [1mSENOSHOST    [22mHost unknown.
69
70       [1mSENOSSERV    [22mService unknown.
71
72       [1mSECOMERR     [22mCommunication error.
73
74       [1mENSNACT      [22mName server is not running or is being
75shutdown.
76
77[1mSEE ALSO[0m
78       [1mCastor_limits(4)[22m,   [1mdpns_chdir(3)[22m,    [1mdp‐
79ns_closedir(3)[22m,   [1mdpns_readdir(3)[22m,
80       [1mdpns_rewinddir(3)[0m
81
82[1mAUTHOR[0m
83       [1mLCG Grid Deployment [22mTeam
84
85
86
87DPNS                     $Date: 2005/11/22 15:59:39 $         DP‐
88NS_OPENDIRG(3)
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
Impressum