Man Linux: Main Page and Category List

NAME

       dpm_addpool - define a new disk pool

SYNOPSIS

       #include <sys/types.h>
       #include "dpm_api.h"

       int dpm_addpool (struct dpm_pool *dpm_pool)

DESCRIPTION

       dpm_addpool defines a new disk pool.

       dpm_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;
       };

       poolname
              specifies the disk pool name.

       defsize
              specifies  the  default  amount of space reserved for a file (in
              bytes).

       gc_start_thresh
              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.

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

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

       defpintime
              specifies the default time a file is kept on a  given  disk  (in
              seconds).

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

       maxpintime
              specifies the maximum time a file is kept on a  given  disk  (in
              seconds).

       nbgids is the size of the array of group ids gids.

       gids   The disk pool is restricted to this set of gids unless the group
              gid is zero.

       ret_policy
              specifies the retention policy supported by the  disk  pool.  It
              can be R (for Replica), O (for Output) or C (for Custodial).

       s_type indicates  the  type of space supported in the disk pool. It can
              be V (for Volatile), D (for Durable), P (for Permanent) or - (to
              accept any type).

       This function requires ADMIN privilege.

RETURN VALUE

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

ERRORS

       EACCES       The caller does not have ADMIN privilege.

       EFAULT       dpm_pool is a NULL pointer.

       EEXIST       This pool exists already.

       ENOMEM       Memory  could  not  be  allocated  for  storing  the  pool
                    definition.

       EINVAL       The length of poolname exceeds CA_MAXPOOLNAMELEN.

       SENOSHOST    Host unknown.

       SEINTERNAL   Database error.

       SECOMERR     Communication error.

LCG          $Date: 2010-02-05 10:56:02 +0100 (Fri, 05 Feb 2010)