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)