dpm-addpool(1)

dpm-addpool1

Define a new disk pool

Usage

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]

Overview

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.

Examples

	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.

Releases

Unchanged in 5 releases since Debian 6.0 (Squeeze).

  1. 6.0–10

From dpm 1.10.0-2+b3 in Debian 10 (Buster). Parsed by carta from the page's man source.