qvm-start.rst 2.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384
  1. .. program:: qvm-start
  2. :program:`qvm-start` -- start a domain
  3. ======================================
  4. .. warning::
  5. This page was autogenerated from command-line parser. It shouldn't be 1:1
  6. conversion, because it would add little value. Please revise it and add
  7. more descriptive help, which normally won't fit in standard ``--help``
  8. option.
  9. After rewrite, please remove this admonition.
  10. Synopsis
  11. --------
  12. :command:`qvm-start` [-h] [options] *VMNAME*
  13. Options
  14. -------
  15. .. option:: --help, -h
  16. Show help message and exit.
  17. .. option:: --verbose, -v
  18. Increase verbosity.
  19. .. option:: --quiet, -q
  20. Decrease verbosity.
  21. .. option:: --skip-if-running
  22. Do not fail if the qube is already runnning
  23. .. option:: --all
  24. perform the action on all qubes
  25. .. option:: --exclude
  26. exclude the qube from --all
  27. .. option:: --drive=DRIVE
  28. Temporarily attach specified drive as CD/DVD or hard disk (can be specified with prefix "hd:" or "cdrom:", default is cdrom).
  29. The syntax for the device itself is "qube_name:device_name", meaning *device_name* served by *qube_name*.
  30. See `qvm-block` output for a list of available devices.
  31. Additionally, "qube_name:path" syntax can be used. This
  32. will setup loop device inside *qube_name*, pointing at *path*, and will use
  33. it as device. You need to clean up that loop device yourself, but it will
  34. also cleanup itself at next qube restart. This syntax is available only when
  35. calling this tool from dom0.
  36. .. option:: --hddisk=DRIVE
  37. Temporarily attach specified drive as hard disk. This is equivalent with
  38. `--drive=hd:DRIVE`.
  39. .. option:: --cdrom=DRIVE
  40. Temporarily attach specified drive as CD/DVD. This is equivalent with
  41. `--drive=cdrom:DRIVE`.
  42. .. option:: --install-windows-tools
  43. Temporarily attach Windows tools CDROM to the domain. This is equivalent with
  44. `--cdrom=dom0:/usr/lib/qubes/qubes-windows-tools.iso`.
  45. Authors
  46. -------
  47. | Joanna Rutkowska <joanna at invisiblethingslab dot com>
  48. | Rafal Wojtczuk <rafal at invisiblethingslab dot com>
  49. | Marek Marczykowski <marmarek at invisiblethingslab dot com>
  50. | Wojtek Porczyk <woju at invisiblethingslab dot com>
  51. .. vim: ts=3 sw=3 et tw=80