lfc_delfilesbyguid man page

LFC_DELFILESBYGUID(3)        LFC Library Functions       LFC_DELFILESBYGUID(3)

[1mNAME[0m
      lfc_delfilesbyguid - delete the file entries corresponding to a list of
      guids

[1mSYNOPSIS[0m
      [1m#include <sys/types.h>[0m
      [1m#include "lfc_api.h"[0m

      [1mint lfc_delfilesbyguid (int [4m[22mnbguids[24m[1m, const char **[4m[22mguids[24m[1m, int [4m[22mforce[24m[1m, int[0m
      [1m*[4m[22mnbstatuses[24m[1m, int **[4m[22mstatuses[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mlfc_delfilesbyguid  [22mdeletes the file entries corresponding to a list of
      guids. If replicas exist and the force argument is not zero, all repli-
      cas are first removed.

      [4mnbguids[0m
             specifies the number of guids in the array [4mguids[24m.

      [4mguids[24m  specifies the list of Grid Unique IDentifiers.

      [4mnbstatuses[0m
             will be set to the number of replies in the array of statuses.

      [4mstatuses[0m
             will be set to the address of an array of integer statuses allo-
             cated by the API. The  client  application  is  responsible  for
             freeing the array when not needed anymore.

[1mRETURN VALUE[0m
      This  routine  returns  0  if the operation was successful or -1 if the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mENOENT       [22mThe named guid does not exist.

      [1mEACCES       [22mSearch permission is denied on a component of  the  parent
                   directory  or  write  permission  is  denied on the parent
                   directory or the parent has the sticky bit S_ISVTX set and

                     the effective user ID of the requestor  does  not  match
                     the owner ID of the file and

                     the  effective  user  ID of the requestor does not match
                     the owner ID of the directory and

                     the file is not writable by the requestor and

                     the requestor does not have ADMIN privilege in the  Cupv
                     database.

      [1mENOMEM       [22mMemory  could not be allocated for marshalling the request
                   or unmarshalling the reply.

      [1mEFAULT       [4m[22mguids[24m, [4mnbstatuses[24m or [4mstatuses[24m is a NULL pointer.

      [1mEEXIST       [22mFile has replicas and [4mforce[24m is zero.

      [1mEINVAL       [4m[22mnbguids[24m is not strictly positive or the length of  one  of
                   the [4mguids[24m exceeds [1mCA_MAXGUIDLEN[22m.

      [1mSENOSSERV    [22mService unknown.

      [1mSEINTERNAL   [22mDatabase error.

      [1mSECOMERR     [22mCommunication error.

      [1mENSNACT      [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
      [1mCastor_limits(4)[22m, [1mlfc_delreplica(3)[22m, [1mlfc_unlink(3)[0m

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

LFC                      $Date: 2007/12/13 11:59:47 $    LFC_DELFILESBYGUID(3)