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