1LFC_DELFILESBYGUID(3)             LFC      Library      Functions
2LFC_DELFILESBYGUID(3)
3
4
5
6[1mNAME[0m
7       lfc_delfilesbyguid ‐ delete the file entries corresponding
8to a list of
9       guids
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "lfc_api.h"[0m
14
15       [1mint lfc_delfilesbyguid (int [4m[22mnbguids[24m[1m, con‐
16st char **[4m[22mguids[24m[1m, int [4m[22mforce[24m[1m, int[0m
17       [1m*[4m[22mnbstatuses[24m[1m,     int     **[4m[22mstatus‐
18es[24m[1m)[0m
19
20[1mDESCRIPTION[0m
21       [1mlfc_delfilesbyguid  [22mdeletes the file entries corre‐
22sponding to a list of
23       guids. If replicas exist and the force argument is not ze‐
24ro, all repli‐
25       cas are first removed.
26
27       [4mnbguids[0m
28              specifies   the   number  of  guids  in  the  array
29[4mguids[24m.
30
31       [4mguids[24m  specifies the list of  Grid  Unique  IDenti‐
32fiers.
33
34       [4mnbstatuses[0m
35              will  be  set to the number of replies in the array
36of statuses.
37
38       [4mstatuses[0m
39              will be set to the address of an array  of  integer
40statuses allo‐
41              cated by the API. The  client  application  is  re‐
42sponsible  for
43              freeing the array when not needed anymore.
44
45[1mRETURN VALUE[0m
46       This  routine  returns  0  if the operation was successful
47or ‐1 if the
48       operation failed. In the latter case, [1mserrno [22mis set
49appropriately.
50
51[1mERRORS[0m
52       [1mENOENT       [22mThe named guid does not exist.
53
54       [1mEACCES       [22mSearch permission is denied on a  com‐
55ponent of  the  parent
56                    directory   or  write  permission  is  denied
57on the parent
58                    directory or the parent has  the  sticky  bit
59S_ISVTX set and
60
61                      the  effective  user  ID  of  the requestor
62does  not  match
63                      the owner ID of the file and
64
65                      the  effective  user  ID of  the  requestor
66does not match
67                      the owner ID of the directory and
68
69                      the  file  is not writable by the requestor
70and
71
72                      the requestor does not have ADMIN privilege
73in the  Cupv
74                      database.
75
76       [1mENOMEM        [22mMemory   could  not  be allocated for
77marshalling the request
78                    or unmarshalling the reply.
79
80       [1mEFAULT        [4m[22mguids[24m,  [4mnbstatuses[24m   or
81[4mstatuses[24m is a NULL pointer.
82
83       [1mEEXIST        [22mFile has replicas and [4mforce[24m is
84zero.
85
86       [1mEINVAL       [4m[22mnbguids[24m is not  strictly  posi‐
87tive or the length of  one  of
88                    the    [4mguids[24m   exceeds   [1mCA_MAXGUI‐
89DLEN[22m.
90
91       [1mSENOSSERV    [22mService unknown.
92
93       [1mSEINTERNAL   [22mDatabase error.
94
95       [1mSECOMERR     [22mCommunication error.
96
97       [1mENSNACT      [22mName server is not running or is being
98shutdown.
99
100[1mSEE ALSO[0m
101       [1mCastor_limits(4)[22m,         [1mlfc_delreplica(3)[22m,
102[1mlfc_unlink(3)[0m
103
104[1mAUTHOR[0m
105       [1mLCG Grid Deployment [22mTeam
106
107
108
109LFC                         $Date:    2007/12/13    11:59:47    $
110LFC_DELFILESBYGUID(3)
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
Impressum