dpm_reservespace man page

DPM_RESERVESPACE(3)          DPM Library Functions         DPM_RESERVESPACE(3)

[1mNAME[0m
      dpm_reservespace - reserve space

[1mSYNOPSIS[0m
      [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

[1mDESCRIPTION[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).

      [4mu_token[0m
             specifies  the  user  provided  description  associated with the
             request.  This argument may be NULL.

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

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

      [4mreq_t_space[0m
             Total space requested in bytes.

      [4mreq_g_space[0m
             Guaranteed space requested in bytes.

      [4mreq_lifetime[0m
             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.

      [4mreq_gids[0m
             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.

      [4mpoolname[0m
             If not NULL, reserves the space in that disk pool.

      The output arguments are:

      [4mactual_s_type[0m
             Type of reserved space.

      [4mactual_t_space[0m
             Total space reserved in bytes (best effort).

      [4mactual_g_space[0m
             Guaranteed space reserved in bytes.

      [4mactual_lifetime[0m
             Lifetime of the reserved space (in seconds) relative to the cur-
             rent time.

      [4ms_token[0m
             Address of a buffer to receive the system allocated token.

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

[1mERRORS[0m
      [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
                   big.

      [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)