summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorCole Robinson <crobinso@redhat.com>2022-02-24 19:08:18 -0500
committerCole Robinson <crobinso@redhat.com>2022-02-26 14:11:56 -0500
commitb275e3c266b260e7becce2957159dd0d556d2f3b (patch)
treee112201a1a081c46e6d0cb0e2c71d11b286b1e36 /man
parent310136337c32073621b51b82392956abf7ab9fa2 (diff)
downloadvirt-manager-b275e3c266b260e7becce2957159dd0d556d2f3b.tar.gz
cli: Add --boot refresh-machine-type=yes
This is a virt-xml option to refresh a VM to use the latest machine type version for the machine type it's currently using. Ex: pseries-2.11 -> pseries pc-q35-5.0 -> q35 This is useful for when qemu deprecates and removes the machine type out from under you, or to pick up bug fixes. Signed-off-by: Cole Robinson <crobinso@redhat.com>
Diffstat (limited to 'man')
-rw-r--r--man/virt-xml.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/man/virt-xml.rst b/man/virt-xml.rst
index cf5db45c..ddd586bb 100644
--- a/man/virt-xml.rst
+++ b/man/virt-xml.rst
@@ -257,6 +257,17 @@ For any option, use --option=? to see a list of all available sub options, examp
--help output also lists a few general examples. See the EXAMPLES section below for some common examples.
+virt-xml specifically has some operations that don't really apply to virt-install
+Examples:
+
+``--boot refresh-machine-type=yes``
+ Refresh the XML ``<os><type machine=X></os>`` value to the latest one
+ that qemu provides. For example, if your VM has a machine type value
+ ``pc-q35-4.0``, this will reset the value to ``q35``, and works
+ similarly with other versioned machine types. Occasionally this is
+ necessary to get enable qemu bug fixes, or when qemu deprecates and
+ removes old machine type values.
+
MISCELLANEOUS OPTIONS
=====================