1DPM_UPDATESPACE(3)                DPM      Library      Functions
2DPM_UPDATESPACE(3)
3
4
5
6[1mNAME[0m
7       dpm_updatespace ‐ update space
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpm_api.h"[0m
12
13       [1mint   dpm_updatespace   (char   *[4m[22ms_token[24m[1m,
14u_signed64 [4m[22mreq_t_space[24m[1m, u_signed64[0m
15       [4mreq_g_space[24m[1m,       time_t       [4m[22mreq_life‐
16time[24m[1m,       int        [4m[22mnbgids[24m[1m,         gid_t
17*[4m[22mreq_gids[24m[1m,[0m
18       [1mu_signed64               *[4m[22mactual_t_space[24m[1m,
19u_signed64   *[4m[22mactual_g_space[24m[1m,   time_t[0m
20       [1m*[4m[22mactual_lifetime[24m[1m)[0m
21
22[1mDESCRIPTION[0m
23       [1mdpm_updatespace [22mupdates space.
24
25       The input arguments are:
26
27       [4ms_token[0m
28              specifies the token  returned  by  a  previous  re‐
29servespace request.
30
31       [4mreq_t_space[0m
32              Total  space requested in bytes.  If set to ‐1, the
33current value
34              is unchanged.
35
36       [4mreq_g_space[0m
37              Guaranteed  space requested in bytes.   If  set  to
38‐1, the current
39              value is unchanged.
40
41       [4mreq_lifetime[0m
42              specifies the requested space lifetime (in seconds)
43relative  to
44              the current time.  If set to ‐1, the current  value
45is unchanged.
46
47       [4mnbgids[24m  is   the   size  of  the array of group ids
48[4mreq_gids[24m.  If set to ‐1,
49              the current value is unchanged.
50
51       [4mreq_gids[0m
52              when zero, the space is reserved for  the  user  if
53the  requester
54              has  a  proxy  without  VOMS  extension  or for the
55group if the
56              requester has a proxy  with  VOMS  extension.    If
57not  zero,  the
58              space  is  reserved  for this set of group ids.  If
59the caller does
60              not belong to the group, it must have ADMIN  privi‐
61leges.
62
63       The output arguments are:
64
65       [4mactual_t_space[0m
66              Total space reserved in bytes (best effort).
67
68       [4mactual_g_space[0m
69              Guaranteed space reserved in bytes.
70
71       [4mactual_lifetime[0m
72              Lifetime  of  the reserved space (in seconds) rela‐
73tive to the cur‐
74              rent time.
75
76[1mRETURN VALUE[0m
77       This  routine  returns  0  if the operation was successful
78or ‐1 if the
79       operation failed. In the latter case, [1mserrno [22mis set
80appropriately.
81
82[1mERRORS[0m
83       [1mEFAULT       [4m[22ms_token[24m is a  NULL  pointer  or
84[4mnbgids[24m is greater than 0  and
85                    [4mreq_gids[24m is a NULL pointer.
86
87       [1mEINVAL         [4m[22ms_token[24m   is   invalid   (too
88long)  or unknown or the space
89                    requested is not a positive value or the num‐
90ber of gids is
91                    too big.
92
93       [1mSENOSHOST    [22mHost unknown.
94
95       [1mSEINTERNAL   [22mDatabase error.
96
97       [1mSECOMERR     [22mCommunication error.
98
99
100
101LCG                                                        $Date$
102DPM_UPDATESPACE(3)
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
Impressum