External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2025-01-22 04:25:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document specifics of virConnectBaselineHypervisorCPU

Browse Source 
The API can be used to get usability blockers for an unusable CPU model,
which is not obvious. Let's explicitly document this behavior as it is
now mentioned in the documentation of domain capabilities XML.

Signed-off-by: Jiri Denemark <jdenemar@redhat.com>
Reviewed-by: Ján Tomko <jtomko@redhat.com>
This commit is contained in:
Jiri Denemark 2022-10-07 18:36:50 +02:00
parent d4975a98b6
commit b9db1ec17d
1 changed files with 9 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
src/libvirt-host.c
View File

@ -1319,6 +1319,15 @@ virConnectBaselineCPU(virConnectPtr conn,
* This is different from virConnectBaselineCPU() which doesn't consider any
* hypervisor abilities when computing the best CPU.
*
* If @ncpus == 1, the result will be the first (and only) CPU in @xmlCPUs
* tailored to what the hypervisor can support on the current host.
* Specifically if this single CPU definition contains no feature elements and
* a CPU model listed as usable='no' in domain capabilities XML, the result
* will contain a list usability blockers, i.e., a list of features that would
* need to be disabled to for the model to be usable on this host. This list
* may contain more features than what the hypervisor reports as blockers in
* case the CPU model definition in libvirt differs from QEMU definition.
*
* If @flags includes VIR_CONNECT_BASELINE_CPU_EXPAND_FEATURES then libvirt
* will explicitly list all CPU features that are part of the computed CPU,
* without this flag features that are part of the CPU model will not be