core-admin/doc/manpages/qvm-block.rst

113 lines
2.3 KiB
ReStructuredText
Raw Normal View History

2014-11-21 12:30:23 +01:00
.. program:: qvm-block
2013-03-12 16:55:05 +01:00
2016-05-09 05:12:37 +02:00
:program:`qvm-block` -- Qubes volume and block device managment
===============================================================
2013-03-12 16:55:05 +01:00
2014-11-21 12:30:23 +01:00
Synopsis
2016-05-09 05:12:37 +02:00
--------
2013-03-12 16:55:05 +01:00
2016-04-30 17:28:13 +02:00
| :command:`qvm-block` *COMMAND* [-h] [--verbose] [--quiet] [options] [arguments]
Description
-----------
.. TODO Add description
2013-03-12 16:55:05 +01:00
2014-11-21 12:30:23 +01:00
Options
2016-05-09 05:12:37 +02:00
-------
2014-11-21 12:30:23 +01:00
.. option:: --help, -h
2016-04-30 17:28:13 +02:00
Show help message and exit
.. option:: --verbose, -v
Increase verbosity.
.. option:: --quiet, -q
Decrease verbosity.
Commands
--------
list
^^^^
| :command:`qvm-block list` [-h] [--verbose] [--quiet] [-p *POOL_NAME*] [-i] [*VMNAME* [*VMNAME* ...]]
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
List block devices. By default the internal devices are hidden. When the
stdout is connected to a TTY `qvm-block 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.
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
.. option:: -p, --pool
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
list volumes from specified pool
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
.. option:: -i, --internal
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
list internal devices
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
.. option:: --full
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
print domain names
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
.. option:: --all
2016-05-09 05:12:37 +02:00
2016-04-30 17:28:13 +02:00
List volumes from all qubes. You can use :option:`--exclude` to limit the
qubes set. Don't forget — internal devices are hidden by default!
.. option:: --exclude
Exclude the qube from :option:`--all`.
aliases: ls, l
attach
^^^^^^
| :command:`qvm-block attach` [-h] [--verbose] [--quiet] [--ro] *VMNAME* *POOL_NAME:VOLUME_ID*
Attach the volume with *VOLUME_ID* from *POOL_NAME* to the domain *VMNAME*
2014-11-21 12:30:23 +01:00
.. option:: --ro
2016-04-30 17:28:13 +02:00
attach device read-only
aliases: a, at
detach
^^^^^^
| :command:`qvm-block detach` [-h] [--verbose] [--quiet] *VMNAME* *POOL_NAME:VOLUME_ID*
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
Detach the volume with *POOL_NAME:VOLUME_ID* from domain *VMNAME*
2014-11-21 12:30:23 +01:00
2016-04-30 17:28:13 +02:00
aliases: d, dt
2013-03-12 16:55:05 +01:00
extend
^^^^^^
2016-09-02 19:55:54 +02:00
| :command:`qvm-block extend` [-h] [--verbose] [--quiet] *POOL_NAME:VOLUME_ID* *NEW_SIZE*
2016-09-02 19:55:54 +02:00
Extend the volume with *POOL_NAME:VOLUME_ID* TO *NEW_SIZE*
2016-07-12 18:23:28 +02:00
revert
^^^^^^
| :command:`qvm-block revert` [-h] [--verbose] [--quiet] *POOL_NAME:VOLUME_ID*
Revert a volume to previous revision.
aliases: rv, r
2014-11-21 12:30:23 +01:00
Authors
2016-05-09 05:12:37 +02:00
-------
2013-03-12 16:55:05 +01:00
| Joanna Rutkowska <joanna at invisiblethingslab dot com>
| Rafal Wojtczuk <rafal at invisiblethingslab dot com>
| Marek Marczykowski <marmarek at invisiblethingslab dot com>
2016-04-30 17:28:13 +02:00
| Bahtiar `kalkin-` Gadimov <bahtiar at gadimov dot de>
2016-05-09 05:12:37 +02:00
.. vim: ts=3 sw=3 et tw=80