2014-11-21 12:30:23 +01:00
|
|
|
.. program:: qvm-create
|
2013-03-12 16:55:05 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
:program:`qvm-create` -- create new domain
|
|
|
|
|
==========================================
|
2013-03-12 16:55:05 +01:00
|
|
|
|
2014-11-21 12:30:23 +01:00
|
|
|
Synopsis
|
2015-06-26 11:08:26 +02:00
|
|
|
--------
|
|
|
|
|
|
2015-10-05 23:57:03 +02:00
|
|
|
:command:`qvm-create` [-h] [--qubesxml *XMLFILE*] [--force-root] [--class *CLS*] [--property *NAME*=*VALUE*] [--template *VALUE*] [--label *VALUE*] [--root-copy-from *FILENAME* | --root-move-from *FILENAME*] *VMNAME*
|
2013-03-12 16:55:05 +01:00
|
|
|
|
2014-11-21 12:30:23 +01:00
|
|
|
Options
|
2015-06-26 11:08:26 +02:00
|
|
|
-------
|
2014-11-21 12:30:23 +01:00
|
|
|
|
|
|
|
|
.. option:: --help, -h
|
|
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
show help message and exit
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-10-05 23:57:03 +02:00
|
|
|
.. option:: --qubesxml=XMLFILE
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
Qubes OS store file
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
.. option:: --force-root
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
Force to run as root.
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
.. option:: --class, -C
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-07-03 14:31:48 +02:00
|
|
|
The new domain class name (default: **AppVM** for
|
|
|
|
|
:py:class:`qubes.vm.appvm.AppVM`).
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
.. option:: --prop=NAME=VALUE, --property=NAME=VALUE, -p NAME=VALUE
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
Set domain's property, like "internal", "memory" or "vcpus". Any property may
|
|
|
|
|
be set this way, even "qid".
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
.. option:: --template=VALUE, -t VALUE
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
Specify the TemplateVM to use, when applicable. This is an alias for
|
|
|
|
|
``--property template=VALUE``.
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
.. option:: --label=VALUE, -l VALUE
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
Specify the label to use for the new domain (e.g. red, yellow, green, ...).
|
|
|
|
|
This in an alias for ``--property label=VALUE``.
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
.. option:: --root-copy-from=FILENAME, -r FILENAME
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-07-03 14:31:48 +02:00
|
|
|
Use provided :file:`root.img` instead of default/empty one (file will be
|
|
|
|
|
*copied*). This option is mutually exclusive with :option:`--root-move-from`.
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-06-26 11:08:26 +02:00
|
|
|
.. option:: --root-move-from=FILENAME, -R FILENAME
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-07-03 14:31:48 +02:00
|
|
|
Use provided :file:`root.img` instead of default/empty one (file will be
|
|
|
|
|
*moved*). This option is mutually exclusive with :option:`--root-copy-from`.
|
|
|
|
|
|
|
|
|
|
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`.
|
2014-11-21 12:30:23 +01:00
|
|
|
|
2015-01-26 17:17:48 +01:00
|
|
|
|
2014-11-21 12:30:23 +01:00
|
|
|
Authors
|
2015-06-26 11:08:26 +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>
|
2015-06-26 11:08:26 +02:00
|
|
|
| Wojtek Porczyk <woju at invisiblethingslab dot com>
|
|
|
|
|
|
|
|
|
|
.. vim: ts=3 sw=3 et tw=80
|
