lfc_delfilesbyname man page

LFC_DELFILESBYNAME(3)        LFC Library Functions       LFC_DELFILESBYNAME(3)

[1mNAME[0m
      lfc_delfilesbyname - delete the file entries corresponding to a list of
      path names

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

      [1mint lfc_delfilesbyname (int [4m[22mnbfiles[24m[1m, const char **[4m[22mpaths[24m[1m, int [4m[22mforce[24m[1m, int[0m
      [1m*[4m[22mnbstatuses[24m[1m, int **[4m[22mstatuses[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mlfc_delfilesbyname  [22mdeletes the file entries corresponding to a list of
      path names. If replicas exist and the force argument is not  zero,  all
      replicas are first removed.

      [4mnbfiles[0m
             specifies the number of path names in the array [4mpaths[24m.

      [4mpaths[24m  specifies the list of logical path names relative to the current
             LFC directory or the list of full LFC path names.

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

      [1mEACCES       [22mSearch  permission  is  denied  on a component of the [4mpath[0m
                   prefix or write permission is denied on the parent  direc-
                   tory 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[22mpaths[24m, [4mnbstatuses[24m or [4mstatuses[24m is a NULL pointer.

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

      [1mENOTDIR      [22mA component of [4mpath[24m prefix is not a directory.

      [1mENAMETOOLONG [22mThe  length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length of
                   a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[22m.

      [1mEINVAL       [4m[22mnbfiles[24m is not strictly positive.

      [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_DELFILESBYNAME(3)