1DPNS_DELREPLICASBYSFN(3)     DPNS  Library Functions    DPNS_DEL‐
2REPLICASBYSFN(3)
3
4
5
6[1mNAME[0m
7       dpns_delreplicasbysfn  ‐  delete entries associated with a
8list of sfns
9       and corresponding lfn if last replica
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "dpns_api.h"[0m
14
15       [1mint  dpns_delreplicasbysfn  (int [4m[22mnbfiles[24m[1m,
16const char **[4m[22msfns[24m[1m,  const  char[0m
17       [1m**[4m[22mguids[24m[1m,  int  *[4m[22mnbstatuses[24m[1m,
18int **[4m[22mstatuses[24m[1m)[0m
19
20[1mDESCRIPTION[0m
21       [1mdpns_delreplicasbysfn  [22mdeletes  entries  associated
22with a list of sfns
23       and corresponding lfn if last replica.  An extra check may
24be  obtained
25       by specifying a list of [4mguids[24m.
26
27       [4mnbfiles[0m
28              specifies  the  number  of  file names in the array
29[4msfns[24m.
30
31       [4msfns[24m   specifies  either  the   Site  URLs  or  the
32Physical File Names for
33              the list of replicas.
34
35       [4mguids[24m   specifies  the  list of Grid Unique IDenti‐
36fiers (optional). Can be
37              NULL.
38
39       [4mnbstatuses[0m
40              will be set to the number of replies in  the  array
41of statuses.
42
43       [4mstatuses[0m
44              will  be  set to the address of an array of integer
45statuses allo‐
46              cated by the API. The  client  application  is  re‐
47sponsible  for
48              freeing   the array when not needed anymore.  Indi‐
49vidual statuses
50              are 0 if the operation was successful or set to the
51serrno value
52              in case of error.
53
54[1mRETURN VALUE[0m
55       This  routine  returns  0  if the operation was successful
56or ‐1 if the
57       operation failed. In the latter case, [1mserrno [22mis set
58appropriately.
59
60[1mERRORS[0m
61       [1mENOENT       [22mThe named file or replica does not ex‐
62ist.
63
64       [1mE2BIG        [22mRequest too large (max 1 MB).
65
66       [1mENOMEM       [22mMemory could not be allocated for mar‐
67shalling the  request
68                    or unmarshalling the reply.
69
70       [1mEACCES        [22mSearch   permission   is  denied on a
71component of the parent
72                    directory or write permission  is  denied  on
73the  parent
74                    directory  or  the  parent has the sticky bit
75S_ISVTX set and
76
77                      the  effective  user  ID of  the  requestor
78does not match
79                      the owner ID of the file and
80
81                      the  effective  user  ID  of  the requestor
82does  not  match
83                      the owner ID of the directory and
84
85                      the file is not writable by  the  requestor
86and
87
88                      the   requestor  does not have ADMIN privi‐
89lege in the Cupv
90                      database.
91
92       [1mENOMEM       [22mMemory could not be allocated for mar‐
93shalling the  request
94                    or unmarshalling the reply.
95
96       [1mEFAULT         [4m[22msfns[24m,   [4mnbstatuses[24m  or
97[4mstatuses[24m is a NULL pointer.
98
99       [1mEINVAL       [4m[22mnbfiles[24m  is  not strictly posi‐
100tive or the length of one of
101                    the    [4mguids[24m   exceeds   [1mCA_MAXGUI‐
102DLEN[22m.
103
104       [1mENAMETOOLONG  [22mThe  length  of  [4msfn[24m   exceeds
105[1mCA_MAXSFNLEN[22m.
106
107       [1mSENOSSERV    [22mService unknown.
108
109       [1mSEINTERNAL   [22mDatabase error.
110
111       [1mSECOMERR     [22mCommunication error.
112
113       [1mENSNACT      [22mName server is not running or is being
114shutdown.
115
116[1mSEE ALSO[0m
117       [1mCastor_limits(4)[22m, [1mdpns_delreplica(3)[22m, [1mdp‐
118ns_unlink(3)[0m
119
120[1mAUTHOR[0m
121       [1mLCG Grid Deployment [22mTeam
122
123
124
125DPNS                      $Date:  2009/04/06 08:30:13 $ DPNS_DEL‐
126REPLICASBYSFN(3)
127
128
129
130
131
132
Impressum