dpm_addpool man page

DPM_ADDPOOL(3)               DPM Library Functions              DPM_ADDPOOL(3)

      dpm_addpool - define a new disk pool

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

      [1mint dpm_addpool (struct dpm_pool *[4m[22mdpm_pool[24m[1m)[0m

      [1mdpm_addpool [22mdefines a new disk pool.

             contains the pool definition.

      struct dpm_pool {
           char      poolname[CA_MAXPOOLNAMELEN+1];
           u_signed64     defsize;
           int       gc_start_thresh;
           int       gc_stop_thresh;
           int       def_lifetime;
           int       defpintime;
           int       max_lifetime;
           int       maxpintime;
           char      fss_policy[CA_MAXPOLICYLEN+1];
           char      gc_policy[CA_MAXPOLICYLEN+1];
           char      mig_policy[CA_MAXPOLICYLEN+1];
           char      rs_policy[CA_MAXPOLICYLEN+1];
           int       nbgids;
           gid_t          *gids;
           char      ret_policy;
           char      s_type;
           u_signed64     capacity;
           u_signed64     free;
           int       nbelem;

             specifies the disk pool name.

             specifies  the  default  amount of space reserved for a file (in

             specifies the minimum free space in the pool.  If the percentage
             of  free  space  goes below this value, the garbage collector is
             started. Default is 0.

             specifies the percentage of free space in the pool  above  which
             the garbage collector is stopped. Default is 0.

             specifies  the  default time a space or volatile file is kept in
             the system (in seconds).

             specifies the default time a file is kept on a  given  disk  (in

             specifies  the  maximum time a space or volatile file is kept in
             the system (in seconds).

             specifies the maximum time a file is kept on a  given  disk  (in

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

      [4mgids[24m   The disk pool is restricted to this set of gids unless the group
             gid is zero.

             specifies the retention policy supported by the  disk  pool.  It
             can be [1mR [22m(for Replica), [1mO [22m(for Output) or [1mC [22m(for Custodial).

      [4ms_type[24m indicates  the  type of space supported in the disk pool. It can
             be [1mV [22m(for Volatile), [1mD [22m(for Durable), [1mP [22m(for Permanent) or [1m- [22m(to
             accept any type).

      This function requires ADMIN privilege.

      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 have ADMIN privilege.

      [1mEFAULT       [4m[22mdpm_pool[24m is a NULL pointer.

      [1mEEXIST       [22mThis pool exists already.

      [1mENOMEM       [22mMemory could not be allocated for storing the pool defini-

      [1mEINVAL       [22mThe  length  of  [4mpoolname[24m exceeds [1mCA_MAXPOOLNAMELEN [22mor 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 2011)D$PM_ADDPOOL(3)