qvm-features.rst 1.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. .. program:: qvm-features
  2. :program:`qvm-features` -- manage domain's features
  3. ===================================================
  4. Synopsis
  5. --------
  6. :command:`qvm-features` [-h] [--verbose] [--quiet] *VMNAME* [*FEATURE* [*VALUE*]]
  7. Options
  8. -------
  9. .. option:: --help, -h
  10. show this help message and exit
  11. .. option:: --verbose, -v
  12. increase verbosity
  13. .. option:: --quiet, -q
  14. decrease verbosity
  15. Description
  16. -----------
  17. This command is used to manually manage the *features* of the domain. The
  18. features are key-value pairs with both key and value being strings. They are
  19. used by extensions to store information about the domain and make policy
  20. decisions based on them. For example, they may indicate that some specific
  21. software package was installed inside the template and the domains based on it
  22. have some specific capability.
  23. .. warning::
  24. The features are normally managed by the extensions themselves and you should
  25. not change them directly. Strange things might happen otherwise.
  26. Some extensions interpret the values as boolean. In this case, the empty string
  27. means :py:obj:`False` and non-empty string (commonly ``'1'``) means
  28. :py:obj:`True`. An absence of the feature means "default", which is
  29. extension-dependent.
  30. Authors
  31. -------
  32. | Joanna Rutkowska <joanna at invisiblethingslab dot com>
  33. | Marek Marczykowski <marmarek at invisiblethingslab dot com>
  34. | Wojtek Porczyk <woju at invisiblethingslab dot com>
  35. .. vim: ts=3 sw=3 et tw=80