1DPM_GETSTATUS_GETREQ(3)       DPM  Library Functions     DPM_GET‐
2STATUS_GETREQ(3)
3
4
5
6[1mNAME[0m
7       dpm_getstatus_getreq ‐ get status for a dpm_get request
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint  dpm_getstatus_getreq (char *[4m[22mr_token[24m[1m,
14int [4m[22mnbfromsurls[24m[1m, char **[4m[22mfrom‐[0m
15       [4msurls[24m[1m,   int   *[4m[22mnbreplies[24m[1m,  struct
16dpm_getfilestatus **[4m[22mfilestatuses[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mdpm_getstatus_getreq [22mgets status for a dpm_get  re‐
20quest.
21
22       The input arguments are:
23
24       [4mr_token[0m
25              specifies  the token returned by a previous get re‐
26quest.
27
28       [4mnbfromsurls[0m
29              specifies the number of files for which the  status
30is requested.
31              If zero, the status of all files in the get request
32is returned.
33
34       [4mfromsurls[0m
35              specifies the array of file names.
36
37       The output arguments are:
38
39       [4mnbreplies[0m
40              will  be  set to the number of replies in the array
41of file sta‐
42              tuses.
43
44       [4mfilestatuses[0m
45              will  be  set  to  the  address   of  an  array  of
46dpm_getfilestatus
47              structures  allocated  by  the  API.   The   client
48application is
49              responsible  for  freeing the array when not needed
50anymore.
51
52       struct dpm_getfilestatus {
53            char      *from_surl;
54            char      *turl;
55            u_signed64     filesize;
56            int       status;
57            char      *errstring;
58            time_t    pintime;
59       };
60
61[1mRETURN VALUE[0m
62       This routine returns 0 if the operation was successful  or
63‐1  if  the
64       operation failed. In the latter case, [1mserrno [22mis set
65appropriately.
66
67[1mERRORS[0m
68       [1mEFAULT       [4m[22mnbfromsurls[24m  is strictly  posi‐
69tive and [4mfromsurls[24m is NULL or
70                    [4mr_token[24m,      [4mnbreplies[24m      or
71[4mfilestatuses[24m is a NULL pointer.
72
73       [1mENOMEM       [22mMemory could not be allocated for mar‐
74shalling the request.
75
76       [1mEINVAL        [4m[22mnbfromsurls[24m  is  not positive,
77the token is  invalid/unknown
78                    or all file requests have errors.
79
80       [1mSENOSHOST    [22mHost unknown.
81
82       [1mSEINTERNAL   [22mDatabase error.
83
84       [1mSECOMERR     [22mCommunication error.
85
86
87
88LCG                      $Date: 2006/03/23 06:12:41  $   DPM_GET‐
89STATUS_GETREQ(3)
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