qvm-create.rst 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. .. program:: qvm-create
  2. :program:`qvm-create` -- create new domain
  3. ==========================================
  4. Synopsis
  5. --------
  6. :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*
  7. Options
  8. -------
  9. .. option:: --help, -h
  10. show help message and exit
  11. .. option:: --verbose, -v
  12. Increase verbosity.
  13. .. option:: --quiet, -q
  14. Decrease verbosity.
  15. .. option:: --force-root
  16. Force to run as root.
  17. .. option:: --class, -C
  18. The new domain class name (default: **AppVM** for
  19. :py:class:`qubes.vm.appvm.AppVM`).
  20. .. option:: --prop=NAME=VALUE, --property=NAME=VALUE
  21. Set domain's property, like "internal", "memory" or "vcpus". Any property may
  22. be set this way, even "qid".
  23. .. option:: --template=VALUE, -t VALUE
  24. Specify the TemplateVM to use, when applicable. This is an alias for
  25. ``--property template=VALUE``.
  26. .. option:: --label=VALUE, -l VALUE
  27. Specify the label to use for the new domain (e.g. red, yellow, green, ...).
  28. This in an alias for ``--property label=VALUE``.
  29. .. option:: --root-copy-from=FILENAME, -r FILENAME
  30. Use provided :file:`root.img` instead of default/empty one (file will be
  31. *copied*). This option is mutually exclusive with :option:`--root-move-from`.
  32. .. option:: --root-move-from=FILENAME, -R FILENAME
  33. Use provided :file:`root.img` instead of default/empty one (file will be
  34. *moved*). This option is mutually exclusive with :option:`--root-copy-from`.
  35. .. option:: -P POOL
  36. Pool to use for the new domain. All volumes besides snapshots volumes are
  37. imported in to the specified POOL. ~HIS IS WHAT YOU WANT TO USE NORMALLY.
  38. .. option:: --pool=POOL:VOLUME, -p POOL:VOLUME
  39. Specify the pool to use for the specific volume
  40. Options for internal use
  41. ------------------------
  42. Do not use if you don't know, what you are doing.
  43. .. option:: --no-root
  44. Do not create :file:`root.img`. This option is mutually exclusive with
  45. :option:`--root-copy-from` and :option:`--root-move-from`.
  46. Authors
  47. -------
  48. | Joanna Rutkowska <joanna at invisiblethingslab dot com>
  49. | Rafal Wojtczuk <rafal at invisiblethingslab dot com>
  50. | Marek Marczykowski <marmarek at invisiblethingslab dot com>
  51. | Wojtek Porczyk <woju at invisiblethingslab dot com>
  52. | Bahtiar `kalkin-` Gadimov <bahtiar at gadimov dot de>
  53. .. vim: ts=3 sw=3 et tw=80