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

# dpm-modifypool(1)

modify a disk pool definition

## NAME

dpm-modifypool - modify a disk pool definition

## SYNOPSIS

**dpm-modifypool** **--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-modifypool** modifies a disk pool definition.

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.

- *gc\_stop\_thresh*

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

- *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*

  The existing list can be reset using a comma separated list of group gids, extended by prefixing the gid by + or reduced by prefixing the gid by -. See examples.

- *pool\_groups*

  The existing list can be reset using a comma separated list of group names, extended by prefixing the name by + or reduced by prefixing the name by -. The keyword "ALL" means non-dedicated pool. See examples.

- *retention\_policy*

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

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

## EXAMPLE

```
	dpm-modifypool --poolname Volatile --def_filesize 100M \
		--groups -dteam,ops,+atlas
```

## EXIT STATUS

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

## SEE ALSO

**dpm(1)**, **[dpm\_modifypool(3)](/dpm_modifypool/3.md)**