dpm_reservespace man page


dpm_reservespace - reserve space

[1m#include <sys/types.h>[0m
[1m#include "dpm_api.h"[0m

[1mint dpm_reservespace (const char [4m[22ms_type[24m[1m, const char *[4m[22mu_token[24m[1m, const[0m
[1mchar [4m[22mret_policy[24m[1m, const char [4m[22mac_latency[24m[1m, u_signed64 [4m[22mreq_t_space[24m[1m,[0m
[1mu_signed64 [4m[22mreq_g_space[24m[1m, time_t [4m[22mreq_lifetime[24m[1m, int [4m[22mnbgids[24m[1m, gid_t[0m
[1m*[4m[22mreq_gids[24m[1m, const char *[4m[22mpoolname,[24m [1mchar *[4m[22mactual_s_type[24m[1m, u_signed64[0m
[1m*[4m[22mactual_t_space[24m[1m, u_signed64 *[4m[22mactual_g_space[24m[1m, time_t *[4m[22mactual_lifetime[24m[1m,[0m
[1mchar *[4m[22ms_token[24m[1m)[0m

[1mdpm_reservespace [22mreserves space.

The input arguments are:

[4ms_type[24m specifies the type of space requested. It can be [1mV [22m(for
Volatile), [1mD [22m(for Durable), [1mP [22m(for Permanent) or [1m- [22m(for any).

specifies the user provided description associated with the
request. This argument may be NULL.

specifies the retention policy requested. It can be [1mR [22m(for
REPLICA), [1mO [22m(for OUTPUT) or [1mC [22m(for CUSTODIAL).

specifies the access latency requested. It can be [1mO [22m(for ONLINE)
or [1mN [22m(for NEARLINE).

Total space requested in bytes.

Guaranteed space requested in bytes.

specifies the requested space lifetime (in seconds) relative to
the current time.

[4mnbgids[24m is the size of the array of group ids [4mreq_gids[24m.

when zero, the space is reserved for the user if the requester
has a proxy without VOMS extension or for the group if the
requester has a proxy with VOMS extension. If not zero, the
space is reserved for this set of group ids. If the caller does
not belong to the group, it must have ADMIN privileges.

If not NULL, reserves the space in that disk pool.

The output arguments are:

Type of reserved space.

Total space reserved in bytes (best effort).

Guaranteed space reserved in bytes.

Lifetime of the reserved space (in seconds) relative to the cur-
rent time.

Address of a buffer to receive the system allocated token.

This routine returns 0 if the operation was successful or -1 if the
operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mEACCES [22mThe caller does not belong to the group identified by
[4mreq_gid[24m and does not have ADMIN privileges.

[1mEFAULT [4m[22mnbgids[24m is greater than 0 and [4mreq_gids[24m is a NULL pointer.

[1mEINVAL [22mThe space type is invalid or the length of the user space
token description is greater than 255, the space requested
is not a positive value, the pool name is longer than
[1mCA_MAXPOOLNAMELEN [22mor unknown or the number of gids is too

[1mSENOSHOST [22mHost unknown.

[1mSEINTERNAL [22mDatabase error.

[1mSECOMERR [22mCommunication error.

LCG $Date: 2011-05-19 12:54:37 +0200 (Thu, 19 May 2D0P1M1_)RE$SERVESPACE(3)