1DPNS_READLINK(3)            DPNS Library Functions            DP‐
2NS_READLINK(3)
3
4
5
6[1mNAME[0m
7       dpns_readlink ‐ read value of a symbolic link in the  DPNS
8Name Server
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "dpns_api.h"[0m
13
14       [1mint dpns_readlink (const char *[4m[22mpath[24m[1m, char
15*[4m[22mbuf[24m[1m, size_t [4m[22mbufsiz[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mdpns_readlink  [22mreads  the  value  of   a   symbolic
19link in the DPNS Name
20       Server.
21
22       [4mpath[24m   specifies the link name relative to the cur‐
23rent  DPNS  directory
24              or the full DPNS pathname.
25
26       [4mbuf[24m    points at a buffer to receive the value.
27
28       [4mbufsiz[24m gives the buffer size.
29
30[1mRETURN VALUE[0m
31       This  routine returns the number of characters put in  the
32buffer if the
33       operation was successful or ‐1 if the operation failed. In
34the  latter
35       case, [1mserrno [22mis set appropriately.
36
37[1mERRORS[0m
38       [1mENOENT       [22mThe named link does not exist or is  a
39null pathname.
40
41       [1mEACCES        [22mSearch   permission  is  denied  on a
42component of the [4mpath[0m
43                    prefix.
44
45       [1mEFAULT       [4m[22mpath[24m or [4mbuf[24m  is  a  NULL
46pointer.
47
48       [1mENOTDIR       [22mA  component of [4mpath[24m prefix is
49not a directory.
50
51       [1mEINVAL       [4m[22mpath[24m is not a symbolic link.
52
53       [1mENAMETOOLONG  [22mThe  length  of  [4mpath[24m  exceeds
54[1mCA_MAXPATHLEN [22mor the length  of
55                    a  [4mpath[24m  component  exceeds [1mCA_MAX‐
56NAMELEN[22m.
57
58       [1mSENOSHOST    [22mHost unknown.
59
60       [1mSENOSSERV    [22mService unknown.
61
62       [1mSECOMERR     [22mCommunication error.
63
64       [1mENSNACT      [22mName server is not running or is being
65shutdown.
66
67[1mSEE ALSO[0m
68       [1mCastor_limits(4)[22m,    [1mdpns_chdir(3)[22m,   [1mdp‐
69ns_stat(3), dpns_statg(3)[22m, [1mdpns_sym‐[0m
70       [1mlink(3)[0m
71
72[1mAUTHOR[0m
73       [1mLCG Grid Deployment [22mTeam
74
75
76
77DPNS                     $Date: 2004/06/28 09:46:55 $         DP‐
78NS_READLINK(3)
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