---
name: "dpm-addpool"
section: "1"
platform: "linux"
package: "dpm"
version: "1.10.0-2+b3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/dpm-addpool"
---

# dpm-addpool(1)

define a new disk pool

## 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)](/dpm_addpool/3.md)**