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