1DPM_GETREQSUMMARY(3)         DPM Library Functions        DPM_GE‐
2TREQSUMMARY(3)
3
4
5
6[1mNAME[0m
7       dpm_getreqsummary ‐ get summary for a set of requests
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint   dpm_getreqsummary   (int  [4m[22mnbtokens[24m[1m,
14char **[4m[22mr_tokens[24m[1m, int *[4m[22mnbreplies[24m[1m,[0m
15       [1mstruct dpm_reqsummary **[4m[22msummaries[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mdpm_getreqsummary  [22mgets  summary  for  a set of re‐
19quests.
20
21       The input arguments are:
22
23       [4mnbtokens[0m
24              specifies the number of tokens in the request.
25
26       [4mr_tokens[0m
27              specifies an array of tokens returned by   previous
28get/put/copy
29              requests.
30
31       The output arguments are:
32
33       [4mnbreplies[0m
34              will  be  set  to  the number of replies in the ar‐
35ray of request
36              summaries.
37
38       [4msummaries[0m
39              will be set to the address of an array of  dpm_req‐
40summary  struc‐
41              tures  allocated by the API. The client application
42is responsi‐
43              ble for freeing the array when not needed anymore.
44
45       struct dpm_reqsummary {
46            char      r_token[CA_MAXDPMTOKENLEN+1];
47            char      r_type;
48            int       nb_reqfiles;
49            int       nb_queued;
50            int       nb_finished;
51            int       nb_progress;
52       };
53
54[1mRETURN VALUE[0m
55       This routine returns 0 if the operation was successful  or
56‐1  if  the
57       operation failed. In the latter case, [1mserrno [22mis set
58appropriately.
59
60[1mERRORS[0m
61       [1mEFAULT         [4m[22mr_tokens[24m    [4m,[24m    [4mn‐
62breplies[24m or [4msummaries[24m is a NULL pointer.
63
64       [1mENOMEM        [22mMemory  could  not  be  allocated for
65storing the reply.
66
67       [1mEINVAL       [4m[22mnbtokens[24m  is not strictly posi‐
68tive or the specified tokens
69                    are invalid/unknown.
70
71       [1mSENOSHOST    [22mHost unknown.
72
73       [1mSEINTERNAL   [22mDatabase error.
74
75       [1mSECOMERR     [22mCommunication error.
76
77
78
79LCG                      $Date: 2004/12/15 08:04:58 $     DPM_GE‐
80TREQSUMMARY(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