| 1 |
.. SPDX-License-Identifier: GPL-2.0 |
| 2 |
|
| 3 |
============== |
| 4 |
KVM CPUID bits |
| 5 |
============== |
| 6 |
|
| 7 |
:Author: Glauber Costa <[email protected]> |
| 8 |
|
| 9 |
A guest running on a kvm host, can check some of its features using |
| 10 |
cpuid. This is not always guaranteed to work, since userspace can |
| 11 |
mask-out some, or even all KVM-related cpuid features before launching |
| 12 |
a guest. |
| 13 |
|
| 14 |
KVM cpuid functions are: |
| 15 |
|
| 16 |
function: KVM_CPUID_SIGNATURE (0x40000000) |
| 17 |
|
| 18 |
returns:: |
| 19 |
|
| 20 |
eax = 0x40000001 |
| 21 |
ebx = 0x4b4d564b |
| 22 |
ecx = 0x564b4d56 |
| 23 |
edx = 0x4d |
| 24 |
|
| 25 |
Note that this value in ebx, ecx and edx corresponds to the string "KVMKVMKVM". |
| 26 |
The value in eax corresponds to the maximum cpuid function present in this leaf, |
| 27 |
and will be updated if more functions are added in the future. |
| 28 |
Note also that old hosts set eax value to 0x0. This should |
| 29 |
be interpreted as if the value was 0x40000001. |
| 30 |
This function queries the presence of KVM cpuid leafs. |
| 31 |
|
| 32 |
function: define KVM_CPUID_FEATURES (0x40000001) |
| 33 |
|
| 34 |
returns:: |
| 35 |
|
| 36 |
ebx, ecx |
| 37 |
eax = an OR'ed group of (1 << flag) |
| 38 |
|
| 39 |
where ``flag`` is defined as below: |
| 40 |
|
| 41 |
================================== =========== ================================ |
| 42 |
flag value meaning |
| 43 |
================================== =========== ================================ |
| 44 |
KVM_FEATURE_CLOCKSOURCE 0 kvmclock available at msrs |
| 45 |
0x11 and 0x12 |
| 46 |
|
| 47 |
KVM_FEATURE_NOP_IO_DELAY 1 not necessary to perform delays |
| 48 |
on PIO operations |
| 49 |
|
| 50 |
KVM_FEATURE_MMU_OP 2 deprecated |
| 51 |
|
| 52 |
KVM_FEATURE_CLOCKSOURCE2 3 kvmclock available at msrs |
| 53 |
0x4b564d00 and 0x4b564d01 |
| 54 |
|
| 55 |
KVM_FEATURE_ASYNC_PF 4 async pf can be enabled by |
| 56 |
writing to msr 0x4b564d02 |
| 57 |
|
| 58 |
KVM_FEATURE_STEAL_TIME 5 steal time can be enabled by |
| 59 |
writing to msr 0x4b564d03 |
| 60 |
|
| 61 |
KVM_FEATURE_PV_EOI 6 paravirtualized end of interrupt |
| 62 |
handler can be enabled by |
| 63 |
writing to msr 0x4b564d04 |
| 64 |
|
| 65 |
KVM_FEATURE_PV_UNHALT 7 guest checks this feature bit |
| 66 |
before enabling paravirtualized |
| 67 |
spinlock support |
| 68 |
|
| 69 |
KVM_FEATURE_PV_TLB_FLUSH 9 guest checks this feature bit |
| 70 |
before enabling paravirtualized |
| 71 |
tlb flush |
| 72 |
|
| 73 |
KVM_FEATURE_ASYNC_PF_VMEXIT 10 paravirtualized async PF VM EXIT |
| 74 |
can be enabled by setting bit 2 |
| 75 |
when writing to msr 0x4b564d02 |
| 76 |
|
| 77 |
KVM_FEATURE_PV_SEND_IPI 11 guest checks this feature bit |
| 78 |
before enabling paravirtualized |
| 79 |
send IPIs |
| 80 |
|
| 81 |
KVM_FEATURE_POLL_CONTROL 12 host-side polling on HLT can |
| 82 |
be disabled by writing |
| 83 |
to msr 0x4b564d05. |
| 84 |
|
| 85 |
KVM_FEATURE_PV_SCHED_YIELD 13 guest checks this feature bit |
| 86 |
before using paravirtualized |
| 87 |
sched yield. |
| 88 |
|
| 89 |
KVM_FEATURE_ASYNC_PF_INT 14 guest checks this feature bit |
| 90 |
before using the second async |
| 91 |
pf control msr 0x4b564d06 and |
| 92 |
async pf acknowledgment msr |
| 93 |
0x4b564d07. |
| 94 |
|
| 95 |
KVM_FEATURE_MSI_EXT_DEST_ID 15 guest checks this feature bit |
| 96 |
before using extended destination |
| 97 |
ID bits in MSI address bits 11-5. |
| 98 |
|
| 99 |
KVM_FEATURE_HC_MAP_GPA_RANGE 16 guest checks this feature bit before |
| 100 |
using the map gpa range hypercall |
| 101 |
to notify the page state change |
| 102 |
|
| 103 |
KVM_FEATURE_MIGRATION_CONTROL 17 guest checks this feature bit before |
| 104 |
using MSR_KVM_MIGRATION_CONTROL |
| 105 |
|
| 106 |
KVM_FEATURE_CLOCKSOURCE_STABLE_BIT 24 host will warn if no guest-side |
| 107 |
per-cpu warps are expected in |
| 108 |
kvmclock |
| 109 |
================================== =========== ================================ |
| 110 |
|
| 111 |
:: |
| 112 |
|
| 113 |
edx = an OR'ed group of (1 << flag) |
| 114 |
|
| 115 |
Where ``flag`` here is defined as below: |
| 116 |
|
| 117 |
================== ============ ================================= |
| 118 |
flag value meaning |
| 119 |
================== ============ ================================= |
| 120 |
KVM_HINTS_REALTIME 0 guest checks this feature bit to |
| 121 |
determine that vCPUs are never |
| 122 |
preempted for an unlimited time |
| 123 |
allowing optimizations |
| 124 |
================== ============ ================================= |