1DPM_ABORTFILES(3)                 DPM      Library      Functions
2DPM_ABORTFILES(3)
3
4
5
6[1mNAME[0m
7       dpm_abortfiles ‐ abort a set of file requests
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint   dpm_abortfiles   (char    *[4m[22mr_token[24m[1m,
14int  [4m[22mnbsurls[24m[1m,  char **[4m[22msurls[24m[1m, int[0m
15       [1m*[4m[22mnbreplies[24m[1m,     struct     dpm_filestatus
16**[4m[22mfilestatuses[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mdpm_abortfiles [22maborts a set of file requests.  File
20requests in  status
21       DPM_QUEUED   are  removed  from  the  queue of pending re‐
22quests, the ones in
23       status DPM_READY or DPM_DONE are released (unpinned).
24
25       The input arguments are:
26
27       [4mr_token[0m
28              specifies  the  token  returned   by   a   previous
29get/put/copy request.
30
31       [4mnbsurls[0m
32              specifies the number of files to be aborted.
33
34       [4msurls[24m  specifies the array of file names.
35
36       The output arguments are:
37
38       [4mnbreplies[0m
39              will  be  set to the number of replies in the array
40of  file  sta‐
41              tuses.
42
43       [4mfilestatuses[0m
44              will   be  set  to  the  address  of  an  array  of
45dpm_filestatus struc‐
46              tures  allocated by the API. The client application
47is  responsi‐
48              ble for freeing the array when not needed anymore.
49
50       struct dpm_filestatus {
51            char      *surl;
52            int       status;
53            char      *errstring;
54       };
55
56[1mRETURN VALUE[0m
57       This  routine  returns  0  if the operation was successful
58or ‐1 if the
59       operation failed. In the latter case, [1mserrno [22mis set
60appropriately.
61
62[1mERRORS[0m
63       [1mENOENT       [22mFile does not exist.
64
65       [1mEACCES       [22mPermission denied.
66
67       [1mEFAULT       [4m[22mr_token[24m,  [4msurls[24m,   [4mn‐
68breplies[24m  or  [4mfilestatuses[24m  is  a  NULL
69                    pointer.
70
71       [1mENOMEM       [22mMemory could not be allocated for mar‐
72shalling the request.
73
74       [1mEINVAL       [4m[22mnbsurls[24m  is  not strictly posi‐
75tive, the token is not known
76                    or all file requests have errors.
77
78       [1mENAMETOOLONG   [22mThe   length  of  the  surl  exceeds
79[1mCA_MAXSFNLEN[22m.
80
81       [1mSENOSHOST    [22mHost unknown.
82
83       [1mSEINTERNAL   [22mDatabase error.
84
85       [1mSECOMERR     [22mCommunication error.
86
87
88
89LCG                         $Date:    2006/08/01    07:37:06    $
90DPM_ABORTFILES(3)
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
Impressum