1DPNS_UNLINK(3)                   DPNS      Library      Functions
2DPNS_UNLINK(3)
3
4
5
6[1mNAME[0m
7       dpns_unlink ‐ remove a DPNS file entry in the name server
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpns_api.h"[0m
12
13       [1mint dpns_unlink (const char *[4m[22mpath[24m[1m)[0m
14
15[1mDESCRIPTION[0m
16       [1mdpns_unlink [22mremoves a DPNS file entry in  the  name
17server.
18
19       [4mpath[24m    specifies  the  logical  pathname  relative
20to the current DPNS
21              directory or the full DPNS pathname.
22
23[1mRETURN VALUE[0m
24       This routine returns 0 if the operation was successful  or
25‐1  if  the
26       operation failed. In the latter case, [1mserrno [22mis set
27appropriately.
28
29[1mERRORS[0m
30       [1mEPERM        [4m[22mpath[24m is a directory.
31
32       [1mENOENT       [22mThe named file does not exist or is  a
33null pathname.
34
35       [1mEACCES        [22mSearch   permission  is  denied  on a
36component of the [4mpath[0m
37                    prefix or write permission is denied  on  the
38parent  direc‐
39                    tory or the parent has the sticky bit S_ISVTX
40set and
41
42                      the  effective  user  ID of  the  requestor
43does not match
44                      the owner ID of the file and
45
46                      the  effective  user  ID  of  the requestor
47does  not  match
48                      the owner ID of the directory and
49
50                      the file is not writable by  the  requestor
51and
52
53                      the   requestor  does not have ADMIN privi‐
54lege in the Cupv
55                      database.
56
57       [1mEFAULT       [4m[22mpath[24m is a NULL pointer.
58
59       [1mEEXIST       [22mFile has replicas.
60
61       [1mENOTDIR      [22mA component of [4mpath[24m  prefix  is
62not a directory.
63
64       [1mENAMETOOLONG  [22mThe  length  of  [4mpath[24m  exceeds
65[1mCA_MAXPATHLEN [22mor the length  of
66                    a [4mpath[24m  component  exceeds  [1mCA_MAX‐
67NAMELEN[22m.
68
69       [1mSENOSHOST    [22mHost unknown.
70
71       [1mSENOSSERV    [22mService unknown.
72
73       [1mSECOMERR     [22mCommunication error.
74
75       [1mENSNACT      [22mName server is not running or is being
76shutdown.
77
78[1mSEE ALSO[0m
79       [1mCastor_limits(4)[22m,   [1mdpns_chdir(3)[22m,    [1mdp‐
80ns_rmdir(3)[22m, [1mCupvlist(1)[0m
81
82[1mAUTHOR[0m
83       [1mLCG Grid Deployment [22mTeam
84
85
86
87DPNS                        $Date:    2005/06/30    08:34:03    $
88DPNS_UNLINK(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