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