qvm-volume – Qubes volume and block device managment

Synopsis

qvm-volume COMMAND [-h] [–verbose] [–quiet] [options] [arguments]

Description

Options

--help, -h

Show help message and exit

--verbose, -v

Increase verbosity.

--quiet, -q

Decrease verbosity.

Commands

list

qvm-volume list [-h] [–verbose] [–quiet] [-p POOL_NAME] [VMNAME [VMNAME …]]

List block devices. By default the internal devices are hidden. When the stdout is connected to a TTY qvm-volume list will print a pretty table by omitting redundant data. This behaviour is disabled when –full option is passed or stdout is redirected to a pipe or file.

-p, --pool

list volumes from specified pool

--full

print domain names

--all

List volumes from all qubes. You can use --exclude to limit the qubes set. Don’t forget — internal devices are hidden by default!

--exclude

Exclude the qube from --all.

aliases: ls, l

info

qvm-volume info [-h] [–verbose] [–quiet] VMNAME:VOLUME [PROPERTY]

Show information about given volume - all properties and available revisions (for revert action). If specific property is given, only its value is printed. For list of revisions use revisions value.

aliases: i

config

qvm-volume config [-h] [–verbose] [–quiet] VMNAME:VOLUME PROPERTY VALUE

Set property of given volume. Properties currently possible to change:

  • rw - True if volume should be writeable by the qube, False otherwise
  • revisions_to_keep - how many revisions (previous versions of volume) should be keep. At each qube shutdown its previous state is saved in new revision, and the oldest revisions are remove so that only revisions_to_keep are left. Set to 0 to not leave any previous versions.

aliases: c, set, s

resize

qvm-volume resize [-h] [–force|-f] [–verbose] [–quiet] VMNAME:VOLUME NEW_SIZE

Resize the volume with VMNAME:VOLUME TO NEW_SIZE

If new size is smaller than current, the tool will refuse to continue unless –force option is used. One should be very careful about that, because shrinking volume without shrinking filesystem and other data inside first, will surely end with data loss.

-f, --force

Force operation even if new size is smaller than the current one.

aliases: extend

revert

qvm-volume revert [-h] [–verbose] [–quiet] VMNAME:VOLUME

Revert a volume to previous revision.

aliases: rv, r

Authors

Joanna Rutkowska <joanna at invisiblethingslab dot com>
Rafal Wojtczuk <rafal at invisiblethingslab dot com>
Marek Marczykowski <marmarek at invisiblethingslab dot com>
Bahtiar kalkin- Gadimov <bahtiar at gadimov dot de>