qvm-run.rst 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980
  1. .. program:: qvm-run
  2. =====================================================
  3. :program:`qvm-run` -- Run a command on a specified VM
  4. =====================================================
  5. Synopsis
  6. ========
  7. :command:`qvm-run` [*options*] [<*vm-name*>] [<*cmd*>]
  8. Options
  9. =======
  10. .. option:: --help, -h
  11. Show this help message and exit
  12. .. option:: --quiet, -q
  13. Be quiet
  14. .. option:: --auto, -a
  15. Auto start the VM if not running
  16. .. option:: --user=USER, -u USER
  17. Run command in a VM as a specified user
  18. .. option:: --tray
  19. Use tray notifications instead of stdout
  20. .. option:: --all
  21. Run command on all currently running VMs (or all paused, in case of :option:`--unpause`)
  22. .. option:: --exclude=EXCLUDE_LIST
  23. When :option:`--all` is used: exclude this VM name (might be repeated)
  24. .. option:: --wait
  25. Wait for the VM(s) to shutdown
  26. .. option:: --shutdown
  27. Do 'xl shutdown' for the VM(s) (can be combined with :option:`--all` and
  28. :option:`--wait`)
  29. .. deprecated:: R2
  30. Use :manpage:`qvm-shutdown(1)` instead.
  31. .. option:: --pause
  32. Do 'xl pause' for the VM(s) (can be combined with :option:`--all` and
  33. :option:`--wait`)
  34. .. option:: --unpause
  35. Do 'xl unpause' for the VM(s) (can be combined with :option:`--all` and
  36. :option:`--wait`)
  37. .. option:: --pass-io, -p
  38. Pass stdin/stdout/stderr from remote program
  39. .. option:: --localcmd=LOCALCMD
  40. With :option:`--pass-io`, pass stdin/stdout/stderr to the given program
  41. .. option:: --force
  42. Force operation, even if may damage other VMs (eg. shutdown of NetVM)
  43. Authors
  44. =======
  45. | Joanna Rutkowska <joanna at invisiblethingslab dot com>
  46. | Rafal Wojtczuk <rafal at invisiblethingslab dot com>
  47. | Marek Marczykowski <marmarek at invisiblethingslab dot com>