1DPM_GETSPACETOKEN(3)              DPM      Library      Functions
2DPM_GETSPACETOKEN(3)
3
4
5
6[1mNAME[0m
7       dpm_getspacetoken ‐ get space token
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint   dpm_getspacetoken   (const   char   *[4m[22mu_to‐
14ken[24m[1m,  int  *[4m[22mnbreplies[24m[1m,  char[0m
15       [1m***[4m[22ms_tokens[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mdpm_getspacetoken  [22mgets  the  list  of space tokens
19associated  with  this
20       user description.
21
22       The input argument is:
23
24       [4mu_token[0m
25              specifies the user provided description  associated
26with a previ‐
27              ous  reservespace request. If the argument is NULL,
28all the space
29              tokens accessible by the user will be listed.
30
31       The output arguments are:
32
33       [4mnbreplies[0m
34              will  be  set  to  the  number  of replies  in  the
35array of space
36              tokens.
37
38       [4ms_tokens[0m
39              will be set to the address of an array of space to‐
40kens allocated
41              by  the  API.  The client application is  responsi‐
42ble for freeing
43              the array when not needed anymore.
44
45[1mRETURN VALUE[0m
46       This routine returns 0 if the operation was successful  or
47‐1  if  the
48       operation failed. In the latter case, [1mserrno [22mis set
49appropriately.
50
51[1mERRORS[0m
52       [1mEFAULT       [4m[22mnbreplies[24m or [4ms_tokens[24m is
53a NULL pointer.
54
55       [1mENOMEM       [22mMemory  could  not  be  allocated  for
56storing the reply.
57
58       [1mEINVAL        [22mThe   length  of the user space token
59description is greater
60                    than 255 or the user space token  description
61is unknown.
62
63       [1mSENOSHOST    [22mHost unknown.
64
65       [1mSEINTERNAL   [22mDatabase error.
66
67       [1mSECOMERR     [22mCommunication error.
68
69
70
71LCG                         $Date:    2006/12/20    15:47:54    $
72DPM_GETSPACETOKEN(3)
73
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