1DPM_PUTDONE(3)                    DPM      Library      Functions
2DPM_PUTDONE(3)
3
4
5
6[1mNAME[0m
7       dpm_putdone ‐ mark a set of files as complete
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint   dpm_putdone  (char  *[4m[22mr_token[24m[1m,   int
14[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_putdone [22mmarks a set of files as complete.
20
21       The input arguments are:
22
23       [4mr_token[0m
24              specifies the token returned by a previous put  re‐
25quest.
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       The output arguments are:
34
35       [4mnbreplies[0m
36              will be set to the number of replies in  the  array
37of  file  sta‐
38              tuses.
39
40       [4mfilestatuses[0m
41              will   be  set  to  the  address  of  an  array  of
42dpm_filestatus struc‐
43              tures allocated by the API. The client  application
44is  responsi‐
45              ble for freeing the array when not needed anymore.
46
47       struct dpm_filestatus {
48            char      *surl;
49            int       status;
50            char      *errstring;
51       };
52
53[1mRETURN VALUE[0m
54       This  routine  returns  0  if the operation was successful
55or ‐1 if the
56       operation failed. In the latter case, [1mserrno [22mis set
57appropriately.
58
59[1mERRORS[0m
60       [1mEFAULT        [4m[22mr_token[24m,  [4msurls[24m,  [4mn‐
61breplies[24m  or  [4mfilestatuses[24m  is  a  NULL
62                    pointer.
63
64       [1mENOMEM       [22mMemory could not be allocated for mar‐
65shalling the request.
66
67       [1mEINVAL        [4m[22mnbsurls[24m  is not strictly posi‐
68tive, the token is too long or
69                    not known or all file requests have errors.
70
71       [1mSENOSHOST    [22mHost unknown.
72
73       [1mSEINTERNAL   [22mDatabase error.
74
75       [1mSECOMERR     [22mCommunication error.
76
77
78
79LCG                         $Date:    2006/02/17    06:47:32    $
80DPM_PUTDONE(3)
81
82
83
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
Impressum