qvm-ls.rst 2.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. .. program:: qvm-ls
  2. :program:`qvm-ls` -- List VMs and various information about them
  3. ================================================================
  4. Synopsis
  5. --------
  6. :command:`qvm-ls` [-h] [--verbose] [--quiet] [--help-columns] [--help-formats] [--format *FORMAT* | --fields *FIELD*,...] [--tags *TAG* [*TAG* ...]]
  7. Options
  8. -------
  9. .. option:: --help, -h
  10. Show help message and exit
  11. .. option:: --help-columns
  12. List all available columns with short descriptions and exit.
  13. .. option:: --help-formats
  14. List all available formats with their definitions and exit.
  15. .. option:: --all
  16. List all qubes, this is default.
  17. .. option:: --exclude
  18. Exclude the qube from --all. You need to use --all option explicitly to use
  19. --exclude.
  20. .. option:: --format=FORMAT, -o FORMAT
  21. Sets format to a list of columns defined by preset. All formats along with
  22. columns which they show can be listed with :option:`--help-formats`.
  23. .. option:: --fields=FIELD,..., -O FIELD,...
  24. Sets format to specified set of columns. This gives more control over
  25. :option:`--format`. All columns along with short descriptions can be listed
  26. with :option:`--help-columns`.
  27. .. option:: --tags TAG ...
  28. Shows only VMs having specific tag(s).
  29. .. option:: --raw-data
  30. Output data in easy to parse format. Table header is skipped and columns are
  31. separated by `|` character.
  32. .. option:: --raw-list
  33. Give plain list of VM names, without header or separator. Useful in scripts.
  34. Same as --raw-data --fields=name
  35. .. option:: --disk, -d
  36. Same as --format=disk, for compatibility with Qubes 3.x
  37. .. option:: --network, -n
  38. Same as --format=network, for compatibility with Qubes 3.x
  39. .. option:: --kernel, -k
  40. Same as --format=kernel, for compatibility with Qubes 3.x
  41. .. option:: --verbose, -v
  42. Increase verbosity.
  43. .. option:: --quiet, -q
  44. Decrease verbosity.
  45. .. option:: --spinner
  46. Have a spinner spinning while the spinning mainloop spins new table cells.
  47. .. option:: --no-spinner
  48. No spinner today.
  49. Authors
  50. -------
  51. | Joanna Rutkowska <joanna at invisiblethingslab dot com>
  52. | Rafal Wojtczuk <rafal at invisiblethingslab dot com>
  53. | Marek Marczykowski <marmarek at invisiblethingslab dot com>
  54. | Wojtek Porczyk <woju at invisiblethingslab dot com>
  55. .. vim: ts=3 sw=3 et