1 /* SPDX-License-Identifier: GPL-2.0-only */
3 * tools/testing/selftests/kvm/include/x86_64/processor.h
5 * Copyright (C) 2018, Google LLC.
8 #ifndef SELFTEST_KVM_PROCESSOR_H
9 #define SELFTEST_KVM_PROCESSOR_H
15 #include <asm/msr-index.h>
16 #include <asm/prctl.h>
18 #include <linux/stringify.h>
20 #include "../kvm_util.h"
22 extern bool host_cpu_is_intel;
23 extern bool host_cpu_is_amd;
25 #define NMI_VECTOR 0x02
27 #define X86_EFLAGS_FIXED (1u << 1)
29 #define X86_CR4_VME (1ul << 0)
30 #define X86_CR4_PVI (1ul << 1)
31 #define X86_CR4_TSD (1ul << 2)
32 #define X86_CR4_DE (1ul << 3)
33 #define X86_CR4_PSE (1ul << 4)
34 #define X86_CR4_PAE (1ul << 5)
35 #define X86_CR4_MCE (1ul << 6)
36 #define X86_CR4_PGE (1ul << 7)
37 #define X86_CR4_PCE (1ul << 8)
38 #define X86_CR4_OSFXSR (1ul << 9)
39 #define X86_CR4_OSXMMEXCPT (1ul << 10)
40 #define X86_CR4_UMIP (1ul << 11)
41 #define X86_CR4_LA57 (1ul << 12)
42 #define X86_CR4_VMXE (1ul << 13)
43 #define X86_CR4_SMXE (1ul << 14)
44 #define X86_CR4_FSGSBASE (1ul << 16)
45 #define X86_CR4_PCIDE (1ul << 17)
46 #define X86_CR4_OSXSAVE (1ul << 18)
47 #define X86_CR4_SMEP (1ul << 20)
48 #define X86_CR4_SMAP (1ul << 21)
49 #define X86_CR4_PKE (1ul << 22)
51 struct xstate_header {
55 } __attribute__((packed));
59 struct xstate_header header;
60 u8 extended_state_area[0];
61 } __attribute__ ((packed, aligned (64)));
63 #define XFEATURE_MASK_FP BIT_ULL(0)
64 #define XFEATURE_MASK_SSE BIT_ULL(1)
65 #define XFEATURE_MASK_YMM BIT_ULL(2)
66 #define XFEATURE_MASK_BNDREGS BIT_ULL(3)
67 #define XFEATURE_MASK_BNDCSR BIT_ULL(4)
68 #define XFEATURE_MASK_OPMASK BIT_ULL(5)
69 #define XFEATURE_MASK_ZMM_Hi256 BIT_ULL(6)
70 #define XFEATURE_MASK_Hi16_ZMM BIT_ULL(7)
71 #define XFEATURE_MASK_XTILE_CFG BIT_ULL(17)
72 #define XFEATURE_MASK_XTILE_DATA BIT_ULL(18)
74 #define XFEATURE_MASK_AVX512 (XFEATURE_MASK_OPMASK | \
75 XFEATURE_MASK_ZMM_Hi256 | \
76 XFEATURE_MASK_Hi16_ZMM)
77 #define XFEATURE_MASK_XTILE (XFEATURE_MASK_XTILE_DATA | \
78 XFEATURE_MASK_XTILE_CFG)
80 /* Note, these are ordered alphabetically to match kvm_cpuid_entry2. Eww. */
81 enum cpuid_output_regs {
89 * Pack the information into a 64-bit value so that each X86_FEATURE_XXX can be
90 * passed by value with no overhead.
92 struct kvm_x86_cpu_feature {
98 #define KVM_X86_CPU_FEATURE(fn, idx, gpr, __bit) \
100 struct kvm_x86_cpu_feature feature = { \
103 .reg = KVM_CPUID_##gpr, \
107 kvm_static_assert((fn & 0xc0000000) == 0 || \
108 (fn & 0xc0000000) == 0x40000000 || \
109 (fn & 0xc0000000) == 0x80000000 || \
110 (fn & 0xc0000000) == 0xc0000000); \
111 kvm_static_assert(idx < BIT(sizeof(feature.index) * BITS_PER_BYTE)); \
116 * Basic Leafs, a.k.a. Intel defined
118 #define X86_FEATURE_MWAIT KVM_X86_CPU_FEATURE(0x1, 0, ECX, 3)
119 #define X86_FEATURE_VMX KVM_X86_CPU_FEATURE(0x1, 0, ECX, 5)
120 #define X86_FEATURE_SMX KVM_X86_CPU_FEATURE(0x1, 0, ECX, 6)
121 #define X86_FEATURE_PDCM KVM_X86_CPU_FEATURE(0x1, 0, ECX, 15)
122 #define X86_FEATURE_PCID KVM_X86_CPU_FEATURE(0x1, 0, ECX, 17)
123 #define X86_FEATURE_X2APIC KVM_X86_CPU_FEATURE(0x1, 0, ECX, 21)
124 #define X86_FEATURE_MOVBE KVM_X86_CPU_FEATURE(0x1, 0, ECX, 22)
125 #define X86_FEATURE_TSC_DEADLINE_TIMER KVM_X86_CPU_FEATURE(0x1, 0, ECX, 24)
126 #define X86_FEATURE_XSAVE KVM_X86_CPU_FEATURE(0x1, 0, ECX, 26)
127 #define X86_FEATURE_OSXSAVE KVM_X86_CPU_FEATURE(0x1, 0, ECX, 27)
128 #define X86_FEATURE_RDRAND KVM_X86_CPU_FEATURE(0x1, 0, ECX, 30)
129 #define X86_FEATURE_HYPERVISOR KVM_X86_CPU_FEATURE(0x1, 0, ECX, 31)
130 #define X86_FEATURE_PAE KVM_X86_CPU_FEATURE(0x1, 0, EDX, 6)
131 #define X86_FEATURE_MCE KVM_X86_CPU_FEATURE(0x1, 0, EDX, 7)
132 #define X86_FEATURE_APIC KVM_X86_CPU_FEATURE(0x1, 0, EDX, 9)
133 #define X86_FEATURE_CLFLUSH KVM_X86_CPU_FEATURE(0x1, 0, EDX, 19)
134 #define X86_FEATURE_XMM KVM_X86_CPU_FEATURE(0x1, 0, EDX, 25)
135 #define X86_FEATURE_XMM2 KVM_X86_CPU_FEATURE(0x1, 0, EDX, 26)
136 #define X86_FEATURE_FSGSBASE KVM_X86_CPU_FEATURE(0x7, 0, EBX, 0)
137 #define X86_FEATURE_TSC_ADJUST KVM_X86_CPU_FEATURE(0x7, 0, EBX, 1)
138 #define X86_FEATURE_SGX KVM_X86_CPU_FEATURE(0x7, 0, EBX, 2)
139 #define X86_FEATURE_HLE KVM_X86_CPU_FEATURE(0x7, 0, EBX, 4)
140 #define X86_FEATURE_SMEP KVM_X86_CPU_FEATURE(0x7, 0, EBX, 7)
141 #define X86_FEATURE_INVPCID KVM_X86_CPU_FEATURE(0x7, 0, EBX, 10)
142 #define X86_FEATURE_RTM KVM_X86_CPU_FEATURE(0x7, 0, EBX, 11)
143 #define X86_FEATURE_MPX KVM_X86_CPU_FEATURE(0x7, 0, EBX, 14)
144 #define X86_FEATURE_SMAP KVM_X86_CPU_FEATURE(0x7, 0, EBX, 20)
145 #define X86_FEATURE_PCOMMIT KVM_X86_CPU_FEATURE(0x7, 0, EBX, 22)
146 #define X86_FEATURE_CLFLUSHOPT KVM_X86_CPU_FEATURE(0x7, 0, EBX, 23)
147 #define X86_FEATURE_CLWB KVM_X86_CPU_FEATURE(0x7, 0, EBX, 24)
148 #define X86_FEATURE_UMIP KVM_X86_CPU_FEATURE(0x7, 0, ECX, 2)
149 #define X86_FEATURE_PKU KVM_X86_CPU_FEATURE(0x7, 0, ECX, 3)
150 #define X86_FEATURE_LA57 KVM_X86_CPU_FEATURE(0x7, 0, ECX, 16)
151 #define X86_FEATURE_RDPID KVM_X86_CPU_FEATURE(0x7, 0, ECX, 22)
152 #define X86_FEATURE_SGX_LC KVM_X86_CPU_FEATURE(0x7, 0, ECX, 30)
153 #define X86_FEATURE_SHSTK KVM_X86_CPU_FEATURE(0x7, 0, ECX, 7)
154 #define X86_FEATURE_IBT KVM_X86_CPU_FEATURE(0x7, 0, EDX, 20)
155 #define X86_FEATURE_AMX_TILE KVM_X86_CPU_FEATURE(0x7, 0, EDX, 24)
156 #define X86_FEATURE_SPEC_CTRL KVM_X86_CPU_FEATURE(0x7, 0, EDX, 26)
157 #define X86_FEATURE_ARCH_CAPABILITIES KVM_X86_CPU_FEATURE(0x7, 0, EDX, 29)
158 #define X86_FEATURE_PKS KVM_X86_CPU_FEATURE(0x7, 0, ECX, 31)
159 #define X86_FEATURE_XTILECFG KVM_X86_CPU_FEATURE(0xD, 0, EAX, 17)
160 #define X86_FEATURE_XTILEDATA KVM_X86_CPU_FEATURE(0xD, 0, EAX, 18)
161 #define X86_FEATURE_XSAVES KVM_X86_CPU_FEATURE(0xD, 1, EAX, 3)
162 #define X86_FEATURE_XFD KVM_X86_CPU_FEATURE(0xD, 1, EAX, 4)
163 #define X86_FEATURE_XTILEDATA_XFD KVM_X86_CPU_FEATURE(0xD, 18, ECX, 2)
166 * Extended Leafs, a.k.a. AMD defined
168 #define X86_FEATURE_SVM KVM_X86_CPU_FEATURE(0x80000001, 0, ECX, 2)
169 #define X86_FEATURE_NX KVM_X86_CPU_FEATURE(0x80000001, 0, EDX, 20)
170 #define X86_FEATURE_GBPAGES KVM_X86_CPU_FEATURE(0x80000001, 0, EDX, 26)
171 #define X86_FEATURE_RDTSCP KVM_X86_CPU_FEATURE(0x80000001, 0, EDX, 27)
172 #define X86_FEATURE_LM KVM_X86_CPU_FEATURE(0x80000001, 0, EDX, 29)
173 #define X86_FEATURE_INVTSC KVM_X86_CPU_FEATURE(0x80000007, 0, EDX, 8)
174 #define X86_FEATURE_RDPRU KVM_X86_CPU_FEATURE(0x80000008, 0, EBX, 4)
175 #define X86_FEATURE_AMD_IBPB KVM_X86_CPU_FEATURE(0x80000008, 0, EBX, 12)
176 #define X86_FEATURE_NPT KVM_X86_CPU_FEATURE(0x8000000A, 0, EDX, 0)
177 #define X86_FEATURE_LBRV KVM_X86_CPU_FEATURE(0x8000000A, 0, EDX, 1)
178 #define X86_FEATURE_NRIPS KVM_X86_CPU_FEATURE(0x8000000A, 0, EDX, 3)
179 #define X86_FEATURE_TSCRATEMSR KVM_X86_CPU_FEATURE(0x8000000A, 0, EDX, 4)
180 #define X86_FEATURE_PAUSEFILTER KVM_X86_CPU_FEATURE(0x8000000A, 0, EDX, 10)
181 #define X86_FEATURE_PFTHRESHOLD KVM_X86_CPU_FEATURE(0x8000000A, 0, EDX, 12)
182 #define X86_FEATURE_VGIF KVM_X86_CPU_FEATURE(0x8000000A, 0, EDX, 16)
183 #define X86_FEATURE_SEV KVM_X86_CPU_FEATURE(0x8000001F, 0, EAX, 1)
184 #define X86_FEATURE_SEV_ES KVM_X86_CPU_FEATURE(0x8000001F, 0, EAX, 3)
187 * KVM defined paravirt features.
189 #define X86_FEATURE_KVM_CLOCKSOURCE KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 0)
190 #define X86_FEATURE_KVM_NOP_IO_DELAY KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 1)
191 #define X86_FEATURE_KVM_MMU_OP KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 2)
192 #define X86_FEATURE_KVM_CLOCKSOURCE2 KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 3)
193 #define X86_FEATURE_KVM_ASYNC_PF KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 4)
194 #define X86_FEATURE_KVM_STEAL_TIME KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 5)
195 #define X86_FEATURE_KVM_PV_EOI KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 6)
196 #define X86_FEATURE_KVM_PV_UNHALT KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 7)
197 /* Bit 8 apparently isn't used?!?! */
198 #define X86_FEATURE_KVM_PV_TLB_FLUSH KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 9)
199 #define X86_FEATURE_KVM_ASYNC_PF_VMEXIT KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 10)
200 #define X86_FEATURE_KVM_PV_SEND_IPI KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 11)
201 #define X86_FEATURE_KVM_POLL_CONTROL KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 12)
202 #define X86_FEATURE_KVM_PV_SCHED_YIELD KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 13)
203 #define X86_FEATURE_KVM_ASYNC_PF_INT KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 14)
204 #define X86_FEATURE_KVM_MSI_EXT_DEST_ID KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 15)
205 #define X86_FEATURE_KVM_HC_MAP_GPA_RANGE KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 16)
206 #define X86_FEATURE_KVM_MIGRATION_CONTROL KVM_X86_CPU_FEATURE(0x40000001, 0, EAX, 17)
209 * Same idea as X86_FEATURE_XXX, but X86_PROPERTY_XXX retrieves a multi-bit
210 * value/property as opposed to a single-bit feature. Again, pack the info
211 * into a 64-bit value to pass by value with no overhead.
213 struct kvm_x86_cpu_property {
220 #define KVM_X86_CPU_PROPERTY(fn, idx, gpr, low_bit, high_bit) \
222 struct kvm_x86_cpu_property property = { \
225 .reg = KVM_CPUID_##gpr, \
227 .hi_bit = high_bit, \
230 kvm_static_assert(low_bit < high_bit); \
231 kvm_static_assert((fn & 0xc0000000) == 0 || \
232 (fn & 0xc0000000) == 0x40000000 || \
233 (fn & 0xc0000000) == 0x80000000 || \
234 (fn & 0xc0000000) == 0xc0000000); \
235 kvm_static_assert(idx < BIT(sizeof(property.index) * BITS_PER_BYTE)); \
239 #define X86_PROPERTY_MAX_BASIC_LEAF KVM_X86_CPU_PROPERTY(0, 0, EAX, 0, 31)
240 #define X86_PROPERTY_PMU_VERSION KVM_X86_CPU_PROPERTY(0xa, 0, EAX, 0, 7)
241 #define X86_PROPERTY_PMU_NR_GP_COUNTERS KVM_X86_CPU_PROPERTY(0xa, 0, EAX, 8, 15)
242 #define X86_PROPERTY_PMU_EBX_BIT_VECTOR_LENGTH KVM_X86_CPU_PROPERTY(0xa, 0, EAX, 24, 31)
244 #define X86_PROPERTY_XSTATE_MAX_SIZE_XCR0 KVM_X86_CPU_PROPERTY(0xd, 0, EBX, 0, 31)
245 #define X86_PROPERTY_XSTATE_MAX_SIZE KVM_X86_CPU_PROPERTY(0xd, 0, ECX, 0, 31)
246 #define X86_PROPERTY_XSTATE_TILE_SIZE KVM_X86_CPU_PROPERTY(0xd, 18, EAX, 0, 31)
247 #define X86_PROPERTY_XSTATE_TILE_OFFSET KVM_X86_CPU_PROPERTY(0xd, 18, EBX, 0, 31)
248 #define X86_PROPERTY_AMX_MAX_PALETTE_TABLES KVM_X86_CPU_PROPERTY(0x1d, 0, EAX, 0, 31)
249 #define X86_PROPERTY_AMX_TOTAL_TILE_BYTES KVM_X86_CPU_PROPERTY(0x1d, 1, EAX, 0, 15)
250 #define X86_PROPERTY_AMX_BYTES_PER_TILE KVM_X86_CPU_PROPERTY(0x1d, 1, EAX, 16, 31)
251 #define X86_PROPERTY_AMX_BYTES_PER_ROW KVM_X86_CPU_PROPERTY(0x1d, 1, EBX, 0, 15)
252 #define X86_PROPERTY_AMX_NR_TILE_REGS KVM_X86_CPU_PROPERTY(0x1d, 1, EBX, 16, 31)
253 #define X86_PROPERTY_AMX_MAX_ROWS KVM_X86_CPU_PROPERTY(0x1d, 1, ECX, 0, 15)
255 #define X86_PROPERTY_MAX_KVM_LEAF KVM_X86_CPU_PROPERTY(0x40000000, 0, EAX, 0, 31)
257 #define X86_PROPERTY_MAX_EXT_LEAF KVM_X86_CPU_PROPERTY(0x80000000, 0, EAX, 0, 31)
258 #define X86_PROPERTY_MAX_PHY_ADDR KVM_X86_CPU_PROPERTY(0x80000008, 0, EAX, 0, 7)
259 #define X86_PROPERTY_MAX_VIRT_ADDR KVM_X86_CPU_PROPERTY(0x80000008, 0, EAX, 8, 15)
260 #define X86_PROPERTY_PHYS_ADDR_REDUCTION KVM_X86_CPU_PROPERTY(0x8000001F, 0, EBX, 6, 11)
262 #define X86_PROPERTY_MAX_CENTAUR_LEAF KVM_X86_CPU_PROPERTY(0xC0000000, 0, EAX, 0, 31)
265 * Intel's architectural PMU events are bizarre. They have a "feature" bit
266 * that indicates the feature is _not_ supported, and a property that states
267 * the length of the bit mask of unsupported features. A feature is supported
268 * if the size of the bit mask is larger than the "unavailable" bit, and said
271 * Wrap the "unavailable" feature to simplify checking whether or not a given
272 * architectural event is supported.
274 struct kvm_x86_pmu_feature {
275 struct kvm_x86_cpu_feature anti_feature;
277 #define KVM_X86_PMU_FEATURE(name, __bit) \
279 struct kvm_x86_pmu_feature feature = { \
280 .anti_feature = KVM_X86_CPU_FEATURE(0xa, 0, EBX, __bit), \
286 #define X86_PMU_FEATURE_BRANCH_INSNS_RETIRED KVM_X86_PMU_FEATURE(BRANCH_INSNS_RETIRED, 5)
288 static inline unsigned int x86_family(unsigned int eax)
292 x86 = (eax >> 8) & 0xf;
295 x86 += (eax >> 20) & 0xff;
300 static inline unsigned int x86_model(unsigned int eax)
302 return ((eax >> 12) & 0xf0) | ((eax >> 4) & 0x0f);
305 /* Page table bitfield declarations */
306 #define PTE_PRESENT_MASK BIT_ULL(0)
307 #define PTE_WRITABLE_MASK BIT_ULL(1)
308 #define PTE_USER_MASK BIT_ULL(2)
309 #define PTE_ACCESSED_MASK BIT_ULL(5)
310 #define PTE_DIRTY_MASK BIT_ULL(6)
311 #define PTE_LARGE_MASK BIT_ULL(7)
312 #define PTE_GLOBAL_MASK BIT_ULL(8)
313 #define PTE_NX_MASK BIT_ULL(63)
315 #define PHYSICAL_PAGE_MASK GENMASK_ULL(51, 12)
317 #define PAGE_SHIFT 12
318 #define PAGE_SIZE (1ULL << PAGE_SHIFT)
319 #define PAGE_MASK (~(PAGE_SIZE-1) & PHYSICAL_PAGE_MASK)
321 #define HUGEPAGE_SHIFT(x) (PAGE_SHIFT + (((x) - 1) * 9))
322 #define HUGEPAGE_SIZE(x) (1UL << HUGEPAGE_SHIFT(x))
323 #define HUGEPAGE_MASK(x) (~(HUGEPAGE_SIZE(x) - 1) & PHYSICAL_PAGE_MASK)
325 #define PTE_GET_PA(pte) ((pte) & PHYSICAL_PAGE_MASK)
326 #define PTE_GET_PFN(pte) (PTE_GET_PA(pte) >> PAGE_SHIFT)
328 /* General Registers in 64-Bit Mode */
351 unsigned base1:8, type:4, s:1, dpl:2, p:1;
352 unsigned limit1:4, avl:1, l:1, db:1, g:1, base2:8;
355 } __attribute__((packed));
360 } __attribute__((packed));
362 struct kvm_x86_state {
363 struct kvm_xsave *xsave;
364 struct kvm_vcpu_events events;
365 struct kvm_mp_state mp_state;
366 struct kvm_regs regs;
367 struct kvm_xcrs xcrs;
368 struct kvm_sregs sregs;
369 struct kvm_debugregs debugregs;
371 struct kvm_nested_state nested;
374 struct kvm_msrs msrs;
377 static inline uint64_t get_desc64_base(const struct desc64 *desc)
379 return ((uint64_t)desc->base3 << 32) |
380 (desc->base0 | ((desc->base1) << 16) | ((desc->base2) << 24));
383 static inline uint64_t rdtsc(void)
388 * The lfence is to wait (on Intel CPUs) until all previous
389 * instructions have been executed. If software requires RDTSC to be
390 * executed prior to execution of any subsequent instruction, it can
391 * execute LFENCE immediately after RDTSC
393 __asm__ __volatile__("lfence; rdtsc; lfence" : "=a"(eax), "=d"(edx));
394 tsc_val = ((uint64_t)edx) << 32 | eax;
398 static inline uint64_t rdtscp(uint32_t *aux)
402 __asm__ __volatile__("rdtscp" : "=a"(eax), "=d"(edx), "=c"(*aux));
403 return ((uint64_t)edx) << 32 | eax;
406 static inline uint64_t rdmsr(uint32_t msr)
410 __asm__ __volatile__("rdmsr" : "=a"(a), "=d"(d) : "c"(msr) : "memory");
412 return a | ((uint64_t) d << 32);
415 static inline void wrmsr(uint32_t msr, uint64_t value)
418 uint32_t d = value >> 32;
420 __asm__ __volatile__("wrmsr" :: "a"(a), "d"(d), "c"(msr) : "memory");
424 static inline uint16_t inw(uint16_t port)
428 __asm__ __volatile__("in %%dx, %%ax"
429 : /* output */ "=a" (tmp)
430 : /* input */ "d" (port));
435 static inline uint16_t get_es(void)
439 __asm__ __volatile__("mov %%es, %[es]"
440 : /* output */ [es]"=rm"(es));
444 static inline uint16_t get_cs(void)
448 __asm__ __volatile__("mov %%cs, %[cs]"
449 : /* output */ [cs]"=rm"(cs));
453 static inline uint16_t get_ss(void)
457 __asm__ __volatile__("mov %%ss, %[ss]"
458 : /* output */ [ss]"=rm"(ss));
462 static inline uint16_t get_ds(void)
466 __asm__ __volatile__("mov %%ds, %[ds]"
467 : /* output */ [ds]"=rm"(ds));
471 static inline uint16_t get_fs(void)
475 __asm__ __volatile__("mov %%fs, %[fs]"
476 : /* output */ [fs]"=rm"(fs));
480 static inline uint16_t get_gs(void)
484 __asm__ __volatile__("mov %%gs, %[gs]"
485 : /* output */ [gs]"=rm"(gs));
489 static inline uint16_t get_tr(void)
493 __asm__ __volatile__("str %[tr]"
494 : /* output */ [tr]"=rm"(tr));
498 static inline uint64_t get_cr0(void)
502 __asm__ __volatile__("mov %%cr0, %[cr0]"
503 : /* output */ [cr0]"=r"(cr0));
507 static inline uint64_t get_cr3(void)
511 __asm__ __volatile__("mov %%cr3, %[cr3]"
512 : /* output */ [cr3]"=r"(cr3));
516 static inline uint64_t get_cr4(void)
520 __asm__ __volatile__("mov %%cr4, %[cr4]"
521 : /* output */ [cr4]"=r"(cr4));
525 static inline void set_cr4(uint64_t val)
527 __asm__ __volatile__("mov %0, %%cr4" : : "r" (val) : "memory");
530 static inline u64 xgetbv(u32 index)
534 __asm__ __volatile__("xgetbv;"
535 : "=a" (eax), "=d" (edx)
537 return eax | ((u64)edx << 32);
540 static inline void xsetbv(u32 index, u64 value)
543 u32 edx = value >> 32;
545 __asm__ __volatile__("xsetbv" :: "a" (eax), "d" (edx), "c" (index));
548 static inline struct desc_ptr get_gdt(void)
551 __asm__ __volatile__("sgdt %[gdt]"
552 : /* output */ [gdt]"=m"(gdt));
556 static inline struct desc_ptr get_idt(void)
559 __asm__ __volatile__("sidt %[idt]"
560 : /* output */ [idt]"=m"(idt));
564 static inline void outl(uint16_t port, uint32_t value)
566 __asm__ __volatile__("outl %%eax, %%dx" : : "d"(port), "a"(value));
569 static inline void __cpuid(uint32_t function, uint32_t index,
570 uint32_t *eax, uint32_t *ebx,
571 uint32_t *ecx, uint32_t *edx)
581 : "0" (*eax), "2" (*ecx)
585 static inline void cpuid(uint32_t function,
586 uint32_t *eax, uint32_t *ebx,
587 uint32_t *ecx, uint32_t *edx)
589 return __cpuid(function, 0, eax, ebx, ecx, edx);
592 static inline uint32_t this_cpu_fms(void)
594 uint32_t eax, ebx, ecx, edx;
596 cpuid(1, &eax, &ebx, &ecx, &edx);
600 static inline uint32_t this_cpu_family(void)
602 return x86_family(this_cpu_fms());
605 static inline uint32_t this_cpu_model(void)
607 return x86_model(this_cpu_fms());
610 static inline bool this_cpu_vendor_string_is(const char *vendor)
612 const uint32_t *chunk = (const uint32_t *)vendor;
613 uint32_t eax, ebx, ecx, edx;
615 cpuid(0, &eax, &ebx, &ecx, &edx);
616 return (ebx == chunk[0] && edx == chunk[1] && ecx == chunk[2]);
619 static inline bool this_cpu_is_intel(void)
621 return this_cpu_vendor_string_is("GenuineIntel");
625 * Exclude early K5 samples with a vendor string of "AMDisbetter!"
627 static inline bool this_cpu_is_amd(void)
629 return this_cpu_vendor_string_is("AuthenticAMD");
632 static inline uint32_t __this_cpu_has(uint32_t function, uint32_t index,
633 uint8_t reg, uint8_t lo, uint8_t hi)
637 __cpuid(function, index,
638 &gprs[KVM_CPUID_EAX], &gprs[KVM_CPUID_EBX],
639 &gprs[KVM_CPUID_ECX], &gprs[KVM_CPUID_EDX]);
641 return (gprs[reg] & GENMASK(hi, lo)) >> lo;
644 static inline bool this_cpu_has(struct kvm_x86_cpu_feature feature)
646 return __this_cpu_has(feature.function, feature.index,
647 feature.reg, feature.bit, feature.bit);
650 static inline uint32_t this_cpu_property(struct kvm_x86_cpu_property property)
652 return __this_cpu_has(property.function, property.index,
653 property.reg, property.lo_bit, property.hi_bit);
656 static __always_inline bool this_cpu_has_p(struct kvm_x86_cpu_property property)
660 switch (property.function & 0xc0000000) {
662 max_leaf = this_cpu_property(X86_PROPERTY_MAX_BASIC_LEAF);
665 max_leaf = this_cpu_property(X86_PROPERTY_MAX_KVM_LEAF);
668 max_leaf = this_cpu_property(X86_PROPERTY_MAX_EXT_LEAF);
671 max_leaf = this_cpu_property(X86_PROPERTY_MAX_CENTAUR_LEAF);
673 return max_leaf >= property.function;
676 static inline bool this_pmu_has(struct kvm_x86_pmu_feature feature)
678 uint32_t nr_bits = this_cpu_property(X86_PROPERTY_PMU_EBX_BIT_VECTOR_LENGTH);
680 return nr_bits > feature.anti_feature.bit &&
681 !this_cpu_has(feature.anti_feature);
684 typedef u32 __attribute__((vector_size(16))) sse128_t;
685 #define __sse128_u union { sse128_t vec; u64 as_u64[2]; u32 as_u32[4]; }
686 #define sse128_lo(x) ({ __sse128_u t; t.vec = x; t.as_u64[0]; })
687 #define sse128_hi(x) ({ __sse128_u t; t.vec = x; t.as_u64[1]; })
689 static inline void read_sse_reg(int reg, sse128_t *data)
693 asm("movdqa %%xmm0, %0" : "=m"(*data));
696 asm("movdqa %%xmm1, %0" : "=m"(*data));
699 asm("movdqa %%xmm2, %0" : "=m"(*data));
702 asm("movdqa %%xmm3, %0" : "=m"(*data));
705 asm("movdqa %%xmm4, %0" : "=m"(*data));
708 asm("movdqa %%xmm5, %0" : "=m"(*data));
711 asm("movdqa %%xmm6, %0" : "=m"(*data));
714 asm("movdqa %%xmm7, %0" : "=m"(*data));
721 static inline void write_sse_reg(int reg, const sse128_t *data)
725 asm("movdqa %0, %%xmm0" : : "m"(*data));
728 asm("movdqa %0, %%xmm1" : : "m"(*data));
731 asm("movdqa %0, %%xmm2" : : "m"(*data));
734 asm("movdqa %0, %%xmm3" : : "m"(*data));
737 asm("movdqa %0, %%xmm4" : : "m"(*data));
740 asm("movdqa %0, %%xmm5" : : "m"(*data));
743 asm("movdqa %0, %%xmm6" : : "m"(*data));
746 asm("movdqa %0, %%xmm7" : : "m"(*data));
753 static inline void cpu_relax(void)
755 asm volatile("rep; nop" ::: "memory");
759 __asm__ __volatile__( \
764 __asm__ __volatile__( \
768 struct kvm_x86_state *vcpu_save_state(struct kvm_vcpu *vcpu);
769 void vcpu_load_state(struct kvm_vcpu *vcpu, struct kvm_x86_state *state);
770 void kvm_x86_state_cleanup(struct kvm_x86_state *state);
772 const struct kvm_msr_list *kvm_get_msr_index_list(void);
773 const struct kvm_msr_list *kvm_get_feature_msr_index_list(void);
774 bool kvm_msr_is_in_save_restore_list(uint32_t msr_index);
775 uint64_t kvm_get_feature_msr(uint64_t msr_index);
777 static inline void vcpu_msrs_get(struct kvm_vcpu *vcpu,
778 struct kvm_msrs *msrs)
780 int r = __vcpu_ioctl(vcpu, KVM_GET_MSRS, msrs);
782 TEST_ASSERT(r == msrs->nmsrs,
783 "KVM_GET_MSRS failed, r: %i (failed on MSR %x)",
784 r, r < 0 || r >= msrs->nmsrs ? -1 : msrs->entries[r].index);
786 static inline void vcpu_msrs_set(struct kvm_vcpu *vcpu, struct kvm_msrs *msrs)
788 int r = __vcpu_ioctl(vcpu, KVM_SET_MSRS, msrs);
790 TEST_ASSERT(r == msrs->nmsrs,
791 "KVM_SET_MSRS failed, r: %i (failed on MSR %x)",
792 r, r < 0 || r >= msrs->nmsrs ? -1 : msrs->entries[r].index);
794 static inline void vcpu_debugregs_get(struct kvm_vcpu *vcpu,
795 struct kvm_debugregs *debugregs)
797 vcpu_ioctl(vcpu, KVM_GET_DEBUGREGS, debugregs);
799 static inline void vcpu_debugregs_set(struct kvm_vcpu *vcpu,
800 struct kvm_debugregs *debugregs)
802 vcpu_ioctl(vcpu, KVM_SET_DEBUGREGS, debugregs);
804 static inline void vcpu_xsave_get(struct kvm_vcpu *vcpu,
805 struct kvm_xsave *xsave)
807 vcpu_ioctl(vcpu, KVM_GET_XSAVE, xsave);
809 static inline void vcpu_xsave2_get(struct kvm_vcpu *vcpu,
810 struct kvm_xsave *xsave)
812 vcpu_ioctl(vcpu, KVM_GET_XSAVE2, xsave);
814 static inline void vcpu_xsave_set(struct kvm_vcpu *vcpu,
815 struct kvm_xsave *xsave)
817 vcpu_ioctl(vcpu, KVM_SET_XSAVE, xsave);
819 static inline void vcpu_xcrs_get(struct kvm_vcpu *vcpu,
820 struct kvm_xcrs *xcrs)
822 vcpu_ioctl(vcpu, KVM_GET_XCRS, xcrs);
824 static inline void vcpu_xcrs_set(struct kvm_vcpu *vcpu, struct kvm_xcrs *xcrs)
826 vcpu_ioctl(vcpu, KVM_SET_XCRS, xcrs);
829 const struct kvm_cpuid_entry2 *get_cpuid_entry(const struct kvm_cpuid2 *cpuid,
830 uint32_t function, uint32_t index);
831 const struct kvm_cpuid2 *kvm_get_supported_cpuid(void);
832 const struct kvm_cpuid2 *kvm_get_supported_hv_cpuid(void);
833 const struct kvm_cpuid2 *vcpu_get_supported_hv_cpuid(struct kvm_vcpu *vcpu);
835 static inline uint32_t kvm_cpu_fms(void)
837 return get_cpuid_entry(kvm_get_supported_cpuid(), 0x1, 0)->eax;
840 static inline uint32_t kvm_cpu_family(void)
842 return x86_family(kvm_cpu_fms());
845 static inline uint32_t kvm_cpu_model(void)
847 return x86_model(kvm_cpu_fms());
850 bool kvm_cpuid_has(const struct kvm_cpuid2 *cpuid,
851 struct kvm_x86_cpu_feature feature);
853 static inline bool kvm_cpu_has(struct kvm_x86_cpu_feature feature)
855 return kvm_cpuid_has(kvm_get_supported_cpuid(), feature);
858 uint32_t kvm_cpuid_property(const struct kvm_cpuid2 *cpuid,
859 struct kvm_x86_cpu_property property);
861 static inline uint32_t kvm_cpu_property(struct kvm_x86_cpu_property property)
863 return kvm_cpuid_property(kvm_get_supported_cpuid(), property);
866 static __always_inline bool kvm_cpu_has_p(struct kvm_x86_cpu_property property)
870 switch (property.function & 0xc0000000) {
872 max_leaf = kvm_cpu_property(X86_PROPERTY_MAX_BASIC_LEAF);
875 max_leaf = kvm_cpu_property(X86_PROPERTY_MAX_KVM_LEAF);
878 max_leaf = kvm_cpu_property(X86_PROPERTY_MAX_EXT_LEAF);
881 max_leaf = kvm_cpu_property(X86_PROPERTY_MAX_CENTAUR_LEAF);
883 return max_leaf >= property.function;
886 static inline bool kvm_pmu_has(struct kvm_x86_pmu_feature feature)
888 uint32_t nr_bits = kvm_cpu_property(X86_PROPERTY_PMU_EBX_BIT_VECTOR_LENGTH);
890 return nr_bits > feature.anti_feature.bit &&
891 !kvm_cpu_has(feature.anti_feature);
894 static inline size_t kvm_cpuid2_size(int nr_entries)
896 return sizeof(struct kvm_cpuid2) +
897 sizeof(struct kvm_cpuid_entry2) * nr_entries;
901 * Allocate a "struct kvm_cpuid2* instance, with the 0-length arrary of
902 * entries sized to hold @nr_entries. The caller is responsible for freeing
905 static inline struct kvm_cpuid2 *allocate_kvm_cpuid2(int nr_entries)
907 struct kvm_cpuid2 *cpuid;
909 cpuid = malloc(kvm_cpuid2_size(nr_entries));
910 TEST_ASSERT(cpuid, "-ENOMEM when allocating kvm_cpuid2");
912 cpuid->nent = nr_entries;
917 void vcpu_init_cpuid(struct kvm_vcpu *vcpu, const struct kvm_cpuid2 *cpuid);
918 void vcpu_set_hv_cpuid(struct kvm_vcpu *vcpu);
920 static inline struct kvm_cpuid_entry2 *__vcpu_get_cpuid_entry(struct kvm_vcpu *vcpu,
924 return (struct kvm_cpuid_entry2 *)get_cpuid_entry(vcpu->cpuid,
928 static inline struct kvm_cpuid_entry2 *vcpu_get_cpuid_entry(struct kvm_vcpu *vcpu,
931 return __vcpu_get_cpuid_entry(vcpu, function, 0);
934 static inline int __vcpu_set_cpuid(struct kvm_vcpu *vcpu)
938 TEST_ASSERT(vcpu->cpuid, "Must do vcpu_init_cpuid() first");
939 r = __vcpu_ioctl(vcpu, KVM_SET_CPUID2, vcpu->cpuid);
943 /* On success, refresh the cache to pick up adjustments made by KVM. */
944 vcpu_ioctl(vcpu, KVM_GET_CPUID2, vcpu->cpuid);
948 static inline void vcpu_set_cpuid(struct kvm_vcpu *vcpu)
950 TEST_ASSERT(vcpu->cpuid, "Must do vcpu_init_cpuid() first");
951 vcpu_ioctl(vcpu, KVM_SET_CPUID2, vcpu->cpuid);
953 /* Refresh the cache to pick up adjustments made by KVM. */
954 vcpu_ioctl(vcpu, KVM_GET_CPUID2, vcpu->cpuid);
957 void vcpu_set_cpuid_maxphyaddr(struct kvm_vcpu *vcpu, uint8_t maxphyaddr);
959 void vcpu_clear_cpuid_entry(struct kvm_vcpu *vcpu, uint32_t function);
960 void vcpu_set_or_clear_cpuid_feature(struct kvm_vcpu *vcpu,
961 struct kvm_x86_cpu_feature feature,
964 static inline void vcpu_set_cpuid_feature(struct kvm_vcpu *vcpu,
965 struct kvm_x86_cpu_feature feature)
967 vcpu_set_or_clear_cpuid_feature(vcpu, feature, true);
971 static inline void vcpu_clear_cpuid_feature(struct kvm_vcpu *vcpu,
972 struct kvm_x86_cpu_feature feature)
974 vcpu_set_or_clear_cpuid_feature(vcpu, feature, false);
977 uint64_t vcpu_get_msr(struct kvm_vcpu *vcpu, uint64_t msr_index);
978 int _vcpu_set_msr(struct kvm_vcpu *vcpu, uint64_t msr_index, uint64_t msr_value);
980 static inline void vcpu_set_msr(struct kvm_vcpu *vcpu, uint64_t msr_index,
983 int r = _vcpu_set_msr(vcpu, msr_index, msr_value);
985 TEST_ASSERT(r == 1, KVM_IOCTL_ERROR(KVM_SET_MSRS, r));
989 void kvm_get_cpu_address_width(unsigned int *pa_bits, unsigned int *va_bits);
990 bool vm_is_unrestricted_guest(struct kvm_vm *vm);
993 uint64_t rax, rcx, rdx, rbx;
994 uint64_t rbp, rsi, rdi;
995 uint64_t r8, r9, r10, r11;
996 uint64_t r12, r13, r14, r15;
1014 uint32_t offset2; uint32_t reserved;
1017 void vm_init_descriptor_tables(struct kvm_vm *vm);
1018 void vcpu_init_descriptor_tables(struct kvm_vcpu *vcpu);
1019 void vm_install_exception_handler(struct kvm_vm *vm, int vector,
1020 void (*handler)(struct ex_regs *));
1022 /* If a toddler were to say "abracadabra". */
1023 #define KVM_EXCEPTION_MAGIC 0xabacadabaULL
1026 * KVM selftest exception fixup uses registers to coordinate with the exception
1027 * handler, versus the kernel's in-memory tables and KVM-Unit-Tests's in-memory
1028 * per-CPU data. Using only registers avoids having to map memory into the
1029 * guest, doesn't require a valid, stable GS.base, and reduces the risk of
1030 * for recursive faults when accessing memory in the handler. The downside to
1031 * using registers is that it restricts what registers can be used by the actual
1032 * instruction. But, selftests are 64-bit only, making register* pressure a
1033 * minor concern. Use r9-r11 as they are volatile, i.e. don't need to be saved
1034 * by the callee, and except for r11 are not implicit parameters to any
1035 * instructions. Ideally, fixup would use r8-r10 and thus avoid implicit
1036 * parameters entirely, but Hyper-V's hypercall ABI uses r8 and testing Hyper-V
1037 * is higher priority than testing non-faulting SYSCALL/SYSRET.
1039 * Note, the fixup handler deliberately does not handle #DE, i.e. the vector
1040 * is guaranteed to be non-zero on fault.
1045 * r11 = new RIP on fault
1048 * r9 = exception vector (non-zero)
1051 #define KVM_ASM_SAFE(insn) \
1052 "mov $" __stringify(KVM_EXCEPTION_MAGIC) ", %%r9\n\t" \
1053 "lea 1f(%%rip), %%r10\n\t" \
1054 "lea 2f(%%rip), %%r11\n\t" \
1056 "xor %%r9, %%r9\n\t" \
1058 "mov %%r9b, %[vector]\n\t" \
1059 "mov %%r10, %[error_code]\n\t"
1061 #define KVM_ASM_SAFE_OUTPUTS(v, ec) [vector] "=qm"(v), [error_code] "=rm"(ec)
1062 #define KVM_ASM_SAFE_CLOBBERS "r9", "r10", "r11"
1064 #define kvm_asm_safe(insn, inputs...) \
1066 uint64_t ign_error_code; \
1069 asm volatile(KVM_ASM_SAFE(insn) \
1070 : KVM_ASM_SAFE_OUTPUTS(vector, ign_error_code) \
1072 : KVM_ASM_SAFE_CLOBBERS); \
1076 #define kvm_asm_safe_ec(insn, error_code, inputs...) \
1080 asm volatile(KVM_ASM_SAFE(insn) \
1081 : KVM_ASM_SAFE_OUTPUTS(vector, error_code) \
1083 : KVM_ASM_SAFE_CLOBBERS); \
1087 static inline uint8_t rdmsr_safe(uint32_t msr, uint64_t *val)
1089 uint64_t error_code;
1093 asm volatile(KVM_ASM_SAFE("rdmsr")
1094 : "=a"(a), "=d"(d), KVM_ASM_SAFE_OUTPUTS(vector, error_code)
1096 : KVM_ASM_SAFE_CLOBBERS);
1098 *val = (uint64_t)a | ((uint64_t)d << 32);
1102 static inline uint8_t wrmsr_safe(uint32_t msr, uint64_t val)
1104 return kvm_asm_safe("wrmsr", "a"(val & -1u), "d"(val >> 32), "c"(msr));
1107 bool kvm_is_tdp_enabled(void);
1109 uint64_t *__vm_get_page_table_entry(struct kvm_vm *vm, uint64_t vaddr,
1111 uint64_t *vm_get_page_table_entry(struct kvm_vm *vm, uint64_t vaddr);
1113 uint64_t kvm_hypercall(uint64_t nr, uint64_t a0, uint64_t a1, uint64_t a2,
1115 uint64_t __xen_hypercall(uint64_t nr, uint64_t a0, void *a1);
1116 void xen_hypercall(uint64_t nr, uint64_t a0, void *a1);
1118 void __vm_xsave_require_permission(uint64_t xfeature, const char *name);
1120 #define vm_xsave_require_permission(xfeature) \
1121 __vm_xsave_require_permission(xfeature, #xfeature)
1132 #define PG_LEVEL_SHIFT(_level) ((_level - 1) * 9 + 12)
1133 #define PG_LEVEL_SIZE(_level) (1ull << PG_LEVEL_SHIFT(_level))
1135 #define PG_SIZE_4K PG_LEVEL_SIZE(PG_LEVEL_4K)
1136 #define PG_SIZE_2M PG_LEVEL_SIZE(PG_LEVEL_2M)
1137 #define PG_SIZE_1G PG_LEVEL_SIZE(PG_LEVEL_1G)
1139 void __virt_pg_map(struct kvm_vm *vm, uint64_t vaddr, uint64_t paddr, int level);
1140 void virt_map_level(struct kvm_vm *vm, uint64_t vaddr, uint64_t paddr,
1141 uint64_t nr_bytes, int level);
1144 * Basic CPU control in CR0
1146 #define X86_CR0_PE (1UL<<0) /* Protection Enable */
1147 #define X86_CR0_MP (1UL<<1) /* Monitor Coprocessor */
1148 #define X86_CR0_EM (1UL<<2) /* Emulation */
1149 #define X86_CR0_TS (1UL<<3) /* Task Switched */
1150 #define X86_CR0_ET (1UL<<4) /* Extension Type */
1151 #define X86_CR0_NE (1UL<<5) /* Numeric Error */
1152 #define X86_CR0_WP (1UL<<16) /* Write Protect */
1153 #define X86_CR0_AM (1UL<<18) /* Alignment Mask */
1154 #define X86_CR0_NW (1UL<<29) /* Not Write-through */
1155 #define X86_CR0_CD (1UL<<30) /* Cache Disable */
1156 #define X86_CR0_PG (1UL<<31) /* Paging */
1158 #define PFERR_PRESENT_BIT 0
1159 #define PFERR_WRITE_BIT 1
1160 #define PFERR_USER_BIT 2
1161 #define PFERR_RSVD_BIT 3
1162 #define PFERR_FETCH_BIT 4
1163 #define PFERR_PK_BIT 5
1164 #define PFERR_SGX_BIT 15
1165 #define PFERR_GUEST_FINAL_BIT 32
1166 #define PFERR_GUEST_PAGE_BIT 33
1167 #define PFERR_IMPLICIT_ACCESS_BIT 48
1169 #define PFERR_PRESENT_MASK BIT(PFERR_PRESENT_BIT)
1170 #define PFERR_WRITE_MASK BIT(PFERR_WRITE_BIT)
1171 #define PFERR_USER_MASK BIT(PFERR_USER_BIT)
1172 #define PFERR_RSVD_MASK BIT(PFERR_RSVD_BIT)
1173 #define PFERR_FETCH_MASK BIT(PFERR_FETCH_BIT)
1174 #define PFERR_PK_MASK BIT(PFERR_PK_BIT)
1175 #define PFERR_SGX_MASK BIT(PFERR_SGX_BIT)
1176 #define PFERR_GUEST_FINAL_MASK BIT_ULL(PFERR_GUEST_FINAL_BIT)
1177 #define PFERR_GUEST_PAGE_MASK BIT_ULL(PFERR_GUEST_PAGE_BIT)
1178 #define PFERR_IMPLICIT_ACCESS BIT_ULL(PFERR_IMPLICIT_ACCESS_BIT)
1180 #endif /* SELFTEST_KVM_PROCESSOR_H */