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 */