qvm-create.rst 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. .. program:: qvm-create
  2. :program:`qvm-create` -- create new domain
  3. ==========================================
  4. Synopsis
  5. --------
  6. :command:`qvm-create` [-h] [--xml *XMLFILE*] [--force-root] [--class *CLS*] [--property *NAME*=*VALUE*] [--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:: --xml=XMLFILE
  12. Qubes OS store file
  13. .. option:: --force-root
  14. Force to run as root.
  15. .. option:: --class, -C
  16. The new domain class name (default: **AppVM** for
  17. :py:class:`qubes.vm.appvm.AppVM`).
  18. .. option:: --prop=NAME=VALUE, --property=NAME=VALUE, -p NAME=VALUE
  19. Set domain's property, like "internal", "memory" or "vcpus". Any property may
  20. be set this way, even "qid".
  21. .. option:: --template=VALUE, -t VALUE
  22. Specify the TemplateVM to use, when applicable. This is an alias for
  23. ``--property template=VALUE``.
  24. .. option:: --label=VALUE, -l VALUE
  25. Specify the label to use for the new domain (e.g. red, yellow, green, ...).
  26. This in an alias for ``--property label=VALUE``.
  27. .. option:: --root-copy-from=FILENAME, -r FILENAME
  28. Use provided :file:`root.img` instead of default/empty one (file will be
  29. *copied*). This option is mutually exclusive with :option:`--root-move-from`.
  30. .. option:: --root-move-from=FILENAME, -R FILENAME
  31. Use provided :file:`root.img` instead of default/empty one (file will be
  32. *moved*). This option is mutually exclusive with :option:`--root-copy-from`.
  33. Options for internal use
  34. ------------------------
  35. Do not use if you don't know, what you are doing.
  36. .. option:: --no-root
  37. Do not create :file:`root.img`. This option is mutually exclusive with
  38. :option:`--root-copy-from` and :option:`--root-move-from`.
  39. Authors
  40. -------
  41. | Joanna Rutkowska <joanna at invisiblethingslab dot com>
  42. | Rafal Wojtczuk <rafal at invisiblethingslab dot com>
  43. | Marek Marczykowski <marmarek at invisiblethingslab dot com>
  44. | Wojtek Porczyk <woju at invisiblethingslab dot com>
  45. .. vim: ts=3 sw=3 et tw=80