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

NAME

6       dpm_updatespace - update space
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpm_api.h"
11
12       int  dpm_updatespace (char *s_token, u_signed64 req_t_space, u_signed64
13       req_g_space,  time_t  req_lifetime,  int   nbgids,   gid_t   *req_gids,
14       u_signed64    *actual_t_space,   u_signed64   *actual_g_space,   time_t
15       *actual_lifetime)
16

DESCRIPTION

18       dpm_updatespace updates space.
19
20       The input arguments are:
21
22       s_token
23              specifies the token returned by a previous reservespace request.
24
25       req_t_space
26              Total space requested in bytes.  If set to -1, the current value
27              is unchanged.
28
29       req_g_space
30              Guaranteed  space requested in bytes.  If set to -1, the current
31              value is unchanged.
32
33       req_lifetime
34              specifies the requested space lifetime (in seconds) relative  to
35              the current time.  If set to -1, the current value is unchanged.
36
37       nbgids is  the  size of the array of group ids req_gids.  If set to -1,
38              the current value is unchanged.
39
40       req_gids
41              when zero, the space is reserved for the user if  the  requester
42              has  a  proxy  without  VOMS  extension  or for the group if the
43              requester has a proxy with VOMS extension.   If  not  zero,  the
44              space is reserved for this set of group ids.  If the caller does
45              not belong to the group, it must have ADMIN privileges.
46
47       The output arguments are:
48
49       actual_t_space
50              Total space reserved in bytes (best effort).
51
52       actual_g_space
53              Guaranteed space reserved in bytes.
54
55       actual_lifetime
56              Lifetime of the reserved space (in seconds) relative to the cur‐
57              rent time.
58

RETURN VALUE

60       This  routine  returns  0  if the operation was successful or -1 if the
61       operation failed. In the latter case, serrno is set appropriately.
62

ERRORS

64       EFAULT       s_token is a NULL pointer or nbgids is greater than 0  and
65                    req_gids is a NULL pointer.
66
67       EINVAL       s_token  is  invalid  (too  long)  or unknown or the space
68                    requested is not a positive value.
69
70       SENOSHOST    Host unknown.
71
72       SEINTERNAL   Database error.
73
74       SECOMERR     Communication error.
75
76
77
78LCG                      $Date: 2008/09/24 11:25:00 $       DPM_UPDATESPACE(3)
Impressum