<cpu>

Specifies the features of the virtual CPUs of a virtual server.

Text content

None.

Selected attributes

match=exact

The virtual CPU provided to the virtual server must match the specification. The virtual server can be started only if the specified CPU model is supported. This is the default.

mode= custom | host-model | host-passthrough

custom: The <cpu> element and its nested elements define the CPU to be presented to the virtual server. This mode ensures that a persistent virtual server uses the same CPU model on any KVM host. The virtual server can be started only if the KVM host supports the specified CPU model. This is the default.
host-model: The CPU definition is derived from the KVM host CPU. On a running virtual server, the model is expanded to an explicit specification in the libvirt-internal configuration.
host-passthrough: The CPU model of the KVM host is used. On a running virtual server, the model remains host-passthrough. It is not expanded to an explicit specification in the libvirt-internal configuration.

Usage

Configuring the CPU model

Parent elements

Child elements

Example

This example sets the CPU model to the default for z14:

<cpu mode="custom">
  <model>z14</model>
</cpu>