how-to-update.rst : Add examples

1. Add CLI tools usage examples and references to documentation
2. Minor styling in Command-line interface section: make writing a bit more concise, use numbered nested list
This commit is contained in:
Randy 2025-10-26 16:00:14 +00:00 committed by GitHub
parent 7b5dd3633a
commit ca2b5312d8
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -87,14 +87,29 @@ Command-line interface
Advanced users may wish to perform updates via the command-line interface. There are two ways to do this: Advanced users may wish to perform updates via the command-line interface. There are two ways to do this:
- If you are using Salt, one can use the following two Salt states. 1. Use the following two Salt states:
- :ref:`update.qubes-dom0 <user/advanced-topics/salt:\`\`update.qubes-dom0\`\`>` - :ref:`update.qubes-dom0 <user/advanced-topics/salt:\`\`update.qubes-dom0\`\`>`
- :ref:`update.qubes-vm <user/advanced-topics/salt:\`\`update.qubes-vm\`\`>` - :ref:`update.qubes-vm <user/advanced-topics/salt:\`\`update.qubes-vm\`\`>`
- Alternatively, use ``qubes-dom0-update`` to update dom0, and use ``qubes-vm-update`` to update domUs. 2. Use ``qubes-dom0-update`` to update dom0, and use ``qubes-vm-update`` to update domUs:
- Execute ``sudo qubes-dom0-update`` to check for updates and apply them or add arguments to tweak the behavior. Refer to:
- ``qubes-dom0-update --help``
- ``man qubes-dom0-update`` (if you have documentation installed)
- `manual on github <https://github.com/QubesOS/qubes-core-admin-linux/blob/main/doc/tools/qubes-dom0-update.rst>`__ (make sure to read the appropriate version)
- Execute ``qubes-vm-update -T`` to update all templates with available updates or use a different set of arguments. Refer to:
- ``qubes-vm-update --help``
- ``man qubes-vm-update`` (if you have documentation installed)
- `manual on github <https://github.com/QubesOS/qubes-core-admin-linux/blob/main/doc/tools/qubes-vm-update.rst>`__ (make sure to read the appropriate version)
Using either of these methods has the same effect as updating via the Qubes Update tool. Using either of these methods has the same effect as updating via the Qubes Update tool.