1LFC_DELFILESBYNAME(3)        LFC Library Functions       LFC_DELFILESBYNAME(3)
2
3
4

NAME

6       lfc_delfilesbyname - delete the file entries corresponding to a list of
7       path names
8

SYNOPSIS

10       #include <sys/types.h>
11       #include "lfc_api.h"
12
13       int lfc_delfilesbyname (int nbfiles, const char **paths, int force, int
14       *nbstatuses, int **statuses)
15

DESCRIPTION

17       lfc_delfilesbyname  deletes the file entries corresponding to a list of
18       path names. If replicas exist and the force argument is not  zero,  all
19       replicas are first removed.
20
21       nbfiles
22              specifies the number of path names in the array paths.
23
24       paths  specifies the list of logical path names relative to the current
25              LFC directory or the list of full LFC path names.
26
27       nbstatuses
28              will be set to the number of replies in the array of statuses.
29
30       statuses
31              will be set to the address of an array of integer statuses allo‐
32              cated  by  the  API.  The  client application is responsible for
33              freeing the array when not needed anymore.
34

RETURN VALUE

36       This routine returns 0 if the operation was successful  or  -1  if  the
37       operation failed. In the latter case, serrno is set appropriately.
38

ERRORS

40       ENOENT       The named file does not exist.
41
42       EACCES       Search  permission  is  denied  on a component of the path
43                    prefix or write permission is denied on the parent  direc‐
44                    tory or the parent has the sticky bit S_ISVTX set and
45
46                      the  effective  user  ID of the requestor does not match
47                      the owner ID of the file and
48
49                      the effective user ID of the requestor  does  not  match
50                      the owner ID of the directory and
51
52                      the file is not writable by the requestor and
53
54                      the  requestor does not have ADMIN privilege in the Cupv
55                      database.
56
57       ENOMEM       Memory could not be allocated for marshalling the  request
58                    or unmarshalling the reply.
59
60       EFAULT       paths, nbstatuses or statuses is a NULL pointer.
61
62       EEXIST       File has replicas and force is zero.
63
64       ENOTDIR      A component of path prefix is not a directory.
65
66       ENAMETOOLONG The  length of path exceeds CA_MAXPATHLEN or the length of
67                    a path component exceeds CA_MAXNAMELEN.
68
69       EINVAL       nbfiles is not strictly positive.
70
71       SENOSSERV    Service unknown.
72
73       SEINTERNAL   Database error.
74
75       SECOMERR     Communication error.
76
77       ENSNACT      Name server is not running or is being shutdown.
78

SEE ALSO

80       Castor_limits(4), lfc_delreplica(3), lfc_unlink(3)
81

AUTHOR

83       LCG Grid Deployment Team
84
85
86
87LFC                      $Date: 2007/12/13 11:59:47 $    LFC_DELFILESBYNAME(3)