docs: Update documentation of CPU models in domain caps

Using check='none' when starting a domain with a CPU model marked as
usable is no longer needed as libvirt will do the right thing even with
check='partial'.

Signed-off-by: Jiri Denemark <jdenemar@redhat.com>
Reviewed-by: Andrea Bolognani <abologna@redhat.com>
This commit is contained in:
Jiri Denemark 2024-03-05 16:16:05 +01:00
parent 8132478fa0
commit 75ace65104

View File

@ -237,10 +237,12 @@ more details about it:
using the CPU model and no additional feature elements. Models marked as using the CPU model and no additional feature elements. Models marked as
usable (``usable='yes'``) can be safely used in domain XMLs with usable (``usable='yes'``) can be safely used in domain XMLs with
``check='none'`` as the hypervisor guarantees the model can be used on the ``check='none'`` as the hypervisor guarantees the model can be used on the
current host and additional checks done by libvirt are redundant. In fact, current host and additional checks done by libvirt are redundant.
disabling libvirt checks via ``check='none'`` for such models is recommended :since:`Since 10.2.0` libvirt automatically detects this situation and
to avoid needless issues with starting domains when libvirt's definition of avoids the redundant checks even when ``check='partial'`` is used, with
a particular model differs from hypervisor's definition. The older releases disabling libvirt checks via ``check='none'`` for such models
is recommended to avoid needless issues with starting domains when libvirt's
definition of a particular model differs from hypervisor's definition. The
``deprecated`` attribute reflects the hypervisor's policy on usage of this ``deprecated`` attribute reflects the hypervisor's policy on usage of this
model :since:`(since 7.1.0)`. The ``vendor`` attribute :since:`(since 8.9.0)` model :since:`(since 7.1.0)`. The ``vendor`` attribute :since:`(since 8.9.0)`
contains the vendor of the CPU model for users who want to use CPU models contains the vendor of the CPU model for users who want to use CPU models