NAME

       dpm-addpool - define a new disk pool

SYNOPSIS

       dpm-addpool  --poolname pool_name --def_filesize defsize [ --def_lifetime def_lifetime ] [
       --def_pintime defpintime ] [ --gc_start_thresh perc ] [ --gc_stop_thresh perc  ]  [  --gid
       pool_gids  ]  [  --group  pool_groups  ]  [  --help  ]  [  --max_lifetime max_lifetime ] [
       --max_pintime maxpintime ] [ --ret_policy retention_policy ] [ --s_type space_type ]

DESCRIPTION

       dpm-addpool defines a new disk pool.

       This command requires ADMIN privilege.

OPTIONS

       pool_name
              specifies the disk pool name.  It must  be  at  most  CA_MAXPOOLNAMELEN  characters
              long.

       defsize
              specifies  the  default amount of space reserved for a file.  This is by default in
              bytes, but the number may also be post-fixed with 'k', 'M'  or  'G'  for  kilobyte,
              Megabyte and Gigabyte respectively.

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

       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.

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

       pool_gids
              if  not  zero,  the  disk  pool is restricted to this comma separated list of group
              gids.

       pool_groups
              if set and not "ALL", the disk pool is restricted to this comma separated  list  of
              group names.

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

       space_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).  The latter is the
              default.

EXAMPLE

            dpm-addpool --poolname Volatile --def_filesize 200M --s_type V

EXIT STATUS

       This program returns 0 if the operation was successful or >0 if the operation failed.

SEE ALSO

       dpm(1), dpm_addpool(3)