1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
6 * KVM x86 specific structures and definitions
10 #include <linux/types.h>
11 #include <linux/ioctl.h>
13 #define KVM_PIO_PAGE_OFFSET 1
14 #define KVM_COALESCED_MMIO_PAGE_OFFSET 2
35 /* Select x86 specific features in <linux/kvm.h> */
36 #define __KVM_HAVE_PIT
37 #define __KVM_HAVE_IOAPIC
38 #define __KVM_HAVE_IRQ_LINE
39 #define __KVM_HAVE_MSI
40 #define __KVM_HAVE_USER_NMI
41 #define __KVM_HAVE_GUEST_DEBUG
42 #define __KVM_HAVE_MSIX
43 #define __KVM_HAVE_MCE
44 #define __KVM_HAVE_PIT_STATE2
45 #define __KVM_HAVE_XEN_HVM
46 #define __KVM_HAVE_VCPU_EVENTS
47 #define __KVM_HAVE_DEBUGREGS
48 #define __KVM_HAVE_XSAVE
49 #define __KVM_HAVE_XCRS
50 #define __KVM_HAVE_READONLY_MEM
52 /* Architectural interrupt line count. */
53 #define KVM_NR_INTERRUPTS 256
55 struct kvm_memory_alias {
56 __u32 slot; /* this has a different namespace than memory slots */
58 __u64 guest_phys_addr;
60 __u64 target_phys_addr;
63 /* for KVM_GET_IRQCHIP and KVM_SET_IRQCHIP */
64 struct kvm_pic_state {
65 __u8 last_irr; /* edge detection */
66 __u8 irr; /* interrupt request register */
67 __u8 imr; /* interrupt mask register */
68 __u8 isr; /* interrupt service register */
69 __u8 priority_add; /* highest irq priority */
76 __u8 rotate_on_auto_eoi;
77 __u8 special_fully_nested_mode;
78 __u8 init4; /* true if 4 byte init */
79 __u8 elcr; /* PIIX edge/trigger selection */
83 #define KVM_IOAPIC_NUM_PINS 24
84 struct kvm_ioapic_state {
96 __u8 delivery_status:1;
105 } redirtbl[KVM_IOAPIC_NUM_PINS];
108 #define KVM_IRQCHIP_PIC_MASTER 0
109 #define KVM_IRQCHIP_PIC_SLAVE 1
110 #define KVM_IRQCHIP_IOAPIC 2
111 #define KVM_NR_IRQCHIPS 3
113 #define KVM_RUN_X86_SMM (1 << 0)
115 /* for KVM_GET_REGS and KVM_SET_REGS */
117 /* out (KVM_GET_REGS) / in (KVM_SET_REGS) */
118 __u64 rax, rbx, rcx, rdx;
119 __u64 rsi, rdi, rsp, rbp;
120 __u64 r8, r9, r10, r11;
121 __u64 r12, r13, r14, r15;
125 /* for KVM_GET_LAPIC and KVM_SET_LAPIC */
126 #define KVM_APIC_REG_SIZE 0x400
127 struct kvm_lapic_state {
128 char regs[KVM_APIC_REG_SIZE];
136 __u8 present, dpl, db, s, l, g, avl;
148 /* for KVM_GET_SREGS and KVM_SET_SREGS */
150 /* out (KVM_GET_SREGS) / in (KVM_SET_SREGS) */
151 struct kvm_segment cs, ds, es, fs, gs, ss;
152 struct kvm_segment tr, ldt;
153 struct kvm_dtable gdt, idt;
154 __u64 cr0, cr2, cr3, cr4, cr8;
157 __u64 interrupt_bitmap[(KVM_NR_INTERRUPTS + 63) / 64];
160 /* for KVM_GET_FPU and KVM_SET_FPU */
165 __u8 ftwx; /* in fxsave format */
175 struct kvm_msr_entry {
181 /* for KVM_GET_MSRS and KVM_SET_MSRS */
183 __u32 nmsrs; /* number of msrs in entries */
186 struct kvm_msr_entry entries[0];
189 /* for KVM_GET_MSR_INDEX_LIST */
190 struct kvm_msr_list {
191 __u32 nmsrs; /* number of msrs in entries */
195 /* Maximum size of any access bitmap in bytes */
196 #define KVM_MSR_FILTER_MAX_BITMAP_SIZE 0x600
198 /* for KVM_X86_SET_MSR_FILTER */
199 struct kvm_msr_filter_range {
200 #define KVM_MSR_FILTER_READ (1 << 0)
201 #define KVM_MSR_FILTER_WRITE (1 << 1)
203 __u32 nmsrs; /* number of msrs in bitmap */
204 __u32 base; /* MSR index the bitmap starts at */
205 __u8 *bitmap; /* a 1 bit allows the operations in flags, 0 denies */
208 #define KVM_MSR_FILTER_MAX_RANGES 16
209 struct kvm_msr_filter {
210 #define KVM_MSR_FILTER_DEFAULT_ALLOW (0 << 0)
211 #define KVM_MSR_FILTER_DEFAULT_DENY (1 << 0)
213 struct kvm_msr_filter_range ranges[KVM_MSR_FILTER_MAX_RANGES];
216 struct kvm_cpuid_entry {
225 /* for KVM_SET_CPUID */
229 struct kvm_cpuid_entry entries[0];
232 struct kvm_cpuid_entry2 {
243 #define KVM_CPUID_FLAG_SIGNIFCANT_INDEX (1 << 0)
244 #define KVM_CPUID_FLAG_STATEFUL_FUNC (1 << 1)
245 #define KVM_CPUID_FLAG_STATE_READ_NEXT (1 << 2)
247 /* for KVM_SET_CPUID2 */
251 struct kvm_cpuid_entry2 entries[0];
254 /* for KVM_GET_PIT and KVM_SET_PIT */
255 struct kvm_pit_channel_state {
256 __u32 count; /* can be 65536 */
268 __s64 count_load_time;
271 struct kvm_debug_exit_arch {
279 #define KVM_GUESTDBG_USE_SW_BP 0x00010000
280 #define KVM_GUESTDBG_USE_HW_BP 0x00020000
281 #define KVM_GUESTDBG_INJECT_DB 0x00040000
282 #define KVM_GUESTDBG_INJECT_BP 0x00080000
284 /* for KVM_SET_GUEST_DEBUG */
285 struct kvm_guest_debug_arch {
289 struct kvm_pit_state {
290 struct kvm_pit_channel_state channels[3];
293 #define KVM_PIT_FLAGS_HPET_LEGACY 0x00000001
295 struct kvm_pit_state2 {
296 struct kvm_pit_channel_state channels[3];
301 struct kvm_reinject_control {
306 /* When set in flags, include corresponding fields on KVM_SET_VCPU_EVENTS */
307 #define KVM_VCPUEVENT_VALID_NMI_PENDING 0x00000001
308 #define KVM_VCPUEVENT_VALID_SIPI_VECTOR 0x00000002
309 #define KVM_VCPUEVENT_VALID_SHADOW 0x00000004
310 #define KVM_VCPUEVENT_VALID_SMM 0x00000008
311 #define KVM_VCPUEVENT_VALID_PAYLOAD 0x00000010
313 /* Interrupt shadow states */
314 #define KVM_X86_SHADOW_INT_MOV_SS 0x01
315 #define KVM_X86_SHADOW_INT_STI 0x02
317 /* for KVM_GET/SET_VCPU_EVENTS */
318 struct kvm_vcpu_events {
347 __u8 exception_has_payload;
348 __u64 exception_payload;
351 /* for KVM_GET/SET_DEBUGREGS */
352 struct kvm_debugregs {
360 /* for KVM_CAP_XSAVE */
365 #define KVM_MAX_XCRS 16
376 struct kvm_xcr xcrs[KVM_MAX_XCRS];
380 #define KVM_SYNC_X86_REGS (1UL << 0)
381 #define KVM_SYNC_X86_SREGS (1UL << 1)
382 #define KVM_SYNC_X86_EVENTS (1UL << 2)
384 #define KVM_SYNC_X86_VALID_FIELDS \
385 (KVM_SYNC_X86_REGS| \
386 KVM_SYNC_X86_SREGS| \
389 /* kvm_sync_regs struct included by kvm_run struct */
390 struct kvm_sync_regs {
391 /* Members of this structure are potentially malicious.
392 * Care must be taken by code reading, esp. interpreting,
393 * data fields from them inside KVM to prevent TOCTOU and
394 * double-fetch types of vulnerabilities.
396 struct kvm_regs regs;
397 struct kvm_sregs sregs;
398 struct kvm_vcpu_events events;
401 #define KVM_X86_QUIRK_LINT0_REENABLED (1 << 0)
402 #define KVM_X86_QUIRK_CD_NW_CLEARED (1 << 1)
403 #define KVM_X86_QUIRK_LAPIC_MMIO_HOLE (1 << 2)
404 #define KVM_X86_QUIRK_OUT_7E_INC_RIP (1 << 3)
405 #define KVM_X86_QUIRK_MISC_ENABLE_NO_MWAIT (1 << 4)
407 #define KVM_STATE_NESTED_FORMAT_VMX 0
408 #define KVM_STATE_NESTED_FORMAT_SVM 1
410 #define KVM_STATE_NESTED_GUEST_MODE 0x00000001
411 #define KVM_STATE_NESTED_RUN_PENDING 0x00000002
412 #define KVM_STATE_NESTED_EVMCS 0x00000004
413 #define KVM_STATE_NESTED_MTF_PENDING 0x00000008
414 #define KVM_STATE_NESTED_GIF_SET 0x00000100
416 #define KVM_STATE_NESTED_SMM_GUEST_MODE 0x00000001
417 #define KVM_STATE_NESTED_SMM_VMXON 0x00000002
419 #define KVM_STATE_NESTED_VMX_VMCS_SIZE 0x1000
421 #define KVM_STATE_NESTED_SVM_VMCB_SIZE 0x1000
423 #define KVM_STATE_VMX_PREEMPTION_TIMER_DEADLINE 0x00000001
425 struct kvm_vmx_nested_state_data {
426 __u8 vmcs12[KVM_STATE_NESTED_VMX_VMCS_SIZE];
427 __u8 shadow_vmcs12[KVM_STATE_NESTED_VMX_VMCS_SIZE];
430 struct kvm_vmx_nested_state_hdr {
439 __u64 preemption_timer_deadline;
442 struct kvm_svm_nested_state_data {
443 /* Save area only used if KVM_STATE_NESTED_RUN_PENDING. */
444 __u8 vmcb12[KVM_STATE_NESTED_SVM_VMCB_SIZE];
447 struct kvm_svm_nested_state_hdr {
451 /* for KVM_CAP_NESTED_STATE */
452 struct kvm_nested_state {
458 struct kvm_vmx_nested_state_hdr vmx;
459 struct kvm_svm_nested_state_hdr svm;
461 /* Pad the header to 128 bytes. */
466 * Define data region as 0 bytes to preserve backwards-compatability
467 * to old definition of kvm_nested_state in order to avoid changing
468 * KVM_{GET,PUT}_NESTED_STATE ioctl values.
471 struct kvm_vmx_nested_state_data vmx[0];
472 struct kvm_svm_nested_state_data svm[0];
476 /* for KVM_CAP_PMU_EVENT_FILTER */
477 struct kvm_pmu_event_filter {
480 __u32 fixed_counter_bitmap;
486 #define KVM_PMU_EVENT_ALLOW 0
487 #define KVM_PMU_EVENT_DENY 1
489 #endif /* _ASM_X86_KVM_H */