1DPM_RELFILES(3)                   DPM      Library      Functions
2DPM_RELFILES(3)
3
4
5
6[1mNAME[0m
7       dpm_relfiles ‐ release a set of files
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint  dpm_relfiles  (char  *[4m[22mr_token[24m[1m,   int
14[4m[22mnbsurls[24m[1m,  char  **[4m[22msurls[24m[1m,  int[0m
15       [4mkeepspace[24m[1m,  int *[4m[22mnbreplies[24m[1m, struct
16dpm_filestatus **[4m[22mfilestatuses[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mdpm_relfiles [22mreleases a set of files.
20
21       The input arguments are:
22
23       [4mr_token[0m
24              specifies  the  token  returned   by   a   previous
25get/put/copy request.
26
27       [4mnbsurls[0m
28              specifies  the number of files belonging to the re‐
29quest.
30
31       [4msurls[24m  specifies the array of file names.
32
33       [4mkeepspace[0m
34              This field is currently ignored.
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       [1mEFAULT        [4m[22mr_token[24m,  [4msurls[24m,  [4mn‐
64breplies[24m  or  [4mfilestatuses[24m  is  a  NULL
65                    pointer.
66
67       [1mENOMEM       [22mMemory could not be allocated for mar‐
68shalling the request.
69
70       [1mEINVAL       [4m[22mnbsurls[24m  is  not strictly posi‐
71tive, the token is not known
72                    or all file requests have errors.
73
74       [1mSENOSHOST    [22mHost unknown.
75
76       [1mSEINTERNAL   [22mDatabase error.
77
78       [1mSECOMERR     [22mCommunication error.
79
80
81
82LCG                         $Date:    2004/12/15    08:34:56    $
83DPM_RELFILES(3)
84
85
86
87
88
89
90
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