xref: /qemu/linux-headers/linux/kvm.h (revision a372823a)
1 #ifndef __LINUX_KVM_H
2 #define __LINUX_KVM_H
3 
4 /*
5  * Userspace interface for /dev/kvm - kernel based virtual machine
6  *
7  * Note: you must update KVM_API_VERSION if you change this interface.
8  */
9 
10 #include <linux/types.h>
11 
12 #include <linux/ioctl.h>
13 #include <asm/kvm.h>
14 
15 #define KVM_API_VERSION 12
16 
17 /* *** Deprecated interfaces *** */
18 
19 #define KVM_TRC_SHIFT           16
20 
21 #define KVM_TRC_ENTRYEXIT       (1 << KVM_TRC_SHIFT)
22 #define KVM_TRC_HANDLER         (1 << (KVM_TRC_SHIFT + 1))
23 
24 #define KVM_TRC_VMENTRY         (KVM_TRC_ENTRYEXIT + 0x01)
25 #define KVM_TRC_VMEXIT          (KVM_TRC_ENTRYEXIT + 0x02)
26 #define KVM_TRC_PAGE_FAULT      (KVM_TRC_HANDLER + 0x01)
27 
28 #define KVM_TRC_HEAD_SIZE       12
29 #define KVM_TRC_CYCLE_SIZE      8
30 #define KVM_TRC_EXTRA_MAX       7
31 
32 #define KVM_TRC_INJ_VIRQ         (KVM_TRC_HANDLER + 0x02)
33 #define KVM_TRC_REDELIVER_EVT    (KVM_TRC_HANDLER + 0x03)
34 #define KVM_TRC_PEND_INTR        (KVM_TRC_HANDLER + 0x04)
35 #define KVM_TRC_IO_READ          (KVM_TRC_HANDLER + 0x05)
36 #define KVM_TRC_IO_WRITE         (KVM_TRC_HANDLER + 0x06)
37 #define KVM_TRC_CR_READ          (KVM_TRC_HANDLER + 0x07)
38 #define KVM_TRC_CR_WRITE         (KVM_TRC_HANDLER + 0x08)
39 #define KVM_TRC_DR_READ          (KVM_TRC_HANDLER + 0x09)
40 #define KVM_TRC_DR_WRITE         (KVM_TRC_HANDLER + 0x0A)
41 #define KVM_TRC_MSR_READ         (KVM_TRC_HANDLER + 0x0B)
42 #define KVM_TRC_MSR_WRITE        (KVM_TRC_HANDLER + 0x0C)
43 #define KVM_TRC_CPUID            (KVM_TRC_HANDLER + 0x0D)
44 #define KVM_TRC_INTR             (KVM_TRC_HANDLER + 0x0E)
45 #define KVM_TRC_NMI              (KVM_TRC_HANDLER + 0x0F)
46 #define KVM_TRC_VMMCALL          (KVM_TRC_HANDLER + 0x10)
47 #define KVM_TRC_HLT              (KVM_TRC_HANDLER + 0x11)
48 #define KVM_TRC_CLTS             (KVM_TRC_HANDLER + 0x12)
49 #define KVM_TRC_LMSW             (KVM_TRC_HANDLER + 0x13)
50 #define KVM_TRC_APIC_ACCESS      (KVM_TRC_HANDLER + 0x14)
51 #define KVM_TRC_TDP_FAULT        (KVM_TRC_HANDLER + 0x15)
52 #define KVM_TRC_GTLB_WRITE       (KVM_TRC_HANDLER + 0x16)
53 #define KVM_TRC_STLB_WRITE       (KVM_TRC_HANDLER + 0x17)
54 #define KVM_TRC_STLB_INVAL       (KVM_TRC_HANDLER + 0x18)
55 #define KVM_TRC_PPC_INSTR        (KVM_TRC_HANDLER + 0x19)
56 
57 struct kvm_user_trace_setup {
58 	__u32 buf_size;
59 	__u32 buf_nr;
60 };
61 
62 #define __KVM_DEPRECATED_MAIN_W_0x06 \
63 	_IOW(KVMIO, 0x06, struct kvm_user_trace_setup)
64 #define __KVM_DEPRECATED_MAIN_0x07 _IO(KVMIO, 0x07)
65 #define __KVM_DEPRECATED_MAIN_0x08 _IO(KVMIO, 0x08)
66 
67 #define __KVM_DEPRECATED_VM_R_0x70 _IOR(KVMIO, 0x70, struct kvm_assigned_irq)
68 
69 struct kvm_breakpoint {
70 	__u32 enabled;
71 	__u32 padding;
72 	__u64 address;
73 };
74 
75 struct kvm_debug_guest {
76 	__u32 enabled;
77 	__u32 pad;
78 	struct kvm_breakpoint breakpoints[4];
79 	__u32 singlestep;
80 };
81 
82 #define __KVM_DEPRECATED_VCPU_W_0x87 _IOW(KVMIO, 0x87, struct kvm_debug_guest)
83 
84 /* *** End of deprecated interfaces *** */
85 
86 
87 /* for KVM_CREATE_MEMORY_REGION */
88 struct kvm_memory_region {
89 	__u32 slot;
90 	__u32 flags;
91 	__u64 guest_phys_addr;
92 	__u64 memory_size; /* bytes */
93 };
94 
95 /* for KVM_SET_USER_MEMORY_REGION */
96 struct kvm_userspace_memory_region {
97 	__u32 slot;
98 	__u32 flags;
99 	__u64 guest_phys_addr;
100 	__u64 memory_size; /* bytes */
101 	__u64 userspace_addr; /* start of the userspace allocated memory */
102 };
103 
104 /*
105  * The bit 0 ~ bit 15 of kvm_memory_region::flags are visible for userspace,
106  * other bits are reserved for kvm internal use which are defined in
107  * include/linux/kvm_host.h.
108  */
109 #define KVM_MEM_LOG_DIRTY_PAGES	(1UL << 0)
110 #define KVM_MEM_READONLY	(1UL << 1)
111 
112 /* for KVM_IRQ_LINE */
113 struct kvm_irq_level {
114 	/*
115 	 * ACPI gsi notion of irq.
116 	 * For IA-64 (APIC model) IOAPIC0: irq 0-23; IOAPIC1: irq 24-47..
117 	 * For X86 (standard AT mode) PIC0/1: irq 0-15. IOAPIC0: 0-23..
118 	 */
119 	union {
120 		__u32 irq;
121 		__s32 status;
122 	};
123 	__u32 level;
124 };
125 
126 
127 struct kvm_irqchip {
128 	__u32 chip_id;
129 	__u32 pad;
130         union {
131 		char dummy[512];  /* reserving space */
132 #ifdef __KVM_HAVE_PIT
133 		struct kvm_pic_state pic;
134 #endif
135 #ifdef __KVM_HAVE_IOAPIC
136 		struct kvm_ioapic_state ioapic;
137 #endif
138 	} chip;
139 };
140 
141 /* for KVM_CREATE_PIT2 */
142 struct kvm_pit_config {
143 	__u32 flags;
144 	__u32 pad[15];
145 };
146 
147 #define KVM_PIT_SPEAKER_DUMMY     1
148 
149 #define KVM_EXIT_UNKNOWN          0
150 #define KVM_EXIT_EXCEPTION        1
151 #define KVM_EXIT_IO               2
152 #define KVM_EXIT_HYPERCALL        3
153 #define KVM_EXIT_DEBUG            4
154 #define KVM_EXIT_HLT              5
155 #define KVM_EXIT_MMIO             6
156 #define KVM_EXIT_IRQ_WINDOW_OPEN  7
157 #define KVM_EXIT_SHUTDOWN         8
158 #define KVM_EXIT_FAIL_ENTRY       9
159 #define KVM_EXIT_INTR             10
160 #define KVM_EXIT_SET_TPR          11
161 #define KVM_EXIT_TPR_ACCESS       12
162 #define KVM_EXIT_S390_SIEIC       13
163 #define KVM_EXIT_S390_RESET       14
164 #define KVM_EXIT_DCR              15
165 #define KVM_EXIT_NMI              16
166 #define KVM_EXIT_INTERNAL_ERROR   17
167 #define KVM_EXIT_OSI              18
168 #define KVM_EXIT_PAPR_HCALL	  19
169 #define KVM_EXIT_S390_UCONTROL	  20
170 #define KVM_EXIT_WATCHDOG         21
171 
172 /* For KVM_EXIT_INTERNAL_ERROR */
173 /* Emulate instruction failed. */
174 #define KVM_INTERNAL_ERROR_EMULATION	1
175 /* Encounter unexpected simultaneous exceptions. */
176 #define KVM_INTERNAL_ERROR_SIMUL_EX	2
177 /* Encounter unexpected vm-exit due to delivery event. */
178 #define KVM_INTERNAL_ERROR_DELIVERY_EV	3
179 
180 /* for KVM_RUN, returned by mmap(vcpu_fd, offset=0) */
181 struct kvm_run {
182 	/* in */
183 	__u8 request_interrupt_window;
184 	__u8 padding1[7];
185 
186 	/* out */
187 	__u32 exit_reason;
188 	__u8 ready_for_interrupt_injection;
189 	__u8 if_flag;
190 	__u8 padding2[2];
191 
192 	/* in (pre_kvm_run), out (post_kvm_run) */
193 	__u64 cr8;
194 	__u64 apic_base;
195 
196 #ifdef __KVM_S390
197 	/* the processor status word for s390 */
198 	__u64 psw_mask; /* psw upper half */
199 	__u64 psw_addr; /* psw lower half */
200 #endif
201 	union {
202 		/* KVM_EXIT_UNKNOWN */
203 		struct {
204 			__u64 hardware_exit_reason;
205 		} hw;
206 		/* KVM_EXIT_FAIL_ENTRY */
207 		struct {
208 			__u64 hardware_entry_failure_reason;
209 		} fail_entry;
210 		/* KVM_EXIT_EXCEPTION */
211 		struct {
212 			__u32 exception;
213 			__u32 error_code;
214 		} ex;
215 		/* KVM_EXIT_IO */
216 		struct {
217 #define KVM_EXIT_IO_IN  0
218 #define KVM_EXIT_IO_OUT 1
219 			__u8 direction;
220 			__u8 size; /* bytes */
221 			__u16 port;
222 			__u32 count;
223 			__u64 data_offset; /* relative to kvm_run start */
224 		} io;
225 		struct {
226 			struct kvm_debug_exit_arch arch;
227 		} debug;
228 		/* KVM_EXIT_MMIO */
229 		struct {
230 			__u64 phys_addr;
231 			__u8  data[8];
232 			__u32 len;
233 			__u8  is_write;
234 		} mmio;
235 		/* KVM_EXIT_HYPERCALL */
236 		struct {
237 			__u64 nr;
238 			__u64 args[6];
239 			__u64 ret;
240 			__u32 longmode;
241 			__u32 pad;
242 		} hypercall;
243 		/* KVM_EXIT_TPR_ACCESS */
244 		struct {
245 			__u64 rip;
246 			__u32 is_write;
247 			__u32 pad;
248 		} tpr_access;
249 		/* KVM_EXIT_S390_SIEIC */
250 		struct {
251 			__u8 icptcode;
252 			__u16 ipa;
253 			__u32 ipb;
254 		} s390_sieic;
255 		/* KVM_EXIT_S390_RESET */
256 #define KVM_S390_RESET_POR       1
257 #define KVM_S390_RESET_CLEAR     2
258 #define KVM_S390_RESET_SUBSYSTEM 4
259 #define KVM_S390_RESET_CPU_INIT  8
260 #define KVM_S390_RESET_IPL       16
261 		__u64 s390_reset_flags;
262 		/* KVM_EXIT_S390_UCONTROL */
263 		struct {
264 			__u64 trans_exc_code;
265 			__u32 pgm_code;
266 		} s390_ucontrol;
267 		/* KVM_EXIT_DCR */
268 		struct {
269 			__u32 dcrn;
270 			__u32 data;
271 			__u8  is_write;
272 		} dcr;
273 		struct {
274 			__u32 suberror;
275 			/* Available with KVM_CAP_INTERNAL_ERROR_DATA: */
276 			__u32 ndata;
277 			__u64 data[16];
278 		} internal;
279 		/* KVM_EXIT_OSI */
280 		struct {
281 			__u64 gprs[32];
282 		} osi;
283 		struct {
284 			__u64 nr;
285 			__u64 ret;
286 			__u64 args[9];
287 		} papr_hcall;
288 		/* Fix the size of the union. */
289 		char padding[256];
290 	};
291 
292 	/*
293 	 * shared registers between kvm and userspace.
294 	 * kvm_valid_regs specifies the register classes set by the host
295 	 * kvm_dirty_regs specified the register classes dirtied by userspace
296 	 * struct kvm_sync_regs is architecture specific, as well as the
297 	 * bits for kvm_valid_regs and kvm_dirty_regs
298 	 */
299 	__u64 kvm_valid_regs;
300 	__u64 kvm_dirty_regs;
301 	union {
302 		struct kvm_sync_regs regs;
303 		char padding[1024];
304 	} s;
305 };
306 
307 /* for KVM_REGISTER_COALESCED_MMIO / KVM_UNREGISTER_COALESCED_MMIO */
308 
309 struct kvm_coalesced_mmio_zone {
310 	__u64 addr;
311 	__u32 size;
312 	__u32 pad;
313 };
314 
315 struct kvm_coalesced_mmio {
316 	__u64 phys_addr;
317 	__u32 len;
318 	__u32 pad;
319 	__u8  data[8];
320 };
321 
322 struct kvm_coalesced_mmio_ring {
323 	__u32 first, last;
324 	struct kvm_coalesced_mmio coalesced_mmio[0];
325 };
326 
327 #define KVM_COALESCED_MMIO_MAX \
328 	((PAGE_SIZE - sizeof(struct kvm_coalesced_mmio_ring)) / \
329 	 sizeof(struct kvm_coalesced_mmio))
330 
331 /* for KVM_TRANSLATE */
332 struct kvm_translation {
333 	/* in */
334 	__u64 linear_address;
335 
336 	/* out */
337 	__u64 physical_address;
338 	__u8  valid;
339 	__u8  writeable;
340 	__u8  usermode;
341 	__u8  pad[5];
342 };
343 
344 /* for KVM_INTERRUPT */
345 struct kvm_interrupt {
346 	/* in */
347 	__u32 irq;
348 };
349 
350 /* for KVM_GET_DIRTY_LOG */
351 struct kvm_dirty_log {
352 	__u32 slot;
353 	__u32 padding1;
354 	union {
355 		void *dirty_bitmap; /* one bit per page */
356 		__u64 padding2;
357 	};
358 };
359 
360 /* for KVM_SET_SIGNAL_MASK */
361 struct kvm_signal_mask {
362 	__u32 len;
363 	__u8  sigset[0];
364 };
365 
366 /* for KVM_TPR_ACCESS_REPORTING */
367 struct kvm_tpr_access_ctl {
368 	__u32 enabled;
369 	__u32 flags;
370 	__u32 reserved[8];
371 };
372 
373 /* for KVM_SET_VAPIC_ADDR */
374 struct kvm_vapic_addr {
375 	__u64 vapic_addr;
376 };
377 
378 /* for KVM_SET_MPSTATE */
379 
380 #define KVM_MP_STATE_RUNNABLE          0
381 #define KVM_MP_STATE_UNINITIALIZED     1
382 #define KVM_MP_STATE_INIT_RECEIVED     2
383 #define KVM_MP_STATE_HALTED            3
384 #define KVM_MP_STATE_SIPI_RECEIVED     4
385 
386 struct kvm_mp_state {
387 	__u32 mp_state;
388 };
389 
390 struct kvm_s390_psw {
391 	__u64 mask;
392 	__u64 addr;
393 };
394 
395 /* valid values for type in kvm_s390_interrupt */
396 #define KVM_S390_SIGP_STOP		0xfffe0000u
397 #define KVM_S390_PROGRAM_INT		0xfffe0001u
398 #define KVM_S390_SIGP_SET_PREFIX	0xfffe0002u
399 #define KVM_S390_RESTART		0xfffe0003u
400 #define KVM_S390_INT_VIRTIO		0xffff2603u
401 #define KVM_S390_INT_SERVICE		0xffff2401u
402 #define KVM_S390_INT_EMERGENCY		0xffff1201u
403 #define KVM_S390_INT_EXTERNAL_CALL	0xffff1202u
404 
405 struct kvm_s390_interrupt {
406 	__u32 type;
407 	__u32 parm;
408 	__u64 parm64;
409 };
410 
411 /* for KVM_SET_GUEST_DEBUG */
412 
413 #define KVM_GUESTDBG_ENABLE		0x00000001
414 #define KVM_GUESTDBG_SINGLESTEP		0x00000002
415 
416 struct kvm_guest_debug {
417 	__u32 control;
418 	__u32 pad;
419 	struct kvm_guest_debug_arch arch;
420 };
421 
422 enum {
423 	kvm_ioeventfd_flag_nr_datamatch,
424 	kvm_ioeventfd_flag_nr_pio,
425 	kvm_ioeventfd_flag_nr_deassign,
426 	kvm_ioeventfd_flag_nr_max,
427 };
428 
429 #define KVM_IOEVENTFD_FLAG_DATAMATCH (1 << kvm_ioeventfd_flag_nr_datamatch)
430 #define KVM_IOEVENTFD_FLAG_PIO       (1 << kvm_ioeventfd_flag_nr_pio)
431 #define KVM_IOEVENTFD_FLAG_DEASSIGN  (1 << kvm_ioeventfd_flag_nr_deassign)
432 
433 #define KVM_IOEVENTFD_VALID_FLAG_MASK  ((1 << kvm_ioeventfd_flag_nr_max) - 1)
434 
435 struct kvm_ioeventfd {
436 	__u64 datamatch;
437 	__u64 addr;        /* legal pio/mmio address */
438 	__u32 len;         /* 1, 2, 4, or 8 bytes    */
439 	__s32 fd;
440 	__u32 flags;
441 	__u8  pad[36];
442 };
443 
444 /* for KVM_ENABLE_CAP */
445 struct kvm_enable_cap {
446 	/* in */
447 	__u32 cap;
448 	__u32 flags;
449 	__u64 args[4];
450 	__u8  pad[64];
451 };
452 
453 /* for KVM_PPC_GET_PVINFO */
454 struct kvm_ppc_pvinfo {
455 	/* out */
456 	__u32 flags;
457 	__u32 hcall[4];
458 	__u8  pad[108];
459 };
460 
461 /* for KVM_PPC_GET_SMMU_INFO */
462 #define KVM_PPC_PAGE_SIZES_MAX_SZ	8
463 
464 struct kvm_ppc_one_page_size {
465 	__u32 page_shift;	/* Page shift (or 0) */
466 	__u32 pte_enc;		/* Encoding in the HPTE (>>12) */
467 };
468 
469 struct kvm_ppc_one_seg_page_size {
470 	__u32 page_shift;	/* Base page shift of segment (or 0) */
471 	__u32 slb_enc;		/* SLB encoding for BookS */
472 	struct kvm_ppc_one_page_size enc[KVM_PPC_PAGE_SIZES_MAX_SZ];
473 };
474 
475 #define KVM_PPC_PAGE_SIZES_REAL		0x00000001
476 #define KVM_PPC_1T_SEGMENTS		0x00000002
477 
478 struct kvm_ppc_smmu_info {
479 	__u64 flags;
480 	__u32 slb_size;
481 	__u32 pad;
482 	struct kvm_ppc_one_seg_page_size sps[KVM_PPC_PAGE_SIZES_MAX_SZ];
483 };
484 
485 #define KVM_PPC_PVINFO_FLAGS_EV_IDLE   (1<<0)
486 
487 #define KVMIO 0xAE
488 
489 /* machine type bits, to be used as argument to KVM_CREATE_VM */
490 #define KVM_VM_S390_UCONTROL	1
491 
492 #define KVM_S390_SIE_PAGE_OFFSET 1
493 
494 /*
495  * ioctls for /dev/kvm fds:
496  */
497 #define KVM_GET_API_VERSION       _IO(KVMIO,   0x00)
498 #define KVM_CREATE_VM             _IO(KVMIO,   0x01) /* returns a VM fd */
499 #define KVM_GET_MSR_INDEX_LIST    _IOWR(KVMIO, 0x02, struct kvm_msr_list)
500 
501 #define KVM_S390_ENABLE_SIE       _IO(KVMIO,   0x06)
502 /*
503  * Check if a kvm extension is available.  Argument is extension number,
504  * return is 1 (yes) or 0 (no, sorry).
505  */
506 #define KVM_CHECK_EXTENSION       _IO(KVMIO,   0x03)
507 /*
508  * Get size for mmap(vcpu_fd)
509  */
510 #define KVM_GET_VCPU_MMAP_SIZE    _IO(KVMIO,   0x04) /* in bytes */
511 #define KVM_GET_SUPPORTED_CPUID   _IOWR(KVMIO, 0x05, struct kvm_cpuid2)
512 #define KVM_TRACE_ENABLE          __KVM_DEPRECATED_MAIN_W_0x06
513 #define KVM_TRACE_PAUSE           __KVM_DEPRECATED_MAIN_0x07
514 #define KVM_TRACE_DISABLE         __KVM_DEPRECATED_MAIN_0x08
515 
516 /*
517  * Extension capability list.
518  */
519 #define KVM_CAP_IRQCHIP	  0
520 #define KVM_CAP_HLT	  1
521 #define KVM_CAP_MMU_SHADOW_CACHE_CONTROL 2
522 #define KVM_CAP_USER_MEMORY 3
523 #define KVM_CAP_SET_TSS_ADDR 4
524 #define KVM_CAP_VAPIC 6
525 #define KVM_CAP_EXT_CPUID 7
526 #define KVM_CAP_CLOCKSOURCE 8
527 #define KVM_CAP_NR_VCPUS 9       /* returns recommended max vcpus per vm */
528 #define KVM_CAP_NR_MEMSLOTS 10   /* returns max memory slots per vm */
529 #define KVM_CAP_PIT 11
530 #define KVM_CAP_NOP_IO_DELAY 12
531 #define KVM_CAP_PV_MMU 13
532 #define KVM_CAP_MP_STATE 14
533 #define KVM_CAP_COALESCED_MMIO 15
534 #define KVM_CAP_SYNC_MMU 16  /* Changes to host mmap are reflected in guest */
535 #ifdef __KVM_HAVE_DEVICE_ASSIGNMENT
536 #define KVM_CAP_DEVICE_ASSIGNMENT 17
537 #endif
538 #define KVM_CAP_IOMMU 18
539 #ifdef __KVM_HAVE_MSI
540 #define KVM_CAP_DEVICE_MSI 20
541 #endif
542 /* Bug in KVM_SET_USER_MEMORY_REGION fixed: */
543 #define KVM_CAP_DESTROY_MEMORY_REGION_WORKS 21
544 #ifdef __KVM_HAVE_USER_NMI
545 #define KVM_CAP_USER_NMI 22
546 #endif
547 #ifdef __KVM_HAVE_GUEST_DEBUG
548 #define KVM_CAP_SET_GUEST_DEBUG 23
549 #endif
550 #ifdef __KVM_HAVE_PIT
551 #define KVM_CAP_REINJECT_CONTROL 24
552 #endif
553 #ifdef __KVM_HAVE_IOAPIC
554 #define KVM_CAP_IRQ_ROUTING 25
555 #endif
556 #define KVM_CAP_IRQ_INJECT_STATUS 26
557 #ifdef __KVM_HAVE_DEVICE_ASSIGNMENT
558 #define KVM_CAP_DEVICE_DEASSIGNMENT 27
559 #endif
560 #ifdef __KVM_HAVE_MSIX
561 #define KVM_CAP_DEVICE_MSIX 28
562 #endif
563 #define KVM_CAP_ASSIGN_DEV_IRQ 29
564 /* Another bug in KVM_SET_USER_MEMORY_REGION fixed: */
565 #define KVM_CAP_JOIN_MEMORY_REGIONS_WORKS 30
566 #ifdef __KVM_HAVE_MCE
567 #define KVM_CAP_MCE 31
568 #endif
569 #define KVM_CAP_IRQFD 32
570 #ifdef __KVM_HAVE_PIT
571 #define KVM_CAP_PIT2 33
572 #endif
573 #define KVM_CAP_SET_BOOT_CPU_ID 34
574 #ifdef __KVM_HAVE_PIT_STATE2
575 #define KVM_CAP_PIT_STATE2 35
576 #endif
577 #define KVM_CAP_IOEVENTFD 36
578 #define KVM_CAP_SET_IDENTITY_MAP_ADDR 37
579 #ifdef __KVM_HAVE_XEN_HVM
580 #define KVM_CAP_XEN_HVM 38
581 #endif
582 #define KVM_CAP_ADJUST_CLOCK 39
583 #define KVM_CAP_INTERNAL_ERROR_DATA 40
584 #ifdef __KVM_HAVE_VCPU_EVENTS
585 #define KVM_CAP_VCPU_EVENTS 41
586 #endif
587 #define KVM_CAP_S390_PSW 42
588 #define KVM_CAP_PPC_SEGSTATE 43
589 #define KVM_CAP_HYPERV 44
590 #define KVM_CAP_HYPERV_VAPIC 45
591 #define KVM_CAP_HYPERV_SPIN 46
592 #define KVM_CAP_PCI_SEGMENT 47
593 #define KVM_CAP_PPC_PAIRED_SINGLES 48
594 #define KVM_CAP_INTR_SHADOW 49
595 #ifdef __KVM_HAVE_DEBUGREGS
596 #define KVM_CAP_DEBUGREGS 50
597 #endif
598 #define KVM_CAP_X86_ROBUST_SINGLESTEP 51
599 #define KVM_CAP_PPC_OSI 52
600 #define KVM_CAP_PPC_UNSET_IRQ 53
601 #define KVM_CAP_ENABLE_CAP 54
602 #ifdef __KVM_HAVE_XSAVE
603 #define KVM_CAP_XSAVE 55
604 #endif
605 #ifdef __KVM_HAVE_XCRS
606 #define KVM_CAP_XCRS 56
607 #endif
608 #define KVM_CAP_PPC_GET_PVINFO 57
609 #define KVM_CAP_PPC_IRQ_LEVEL 58
610 #define KVM_CAP_ASYNC_PF 59
611 #define KVM_CAP_TSC_CONTROL 60
612 #define KVM_CAP_GET_TSC_KHZ 61
613 #define KVM_CAP_PPC_BOOKE_SREGS 62
614 #define KVM_CAP_SPAPR_TCE 63
615 #define KVM_CAP_PPC_SMT 64
616 #define KVM_CAP_PPC_RMA	65
617 #define KVM_CAP_MAX_VCPUS 66       /* returns max vcpus per vm */
618 #define KVM_CAP_PPC_HIOR 67
619 #define KVM_CAP_PPC_PAPR 68
620 #define KVM_CAP_SW_TLB 69
621 #define KVM_CAP_ONE_REG 70
622 #define KVM_CAP_S390_GMAP 71
623 #define KVM_CAP_TSC_DEADLINE_TIMER 72
624 #define KVM_CAP_S390_UCONTROL 73
625 #define KVM_CAP_SYNC_REGS 74
626 #define KVM_CAP_PCI_2_3 75
627 #define KVM_CAP_KVMCLOCK_CTRL 76
628 #define KVM_CAP_SIGNAL_MSI 77
629 #define KVM_CAP_PPC_GET_SMMU_INFO 78
630 #define KVM_CAP_S390_COW 79
631 #define KVM_CAP_PPC_ALLOC_HTAB 80
632 #ifdef __KVM_HAVE_READONLY_MEM
633 #define KVM_CAP_READONLY_MEM 81
634 #endif
635 #define KVM_CAP_IRQFD_RESAMPLE 82
636 #define KVM_CAP_PPC_BOOKE_WATCHDOG 83
637 #define KVM_CAP_PPC_HTAB_FD 84
638 
639 #ifdef KVM_CAP_IRQ_ROUTING
640 
641 struct kvm_irq_routing_irqchip {
642 	__u32 irqchip;
643 	__u32 pin;
644 };
645 
646 struct kvm_irq_routing_msi {
647 	__u32 address_lo;
648 	__u32 address_hi;
649 	__u32 data;
650 	__u32 pad;
651 };
652 
653 /* gsi routing entry types */
654 #define KVM_IRQ_ROUTING_IRQCHIP 1
655 #define KVM_IRQ_ROUTING_MSI 2
656 
657 struct kvm_irq_routing_entry {
658 	__u32 gsi;
659 	__u32 type;
660 	__u32 flags;
661 	__u32 pad;
662 	union {
663 		struct kvm_irq_routing_irqchip irqchip;
664 		struct kvm_irq_routing_msi msi;
665 		__u32 pad[8];
666 	} u;
667 };
668 
669 struct kvm_irq_routing {
670 	__u32 nr;
671 	__u32 flags;
672 	struct kvm_irq_routing_entry entries[0];
673 };
674 
675 #endif
676 
677 #ifdef KVM_CAP_MCE
678 /* x86 MCE */
679 struct kvm_x86_mce {
680 	__u64 status;
681 	__u64 addr;
682 	__u64 misc;
683 	__u64 mcg_status;
684 	__u8 bank;
685 	__u8 pad1[7];
686 	__u64 pad2[3];
687 };
688 #endif
689 
690 #ifdef KVM_CAP_XEN_HVM
691 struct kvm_xen_hvm_config {
692 	__u32 flags;
693 	__u32 msr;
694 	__u64 blob_addr_32;
695 	__u64 blob_addr_64;
696 	__u8 blob_size_32;
697 	__u8 blob_size_64;
698 	__u8 pad2[30];
699 };
700 #endif
701 
702 #define KVM_IRQFD_FLAG_DEASSIGN (1 << 0)
703 /*
704  * Available with KVM_CAP_IRQFD_RESAMPLE
705  *
706  * KVM_IRQFD_FLAG_RESAMPLE indicates resamplefd is valid and specifies
707  * the irqfd to operate in resampling mode for level triggered interrupt
708  * emlation.  See Documentation/virtual/kvm/api.txt.
709  */
710 #define KVM_IRQFD_FLAG_RESAMPLE (1 << 1)
711 
712 struct kvm_irqfd {
713 	__u32 fd;
714 	__u32 gsi;
715 	__u32 flags;
716 	__u32 resamplefd;
717 	__u8  pad[16];
718 };
719 
720 struct kvm_clock_data {
721 	__u64 clock;
722 	__u32 flags;
723 	__u32 pad[9];
724 };
725 
726 #define KVM_MMU_FSL_BOOKE_NOHV		0
727 #define KVM_MMU_FSL_BOOKE_HV		1
728 
729 struct kvm_config_tlb {
730 	__u64 params;
731 	__u64 array;
732 	__u32 mmu_type;
733 	__u32 array_len;
734 };
735 
736 struct kvm_dirty_tlb {
737 	__u64 bitmap;
738 	__u32 num_dirty;
739 };
740 
741 /* Available with KVM_CAP_ONE_REG */
742 
743 #define KVM_REG_ARCH_MASK	0xff00000000000000ULL
744 #define KVM_REG_GENERIC		0x0000000000000000ULL
745 
746 /*
747  * Architecture specific registers are to be defined in arch headers and
748  * ORed with the arch identifier.
749  */
750 #define KVM_REG_PPC		0x1000000000000000ULL
751 #define KVM_REG_X86		0x2000000000000000ULL
752 #define KVM_REG_IA64		0x3000000000000000ULL
753 #define KVM_REG_ARM		0x4000000000000000ULL
754 #define KVM_REG_S390		0x5000000000000000ULL
755 
756 #define KVM_REG_SIZE_SHIFT	52
757 #define KVM_REG_SIZE_MASK	0x00f0000000000000ULL
758 #define KVM_REG_SIZE_U8		0x0000000000000000ULL
759 #define KVM_REG_SIZE_U16	0x0010000000000000ULL
760 #define KVM_REG_SIZE_U32	0x0020000000000000ULL
761 #define KVM_REG_SIZE_U64	0x0030000000000000ULL
762 #define KVM_REG_SIZE_U128	0x0040000000000000ULL
763 #define KVM_REG_SIZE_U256	0x0050000000000000ULL
764 #define KVM_REG_SIZE_U512	0x0060000000000000ULL
765 #define KVM_REG_SIZE_U1024	0x0070000000000000ULL
766 
767 struct kvm_one_reg {
768 	__u64 id;
769 	__u64 addr;
770 };
771 
772 struct kvm_msi {
773 	__u32 address_lo;
774 	__u32 address_hi;
775 	__u32 data;
776 	__u32 flags;
777 	__u8  pad[16];
778 };
779 
780 /*
781  * ioctls for VM fds
782  */
783 #define KVM_SET_MEMORY_REGION     _IOW(KVMIO,  0x40, struct kvm_memory_region)
784 /*
785  * KVM_CREATE_VCPU receives as a parameter the vcpu slot, and returns
786  * a vcpu fd.
787  */
788 #define KVM_CREATE_VCPU           _IO(KVMIO,   0x41)
789 #define KVM_GET_DIRTY_LOG         _IOW(KVMIO,  0x42, struct kvm_dirty_log)
790 /* KVM_SET_MEMORY_ALIAS is obsolete: */
791 #define KVM_SET_MEMORY_ALIAS      _IOW(KVMIO,  0x43, struct kvm_memory_alias)
792 #define KVM_SET_NR_MMU_PAGES      _IO(KVMIO,   0x44)
793 #define KVM_GET_NR_MMU_PAGES      _IO(KVMIO,   0x45)
794 #define KVM_SET_USER_MEMORY_REGION _IOW(KVMIO, 0x46, \
795 					struct kvm_userspace_memory_region)
796 #define KVM_SET_TSS_ADDR          _IO(KVMIO,   0x47)
797 #define KVM_SET_IDENTITY_MAP_ADDR _IOW(KVMIO,  0x48, __u64)
798 
799 /* enable ucontrol for s390 */
800 struct kvm_s390_ucas_mapping {
801 	__u64 user_addr;
802 	__u64 vcpu_addr;
803 	__u64 length;
804 };
805 #define KVM_S390_UCAS_MAP        _IOW(KVMIO, 0x50, struct kvm_s390_ucas_mapping)
806 #define KVM_S390_UCAS_UNMAP      _IOW(KVMIO, 0x51, struct kvm_s390_ucas_mapping)
807 #define KVM_S390_VCPU_FAULT	 _IOW(KVMIO, 0x52, unsigned long)
808 
809 /* Device model IOC */
810 #define KVM_CREATE_IRQCHIP        _IO(KVMIO,   0x60)
811 #define KVM_IRQ_LINE              _IOW(KVMIO,  0x61, struct kvm_irq_level)
812 #define KVM_GET_IRQCHIP           _IOWR(KVMIO, 0x62, struct kvm_irqchip)
813 #define KVM_SET_IRQCHIP           _IOR(KVMIO,  0x63, struct kvm_irqchip)
814 #define KVM_CREATE_PIT            _IO(KVMIO,   0x64)
815 #define KVM_GET_PIT               _IOWR(KVMIO, 0x65, struct kvm_pit_state)
816 #define KVM_SET_PIT               _IOR(KVMIO,  0x66, struct kvm_pit_state)
817 #define KVM_IRQ_LINE_STATUS       _IOWR(KVMIO, 0x67, struct kvm_irq_level)
818 #define KVM_REGISTER_COALESCED_MMIO \
819 			_IOW(KVMIO,  0x67, struct kvm_coalesced_mmio_zone)
820 #define KVM_UNREGISTER_COALESCED_MMIO \
821 			_IOW(KVMIO,  0x68, struct kvm_coalesced_mmio_zone)
822 #define KVM_ASSIGN_PCI_DEVICE     _IOR(KVMIO,  0x69, \
823 				       struct kvm_assigned_pci_dev)
824 #define KVM_SET_GSI_ROUTING       _IOW(KVMIO,  0x6a, struct kvm_irq_routing)
825 /* deprecated, replaced by KVM_ASSIGN_DEV_IRQ */
826 #define KVM_ASSIGN_IRQ            __KVM_DEPRECATED_VM_R_0x70
827 #define KVM_ASSIGN_DEV_IRQ        _IOW(KVMIO,  0x70, struct kvm_assigned_irq)
828 #define KVM_REINJECT_CONTROL      _IO(KVMIO,   0x71)
829 #define KVM_DEASSIGN_PCI_DEVICE   _IOW(KVMIO,  0x72, \
830 				       struct kvm_assigned_pci_dev)
831 #define KVM_ASSIGN_SET_MSIX_NR    _IOW(KVMIO,  0x73, \
832 				       struct kvm_assigned_msix_nr)
833 #define KVM_ASSIGN_SET_MSIX_ENTRY _IOW(KVMIO,  0x74, \
834 				       struct kvm_assigned_msix_entry)
835 #define KVM_DEASSIGN_DEV_IRQ      _IOW(KVMIO,  0x75, struct kvm_assigned_irq)
836 #define KVM_IRQFD                 _IOW(KVMIO,  0x76, struct kvm_irqfd)
837 #define KVM_CREATE_PIT2		  _IOW(KVMIO,  0x77, struct kvm_pit_config)
838 #define KVM_SET_BOOT_CPU_ID       _IO(KVMIO,   0x78)
839 #define KVM_IOEVENTFD             _IOW(KVMIO,  0x79, struct kvm_ioeventfd)
840 #define KVM_XEN_HVM_CONFIG        _IOW(KVMIO,  0x7a, struct kvm_xen_hvm_config)
841 #define KVM_SET_CLOCK             _IOW(KVMIO,  0x7b, struct kvm_clock_data)
842 #define KVM_GET_CLOCK             _IOR(KVMIO,  0x7c, struct kvm_clock_data)
843 /* Available with KVM_CAP_PIT_STATE2 */
844 #define KVM_GET_PIT2              _IOR(KVMIO,  0x9f, struct kvm_pit_state2)
845 #define KVM_SET_PIT2              _IOW(KVMIO,  0xa0, struct kvm_pit_state2)
846 /* Available with KVM_CAP_PPC_GET_PVINFO */
847 #define KVM_PPC_GET_PVINFO	  _IOW(KVMIO,  0xa1, struct kvm_ppc_pvinfo)
848 /* Available with KVM_CAP_TSC_CONTROL */
849 #define KVM_SET_TSC_KHZ           _IO(KVMIO,  0xa2)
850 #define KVM_GET_TSC_KHZ           _IO(KVMIO,  0xa3)
851 /* Available with KVM_CAP_PCI_2_3 */
852 #define KVM_ASSIGN_SET_INTX_MASK  _IOW(KVMIO,  0xa4, \
853 				       struct kvm_assigned_pci_dev)
854 /* Available with KVM_CAP_SIGNAL_MSI */
855 #define KVM_SIGNAL_MSI            _IOW(KVMIO,  0xa5, struct kvm_msi)
856 /* Available with KVM_CAP_PPC_GET_SMMU_INFO */
857 #define KVM_PPC_GET_SMMU_INFO	  _IOR(KVMIO,  0xa6, struct kvm_ppc_smmu_info)
858 /* Available with KVM_CAP_PPC_ALLOC_HTAB */
859 #define KVM_PPC_ALLOCATE_HTAB	  _IOWR(KVMIO, 0xa7, __u32)
860 #define KVM_CREATE_SPAPR_TCE	  _IOW(KVMIO,  0xa8, struct kvm_create_spapr_tce)
861 /* Available with KVM_CAP_RMA */
862 #define KVM_ALLOCATE_RMA	  _IOR(KVMIO,  0xa9, struct kvm_allocate_rma)
863 /* Available with KVM_CAP_PPC_HTAB_FD */
864 #define KVM_PPC_GET_HTAB_FD	  _IOW(KVMIO,  0xaa, struct kvm_get_htab_fd)
865 
866 /*
867  * ioctls for vcpu fds
868  */
869 #define KVM_RUN                   _IO(KVMIO,   0x80)
870 #define KVM_GET_REGS              _IOR(KVMIO,  0x81, struct kvm_regs)
871 #define KVM_SET_REGS              _IOW(KVMIO,  0x82, struct kvm_regs)
872 #define KVM_GET_SREGS             _IOR(KVMIO,  0x83, struct kvm_sregs)
873 #define KVM_SET_SREGS             _IOW(KVMIO,  0x84, struct kvm_sregs)
874 #define KVM_TRANSLATE             _IOWR(KVMIO, 0x85, struct kvm_translation)
875 #define KVM_INTERRUPT             _IOW(KVMIO,  0x86, struct kvm_interrupt)
876 /* KVM_DEBUG_GUEST is no longer supported, use KVM_SET_GUEST_DEBUG instead */
877 #define KVM_DEBUG_GUEST           __KVM_DEPRECATED_VCPU_W_0x87
878 #define KVM_GET_MSRS              _IOWR(KVMIO, 0x88, struct kvm_msrs)
879 #define KVM_SET_MSRS              _IOW(KVMIO,  0x89, struct kvm_msrs)
880 #define KVM_SET_CPUID             _IOW(KVMIO,  0x8a, struct kvm_cpuid)
881 #define KVM_SET_SIGNAL_MASK       _IOW(KVMIO,  0x8b, struct kvm_signal_mask)
882 #define KVM_GET_FPU               _IOR(KVMIO,  0x8c, struct kvm_fpu)
883 #define KVM_SET_FPU               _IOW(KVMIO,  0x8d, struct kvm_fpu)
884 #define KVM_GET_LAPIC             _IOR(KVMIO,  0x8e, struct kvm_lapic_state)
885 #define KVM_SET_LAPIC             _IOW(KVMIO,  0x8f, struct kvm_lapic_state)
886 #define KVM_SET_CPUID2            _IOW(KVMIO,  0x90, struct kvm_cpuid2)
887 #define KVM_GET_CPUID2            _IOWR(KVMIO, 0x91, struct kvm_cpuid2)
888 /* Available with KVM_CAP_VAPIC */
889 #define KVM_TPR_ACCESS_REPORTING  _IOWR(KVMIO, 0x92, struct kvm_tpr_access_ctl)
890 /* Available with KVM_CAP_VAPIC */
891 #define KVM_SET_VAPIC_ADDR        _IOW(KVMIO,  0x93, struct kvm_vapic_addr)
892 /* valid for virtual machine (for floating interrupt)_and_ vcpu */
893 #define KVM_S390_INTERRUPT        _IOW(KVMIO,  0x94, struct kvm_s390_interrupt)
894 /* store status for s390 */
895 #define KVM_S390_STORE_STATUS_NOADDR    (-1ul)
896 #define KVM_S390_STORE_STATUS_PREFIXED  (-2ul)
897 #define KVM_S390_STORE_STATUS	  _IOW(KVMIO,  0x95, unsigned long)
898 /* initial ipl psw for s390 */
899 #define KVM_S390_SET_INITIAL_PSW  _IOW(KVMIO,  0x96, struct kvm_s390_psw)
900 /* initial reset for s390 */
901 #define KVM_S390_INITIAL_RESET    _IO(KVMIO,   0x97)
902 #define KVM_GET_MP_STATE          _IOR(KVMIO,  0x98, struct kvm_mp_state)
903 #define KVM_SET_MP_STATE          _IOW(KVMIO,  0x99, struct kvm_mp_state)
904 /* Available with KVM_CAP_NMI */
905 #define KVM_NMI                   _IO(KVMIO,   0x9a)
906 /* Available with KVM_CAP_SET_GUEST_DEBUG */
907 #define KVM_SET_GUEST_DEBUG       _IOW(KVMIO,  0x9b, struct kvm_guest_debug)
908 /* MCE for x86 */
909 #define KVM_X86_SETUP_MCE         _IOW(KVMIO,  0x9c, __u64)
910 #define KVM_X86_GET_MCE_CAP_SUPPORTED _IOR(KVMIO,  0x9d, __u64)
911 #define KVM_X86_SET_MCE           _IOW(KVMIO,  0x9e, struct kvm_x86_mce)
912 /* IA64 stack access */
913 #define KVM_IA64_VCPU_GET_STACK   _IOR(KVMIO,  0x9a, void *)
914 #define KVM_IA64_VCPU_SET_STACK   _IOW(KVMIO,  0x9b, void *)
915 /* Available with KVM_CAP_VCPU_EVENTS */
916 #define KVM_GET_VCPU_EVENTS       _IOR(KVMIO,  0x9f, struct kvm_vcpu_events)
917 #define KVM_SET_VCPU_EVENTS       _IOW(KVMIO,  0xa0, struct kvm_vcpu_events)
918 /* Available with KVM_CAP_DEBUGREGS */
919 #define KVM_GET_DEBUGREGS         _IOR(KVMIO,  0xa1, struct kvm_debugregs)
920 #define KVM_SET_DEBUGREGS         _IOW(KVMIO,  0xa2, struct kvm_debugregs)
921 #define KVM_ENABLE_CAP            _IOW(KVMIO,  0xa3, struct kvm_enable_cap)
922 /* Available with KVM_CAP_XSAVE */
923 #define KVM_GET_XSAVE		  _IOR(KVMIO,  0xa4, struct kvm_xsave)
924 #define KVM_SET_XSAVE		  _IOW(KVMIO,  0xa5, struct kvm_xsave)
925 /* Available with KVM_CAP_XCRS */
926 #define KVM_GET_XCRS		  _IOR(KVMIO,  0xa6, struct kvm_xcrs)
927 #define KVM_SET_XCRS		  _IOW(KVMIO,  0xa7, struct kvm_xcrs)
928 /* Available with KVM_CAP_SW_TLB */
929 #define KVM_DIRTY_TLB		  _IOW(KVMIO,  0xaa, struct kvm_dirty_tlb)
930 /* Available with KVM_CAP_ONE_REG */
931 #define KVM_GET_ONE_REG		  _IOW(KVMIO,  0xab, struct kvm_one_reg)
932 #define KVM_SET_ONE_REG		  _IOW(KVMIO,  0xac, struct kvm_one_reg)
933 /* VM is being stopped by host */
934 #define KVM_KVMCLOCK_CTRL	  _IO(KVMIO,   0xad)
935 
936 #define KVM_DEV_ASSIGN_ENABLE_IOMMU	(1 << 0)
937 #define KVM_DEV_ASSIGN_PCI_2_3		(1 << 1)
938 #define KVM_DEV_ASSIGN_MASK_INTX	(1 << 2)
939 
940 struct kvm_assigned_pci_dev {
941 	__u32 assigned_dev_id;
942 	__u32 busnr;
943 	__u32 devfn;
944 	__u32 flags;
945 	__u32 segnr;
946 	union {
947 		__u32 reserved[11];
948 	};
949 };
950 
951 #define KVM_DEV_IRQ_HOST_INTX    (1 << 0)
952 #define KVM_DEV_IRQ_HOST_MSI     (1 << 1)
953 #define KVM_DEV_IRQ_HOST_MSIX    (1 << 2)
954 
955 #define KVM_DEV_IRQ_GUEST_INTX   (1 << 8)
956 #define KVM_DEV_IRQ_GUEST_MSI    (1 << 9)
957 #define KVM_DEV_IRQ_GUEST_MSIX   (1 << 10)
958 
959 #define KVM_DEV_IRQ_HOST_MASK	 0x00ff
960 #define KVM_DEV_IRQ_GUEST_MASK   0xff00
961 
962 struct kvm_assigned_irq {
963 	__u32 assigned_dev_id;
964 	__u32 host_irq; /* ignored (legacy field) */
965 	__u32 guest_irq;
966 	__u32 flags;
967 	union {
968 		__u32 reserved[12];
969 	};
970 };
971 
972 struct kvm_assigned_msix_nr {
973 	__u32 assigned_dev_id;
974 	__u16 entry_nr;
975 	__u16 padding;
976 };
977 
978 #define KVM_MAX_MSIX_PER_DEV		256
979 struct kvm_assigned_msix_entry {
980 	__u32 assigned_dev_id;
981 	__u32 gsi;
982 	__u16 entry; /* The index of entry in the MSI-X table */
983 	__u16 padding[3];
984 };
985 
986 #endif /* __LINUX_KVM_H */
987