Updated qvm-pool.rst file

This commit is contained in:
Saswat Padhi 2019-11-03 05:39:09 -08:00 committed by GitHub
parent f9cf088e90
commit 40bea97c72
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,11 +1,16 @@
.. program:: qvm-pool .. program:: qvm-pool
:program:`qvm-pool` -- manage pools :program:`qvm-pool` -- Manage pools
=================================== ===================================
Synopsis Synopsis
-------- --------
:command:`qvm-pool` [-h] [--verbose] [--quiet] [--help-drivers] [-o options] [-l | -i *NAME* | -a *NAME* *DRIVER* | -r *NAME*] | :command:`qvm-pool` {add,a} [*options*] <*pool_name*> <*driver*>
| :command:`qvm-pool` {drivers,d} [*options*]
| :command:`qvm-pool` {info,i} [*options*] <*pool_name*>
| :command:`qvm-pool` {list,ls,l} [*options*]
| :command:`qvm-pool` {remove,rm,i} [*options*] <*pool_name*> ...
| :command:`qvm-pool` {set,s} [*options*] <*pool_name*>
Options Options
------- -------
@ -22,39 +27,71 @@ Options
Increase verbosity Increase verbosity
.. option:: --help-drivers Commands
--------
List all known drivers with their options. The listed driver options can be add
used with the ``-o options`` switch. ^^^
| :command:`qvm-pool add` [-h] [--verbose] [--quiet] *POOL_NAME* *DRIVER*
.. option:: -o options Add a new pool.
Comma separated list of driver options. See ``--help-drivers`` for a list of .. option:: --option, -o
driver options.
.. option:: --list, -l Set option for the driver in `name=value` format. You can specify this
option multiple times. For supported drivers and their options,
see ``drivers``.
List all pools. aliases: a
.. option:: --info NAME, -i NAME drivers
^^^^^^^
| :command:`qvm-pool drivers` [-h] [--verbose] [--quiet]
Show information about a pool List all known drivers with their options.
The listed driver options can be used with the ``-o options`` switch.
.. option:: --add NAME DRIVER, -a NAME DRIVER aliases: d
Add a pool. For supported drivers and their options see ``--help-drivers``. info
Most of the drivers expect some kind of options. ^^^^
| :command:`qvm-pool info` [-h] [--verbose] [--quiet] *POOL_NAME*
.. option:: --remove NAME, -r NAME Print info about a specified pool
Remove a pool. This removes only the information about the pool in aliases: i
qubes.xml, but does not delete any content (FIXME: is it really true for
all pool drivers?).
.. option:: --set NAME, -s NAME list
^^^^
| :command:`qvm-pool list` [-h] [--verbose] [--quiet]
Modify a pool. This set options of a pool. Use ``--o`` to specify actual modifications. List all available pools.
aliases: l, ls
remove
^^^^^^
| :command:`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
set
^^^
| :command:`qvm-pool set` [-h] [--verbose] [--quiet] *POOL_NAME*
Modify driver options for a pool.
.. option:: --option, -o
Set option for the driver in `name=value` format. You can specify this
option multiple times. For supported drivers and their options,
see ``drivers``.
aliases: s
Examples Examples
-------- --------
@ -63,8 +100,9 @@ Create a pool backed by the `file` driver.
:: ::
qvm-pool -o dir_path=/mnt/foo -a foo file qvm-pool add foo file -o dir_path=/mnt/foo
Authors Authors
------- -------
| Bahtiar \`kalkin-\` Gadimov <bahtiar at gadimov dot de> | Bahtiar \`kalkin-\` Gadimov <bahtiar at gadimov dot de>
| Saswat Padhi <padhi at cs dot ucla dot edu>