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