qvm-ls.rst 2.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  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*,...]
  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:: --raw-data
  28. Output data in easy to parse format. Table header is skipped and columns are
  29. separated by `|` character.
  30. .. option:: --raw-list
  31. Give plain list of VM names, without header or separator. Useful in scripts.
  32. Same as --raw-data --fields=name
  33. .. option:: --disk, -d
  34. Same as --format=disk, for compatibility with Qubes 3.x
  35. .. option:: --network, -n
  36. Same as --format=network, for compatibility with Qubes 3.x
  37. .. option:: --verbose, -v
  38. Increase verbosity.
  39. .. option:: --quiet, -q
  40. Decrease verbosity.
  41. .. option:: --spinner
  42. Have a spinner spinning while the spinning mainloop spins new table cells.
  43. .. option:: --no-spinner
  44. No spinner today.
  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