dpm_abortfiles man page

DPM_ABORTFILES(3)            DPM Library Functions           DPM_ABORTFILES(3)

[1mNAME[0m
      dpm_abortfiles - abort a set of file requests

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

      [1mint  dpm_abortfiles  (char  *[4m[22mr_token[24m[1m,  int  [4m[22mnbsurls[24m[1m,  char **[4m[22msurls[24m[1m, int[0m
      [1m*[4m[22mnbreplies[24m[1m, struct dpm_filestatus **[4m[22mfilestatuses[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpm_abortfiles [22maborts a set of file requests.  File requests in  status
      DPM_QUEUED  are removed from the queue of pending requests, the ones in
      status DPM_READY or DPM_DONE are released (unpinned).

      The input arguments are:

      [4mr_token[0m
             specifies the token returned by a previous get/put/copy request.

      [4mnbsurls[0m
             specifies the number of files to be aborted.

      [4msurls[24m  specifies the array of file names.

      The output arguments are:

      [4mnbreplies[0m
             will be set to the number of replies in the array of  file  sta-
             tuses.

      [4mfilestatuses[0m
             will  be set to the address of an array of dpm_filestatus struc-
             tures allocated by the API. The client application is  responsi-
             ble for freeing the array when not needed anymore.

      struct dpm_filestatus {
           char      *surl;
           int       status;
           char      *errstring;
      };

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

      [1mEACCES       [22mPermission denied.

      [1mEFAULT       [4m[22mr_token[24m,  [4msurls[24m,  [4mnbreplies[24m  or  [4mfilestatuses[24m  is  a  NULL
                   pointer.

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

      [1mEINVAL       [4m[22mnbsurls[24m  is  not strictly positive, the token is not known
                   or all file requests have errors.

      [1mENAMETOOLONG [22mThe length of the surl exceeds [1mCA_MAXSFNLEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSEINTERNAL   [22mDatabase error.

      [1mSECOMERR     [22mCommunication error.

LCG                      $Date: 2006/08/01 07:37:06 $        DPM_ABORTFILES(3)