]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blame - Documentation/virtual/kvm/cpuid.txt
Merge branch 'irq-urgent-for-linus' of git://git.kernel.org/pub/scm/linux/kernel...
[mirror_ubuntu-zesty-kernel.git] / Documentation / virtual / kvm / cpuid.txt
CommitLineData
09c9e813
GC
1KVM CPUID bits
2Glauber Costa <glommer@redhat.com>, Red Hat Inc, 2010
3=====================================================
4
5A guest running on a kvm host, can check some of its features using
6cpuid. This is not always guaranteed to work, since userspace can
7mask-out some, or even all KVM-related cpuid features before launching
8a guest.
9
10KVM cpuid functions are:
11
12function: KVM_CPUID_SIGNATURE (0x40000000)
57c22e5f 13returns : eax = 0x40000001,
09c9e813
GC
14 ebx = 0x4b4d564b,
15 ecx = 0x564b4d56,
16 edx = 0x4d.
17Note that this value in ebx, ecx and edx corresponds to the string "KVMKVMKVM".
57c22e5f
MT
18The value in eax corresponds to the maximum cpuid function present in this leaf,
19and will be updated if more functions are added in the future.
20Note also that old hosts set eax value to 0x0. This should
21be interpreted as if the value was 0x40000001.
09c9e813
GC
22This function queries the presence of KVM cpuid leafs.
23
24
25function: define KVM_CPUID_FEATURES (0x40000001)
26returns : ebx, ecx, edx = 0
27 eax = and OR'ed group of (1 << flag), where each flags is:
28
29
30flag || value || meaning
31=============================================================================
32KVM_FEATURE_CLOCKSOURCE || 0 || kvmclock available at msrs
33 || || 0x11 and 0x12.
34------------------------------------------------------------------------------
35KVM_FEATURE_NOP_IO_DELAY || 1 || not necessary to perform delays
36 || || on PIO operations.
37------------------------------------------------------------------------------
38KVM_FEATURE_MMU_OP || 2 || deprecated.
39------------------------------------------------------------------------------
40KVM_FEATURE_CLOCKSOURCE2 || 3 || kvmclock available at msrs
41 || || 0x4b564d00 and 0x4b564d01
42------------------------------------------------------------------------------
344d9588
GN
43KVM_FEATURE_ASYNC_PF || 4 || async pf can be enabled by
44 || || writing to msr 0x4b564d02
45------------------------------------------------------------------------------
56aba608
R
46KVM_FEATURE_STEAL_TIME || 5 || steal time can be enabled by
47 || || writing to msr 0x4b564d03.
48------------------------------------------------------------------------------
49KVM_FEATURE_PV_EOI || 6 || paravirtualized end of interrupt
50 || || handler can be enabled by writing
51 || || to msr 0x4b564d04.
52------------------------------------------------------------------------------
9bc6cbeb
R
53KVM_FEATURE_PV_UNHALT || 7 || guest checks this feature bit
54 || || before enabling paravirtualized
55 || || spinlock support.
56------------------------------------------------------------------------------
09c9e813
GC
57KVM_FEATURE_CLOCKSOURCE_STABLE_BIT || 24 || host will warn if no guest-side
58 || || per-cpu warps are expected in
59 || || kvmclock.
60------------------------------------------------------------------------------