qvm-pool – Manage pools

Synopsis

qvm-pool {add,a} [options] <pool_name> <driver>
qvm-pool {drivers,d} [options]
qvm-pool {info,i} [options] <pool_name>
qvm-pool {list,ls,l} [options]
qvm-pool {remove,rm,i} [options] <pool_name> …
qvm-pool {set,s} [options] <pool_name>

Legacy Mode

qvm-pool [options] {-a, –add} <pool_name> <driver>
qvm-pool [options] {-i, –info} <pool_name>
qvm-pool [options] {-l, –list}
qvm-pool [options] {-r, –remove} <pool_name>
qvm-pool [options] {-s, –set} <pool_name>
qvm-pool [options] –help-drivers

Deprecated since version 4.0.18.

Options

--help, -h

Show this help message and exit

--quiet, -q

Be quiet

--verbose, -v

Increase verbosity

Commands

add

qvm-pool add [-h] [–verbose] [–quiet] POOL_NAME DRIVER

Add a new pool.

--option, -o

Set option for the driver in name=value format. You can specify this option multiple times.

See also

The drivers command for supported drivers and their options.

aliases: a

Legacy mode: qvm-pool [-h] [–verbose] [–quiet] –add POOL_NAME DRIVER -o OPTIONS

drivers

qvm-pool drivers [-h] [–verbose] [–quiet]

List all known drivers with their options. The listed driver options can be used with the -o options switch.

aliases: d

Legacy mode: qvm-pool [-h] [–verbose] [–quiet] –help-drivers

info

qvm-pool info [-h] [–verbose] [–quiet] POOL_NAME

Print info about a specified pool

aliases: i

Legacy mode: qvm-pool [-h] [–verbose] [–quiet] –info POOL_NAME

list

qvm-pool list [-h] [–verbose] [–quiet]

List all available pools.

aliases: l, ls

Legacy mode: qvm-pool [-h] [–verbose] [–quiet] –list

remove

qvm-pool remove [-h] [–verbose] [–quiet] POOL_NAME [POOL_NAME …]

Remove the specified pools. This removes only the information about the pool from qubes.xml, but does not delete any content (FIXME: is it really true for all pool drivers?).

aliases: r, rm

Legacy mode: qvm-pool [-h] [–verbose] [–quiet] –remove POOL_NAME [POOL_NAME …]

set

qvm-pool set [-h] [–verbose] [–quiet] POOL_NAME

Modify driver options for a pool.

--option, -o

Set option for the driver in name=value format. You can specify this option multiple times.

See also

The drivers command for supported drivers and their options.

aliases: s

Legacy mode: qvm-pool [-h] [–verbose] [–quiet] –set POOL_NAME -o OPTIONS

Examples

Create a pool backed by the file-reflink driver.

qvm-pool add foo file-reflink -o dir_path=/mnt/foo

Have pool lvm encrypt its volatile volumes with an ephemeral key for anti-forensics:

qvm-pool set -o encrypted_volatile=True lvm

Authors

Bahtiar `kalkin-` Gadimov <bahtiar at gadimov dot de>
Saswat Padhi <padhi at cs dot ucla dot edu>
For complete author list see: https://github.com/QubesOS/qubes-core-admin-client.git