dpm_abortfiles man page


dpm_abortfiles - abort a set of file requests

[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

[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:

specifies the token returned by a previous get/put/copy request.

specifies the number of files to be aborted.

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

The output arguments are:

will be set to the number of replies in the array of file sta-

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;

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

[1mENOENT [22mFile does not exist.

[1mEACCES [22mPermission denied.

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

[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)