[pve-docs.git] / cpu-models.conf.5-opts.adoc

`flags`: `<+FLAG[;-FLAG...]>` ::

List of additional CPU flags separated by ';'. Use '+FLAG' to enable, '-FLAG' to disable a flag. Custom CPU models can specify any flag supported by QEMU/KVM, VM-specific flags must be from the following set for security reasons: pcid, spec-ctrl, ibpb, ssbd, virt-ssbd, amd-ssbd, amd-no-ssb, pdpe1gb, md-clear, hv-tlbflush, hv-evmcs, aes

`hidden`: `<boolean>` ('default =' `0`)::

Do not identify as a KVM virtual machine.

`hv-vendor-id`: `<vendor-id>` ::

The Hyper-V vendor ID. Some drivers or programs inside Windows guests need a specific ID.

`phys-bits`: `<8-64|host>` ::

The physical memory address bits that are reported to the guest OS. Should be smaller or equal to the host's. Set to 'host' to use value from host CPU, but note that doing so will break live migration to CPUs with other values.

`reported-model`: `<486 | Broadwell | Broadwell-IBRS | Broadwell-noTSX | Broadwell-noTSX-IBRS | Cascadelake-Server | Cascadelake-Server-noTSX | Cascadelake-Server-v2 | Cascadelake-Server-v4 | Cascadelake-Server-v5 | Conroe | Cooperlake | Cooperlake-v2 | EPYC | EPYC-IBPB | EPYC-Milan | EPYC-Rome | EPYC-Rome-v2 | EPYC-v3 | Haswell | Haswell-IBRS | Haswell-noTSX | Haswell-noTSX-IBRS | Icelake-Client | Icelake-Client-noTSX | Icelake-Server | Icelake-Server-noTSX | Icelake-Server-v3 | Icelake-Server-v4 | Icelake-Server-v5 | Icelake-Server-v6 | IvyBridge | IvyBridge-IBRS | KnightsMill | Nehalem | Nehalem-IBRS | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | SandyBridge-IBRS | SapphireRapids | Skylake-Client | Skylake-Client-IBRS | Skylake-Client-noTSX-IBRS | Skylake-Client-v4 | Skylake-Server | Skylake-Server-IBRS | Skylake-Server-noTSX-IBRS | Skylake-Server-v4 | Skylake-Server-v5 | Westmere | Westmere-IBRS | athlon | core2duo | coreduo | host | kvm32 | kvm64 | max | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`)::

CPU model and vendor to report to the guest. Must be a QEMU/KVM supported model. Only valid for custom CPU model definitions, default models will always report themselves to the guest OS.
Commit	Line	Data
acaaf090 TL	1	`flags`: `<+FLAG[;-FLAG...]>` ::
	2
	3	List of additional CPU flags separated by ';'. Use '+FLAG' to enable, '-FLAG' to disable a flag. Custom CPU models can specify any flag supported by QEMU/KVM, VM-specific flags must be from the following set for security reasons: pcid, spec-ctrl, ibpb, ssbd, virt-ssbd, amd-ssbd, amd-no-ssb, pdpe1gb, md-clear, hv-tlbflush, hv-evmcs, aes
	4
	5	`hidden`: `<boolean>` ('default =' `0`)::
	6
	7	Do not identify as a KVM virtual machine.
	8
	9	`hv-vendor-id`: `<vendor-id>` ::
	10
	11	The Hyper-V vendor ID. Some drivers or programs inside Windows guests need a specific ID.
	12
	13	`phys-bits`: `<8-64\|host>` ::
	14
	15	The physical memory address bits that are reported to the guest OS. Should be smaller or equal to the host's. Set to 'host' to use value from host CPU, but note that doing so will break live migration to CPUs with other values.
	16
d7f84e1c	17	`reported-model`: `<486 \| Broadwell \| Broadwell-IBRS \| Broadwell-noTSX \| Broadwell-noTSX-IBRS \| Cascadelake-Server \| Cascadelake-Server-noTSX \| Cascadelake-Server-v2 \| Cascadelake-Server-v4 \| Cascadelake-Server-v5 \| Conroe \| Cooperlake \| Cooperlake-v2 \| EPYC \| EPYC-IBPB \| EPYC-Milan \| EPYC-Rome \| EPYC-Rome-v2 \| EPYC-v3 \| Haswell \| Haswell-IBRS \| Haswell-noTSX \| Haswell-noTSX-IBRS \| Icelake-Client \| Icelake-Client-noTSX \| Icelake-Server \| Icelake-Server-noTSX \| Icelake-Server-v3 \| Icelake-Server-v4 \| Icelake-Server-v5 \| Icelake-Server-v6 \| IvyBridge \| IvyBridge-IBRS \| KnightsMill \| Nehalem \| Nehalem-IBRS \| Opteron_G1 \| Opteron_G2 \| Opteron_G3 \| Opteron_G4 \| Opteron_G5 \| Penryn \| SandyBridge \| SandyBridge-IBRS \| SapphireRapids \| Skylake-Client \| Skylake-Client-IBRS \| Skylake-Client-noTSX-IBRS \| Skylake-Client-v4 \| Skylake-Server \| Skylake-Server-IBRS \| Skylake-Server-noTSX-IBRS \| Skylake-Server-v4 \| Skylake-Server-v5 \| Westmere \| Westmere-IBRS \| athlon \| core2duo \| coreduo \| host \| kvm32 \| kvm64 \| max \| pentium \| pentium2 \| pentium3 \| phenom \| qemu32 \| qemu64>` ('default =' `kvm64`)::
acaaf090 TL	18
	19	CPU model and vendor to report to the guest. Must be a QEMU/KVM supported model. Only valid for custom CPU model definitions, default models will always report themselves to the guest OS.
	20