lfc_delreplicasbysfn man page

LFC_DELREPLICASBYSFN(3)      LFC Library Functions     LFC_DELREPLICASBYSFN(3)

[1mNAME[0m
      lfc_delreplicasbysfn  -  delete  entries associated with a list of sfns
      and corresponding lfn if last replica

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

      [1mint lfc_delreplicasbysfn (int [4m[22mnbfiles[24m[1m, const char  **[4m[22msfns[24m[1m,  const  char[0m
      [1m**[4m[22mguids[24m[1m, int *[4m[22mnbstatuses[24m[1m, int **[4m[22mstatuses[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mlfc_delreplicasbysfn [22mdeletes entries associated with a list of sfns and
      corresponding lfn if last replica.  An extra check may be  obtained  by
      specifying a list of [4mguids[24m.

      [4mnbfiles[0m
             specifies the number of file names in the array [4msfns[24m.

      [4msfns[24m   specifies  either  the  Site URLs or the Physical File Names for
             the list of replicas.

      [4mguids[24m  specifies the list of Grid Unique IDentifiers (optional). Can be
             NULL.

      [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.  Individual statuses
             are 0 if the operation was successful or set to the serrno value
             in case of error.

[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 file or replica does not exist.

      [1mE2BIG        [22mRequest too large (max 1 MB).

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

      [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[22msfns[24m, [4mnbstatuses[24m or [4mstatuses[24m is a NULL pointer.

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

      [1mENAMETOOLONG [22mThe length of [4msfn[24m exceeds [1mCA_MAXSFNLEN[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: 2009/04/06 08:30:13 $  LFC_DELREPLICASBYSFN(3)