1DPM_GETREQSUMMARY(3)         DPM Library Functions        DPM_GETREQSUMMARY(3)
2
3
4

NAME

6       dpm_getreqsummary - get summary for a set of requests
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpm_api.h"
11
12       int  dpm_getreqsummary  (int nbtokens, char **r_tokens, int *nbreplies,
13       struct dpm_reqsummary **summaries)
14

DESCRIPTION

16       dpm_getreqsummary gets summary for a set of requests.
17
18       The input arguments are:
19
20       nbtokens
21              specifies the number of tokens in the request.
22
23       r_tokens
24              specifies an array of tokens returned by  previous  get/put/copy
25              requests.
26
27       The output arguments are:
28
29       nbreplies
30              will  be  set  to  the number of replies in the array of request
31              summaries.
32
33       summaries
34              will be set to the address of an array of dpm_reqsummary  struc‐
35              tures  allocated by the API. The client application is responsi‐
36              ble for freeing the array when not needed anymore.
37
38       struct dpm_reqsummary {
39            char      r_token[CA_MAXDPMTOKENLEN+1];
40            char      r_type;
41            int       nb_reqfiles;
42            int       nb_queued;
43            int       nb_finished;
44            int       nb_progress;
45       };
46

RETURN VALUE

48       This routine returns 0 if the operation was successful  or  -1  if  the
49       operation failed. In the latter case, serrno is set appropriately.
50

ERRORS

52       EFAULT       r_tokens , nbreplies or summaries is a NULL pointer.
53
54       ENOMEM       Memory could not be allocated for storing the reply.
55
56       EINVAL       nbtokens  is not strictly positive or the specified tokens
57                    are invalid/unknown.
58
59       SENOSHOST    Host unknown.
60
61       SEINTERNAL   Database error.
62
63       SECOMERR     Communication error.
64
65
66
67LCG                      $Date: 2004/12/15 08:04:58 $     DPM_GETREQSUMMARY(3)
Impressum