1 // SPDX-License-Identifier: GPL-2.0-only
3 * Kernel-based Virtual Machine driver for Linux
4 * cpuid support routines
6 * derived from arch/x86/kvm/x86.c
8 * Copyright 2011 Red Hat, Inc. and/or its affiliates.
9 * Copyright IBM Corporation, 2008
12 #include <linux/kvm_host.h>
13 #include <linux/export.h>
14 #include <linux/vmalloc.h>
15 #include <linux/uaccess.h>
16 #include <linux/sched/stat.h>
18 #include <asm/processor.h>
20 #include <asm/fpu/xstate.h>
22 #include <asm/cpuid.h>
30 * Unlike "struct cpuinfo_x86.x86_capability", kvm_cpu_caps doesn't need to be
31 * aligned to sizeof(unsigned long) because it's not accessed via bitops.
33 u32 kvm_cpu_caps[NR_KVM_CPU_CAPS] __read_mostly;
34 EXPORT_SYMBOL_GPL(kvm_cpu_caps);
36 u32 xstate_required_size(u64 xstate_bv, bool compacted)
39 u32 ret = XSAVE_HDR_SIZE + XSAVE_HDR_OFFSET;
41 xstate_bv &= XFEATURE_MASK_EXTEND;
43 if (xstate_bv & 0x1) {
44 u32 eax, ebx, ecx, edx, offset;
45 cpuid_count(0xD, feature_bit, &eax, &ebx, &ecx, &edx);
46 /* ECX[1]: 64B alignment in compacted form */
48 offset = (ecx & 0x2) ? ALIGN(ret, 64) : ret;
51 ret = max(ret, offset + eax);
62 * This one is tied to SSB in the user API, and not
63 * visible in /proc/cpuinfo.
65 #define KVM_X86_FEATURE_PSFD (13*32+28) /* Predictive Store Forwarding Disable */
68 #define SF(name) (boot_cpu_has(X86_FEATURE_##name) ? F(name) : 0)
71 * Magic value used by KVM when querying userspace-provided CPUID entries and
72 * doesn't care about the CPIUD index because the index of the function in
73 * question is not significant. Note, this magic value must have at least one
74 * bit set in bits[63:32] and must be consumed as a u64 by cpuid_entry2_find()
75 * to avoid false positives when processing guest CPUID input.
77 #define KVM_CPUID_INDEX_NOT_SIGNIFICANT -1ull
79 static inline struct kvm_cpuid_entry2 *cpuid_entry2_find(
80 struct kvm_cpuid_entry2 *entries, int nent, u32 function, u64 index)
82 struct kvm_cpuid_entry2 *e;
85 for (i = 0; i < nent; i++) {
88 if (e->function != function)
92 * If the index isn't significant, use the first entry with a
93 * matching function. It's userspace's responsibilty to not
94 * provide "duplicate" entries in all cases.
96 if (!(e->flags & KVM_CPUID_FLAG_SIGNIFCANT_INDEX) || e->index == index)
101 * Similarly, use the first matching entry if KVM is doing a
102 * lookup (as opposed to emulating CPUID) for a function that's
103 * architecturally defined as not having a significant index.
105 if (index == KVM_CPUID_INDEX_NOT_SIGNIFICANT) {
107 * Direct lookups from KVM should not diverge from what
108 * KVM defines internally (the architectural behavior).
110 WARN_ON_ONCE(cpuid_function_is_indexed(function));
118 static int kvm_check_cpuid(struct kvm_vcpu *vcpu,
119 struct kvm_cpuid_entry2 *entries,
122 struct kvm_cpuid_entry2 *best;
126 * The existing code assumes virtual address is 48-bit or 57-bit in the
127 * canonical address checks; exit if it is ever changed.
129 best = cpuid_entry2_find(entries, nent, 0x80000008,
130 KVM_CPUID_INDEX_NOT_SIGNIFICANT);
132 int vaddr_bits = (best->eax & 0xff00) >> 8;
134 if (vaddr_bits != 48 && vaddr_bits != 57 && vaddr_bits != 0)
139 * Exposing dynamic xfeatures to the guest requires additional
140 * enabling in the FPU, e.g. to expand the guest XSAVE state size.
142 best = cpuid_entry2_find(entries, nent, 0xd, 0);
146 xfeatures = best->eax | ((u64)best->edx << 32);
147 xfeatures &= XFEATURE_MASK_USER_DYNAMIC;
151 return fpu_enable_guest_xfd_features(&vcpu->arch.guest_fpu, xfeatures);
154 /* Check whether the supplied CPUID data is equal to what is already set for the vCPU. */
155 static int kvm_cpuid_check_equal(struct kvm_vcpu *vcpu, struct kvm_cpuid_entry2 *e2,
158 struct kvm_cpuid_entry2 *orig;
161 if (nent != vcpu->arch.cpuid_nent)
164 for (i = 0; i < nent; i++) {
165 orig = &vcpu->arch.cpuid_entries[i];
166 if (e2[i].function != orig->function ||
167 e2[i].index != orig->index ||
168 e2[i].flags != orig->flags ||
169 e2[i].eax != orig->eax || e2[i].ebx != orig->ebx ||
170 e2[i].ecx != orig->ecx || e2[i].edx != orig->edx)
177 static void kvm_update_kvm_cpuid_base(struct kvm_vcpu *vcpu)
180 struct kvm_cpuid_entry2 *entry;
182 vcpu->arch.kvm_cpuid_base = 0;
184 for_each_possible_hypervisor_cpuid_base(function) {
185 entry = kvm_find_cpuid_entry(vcpu, function);
190 signature[0] = entry->ebx;
191 signature[1] = entry->ecx;
192 signature[2] = entry->edx;
194 BUILD_BUG_ON(sizeof(signature) > sizeof(KVM_SIGNATURE));
195 if (!memcmp(signature, KVM_SIGNATURE, sizeof(signature))) {
196 vcpu->arch.kvm_cpuid_base = function;
203 static struct kvm_cpuid_entry2 *__kvm_find_kvm_cpuid_features(struct kvm_vcpu *vcpu,
204 struct kvm_cpuid_entry2 *entries, int nent)
206 u32 base = vcpu->arch.kvm_cpuid_base;
211 return cpuid_entry2_find(entries, nent, base | KVM_CPUID_FEATURES,
212 KVM_CPUID_INDEX_NOT_SIGNIFICANT);
215 static struct kvm_cpuid_entry2 *kvm_find_kvm_cpuid_features(struct kvm_vcpu *vcpu)
217 return __kvm_find_kvm_cpuid_features(vcpu, vcpu->arch.cpuid_entries,
218 vcpu->arch.cpuid_nent);
221 void kvm_update_pv_runtime(struct kvm_vcpu *vcpu)
223 struct kvm_cpuid_entry2 *best = kvm_find_kvm_cpuid_features(vcpu);
226 * save the feature bitmap to avoid cpuid lookup for every PV
230 vcpu->arch.pv_cpuid.features = best->eax;
234 * Calculate guest's supported XCR0 taking into account guest CPUID data and
235 * KVM's supported XCR0 (comprised of host's XCR0 and KVM_SUPPORTED_XCR0).
237 static u64 cpuid_get_supported_xcr0(struct kvm_cpuid_entry2 *entries, int nent)
239 struct kvm_cpuid_entry2 *best;
241 best = cpuid_entry2_find(entries, nent, 0xd, 0);
245 return (best->eax | ((u64)best->edx << 32)) & kvm_caps.supported_xcr0;
248 static void __kvm_update_cpuid_runtime(struct kvm_vcpu *vcpu, struct kvm_cpuid_entry2 *entries,
251 struct kvm_cpuid_entry2 *best;
252 u64 guest_supported_xcr0 = cpuid_get_supported_xcr0(entries, nent);
254 best = cpuid_entry2_find(entries, nent, 1, KVM_CPUID_INDEX_NOT_SIGNIFICANT);
256 /* Update OSXSAVE bit */
257 if (boot_cpu_has(X86_FEATURE_XSAVE))
258 cpuid_entry_change(best, X86_FEATURE_OSXSAVE,
259 kvm_read_cr4_bits(vcpu, X86_CR4_OSXSAVE));
261 cpuid_entry_change(best, X86_FEATURE_APIC,
262 vcpu->arch.apic_base & MSR_IA32_APICBASE_ENABLE);
265 best = cpuid_entry2_find(entries, nent, 7, 0);
266 if (best && boot_cpu_has(X86_FEATURE_PKU) && best->function == 0x7)
267 cpuid_entry_change(best, X86_FEATURE_OSPKE,
268 kvm_read_cr4_bits(vcpu, X86_CR4_PKE));
270 best = cpuid_entry2_find(entries, nent, 0xD, 0);
272 best->ebx = xstate_required_size(vcpu->arch.xcr0, false);
274 best = cpuid_entry2_find(entries, nent, 0xD, 1);
275 if (best && (cpuid_entry_has(best, X86_FEATURE_XSAVES) ||
276 cpuid_entry_has(best, X86_FEATURE_XSAVEC)))
277 best->ebx = xstate_required_size(vcpu->arch.xcr0, true);
279 best = __kvm_find_kvm_cpuid_features(vcpu, entries, nent);
280 if (kvm_hlt_in_guest(vcpu->kvm) && best &&
281 (best->eax & (1 << KVM_FEATURE_PV_UNHALT)))
282 best->eax &= ~(1 << KVM_FEATURE_PV_UNHALT);
284 if (!kvm_check_has_quirk(vcpu->kvm, KVM_X86_QUIRK_MISC_ENABLE_NO_MWAIT)) {
285 best = cpuid_entry2_find(entries, nent, 0x1, KVM_CPUID_INDEX_NOT_SIGNIFICANT);
287 cpuid_entry_change(best, X86_FEATURE_MWAIT,
288 vcpu->arch.ia32_misc_enable_msr &
289 MSR_IA32_MISC_ENABLE_MWAIT);
293 * Bits 127:0 of the allowed SECS.ATTRIBUTES (CPUID.0x12.0x1) enumerate
294 * the supported XSAVE Feature Request Mask (XFRM), i.e. the enclave's
295 * requested XCR0 value. The enclave's XFRM must be a subset of XCRO
296 * at the time of EENTER, thus adjust the allowed XFRM by the guest's
297 * supported XCR0. Similar to XCR0 handling, FP and SSE are forced to
298 * '1' even on CPUs that don't support XSAVE.
300 best = cpuid_entry2_find(entries, nent, 0x12, 0x1);
302 best->ecx &= guest_supported_xcr0 & 0xffffffff;
303 best->edx &= guest_supported_xcr0 >> 32;
304 best->ecx |= XFEATURE_MASK_FPSSE;
308 void kvm_update_cpuid_runtime(struct kvm_vcpu *vcpu)
310 __kvm_update_cpuid_runtime(vcpu, vcpu->arch.cpuid_entries, vcpu->arch.cpuid_nent);
312 EXPORT_SYMBOL_GPL(kvm_update_cpuid_runtime);
314 static bool kvm_cpuid_has_hyperv(struct kvm_cpuid_entry2 *entries, int nent)
316 struct kvm_cpuid_entry2 *entry;
318 entry = cpuid_entry2_find(entries, nent, HYPERV_CPUID_INTERFACE,
319 KVM_CPUID_INDEX_NOT_SIGNIFICANT);
320 return entry && entry->eax == HYPERV_CPUID_SIGNATURE_EAX;
323 static void kvm_vcpu_after_set_cpuid(struct kvm_vcpu *vcpu)
325 struct kvm_lapic *apic = vcpu->arch.apic;
326 struct kvm_cpuid_entry2 *best;
328 best = kvm_find_cpuid_entry(vcpu, 1);
330 if (cpuid_entry_has(best, X86_FEATURE_TSC_DEADLINE_TIMER))
331 apic->lapic_timer.timer_mode_mask = 3 << 17;
333 apic->lapic_timer.timer_mode_mask = 1 << 17;
335 kvm_apic_set_version(vcpu);
338 vcpu->arch.guest_supported_xcr0 =
339 cpuid_get_supported_xcr0(vcpu->arch.cpuid_entries, vcpu->arch.cpuid_nent);
341 kvm_update_pv_runtime(vcpu);
343 vcpu->arch.is_amd_compatible = guest_cpuid_is_amd_or_hygon(vcpu);
344 vcpu->arch.maxphyaddr = cpuid_query_maxphyaddr(vcpu);
345 vcpu->arch.reserved_gpa_bits = kvm_vcpu_reserved_gpa_bits_raw(vcpu);
347 kvm_pmu_refresh(vcpu);
348 vcpu->arch.cr4_guest_rsvd_bits =
349 __cr4_reserved_bits(guest_cpuid_has, vcpu);
351 kvm_hv_set_cpuid(vcpu, kvm_cpuid_has_hyperv(vcpu->arch.cpuid_entries,
352 vcpu->arch.cpuid_nent));
354 /* Invoke the vendor callback only after the above state is updated. */
355 static_call(kvm_x86_vcpu_after_set_cpuid)(vcpu);
358 * Except for the MMU, which needs to do its thing any vendor specific
359 * adjustments to the reserved GPA bits.
361 kvm_mmu_after_set_cpuid(vcpu);
364 int cpuid_query_maxphyaddr(struct kvm_vcpu *vcpu)
366 struct kvm_cpuid_entry2 *best;
368 best = kvm_find_cpuid_entry(vcpu, 0x80000000);
369 if (!best || best->eax < 0x80000008)
371 best = kvm_find_cpuid_entry(vcpu, 0x80000008);
373 return best->eax & 0xff;
379 * This "raw" version returns the reserved GPA bits without any adjustments for
380 * encryption technologies that usurp bits. The raw mask should be used if and
381 * only if hardware does _not_ strip the usurped bits, e.g. in virtual MTRRs.
383 u64 kvm_vcpu_reserved_gpa_bits_raw(struct kvm_vcpu *vcpu)
385 return rsvd_bits(cpuid_maxphyaddr(vcpu), 63);
388 static int kvm_set_cpuid(struct kvm_vcpu *vcpu, struct kvm_cpuid_entry2 *e2,
393 __kvm_update_cpuid_runtime(vcpu, e2, nent);
396 * KVM does not correctly handle changing guest CPUID after KVM_RUN, as
397 * MAXPHYADDR, GBPAGES support, AMD reserved bit behavior, etc.. aren't
398 * tracked in kvm_mmu_page_role. As a result, KVM may miss guest page
399 * faults due to reusing SPs/SPTEs. In practice no sane VMM mucks with
400 * the core vCPU model on the fly. It would've been better to forbid any
401 * KVM_SET_CPUID{,2} calls after KVM_RUN altogether but unfortunately
402 * some VMMs (e.g. QEMU) reuse vCPU fds for CPU hotplug/unplug and do
403 * KVM_SET_CPUID{,2} again. To support this legacy behavior, check
404 * whether the supplied CPUID data is equal to what's already set.
406 if (vcpu->arch.last_vmentry_cpu != -1) {
407 r = kvm_cpuid_check_equal(vcpu, e2, nent);
415 if (kvm_cpuid_has_hyperv(e2, nent)) {
416 r = kvm_hv_vcpu_init(vcpu);
421 r = kvm_check_cpuid(vcpu, e2, nent);
425 kvfree(vcpu->arch.cpuid_entries);
426 vcpu->arch.cpuid_entries = e2;
427 vcpu->arch.cpuid_nent = nent;
429 kvm_update_kvm_cpuid_base(vcpu);
430 kvm_vcpu_after_set_cpuid(vcpu);
435 /* when an old userspace process fills a new kernel module */
436 int kvm_vcpu_ioctl_set_cpuid(struct kvm_vcpu *vcpu,
437 struct kvm_cpuid *cpuid,
438 struct kvm_cpuid_entry __user *entries)
441 struct kvm_cpuid_entry *e = NULL;
442 struct kvm_cpuid_entry2 *e2 = NULL;
444 if (cpuid->nent > KVM_MAX_CPUID_ENTRIES)
448 e = vmemdup_user(entries, array_size(sizeof(*e), cpuid->nent));
452 e2 = kvmalloc_array(cpuid->nent, sizeof(*e2), GFP_KERNEL_ACCOUNT);
458 for (i = 0; i < cpuid->nent; i++) {
459 e2[i].function = e[i].function;
460 e2[i].eax = e[i].eax;
461 e2[i].ebx = e[i].ebx;
462 e2[i].ecx = e[i].ecx;
463 e2[i].edx = e[i].edx;
466 e2[i].padding[0] = 0;
467 e2[i].padding[1] = 0;
468 e2[i].padding[2] = 0;
471 r = kvm_set_cpuid(vcpu, e2, cpuid->nent);
481 int kvm_vcpu_ioctl_set_cpuid2(struct kvm_vcpu *vcpu,
482 struct kvm_cpuid2 *cpuid,
483 struct kvm_cpuid_entry2 __user *entries)
485 struct kvm_cpuid_entry2 *e2 = NULL;
488 if (cpuid->nent > KVM_MAX_CPUID_ENTRIES)
492 e2 = vmemdup_user(entries, array_size(sizeof(*e2), cpuid->nent));
497 r = kvm_set_cpuid(vcpu, e2, cpuid->nent);
504 int kvm_vcpu_ioctl_get_cpuid2(struct kvm_vcpu *vcpu,
505 struct kvm_cpuid2 *cpuid,
506 struct kvm_cpuid_entry2 __user *entries)
511 if (cpuid->nent < vcpu->arch.cpuid_nent)
514 if (copy_to_user(entries, vcpu->arch.cpuid_entries,
515 vcpu->arch.cpuid_nent * sizeof(struct kvm_cpuid_entry2)))
520 cpuid->nent = vcpu->arch.cpuid_nent;
524 /* Mask kvm_cpu_caps for @leaf with the raw CPUID capabilities of this CPU. */
525 static __always_inline void __kvm_cpu_cap_mask(unsigned int leaf)
527 const struct cpuid_reg cpuid = x86_feature_cpuid(leaf * 32);
528 struct kvm_cpuid_entry2 entry;
530 reverse_cpuid_check(leaf);
532 cpuid_count(cpuid.function, cpuid.index,
533 &entry.eax, &entry.ebx, &entry.ecx, &entry.edx);
535 kvm_cpu_caps[leaf] &= *__cpuid_entry_get_reg(&entry, cpuid.reg);
538 static __always_inline
539 void kvm_cpu_cap_init_kvm_defined(enum kvm_only_cpuid_leafs leaf, u32 mask)
541 /* Use kvm_cpu_cap_mask for leafs that aren't KVM-only. */
542 BUILD_BUG_ON(leaf < NCAPINTS);
544 kvm_cpu_caps[leaf] = mask;
546 __kvm_cpu_cap_mask(leaf);
549 static __always_inline void kvm_cpu_cap_mask(enum cpuid_leafs leaf, u32 mask)
551 /* Use kvm_cpu_cap_init_kvm_defined for KVM-only leafs. */
552 BUILD_BUG_ON(leaf >= NCAPINTS);
554 kvm_cpu_caps[leaf] &= mask;
556 __kvm_cpu_cap_mask(leaf);
559 void kvm_set_cpu_caps(void)
562 unsigned int f_gbpages = F(GBPAGES);
563 unsigned int f_lm = F(LM);
564 unsigned int f_xfd = F(XFD);
566 unsigned int f_gbpages = 0;
567 unsigned int f_lm = 0;
568 unsigned int f_xfd = 0;
570 memset(kvm_cpu_caps, 0, sizeof(kvm_cpu_caps));
572 BUILD_BUG_ON(sizeof(kvm_cpu_caps) - (NKVMCAPINTS * sizeof(*kvm_cpu_caps)) >
573 sizeof(boot_cpu_data.x86_capability));
575 memcpy(&kvm_cpu_caps, &boot_cpu_data.x86_capability,
576 sizeof(kvm_cpu_caps) - (NKVMCAPINTS * sizeof(*kvm_cpu_caps)));
578 kvm_cpu_cap_mask(CPUID_1_ECX,
580 * NOTE: MONITOR (and MWAIT) are emulated as NOP, but *not*
581 * advertised to guests via CPUID!
583 F(XMM3) | F(PCLMULQDQ) | 0 /* DTES64, MONITOR */ |
584 0 /* DS-CPL, VMX, SMX, EST */ |
585 0 /* TM2 */ | F(SSSE3) | 0 /* CNXT-ID */ | 0 /* Reserved */ |
586 F(FMA) | F(CX16) | 0 /* xTPR Update */ | F(PDCM) |
587 F(PCID) | 0 /* Reserved, DCA */ | F(XMM4_1) |
588 F(XMM4_2) | F(X2APIC) | F(MOVBE) | F(POPCNT) |
589 0 /* Reserved*/ | F(AES) | F(XSAVE) | 0 /* OSXSAVE */ | F(AVX) |
592 /* KVM emulates x2apic in software irrespective of host support. */
593 kvm_cpu_cap_set(X86_FEATURE_X2APIC);
595 kvm_cpu_cap_mask(CPUID_1_EDX,
596 F(FPU) | F(VME) | F(DE) | F(PSE) |
597 F(TSC) | F(MSR) | F(PAE) | F(MCE) |
598 F(CX8) | F(APIC) | 0 /* Reserved */ | F(SEP) |
599 F(MTRR) | F(PGE) | F(MCA) | F(CMOV) |
600 F(PAT) | F(PSE36) | 0 /* PSN */ | F(CLFLUSH) |
601 0 /* Reserved, DS, ACPI */ | F(MMX) |
602 F(FXSR) | F(XMM) | F(XMM2) | F(SELFSNOOP) |
603 0 /* HTT, TM, Reserved, PBE */
606 kvm_cpu_cap_mask(CPUID_7_0_EBX,
607 F(FSGSBASE) | F(SGX) | F(BMI1) | F(HLE) | F(AVX2) |
608 F(FDP_EXCPTN_ONLY) | F(SMEP) | F(BMI2) | F(ERMS) | F(INVPCID) |
609 F(RTM) | F(ZERO_FCS_FDS) | 0 /*MPX*/ | F(AVX512F) |
610 F(AVX512DQ) | F(RDSEED) | F(ADX) | F(SMAP) | F(AVX512IFMA) |
611 F(CLFLUSHOPT) | F(CLWB) | 0 /*INTEL_PT*/ | F(AVX512PF) |
612 F(AVX512ER) | F(AVX512CD) | F(SHA_NI) | F(AVX512BW) |
615 kvm_cpu_cap_mask(CPUID_7_ECX,
616 F(AVX512VBMI) | F(LA57) | F(PKU) | 0 /*OSPKE*/ | F(RDPID) |
617 F(AVX512_VPOPCNTDQ) | F(UMIP) | F(AVX512_VBMI2) | F(GFNI) |
618 F(VAES) | F(VPCLMULQDQ) | F(AVX512_VNNI) | F(AVX512_BITALG) |
619 F(CLDEMOTE) | F(MOVDIRI) | F(MOVDIR64B) | 0 /*WAITPKG*/ |
620 F(SGX_LC) | F(BUS_LOCK_DETECT)
622 /* Set LA57 based on hardware capability. */
623 if (cpuid_ecx(7) & F(LA57))
624 kvm_cpu_cap_set(X86_FEATURE_LA57);
627 * PKU not yet implemented for shadow paging and requires OSPKE
628 * to be set on the host. Clear it if that is not the case
630 if (!tdp_enabled || !boot_cpu_has(X86_FEATURE_OSPKE))
631 kvm_cpu_cap_clear(X86_FEATURE_PKU);
633 kvm_cpu_cap_mask(CPUID_7_EDX,
634 F(AVX512_4VNNIW) | F(AVX512_4FMAPS) | F(SPEC_CTRL) |
635 F(SPEC_CTRL_SSBD) | F(ARCH_CAPABILITIES) | F(INTEL_STIBP) |
636 F(MD_CLEAR) | F(AVX512_VP2INTERSECT) | F(FSRM) |
637 F(SERIALIZE) | F(TSXLDTRK) | F(AVX512_FP16) |
638 F(AMX_TILE) | F(AMX_INT8) | F(AMX_BF16)
641 /* TSC_ADJUST and ARCH_CAPABILITIES are emulated in software. */
642 kvm_cpu_cap_set(X86_FEATURE_TSC_ADJUST);
643 kvm_cpu_cap_set(X86_FEATURE_ARCH_CAPABILITIES);
645 if (boot_cpu_has(X86_FEATURE_IBPB) && boot_cpu_has(X86_FEATURE_IBRS))
646 kvm_cpu_cap_set(X86_FEATURE_SPEC_CTRL);
647 if (boot_cpu_has(X86_FEATURE_STIBP))
648 kvm_cpu_cap_set(X86_FEATURE_INTEL_STIBP);
649 if (boot_cpu_has(X86_FEATURE_AMD_SSBD))
650 kvm_cpu_cap_set(X86_FEATURE_SPEC_CTRL_SSBD);
652 kvm_cpu_cap_mask(CPUID_7_1_EAX,
653 F(AVX_VNNI) | F(AVX512_BF16)
656 kvm_cpu_cap_init_kvm_defined(CPUID_7_2_EDX,
657 F(INTEL_PSFD) | F(IPRED_CTRL) | F(RRSBA_CTRL) | F(DDPD_U) |
658 F(BHI_CTRL) | F(MCDT_NO)
661 kvm_cpu_cap_mask(CPUID_D_1_EAX,
662 F(XSAVEOPT) | F(XSAVEC) | F(XGETBV1) | F(XSAVES) | f_xfd
665 kvm_cpu_cap_init_kvm_defined(CPUID_12_EAX,
669 kvm_cpu_cap_mask(CPUID_8000_0001_ECX,
670 F(LAHF_LM) | F(CMP_LEGACY) | 0 /*SVM*/ | 0 /* ExtApicSpace */ |
671 F(CR8_LEGACY) | F(ABM) | F(SSE4A) | F(MISALIGNSSE) |
672 F(3DNOWPREFETCH) | F(OSVW) | 0 /* IBS */ | F(XOP) |
673 0 /* SKINIT, WDT, LWP */ | F(FMA4) | F(TBM) |
674 F(TOPOEXT) | 0 /* PERFCTR_CORE */
677 kvm_cpu_cap_mask(CPUID_8000_0001_EDX,
678 F(FPU) | F(VME) | F(DE) | F(PSE) |
679 F(TSC) | F(MSR) | F(PAE) | F(MCE) |
680 F(CX8) | F(APIC) | 0 /* Reserved */ | F(SYSCALL) |
681 F(MTRR) | F(PGE) | F(MCA) | F(CMOV) |
682 F(PAT) | F(PSE36) | 0 /* Reserved */ |
683 F(NX) | 0 /* Reserved */ | F(MMXEXT) | F(MMX) |
684 F(FXSR) | F(FXSR_OPT) | f_gbpages | F(RDTSCP) |
685 0 /* Reserved */ | f_lm | F(3DNOWEXT) | F(3DNOW)
688 if (!tdp_enabled && IS_ENABLED(CONFIG_X86_64))
689 kvm_cpu_cap_set(X86_FEATURE_GBPAGES);
691 kvm_cpu_cap_mask(CPUID_8000_0008_EBX,
692 F(CLZERO) | F(XSAVEERPTR) |
693 F(WBNOINVD) | F(AMD_IBPB) | F(AMD_IBRS) | F(AMD_SSBD) | F(VIRT_SSBD) |
694 F(AMD_SSB_NO) | F(AMD_STIBP) | F(AMD_STIBP_ALWAYS_ON) |
695 __feature_bit(KVM_X86_FEATURE_PSFD)
699 * AMD has separate bits for each SPEC_CTRL bit.
700 * arch/x86/kernel/cpu/bugs.c is kind enough to
701 * record that in cpufeatures so use them.
703 if (boot_cpu_has(X86_FEATURE_IBPB))
704 kvm_cpu_cap_set(X86_FEATURE_AMD_IBPB);
705 if (boot_cpu_has(X86_FEATURE_IBRS))
706 kvm_cpu_cap_set(X86_FEATURE_AMD_IBRS);
707 if (boot_cpu_has(X86_FEATURE_STIBP))
708 kvm_cpu_cap_set(X86_FEATURE_AMD_STIBP);
709 if (boot_cpu_has(X86_FEATURE_SPEC_CTRL_SSBD))
710 kvm_cpu_cap_set(X86_FEATURE_AMD_SSBD);
711 if (!boot_cpu_has_bug(X86_BUG_SPEC_STORE_BYPASS))
712 kvm_cpu_cap_set(X86_FEATURE_AMD_SSB_NO);
714 * The preference is to use SPEC CTRL MSR instead of the
717 if (boot_cpu_has(X86_FEATURE_LS_CFG_SSBD) &&
718 !boot_cpu_has(X86_FEATURE_AMD_SSBD))
719 kvm_cpu_cap_set(X86_FEATURE_VIRT_SSBD);
722 * Hide all SVM features by default, SVM will set the cap bits for
723 * features it emulates and/or exposes for L1.
725 kvm_cpu_cap_mask(CPUID_8000_000A_EDX, 0);
727 kvm_cpu_cap_mask(CPUID_8000_001F_EAX,
728 0 /* SME */ | F(SEV) | 0 /* VM_PAGE_FLUSH */ | F(SEV_ES) |
731 kvm_cpu_cap_mask(CPUID_C000_0001_EDX,
732 F(XSTORE) | F(XSTORE_EN) | F(XCRYPT) | F(XCRYPT_EN) |
733 F(ACE2) | F(ACE2_EN) | F(PHE) | F(PHE_EN) |
737 if (cpu_feature_enabled(X86_FEATURE_SRSO_NO))
738 kvm_cpu_cap_set(X86_FEATURE_SRSO_NO);
741 * Hide RDTSCP and RDPID if either feature is reported as supported but
742 * probing MSR_TSC_AUX failed. This is purely a sanity check and
743 * should never happen, but the guest will likely crash if RDTSCP or
744 * RDPID is misreported, and KVM has botched MSR_TSC_AUX emulation in
745 * the past. For example, the sanity check may fire if this instance of
746 * KVM is running as L1 on top of an older, broken KVM.
748 if (WARN_ON((kvm_cpu_cap_has(X86_FEATURE_RDTSCP) ||
749 kvm_cpu_cap_has(X86_FEATURE_RDPID)) &&
750 !kvm_is_supported_user_return_msr(MSR_TSC_AUX))) {
751 kvm_cpu_cap_clear(X86_FEATURE_RDTSCP);
752 kvm_cpu_cap_clear(X86_FEATURE_RDPID);
755 EXPORT_SYMBOL_GPL(kvm_set_cpu_caps);
757 struct kvm_cpuid_array {
758 struct kvm_cpuid_entry2 *entries;
763 static struct kvm_cpuid_entry2 *get_next_cpuid(struct kvm_cpuid_array *array)
765 if (array->nent >= array->maxnent)
768 return &array->entries[array->nent++];
771 static struct kvm_cpuid_entry2 *do_host_cpuid(struct kvm_cpuid_array *array,
772 u32 function, u32 index)
774 struct kvm_cpuid_entry2 *entry = get_next_cpuid(array);
779 memset(entry, 0, sizeof(*entry));
780 entry->function = function;
781 entry->index = index;
782 switch (function & 0xC0000000) {
784 /* Hypervisor leaves are always synthesized by __do_cpuid_func. */
789 * 0x80000021 is sometimes synthesized by __do_cpuid_func, which
790 * would result in out-of-bounds calls to do_host_cpuid.
793 static int max_cpuid_80000000;
794 if (!READ_ONCE(max_cpuid_80000000))
795 WRITE_ONCE(max_cpuid_80000000, cpuid_eax(0x80000000));
796 if (function > READ_ONCE(max_cpuid_80000000))
805 cpuid_count(entry->function, entry->index,
806 &entry->eax, &entry->ebx, &entry->ecx, &entry->edx);
808 if (cpuid_function_is_indexed(function))
809 entry->flags |= KVM_CPUID_FLAG_SIGNIFCANT_INDEX;
814 static int __do_cpuid_func_emulated(struct kvm_cpuid_array *array, u32 func)
816 struct kvm_cpuid_entry2 *entry;
818 if (array->nent >= array->maxnent)
821 entry = &array->entries[array->nent];
822 entry->function = func;
832 entry->ecx = F(MOVBE);
836 entry->flags |= KVM_CPUID_FLAG_SIGNIFCANT_INDEX;
838 if (kvm_cpu_cap_has(X86_FEATURE_RDTSCP))
839 entry->ecx = F(RDPID);
849 static inline int __do_cpuid_func(struct kvm_cpuid_array *array, u32 function)
851 struct kvm_cpuid_entry2 *entry;
854 /* all calls to cpuid_count() should be made on the same cpu */
859 entry = do_host_cpuid(array, function, 0);
865 /* Limited to the highest leaf implemented in KVM. */
866 entry->eax = min(entry->eax, 0x1fU);
869 cpuid_entry_override(entry, CPUID_1_EDX);
870 cpuid_entry_override(entry, CPUID_1_ECX);
874 * On ancient CPUs, function 2 entries are STATEFUL. That is,
875 * CPUID(function=2, index=0) may return different results each
876 * time, with the least-significant byte in EAX enumerating the
877 * number of times software should do CPUID(2, 0).
879 * Modern CPUs, i.e. every CPU KVM has *ever* run on are less
880 * idiotic. Intel's SDM states that EAX & 0xff "will always
881 * return 01H. Software should ignore this value and not
882 * interpret it as an informational descriptor", while AMD's
883 * APM states that CPUID(2) is reserved.
885 * WARN if a frankenstein CPU that supports virtualization and
886 * a stateful CPUID.0x2 is encountered.
888 WARN_ON_ONCE((entry->eax & 0xff) > 1);
890 /* functions 4 and 0x8000001d have additional index. */
894 * Read entries until the cache type in the previous entry is
895 * zero, i.e. indicates an invalid entry.
897 for (i = 1; entry->eax & 0x1f; ++i) {
898 entry = do_host_cpuid(array, function, i);
903 case 6: /* Thermal management */
904 entry->eax = 0x4; /* allow ARAT */
909 /* function 7 has additional index. */
911 max_idx = entry->eax = min(entry->eax, 2u);
912 cpuid_entry_override(entry, CPUID_7_0_EBX);
913 cpuid_entry_override(entry, CPUID_7_ECX);
914 cpuid_entry_override(entry, CPUID_7_EDX);
916 /* KVM only supports up to 0x7.2, capped above via min(). */
918 entry = do_host_cpuid(array, function, 1);
922 cpuid_entry_override(entry, CPUID_7_1_EAX);
928 entry = do_host_cpuid(array, function, 2);
932 cpuid_entry_override(entry, CPUID_7_2_EDX);
938 case 0xa: { /* Architectural Performance Monitoring */
939 union cpuid10_eax eax;
940 union cpuid10_edx edx;
942 if (!static_cpu_has(X86_FEATURE_ARCH_PERFMON)) {
943 entry->eax = entry->ebx = entry->ecx = entry->edx = 0;
947 eax.split.version_id = kvm_pmu_cap.version;
948 eax.split.num_counters = kvm_pmu_cap.num_counters_gp;
949 eax.split.bit_width = kvm_pmu_cap.bit_width_gp;
950 eax.split.mask_length = kvm_pmu_cap.events_mask_len;
951 edx.split.num_counters_fixed = kvm_pmu_cap.num_counters_fixed;
952 edx.split.bit_width_fixed = kvm_pmu_cap.bit_width_fixed;
954 if (kvm_pmu_cap.version)
955 edx.split.anythread_deprecated = 1;
956 edx.split.reserved1 = 0;
957 edx.split.reserved2 = 0;
959 entry->eax = eax.full;
960 entry->ebx = kvm_pmu_cap.events_mask;
962 entry->edx = edx.full;
968 * No topology; a valid topology is indicated by the presence
971 entry->eax = entry->ebx = entry->ecx = 0;
974 u64 permitted_xcr0 = kvm_caps.supported_xcr0 & xstate_get_guest_group_perm();
975 u64 permitted_xss = kvm_caps.supported_xss;
977 entry->eax &= permitted_xcr0;
978 entry->ebx = xstate_required_size(permitted_xcr0, false);
979 entry->ecx = entry->ebx;
980 entry->edx &= permitted_xcr0 >> 32;
984 entry = do_host_cpuid(array, function, 1);
988 cpuid_entry_override(entry, CPUID_D_1_EAX);
989 if (entry->eax & (F(XSAVES)|F(XSAVEC)))
990 entry->ebx = xstate_required_size(permitted_xcr0 | permitted_xss,
993 WARN_ON_ONCE(permitted_xss != 0);
996 entry->ecx &= permitted_xss;
997 entry->edx &= permitted_xss >> 32;
999 for (i = 2; i < 64; ++i) {
1001 if (permitted_xcr0 & BIT_ULL(i))
1003 else if (permitted_xss & BIT_ULL(i))
1008 entry = do_host_cpuid(array, function, i);
1013 * The supported check above should have filtered out
1014 * invalid sub-leafs. Only valid sub-leafs should
1015 * reach this point, and they should have a non-zero
1016 * save state size. Furthermore, check whether the
1017 * processor agrees with permitted_xcr0/permitted_xss
1018 * on whether this is an XCR0- or IA32_XSS-managed area.
1020 if (WARN_ON_ONCE(!entry->eax || (entry->ecx & 0x1) != s_state)) {
1025 if (!kvm_cpu_cap_has(X86_FEATURE_XFD))
1026 entry->ecx &= ~BIT_ULL(2);
1033 if (!kvm_cpu_cap_has(X86_FEATURE_SGX)) {
1034 entry->eax = entry->ebx = entry->ecx = entry->edx = 0;
1039 * Index 0: Sub-features, MISCSELECT (a.k.a extended features)
1040 * and max enclave sizes. The SGX sub-features and MISCSELECT
1041 * are restricted by kernel and KVM capabilities (like most
1042 * feature flags), while enclave size is unrestricted.
1044 cpuid_entry_override(entry, CPUID_12_EAX);
1045 entry->ebx &= SGX_MISC_EXINFO;
1047 entry = do_host_cpuid(array, function, 1);
1052 * Index 1: SECS.ATTRIBUTES. ATTRIBUTES are restricted a la
1053 * feature flags. Advertise all supported flags, including
1054 * privileged attributes that require explicit opt-in from
1055 * userspace. ATTRIBUTES.XFRM is not adjusted as userspace is
1056 * expected to derive it from supported XCR0.
1058 entry->eax &= SGX_ATTR_DEBUG | SGX_ATTR_MODE64BIT |
1059 SGX_ATTR_PROVISIONKEY | SGX_ATTR_EINITTOKENKEY |
1065 if (!kvm_cpu_cap_has(X86_FEATURE_INTEL_PT)) {
1066 entry->eax = entry->ebx = entry->ecx = entry->edx = 0;
1070 for (i = 1, max_idx = entry->eax; i <= max_idx; ++i) {
1071 if (!do_host_cpuid(array, function, i))
1075 /* Intel AMX TILE */
1077 if (!kvm_cpu_cap_has(X86_FEATURE_AMX_TILE)) {
1078 entry->eax = entry->ebx = entry->ecx = entry->edx = 0;
1082 for (i = 1, max_idx = entry->eax; i <= max_idx; ++i) {
1083 if (!do_host_cpuid(array, function, i))
1087 case 0x1e: /* TMUL information */
1088 if (!kvm_cpu_cap_has(X86_FEATURE_AMX_TILE)) {
1089 entry->eax = entry->ebx = entry->ecx = entry->edx = 0;
1093 case KVM_CPUID_SIGNATURE: {
1094 const u32 *sigptr = (const u32 *)KVM_SIGNATURE;
1095 entry->eax = KVM_CPUID_FEATURES;
1096 entry->ebx = sigptr[0];
1097 entry->ecx = sigptr[1];
1098 entry->edx = sigptr[2];
1101 case KVM_CPUID_FEATURES:
1102 entry->eax = (1 << KVM_FEATURE_CLOCKSOURCE) |
1103 (1 << KVM_FEATURE_NOP_IO_DELAY) |
1104 (1 << KVM_FEATURE_CLOCKSOURCE2) |
1105 (1 << KVM_FEATURE_ASYNC_PF) |
1106 (1 << KVM_FEATURE_PV_EOI) |
1107 (1 << KVM_FEATURE_CLOCKSOURCE_STABLE_BIT) |
1108 (1 << KVM_FEATURE_PV_UNHALT) |
1109 (1 << KVM_FEATURE_PV_TLB_FLUSH) |
1110 (1 << KVM_FEATURE_ASYNC_PF_VMEXIT) |
1111 (1 << KVM_FEATURE_PV_SEND_IPI) |
1112 (1 << KVM_FEATURE_POLL_CONTROL) |
1113 (1 << KVM_FEATURE_PV_SCHED_YIELD) |
1114 (1 << KVM_FEATURE_ASYNC_PF_INT);
1116 if (sched_info_on())
1117 entry->eax |= (1 << KVM_FEATURE_STEAL_TIME);
1124 entry->eax = min(entry->eax, 0x80000021);
1126 * Serializing LFENCE is reported in a multitude of ways, and
1127 * NullSegClearsBase is not reported in CPUID on Zen2; help
1128 * userspace by providing the CPUID leaf ourselves.
1130 * However, only do it if the host has CPUID leaf 0x8000001d.
1131 * QEMU thinks that it can query the host blindly for that
1132 * CPUID leaf if KVM reports that it supports 0x8000001d or
1133 * above. The processor merrily returns values from the
1134 * highest Intel leaf which QEMU tries to use as the guest's
1135 * 0x8000001d. Even worse, this can result in an infinite
1136 * loop if said highest leaf has no subleaves indexed by ECX.
1138 if (entry->eax >= 0x8000001d &&
1139 (static_cpu_has(X86_FEATURE_LFENCE_RDTSC)
1140 || !static_cpu_has_bug(X86_BUG_NULL_SEG)))
1141 entry->eax = max(entry->eax, 0x80000021);
1144 entry->ebx &= ~GENMASK(27, 16);
1145 cpuid_entry_override(entry, CPUID_8000_0001_EDX);
1146 cpuid_entry_override(entry, CPUID_8000_0001_ECX);
1149 /* Drop reserved bits, pass host L2 cache and TLB info. */
1150 entry->edx &= ~GENMASK(17, 16);
1152 case 0x80000007: /* Advanced power management */
1153 /* invariant TSC is CPUID.80000007H:EDX[8] */
1154 entry->edx &= (1 << 8);
1155 /* mask against host */
1156 entry->edx &= boot_cpu_data.x86_power;
1157 entry->eax = entry->ebx = entry->ecx = 0;
1160 unsigned g_phys_as = (entry->eax >> 16) & 0xff;
1161 unsigned virt_as = max((entry->eax >> 8) & 0xff, 48U);
1162 unsigned phys_as = entry->eax & 0xff;
1165 * If TDP (NPT) is disabled use the adjusted host MAXPHYADDR as
1166 * the guest operates in the same PA space as the host, i.e.
1167 * reductions in MAXPHYADDR for memory encryption affect shadow
1170 * If TDP is enabled but an explicit guest MAXPHYADDR is not
1171 * provided, use the raw bare metal MAXPHYADDR as reductions to
1172 * the HPAs do not affect GPAs.
1175 g_phys_as = boot_cpu_data.x86_phys_bits;
1176 else if (!g_phys_as)
1177 g_phys_as = phys_as;
1179 entry->eax = g_phys_as | (virt_as << 8);
1180 entry->ecx &= ~(GENMASK(31, 16) | GENMASK(11, 8));
1182 cpuid_entry_override(entry, CPUID_8000_0008_EBX);
1186 if (!kvm_cpu_cap_has(X86_FEATURE_SVM)) {
1187 entry->eax = entry->ebx = entry->ecx = entry->edx = 0;
1190 entry->eax = 1; /* SVM revision 1 */
1191 entry->ebx = 8; /* Lets support 8 ASIDs in case we add proper
1192 ASID emulation to nested SVM */
1193 entry->ecx = 0; /* Reserved */
1194 cpuid_entry_override(entry, CPUID_8000_000A_EDX);
1197 entry->ecx = entry->edx = 0;
1200 entry->eax &= GENMASK(2, 0);
1201 entry->ebx = entry->ecx = entry->edx = 0;
1204 /* Do not return host topology information. */
1205 entry->eax = entry->ebx = entry->ecx = 0;
1206 entry->edx = 0; /* reserved */
1209 if (!kvm_cpu_cap_has(X86_FEATURE_SEV)) {
1210 entry->eax = entry->ebx = entry->ecx = entry->edx = 0;
1212 cpuid_entry_override(entry, CPUID_8000_001F_EAX);
1213 /* Clear NumVMPL since KVM does not support VMPL. */
1214 entry->ebx &= ~GENMASK(31, 12);
1216 * Enumerate '0' for "PA bits reduction", the adjusted
1217 * MAXPHYADDR is enumerated directly (see 0x80000008).
1219 entry->ebx &= ~GENMASK(11, 6);
1223 entry->eax = entry->ebx = entry->ecx = entry->edx = 0;
1226 entry->ebx = entry->ecx = entry->edx = 0;
1228 * Pass down these bits:
1229 * EAX 0 NNDBP, Processor ignores nested data breakpoints
1230 * EAX 2 LAS, LFENCE always serializing
1231 * EAX 6 NSCB, Null selector clear base
1233 * Other defined bits are for MSRs that KVM does not expose:
1234 * EAX 3 SPCL, SMM page configuration lock
1235 * EAX 13 PCMSR, Prefetch control MSR
1237 entry->eax &= BIT(0) | BIT(2) | BIT(6);
1238 if (static_cpu_has(X86_FEATURE_LFENCE_RDTSC))
1239 entry->eax |= BIT(2);
1240 if (!static_cpu_has_bug(X86_BUG_NULL_SEG))
1241 entry->eax |= BIT(6);
1243 /*Add support for Centaur's CPUID instruction*/
1245 /*Just support up to 0xC0000004 now*/
1246 entry->eax = min(entry->eax, 0xC0000004);
1249 cpuid_entry_override(entry, CPUID_C000_0001_EDX);
1251 case 3: /* Processor serial number */
1252 case 5: /* MONITOR/MWAIT */
1257 entry->eax = entry->ebx = entry->ecx = entry->edx = 0;
1269 static int do_cpuid_func(struct kvm_cpuid_array *array, u32 func,
1272 if (type == KVM_GET_EMULATED_CPUID)
1273 return __do_cpuid_func_emulated(array, func);
1275 return __do_cpuid_func(array, func);
1278 #define CENTAUR_CPUID_SIGNATURE 0xC0000000
1280 static int get_cpuid_func(struct kvm_cpuid_array *array, u32 func,
1286 if (func == CENTAUR_CPUID_SIGNATURE &&
1287 boot_cpu_data.x86_vendor != X86_VENDOR_CENTAUR)
1290 r = do_cpuid_func(array, func, type);
1294 limit = array->entries[array->nent - 1].eax;
1295 for (func = func + 1; func <= limit; ++func) {
1296 r = do_cpuid_func(array, func, type);
1304 static bool sanity_check_entries(struct kvm_cpuid_entry2 __user *entries,
1305 __u32 num_entries, unsigned int ioctl_type)
1310 if (ioctl_type != KVM_GET_EMULATED_CPUID)
1314 * We want to make sure that ->padding is being passed clean from
1315 * userspace in case we want to use it for something in the future.
1317 * Sadly, this wasn't enforced for KVM_GET_SUPPORTED_CPUID and so we
1318 * have to give ourselves satisfied only with the emulated side. /me
1321 for (i = 0; i < num_entries; i++) {
1322 if (copy_from_user(pad, entries[i].padding, sizeof(pad)))
1325 if (pad[0] || pad[1] || pad[2])
1331 int kvm_dev_ioctl_get_cpuid(struct kvm_cpuid2 *cpuid,
1332 struct kvm_cpuid_entry2 __user *entries,
1335 static const u32 funcs[] = {
1336 0, 0x80000000, CENTAUR_CPUID_SIGNATURE, KVM_CPUID_SIGNATURE,
1339 struct kvm_cpuid_array array = {
1344 if (cpuid->nent < 1)
1346 if (cpuid->nent > KVM_MAX_CPUID_ENTRIES)
1347 cpuid->nent = KVM_MAX_CPUID_ENTRIES;
1349 if (sanity_check_entries(entries, cpuid->nent, type))
1352 array.entries = kvcalloc(cpuid->nent, sizeof(struct kvm_cpuid_entry2), GFP_KERNEL);
1356 array.maxnent = cpuid->nent;
1358 for (i = 0; i < ARRAY_SIZE(funcs); i++) {
1359 r = get_cpuid_func(&array, funcs[i], type);
1363 cpuid->nent = array.nent;
1365 if (copy_to_user(entries, array.entries,
1366 array.nent * sizeof(struct kvm_cpuid_entry2)))
1370 kvfree(array.entries);
1374 struct kvm_cpuid_entry2 *kvm_find_cpuid_entry_index(struct kvm_vcpu *vcpu,
1375 u32 function, u32 index)
1377 return cpuid_entry2_find(vcpu->arch.cpuid_entries, vcpu->arch.cpuid_nent,
1380 EXPORT_SYMBOL_GPL(kvm_find_cpuid_entry_index);
1382 struct kvm_cpuid_entry2 *kvm_find_cpuid_entry(struct kvm_vcpu *vcpu,
1385 return cpuid_entry2_find(vcpu->arch.cpuid_entries, vcpu->arch.cpuid_nent,
1386 function, KVM_CPUID_INDEX_NOT_SIGNIFICANT);
1388 EXPORT_SYMBOL_GPL(kvm_find_cpuid_entry);
1391 * Intel CPUID semantics treats any query for an out-of-range leaf as if the
1392 * highest basic leaf (i.e. CPUID.0H:EAX) were requested. AMD CPUID semantics
1393 * returns all zeroes for any undefined leaf, whether or not the leaf is in
1394 * range. Centaur/VIA follows Intel semantics.
1396 * A leaf is considered out-of-range if its function is higher than the maximum
1397 * supported leaf of its associated class or if its associated class does not
1400 * There are three primary classes to be considered, with their respective
1401 * ranges described as "<base> - <top>[,<base2> - <top2>] inclusive. A primary
1402 * class exists if a guest CPUID entry for its <base> leaf exists. For a given
1403 * class, CPUID.<base>.EAX contains the max supported leaf for the class.
1405 * - Basic: 0x00000000 - 0x3fffffff, 0x50000000 - 0x7fffffff
1406 * - Hypervisor: 0x40000000 - 0x4fffffff
1407 * - Extended: 0x80000000 - 0xbfffffff
1408 * - Centaur: 0xc0000000 - 0xcfffffff
1410 * The Hypervisor class is further subdivided into sub-classes that each act as
1411 * their own independent class associated with a 0x100 byte range. E.g. if Qemu
1412 * is advertising support for both HyperV and KVM, the resulting Hypervisor
1413 * CPUID sub-classes are:
1415 * - HyperV: 0x40000000 - 0x400000ff
1416 * - KVM: 0x40000100 - 0x400001ff
1418 static struct kvm_cpuid_entry2 *
1419 get_out_of_range_cpuid_entry(struct kvm_vcpu *vcpu, u32 *fn_ptr, u32 index)
1421 struct kvm_cpuid_entry2 *basic, *class;
1422 u32 function = *fn_ptr;
1424 basic = kvm_find_cpuid_entry(vcpu, 0);
1428 if (is_guest_vendor_amd(basic->ebx, basic->ecx, basic->edx) ||
1429 is_guest_vendor_hygon(basic->ebx, basic->ecx, basic->edx))
1432 if (function >= 0x40000000 && function <= 0x4fffffff)
1433 class = kvm_find_cpuid_entry(vcpu, function & 0xffffff00);
1434 else if (function >= 0xc0000000)
1435 class = kvm_find_cpuid_entry(vcpu, 0xc0000000);
1437 class = kvm_find_cpuid_entry(vcpu, function & 0x80000000);
1439 if (class && function <= class->eax)
1443 * Leaf specific adjustments are also applied when redirecting to the
1444 * max basic entry, e.g. if the max basic leaf is 0xb but there is no
1445 * entry for CPUID.0xb.index (see below), then the output value for EDX
1446 * needs to be pulled from CPUID.0xb.1.
1448 *fn_ptr = basic->eax;
1451 * The class does not exist or the requested function is out of range;
1452 * the effective CPUID entry is the max basic leaf. Note, the index of
1453 * the original requested leaf is observed!
1455 return kvm_find_cpuid_entry_index(vcpu, basic->eax, index);
1458 bool kvm_cpuid(struct kvm_vcpu *vcpu, u32 *eax, u32 *ebx,
1459 u32 *ecx, u32 *edx, bool exact_only)
1461 u32 orig_function = *eax, function = *eax, index = *ecx;
1462 struct kvm_cpuid_entry2 *entry;
1463 bool exact, used_max_basic = false;
1465 entry = kvm_find_cpuid_entry_index(vcpu, function, index);
1468 if (!entry && !exact_only) {
1469 entry = get_out_of_range_cpuid_entry(vcpu, &function, index);
1470 used_max_basic = !!entry;
1478 if (function == 7 && index == 0) {
1480 if (!__kvm_get_msr(vcpu, MSR_IA32_TSX_CTRL, &data, true) &&
1481 (data & TSX_CTRL_CPUID_CLEAR))
1482 *ebx &= ~(F(RTM) | F(HLE));
1485 *eax = *ebx = *ecx = *edx = 0;
1487 * When leaf 0BH or 1FH is defined, CL is pass-through
1488 * and EDX is always the x2APIC ID, even for undefined
1489 * subleaves. Index 1 will exist iff the leaf is
1490 * implemented, so we pass through CL iff leaf 1
1491 * exists. EDX can be copied from any existing index.
1493 if (function == 0xb || function == 0x1f) {
1494 entry = kvm_find_cpuid_entry_index(vcpu, function, 1);
1496 *ecx = index & 0xff;
1501 trace_kvm_cpuid(orig_function, index, *eax, *ebx, *ecx, *edx, exact,
1505 EXPORT_SYMBOL_GPL(kvm_cpuid);
1507 int kvm_emulate_cpuid(struct kvm_vcpu *vcpu)
1509 u32 eax, ebx, ecx, edx;
1511 if (cpuid_fault_enabled(vcpu) && !kvm_require_cpl(vcpu, 0))
1514 eax = kvm_rax_read(vcpu);
1515 ecx = kvm_rcx_read(vcpu);
1516 kvm_cpuid(vcpu, &eax, &ebx, &ecx, &edx, false);
1517 kvm_rax_write(vcpu, eax);
1518 kvm_rbx_write(vcpu, ebx);
1519 kvm_rcx_write(vcpu, ecx);
1520 kvm_rdx_write(vcpu, edx);
1521 return kvm_skip_emulated_instruction(vcpu);
1523 EXPORT_SYMBOL_GPL(kvm_emulate_cpuid);