Features/CPUModels
Summary
This page was about the feature of "externally-configurable" CPU models, but its scope was gradually changed to discussion about the design of the CPU code, the CPU model system. The old "cpudef" config section was deprecated, so the original description doesn't apply anymore.
Owner
- Name: Eduardo Habkost
- Email: ehabkost@redhat.com
Detailed Summary
The old "cpudef" config section was deprecated because there are expectations that QEMU is going to provide the CPU model list, and will keep migration compatibility using machine-types, and keeping machine-type compatibility (something that is inside the QEMU C code) while keeping the CPU model definitions external would be a dependency/layering violation. Now both CPU model definitions and per-machine-type CPU-model compatibility code are inside the QEMU C code.
The pseudo CPUID flag 'check' when appearing in the command line feature flag list will warn when feature flags (either implicit in a cpu model or explicit on the command line) would have otherwise been quietly unavailable to a guest:
# qemu-system-x86_64 ... -cpu Nehalem,check warning: host cpuid 0000_0001 lacks requested flag 'sse4.2|sse4_2' [0x00100000] warning: host cpuid 0000_0001 lacks requested flag 'popcnt' [0x00800000]
A similar 'enforce' pseudo flag exists which in addition to the above causes qemu to error exit if requested flags are unavailable.
Current Issues and proposed changes
Allowing CPU models to be updated
We need a mechanism to allow the existing CPU models on Qemu to be updated, without making guest-visible changes for existing Virtual Machines, when migrating to a new version.
Examples
Examples where CPU model updates are necessary and have to be deployed to users:
- The Nehalem CPU model currently has the wrong "level" value, making CPU topology information unavailable.
- The CPUID PMU leaf was added on Qemu 1.1, but it is not supposed to be visible to guests running using -M pc-1.0
- New features are implemented by KVM and we may want to add them to existing models (e.g. SandyBridge may need to have tsc-deadline added)
Requirements
- A different CPU will be visible to the guest depending on the machine-type chosen.
- That means that "-M pc-1.0 -cpu Nehalem" will be different from "-M pc-1.1 -cpu Nehalem"
- Rationale:
- The meaning of "-M pc-1.0 -cpu Nehalem" can't be changed or it will change existing guests
- The meaning of "-M pc-1.1 -cpu Nehalem" needs to be different from the pc-1.0 one, otherwise we would be stuck with a broken "Nehalem" model forever
Current design proposal
- (patches posted) Default CPU models will be shipped on /usr/share instead of /etc, so they can be updated on upgrades
- Those files won't be loaded if
-nodefconfig
is used - But they will be loaded if
-no-user-config
is used (to be implemented) - libvirt will have to use
-no-user-config
instead of-nodefconfig
- Those files won't be loaded if
- Default CPU models will be versioned (e.g. Nehalem-1.0, Nehalem-1.1)
- per-machine-type aliases will be set, so "Nehalem" will be an alias for Nehalem-1.0 on pc-1.0, and an alias for Nehalem-1.1 on pc-1.1
- Mailing list references:
- http://marc.info/?l=qemu-devel&m=133165046801195 (obsolete proposal, see other messages below)
- http://marc.info/?l=qemu-devel&m=133278877315665
- http://marc.info/?l=qemu-devel&m=133292888602469
- Mailing list references:
Probing of CPU model details
libvirt don't write CPU definitions from scratch, so it will reuse the CPU models from /usr/share. But it needs to probe for details of the CPU models.
Requirements
A detailed probing system, similar to "-cpu ?dump", but in a more extensible and machine-friendly format.
Current design proposal
- -query-capabilities RFC series from Anthony
- Message-Id: <1332169763-30665-9-git-send-email-aliguori@us.ibm.com>
- To be defined: Command to list CPU models, and the features they include/exclude
- To be defined: Command to list the resulting CPUID bits of CPU models
- Do we need a version that works before the VM is created? Some bits depend on other Virtual Machine parameters (e.g. SMP configuration), so it won't list every single bit
- Do we need a version that works after the VM is created, so it lists every single bit? (maybe just the "query-cpus" QMP command is already enough for that)
- To be defined: Command to list CPU model aliases (per-machine-type)
- To be defined: command to query which CPU flags are really available and can be enabled (based on host hardware + kernel + qemu capabilities)
-cpu host
and feature probing
See http://article.gmane.org/gmane.comp.emulators.kvm.devel/90035
-cpu host
vs -cpu best
Currently we have -cpu host
, but the naming and semantics are unclear.
We have 3 possible modes of "try to get the best CPU model":
- all-you-can-enable: Enable every single bit that can be enabled, including the ones not present on the host but that can be emulated.
- match-host-CPU: Enable all bits that are present in the host CPU that can be enabled.
- best-predefined-model: Use the best CPU model available from the pre-defined CPU model list.
Proposal
It's unclear if -cpu host
should correspond to the first or second option. The current semantics seems to be all-you-can-enable.
The best-predefined-model will be implemented using -cpu best
.
It's unclear if we're going to have an option for match-host-CPU.
Improve cpudef format and semantics
Currently there are too many low-level bits on the cpudef sections. For example:
- Instead of just being a "enable this feature" interface, it requires the user to know which CPUID leaf/register exposes the feature (features_edx, features_ecx, etc)
- There's no mechanism to enable/disable specific CPUID leafs (e.g. the PMU leaf is not configurable)
- The "level" field is too low-level. We need either:
- An "auto" mode that simply sets "level" depending on the set of required CPUID leafs; and/or
- A validation mode, where "level" can't be set too low, in case a required/requested CPUID leaf needs it
Related to the "Asymmetry between [cpudef] sections and -cpu options" issue above.
Asymmetry between [cpudef] sections and -cpu options
Currently there are two ways to change the CPU configuration: cpudef sections on config file and -cpu options. They use different syntaxes and have different representation powers. We should just use the same system for both, probably with a inheritance system to allow a "[cpu]" section to simply inherit settings from a "[cpudef]" but extend it in some way (adding and removing features, overriding specific fields, etc.).
Related to the "Improve cpudef format and semantics" feature above.