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

NAME

6       lfc_delfilesbyguid - delete the file entries corresponding to a list of
7       guids
8

SYNOPSIS

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

DESCRIPTION

17       lfc_delfilesbyguid  deletes the file entries corresponding to a list of
18       guids. If replicas exist and the force argument is not zero, all repli‐
19       cas are first removed.
20
21       nbguids
22              specifies the number of guids in the array guids.
23
24       guids  specifies the list of Grid Unique IDentifiers.
25
26       nbstatuses
27              will be set to the number of replies in the array of statuses.
28
29       statuses
30              will be set to the address of an array of integer statuses allo‐
31              cated by the API. The  client  application  is  responsible  for
32              freeing the array when not needed anymore.
33

RETURN VALUE

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

ERRORS

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

SEE ALSO

75       Castor_limits(4), lfc_delreplica(3), lfc_unlink(3)
76

AUTHOR

78       LCG Grid Deployment Team
79
80
81
82LFC                      $Date: 2007/12/13 11:59:47 $    LFC_DELFILESBYGUID(3)