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

NAME

6       dpm_getreqid - get request id for a set of requests
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpm_api.h"
11
12       int  dpm_getreqid  (char *u_token, int *nbreplies, struct dpm_tokeninfo
13       **tokeninfos)
14

DESCRIPTION

16       dpm_getreqid gets request id for a set of requests.
17
18       The input argument is:
19
20       u_token
21              specifies the user provided description associated with a previ‐
22              ous get/put/copy request.
23
24       The output arguments are:
25
26       nbreplies
27              will  be  set  to  the  number  of replies in the array of token
28              infos.
29
30       tokeninfos
31              will be set to the address of an array of  dpm_tokeninfo  struc‐
32              tures  allocated by the API. The client application is responsi‐
33              ble for freeing the array when not needed anymore.
34
35       struct dpm_tokeninfo {
36            char      r_token[CA_MAXDPMTOKENLEN+1];
37            time_t    c_time;
38       };
39

RETURN VALUE

41       This routine returns 0 if the operation was successful  or  -1  if  the
42       operation failed. In the latter case, serrno is set appropriately.
43

ERRORS

45       EFAULT       nbreplies or tokeninfos is a NULL pointer.
46
47       ENOMEM       Memory could not be allocated for storing the reply.
48
49       EINVAL       The length of the user request description is greater than
50                    255 or the user request description is unknown.
51
52       SENOSHOST    Host unknown.
53
54       SEINTERNAL   Database error.
55
56       SECOMERR     Communication error.
57
58
59
60LCG                      $Date: 2006/02/17 06:47:32 $          DPM_GETREQID(3)
Impressum