1DPM_GETREQID(3)                   DPM      Library      Functions
2DPM_GETREQID(3)
3
4
5
6[1mNAME[0m
7       dpm_getreqid ‐ get request id 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_getreqid   (char  *[4m[22mu_token[24m[1m,  int
14*[4m[22mnbreplies[24m[1m, struct dpm_tokeninfo[0m
15       [1m**[4m[22mtokeninfos[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mdpm_getreqid [22mgets request id for a set of requests.
19
20       The input argument is:
21
22       [4mu_token[0m
23              specifies  the user provided description associated
24with a previ‐
25              ous get/put/copy request.
26
27       The output arguments are:
28
29       [4mnbreplies[0m
30              will  be  set  to  the  number  of replies  in  the
31array of token
32              infos.
33
34       [4mtokeninfos[0m
35              will  be set to the address of an array of  dpm_to‐
36keninfo  struc‐
37              tures  allocated by the API. The client application
38is responsi‐
39              ble for freeing the array when not needed anymore.
40
41       struct dpm_tokeninfo {
42            char      r_token[CA_MAXDPMTOKENLEN+1];
43            time_t    c_time;
44       };
45
46[1mRETURN VALUE[0m
47       This routine returns 0 if the operation was successful  or
48‐1  if  the
49       operation failed. In the latter case, [1mserrno [22mis set
50appropriately.
51
52[1mERRORS[0m
53       [1mEFAULT        [4m[22mnbreplies[24m or [4mtokeninfos[24m
54is a NULL pointer.
55
56       [1mENOMEM       [22mMemory  could  not  be  allocated  for
57storing the reply.
58
59       [1mEINVAL        [22mThe  length  of  the user request de‐
60scription is greater than
61                    255 or the user request  description  is  un‐
62known.
63
64       [1mSENOSHOST    [22mHost unknown.
65
66       [1mSEINTERNAL   [22mDatabase error.
67
68       [1mSECOMERR     [22mCommunication error.
69
70
71
72LCG                         $Date:    2006/02/17    06:47:32    $
73DPM_GETREQID(3)
74
75
76
77
78
79
80
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