core-admin/doc/manpages/qvm-create.rst
Bahtiar `kalkin-` Gadimov 496434d865
qvm-create uses new api
- `-p` is now used for `--pool` instead of `--property`
- Documented pool usage
2016-07-13 22:34:37 +02:00

90 lines
2.4 KiB
ReStructuredText

.. program:: qvm-create
:program:`qvm-create` -- create new domain
==========================================
Synopsis
--------
:command:`qvm-create` [-h] [--verbose] [--quiet] [--force-root] [--class *CLS*] [--property *NAME*=*VALUE*] [--pool *POOL_NAME:VOLUME_NAME*] [--template *VALUE*] --label *VALUE* [--root-copy-from *FILENAME* | --root-move-from *FILENAME*] *VMNAME*
Options
-------
.. option:: --help, -h
show help message and exit
.. option:: --verbose, -v
Increase verbosity.
.. option:: --quiet, -q
Decrease verbosity.
.. option:: --force-root
Force to run as root.
.. option:: --class, -C
The new domain class name (default: **AppVM** for
:py:class:`qubes.vm.appvm.AppVM`).
.. option:: --prop=NAME=VALUE, --property=NAME=VALUE
Set domain's property, like "internal", "memory" or "vcpus". Any property may
be set this way, even "qid".
.. option:: --template=VALUE, -t VALUE
Specify the TemplateVM to use, when applicable. This is an alias for
``--property template=VALUE``.
.. option:: --label=VALUE, -l VALUE
Specify the label to use for the new domain (e.g. red, yellow, green, ...).
This in an alias for ``--property label=VALUE``.
.. option:: --root-copy-from=FILENAME, -r FILENAME
Use provided :file:`root.img` instead of default/empty one (file will be
*copied*). This option is mutually exclusive with :option:`--root-move-from`.
.. option:: --root-move-from=FILENAME, -R FILENAME
Use provided :file:`root.img` instead of default/empty one (file will be
*moved*). This option is mutually exclusive with :option:`--root-copy-from`.
.. option:: -P POOL
Pool to use for the new domain. All volumes besides snapshots volumes are
imported in to the specified POOL. ~HIS IS WHAT YOU WANT TO USE NORMALLY.
.. option:: --pool=POOL:VOLUME, -p POOL:VOLUME
Specify the pool to use for the specific volume
Options for internal use
------------------------
Do not use if you don't know, what you are doing.
.. option:: --no-root
Do not create :file:`root.img`. This option is mutually exclusive with
:option:`--root-copy-from` and :option:`--root-move-from`.
Authors
-------
| Joanna Rutkowska <joanna at invisiblethingslab dot com>
| Rafal Wojtczuk <rafal at invisiblethingslab dot com>
| Marek Marczykowski <marmarek at invisiblethingslab dot com>
| Wojtek Porczyk <woju at invisiblethingslab dot com>
| Bahtiar `kalkin-` Gadimov <bahtiar at gadimov dot de>
.. vim: ts=3 sw=3 et tw=80