xref: /linux/tools/include/uapi/linux/kvm.h (revision fab183d632628381b466a41479489541ac0e29a0)
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 #ifndef __LINUX_KVM_H
3 #define __LINUX_KVM_H
4 
5 /*
6  * Userspace interface for /dev/kvm - kernel based virtual machine
7  *
8  * Note: you must update KVM_API_VERSION if you change this interface.
9  */
10 
11 #include <linux/const.h>
12 #include <linux/types.h>
13 #include <linux/compiler.h>
14 #include <linux/stddef.h>
15 #include <linux/ioctl.h>
16 #include <asm/kvm.h>
17 
18 #ifdef __KERNEL__
19 #include <linux/kvm_types.h>
20 #endif
21 
22 #define KVM_API_VERSION 12
23 
24 /*
25  * Backwards-compatible definitions.
26  */
27 #define __KVM_HAVE_GUEST_DEBUG
28 
29 /* for KVM_SET_USER_MEMORY_REGION */
30 struct kvm_userspace_memory_region {
31 	__u32 slot;
32 	__u32 flags;
33 	__u64 guest_phys_addr;
34 	__u64 memory_size; /* bytes */
35 	__u64 userspace_addr; /* start of the userspace allocated memory */
36 };
37 
38 /* for KVM_SET_USER_MEMORY_REGION2 */
39 struct kvm_userspace_memory_region2 {
40 	__u32 slot;
41 	__u32 flags;
42 	__u64 guest_phys_addr;
43 	__u64 memory_size;
44 	__u64 userspace_addr;
45 	__u64 guest_memfd_offset;
46 	__u32 guest_memfd;
47 	__u32 pad1;
48 	__u64 pad2[14];
49 };
50 
51 /*
52  * The bit 0 ~ bit 15 of kvm_userspace_memory_region::flags are visible for
53  * userspace, other bits are reserved for kvm internal use which are defined
54  * in include/linux/kvm_host.h.
55  */
56 #define KVM_MEM_LOG_DIRTY_PAGES	(1UL << 0)
57 #define KVM_MEM_READONLY	(1UL << 1)
58 #define KVM_MEM_GUEST_MEMFD	(1UL << 2)
59 
60 /* for KVM_IRQ_LINE */
61 struct kvm_irq_level {
62 	/*
63 	 * ACPI gsi notion of irq.
64 	 * For IA-64 (APIC model) IOAPIC0: irq 0-23; IOAPIC1: irq 24-47..
65 	 * For X86 (standard AT mode) PIC0/1: irq 0-15. IOAPIC0: 0-23..
66 	 * For ARM: See Documentation/virt/kvm/api.rst
67 	 */
68 	union {
69 		__u32 irq;
70 		__s32 status;
71 	};
72 	__u32 level;
73 };
74 
75 
76 struct kvm_irqchip {
77 	__u32 chip_id;
78 	__u32 pad;
79         union {
80 		char dummy[512];  /* reserving space */
81 #ifdef __KVM_HAVE_PIT
82 		struct kvm_pic_state pic;
83 #endif
84 #ifdef __KVM_HAVE_IOAPIC
85 		struct kvm_ioapic_state ioapic;
86 #endif
87 	} chip;
88 };
89 
90 /* for KVM_CREATE_PIT2 */
91 struct kvm_pit_config {
92 	__u32 flags;
93 	__u32 pad[15];
94 };
95 
96 #define KVM_PIT_SPEAKER_DUMMY     1
97 
98 struct kvm_hyperv_exit {
99 #define KVM_EXIT_HYPERV_SYNIC          1
100 #define KVM_EXIT_HYPERV_HCALL          2
101 #define KVM_EXIT_HYPERV_SYNDBG         3
102 	__u32 type;
103 	__u32 pad1;
104 	union {
105 		struct {
106 			__u32 msr;
107 			__u32 pad2;
108 			__u64 control;
109 			__u64 evt_page;
110 			__u64 msg_page;
111 		} synic;
112 		struct {
113 			__u64 input;
114 			__u64 result;
115 			__u64 params[2];
116 		} hcall;
117 		struct {
118 			__u32 msr;
119 			__u32 pad2;
120 			__u64 control;
121 			__u64 status;
122 			__u64 send_page;
123 			__u64 recv_page;
124 			__u64 pending_page;
125 		} syndbg;
126 	} u;
127 };
128 
129 struct kvm_xen_exit {
130 #define KVM_EXIT_XEN_HCALL          1
131 	__u32 type;
132 	union {
133 		struct {
134 			__u32 longmode;
135 			__u32 cpl;
136 			__u64 input;
137 			__u64 result;
138 			__u64 params[6];
139 		} hcall;
140 	} u;
141 };
142 
143 struct kvm_exit_snp_req_certs {
144 	__u64 gpa;
145 	__u64 npages;
146 	__u64 ret;
147 };
148 
149 #define KVM_S390_GET_SKEYS_NONE   1
150 #define KVM_S390_SKEYS_MAX        1048576
151 
152 #define KVM_EXIT_UNKNOWN          0
153 #define KVM_EXIT_EXCEPTION        1
154 #define KVM_EXIT_IO               2
155 #define KVM_EXIT_HYPERCALL        3
156 #define KVM_EXIT_DEBUG            4
157 #define KVM_EXIT_HLT              5
158 #define KVM_EXIT_MMIO             6
159 #define KVM_EXIT_IRQ_WINDOW_OPEN  7
160 #define KVM_EXIT_SHUTDOWN         8
161 #define KVM_EXIT_FAIL_ENTRY       9
162 #define KVM_EXIT_INTR             10
163 #define KVM_EXIT_SET_TPR          11
164 #define KVM_EXIT_TPR_ACCESS       12
165 #define KVM_EXIT_S390_SIEIC       13
166 #define KVM_EXIT_S390_RESET       14
167 #define KVM_EXIT_DCR              15 /* deprecated */
168 #define KVM_EXIT_NMI              16
169 #define KVM_EXIT_INTERNAL_ERROR   17
170 #define KVM_EXIT_OSI              18
171 #define KVM_EXIT_PAPR_HCALL	  19
172 #define KVM_EXIT_S390_UCONTROL	  20
173 #define KVM_EXIT_WATCHDOG         21
174 #define KVM_EXIT_S390_TSCH        22
175 #define KVM_EXIT_EPR              23
176 #define KVM_EXIT_SYSTEM_EVENT     24
177 #define KVM_EXIT_S390_STSI        25
178 #define KVM_EXIT_IOAPIC_EOI       26
179 #define KVM_EXIT_HYPERV           27
180 #define KVM_EXIT_ARM_NISV         28
181 #define KVM_EXIT_X86_RDMSR        29
182 #define KVM_EXIT_X86_WRMSR        30
183 #define KVM_EXIT_DIRTY_RING_FULL  31
184 #define KVM_EXIT_AP_RESET_HOLD    32
185 #define KVM_EXIT_X86_BUS_LOCK     33
186 #define KVM_EXIT_XEN              34
187 #define KVM_EXIT_RISCV_SBI        35
188 #define KVM_EXIT_RISCV_CSR        36
189 #define KVM_EXIT_NOTIFY           37
190 #define KVM_EXIT_LOONGARCH_IOCSR  38
191 #define KVM_EXIT_MEMORY_FAULT     39
192 #define KVM_EXIT_TDX              40
193 #define KVM_EXIT_ARM_SEA          41
194 #define KVM_EXIT_ARM_LDST64B      42
195 #define KVM_EXIT_SNP_REQ_CERTS    43
196 
197 /* For KVM_EXIT_INTERNAL_ERROR */
198 /* Emulate instruction failed. */
199 #define KVM_INTERNAL_ERROR_EMULATION	1
200 /* Encounter unexpected simultaneous exceptions. */
201 #define KVM_INTERNAL_ERROR_SIMUL_EX	2
202 /* Encounter unexpected vm-exit due to delivery event. */
203 #define KVM_INTERNAL_ERROR_DELIVERY_EV	3
204 /* Encounter unexpected vm-exit reason */
205 #define KVM_INTERNAL_ERROR_UNEXPECTED_EXIT_REASON	4
206 
207 /* Flags that describe what fields in emulation_failure hold valid data. */
208 #define KVM_INTERNAL_ERROR_EMULATION_FLAG_INSTRUCTION_BYTES (1ULL << 0)
209 
210 /*
211  * struct kvm_run can be modified by userspace at any time, so KVM must be
212  * careful to avoid TOCTOU bugs. In order to protect KVM, HINT_UNSAFE_IN_KVM()
213  * renames fields in struct kvm_run from <symbol> to <symbol>__unsafe when
214  * compiled into the kernel, ensuring that any use within KVM is obvious and
215  * gets extra scrutiny.
216  */
217 #ifdef __KERNEL__
218 #define HINT_UNSAFE_IN_KVM(_symbol) _symbol##__unsafe
219 #else
220 #define HINT_UNSAFE_IN_KVM(_symbol) _symbol
221 #endif
222 
223 /* for KVM_RUN, returned by mmap(vcpu_fd, offset=0) */
224 struct kvm_run {
225 	/* in */
226 	__u8 request_interrupt_window;
227 	__u8 HINT_UNSAFE_IN_KVM(immediate_exit);
228 	__u8 padding1[6];
229 
230 	/* out */
231 	__u32 exit_reason;
232 	__u8 ready_for_interrupt_injection;
233 	__u8 if_flag;
234 	__u16 flags;
235 
236 	/* in (pre_kvm_run), out (post_kvm_run) */
237 	__u64 cr8;
238 	__u64 apic_base;
239 
240 #ifdef __KVM_S390
241 	/* the processor status word for s390 */
242 	__u64 psw_mask; /* psw upper half */
243 	__u64 psw_addr; /* psw lower half */
244 #endif
245 	union {
246 		/* KVM_EXIT_UNKNOWN */
247 		struct {
248 			__u64 hardware_exit_reason;
249 		} hw;
250 		/* KVM_EXIT_FAIL_ENTRY */
251 		struct {
252 			__u64 hardware_entry_failure_reason;
253 			__u32 cpu;
254 		} fail_entry;
255 		/* KVM_EXIT_EXCEPTION */
256 		struct {
257 			__u32 exception;
258 			__u32 error_code;
259 		} ex;
260 		/* KVM_EXIT_IO */
261 		struct {
262 #define KVM_EXIT_IO_IN  0
263 #define KVM_EXIT_IO_OUT 1
264 			__u8 direction;
265 			__u8 size; /* bytes */
266 			__u16 port;
267 			__u32 count;
268 			__u64 data_offset; /* relative to kvm_run start */
269 		} io;
270 		/* KVM_EXIT_DEBUG */
271 		struct {
272 			struct kvm_debug_exit_arch arch;
273 		} debug;
274 		/* KVM_EXIT_MMIO */
275 		struct {
276 			__u64 phys_addr;
277 			__u8  data[8];
278 			__u32 len;
279 			__u8  is_write;
280 		} mmio;
281 		/* KVM_EXIT_LOONGARCH_IOCSR */
282 		struct {
283 			__u64 phys_addr;
284 			__u8  data[8];
285 			__u32 len;
286 			__u8  is_write;
287 		} iocsr_io;
288 		/* KVM_EXIT_HYPERCALL */
289 		struct {
290 			__u64 nr;
291 			__u64 args[6];
292 			__u64 ret;
293 
294 			union {
295 #ifndef __KERNEL__
296 				__u32 longmode;
297 #endif
298 				__u64 flags;
299 			};
300 		} hypercall;
301 		/* KVM_EXIT_TPR_ACCESS */
302 		struct {
303 			__u64 rip;
304 			__u32 is_write;
305 			__u32 pad;
306 		} tpr_access;
307 		/* KVM_EXIT_S390_SIEIC */
308 		struct {
309 			__u8 icptcode;
310 			__u16 ipa;
311 			__u32 ipb;
312 		} s390_sieic;
313 		/* KVM_EXIT_S390_RESET */
314 		__u64 s390_reset_flags;
315 		/* KVM_EXIT_S390_UCONTROL */
316 		struct {
317 			__u64 trans_exc_code;
318 			__u32 pgm_code;
319 		} s390_ucontrol;
320 		/* KVM_EXIT_DCR (deprecated) */
321 		struct {
322 			__u32 dcrn;
323 			__u32 data;
324 			__u8  is_write;
325 		} dcr;
326 		/* KVM_EXIT_INTERNAL_ERROR */
327 		struct {
328 			__u32 suberror;
329 			/* Available with KVM_CAP_INTERNAL_ERROR_DATA: */
330 			__u32 ndata;
331 			__u64 data[16];
332 		} internal;
333 		/*
334 		 * KVM_INTERNAL_ERROR_EMULATION
335 		 *
336 		 * "struct emulation_failure" is an overlay of "struct internal"
337 		 * that is used for the KVM_INTERNAL_ERROR_EMULATION sub-type of
338 		 * KVM_EXIT_INTERNAL_ERROR.  Note, unlike other internal error
339 		 * sub-types, this struct is ABI!  It also needs to be backwards
340 		 * compatible with "struct internal".  Take special care that
341 		 * "ndata" is correct, that new fields are enumerated in "flags",
342 		 * and that each flag enumerates fields that are 64-bit aligned
343 		 * and sized (so that ndata+internal.data[] is valid/accurate).
344 		 *
345 		 * Space beyond the defined fields may be used to store arbitrary
346 		 * debug information relating to the emulation failure. It is
347 		 * accounted for in "ndata" but the format is unspecified and is
348 		 * not represented in "flags". Any such information is *not* ABI!
349 		 */
350 		struct {
351 			__u32 suberror;
352 			__u32 ndata;
353 			__u64 flags;
354 			union {
355 				struct {
356 					__u8  insn_size;
357 					__u8  insn_bytes[15];
358 				};
359 			};
360 			/* Arbitrary debug data may follow. */
361 		} emulation_failure;
362 		/* KVM_EXIT_OSI */
363 		struct {
364 			__u64 gprs[32];
365 		} osi;
366 		/* KVM_EXIT_PAPR_HCALL */
367 		struct {
368 			__u64 nr;
369 			__u64 ret;
370 			__u64 args[9];
371 		} papr_hcall;
372 		/* KVM_EXIT_S390_TSCH */
373 		struct {
374 			__u16 subchannel_id;
375 			__u16 subchannel_nr;
376 			__u32 io_int_parm;
377 			__u32 io_int_word;
378 			__u32 ipb;
379 			__u8 dequeued;
380 		} s390_tsch;
381 		/* KVM_EXIT_EPR */
382 		struct {
383 			__u32 epr;
384 		} epr;
385 		/* KVM_EXIT_SYSTEM_EVENT */
386 		struct {
387 #define KVM_SYSTEM_EVENT_SHUTDOWN       1
388 #define KVM_SYSTEM_EVENT_RESET          2
389 #define KVM_SYSTEM_EVENT_CRASH          3
390 #define KVM_SYSTEM_EVENT_WAKEUP         4
391 #define KVM_SYSTEM_EVENT_SUSPEND        5
392 #define KVM_SYSTEM_EVENT_SEV_TERM       6
393 #define KVM_SYSTEM_EVENT_TDX_FATAL      7
394 			__u32 type;
395 			__u32 ndata;
396 			union {
397 #ifndef __KERNEL__
398 				__u64 flags;
399 #endif
400 				__u64 data[16];
401 			};
402 		} system_event;
403 		/* KVM_EXIT_S390_STSI */
404 		struct {
405 			__u64 addr;
406 			__u8 ar;
407 			__u8 reserved;
408 			__u8 fc;
409 			__u8 sel1;
410 			__u16 sel2;
411 		} s390_stsi;
412 		/* KVM_EXIT_IOAPIC_EOI */
413 		struct {
414 			__u8 vector;
415 		} eoi;
416 		/* KVM_EXIT_HYPERV */
417 		struct kvm_hyperv_exit hyperv;
418 		/* KVM_EXIT_ARM_NISV / KVM_EXIT_ARM_LDST64B */
419 		struct {
420 			__u64 esr_iss;
421 			__u64 fault_ipa;
422 		} arm_nisv;
423 		/* KVM_EXIT_X86_RDMSR / KVM_EXIT_X86_WRMSR */
424 		struct {
425 			__u8 error; /* user -> kernel */
426 			__u8 pad[7];
427 #define KVM_MSR_EXIT_REASON_INVAL	(1 << 0)
428 #define KVM_MSR_EXIT_REASON_UNKNOWN	(1 << 1)
429 #define KVM_MSR_EXIT_REASON_FILTER	(1 << 2)
430 #define KVM_MSR_EXIT_REASON_VALID_MASK	(KVM_MSR_EXIT_REASON_INVAL   |	\
431 					 KVM_MSR_EXIT_REASON_UNKNOWN |	\
432 					 KVM_MSR_EXIT_REASON_FILTER)
433 			__u32 reason; /* kernel -> user */
434 			__u32 index; /* kernel -> user */
435 			__u64 data; /* kernel <-> user */
436 		} msr;
437 		/* KVM_EXIT_XEN */
438 		struct kvm_xen_exit xen;
439 		/* KVM_EXIT_RISCV_SBI */
440 		struct {
441 			unsigned long extension_id;
442 			unsigned long function_id;
443 			unsigned long args[6];
444 			unsigned long ret[2];
445 		} riscv_sbi;
446 		/* KVM_EXIT_RISCV_CSR */
447 		struct {
448 			unsigned long csr_num;
449 			unsigned long new_value;
450 			unsigned long write_mask;
451 			unsigned long ret_value;
452 		} riscv_csr;
453 		/* KVM_EXIT_NOTIFY */
454 		struct {
455 #define KVM_NOTIFY_CONTEXT_INVALID	(1 << 0)
456 			__u32 flags;
457 		} notify;
458 		/* KVM_EXIT_MEMORY_FAULT */
459 		struct {
460 #define KVM_MEMORY_EXIT_FLAG_PRIVATE	(1ULL << 3)
461 			__u64 flags;
462 			__u64 gpa;
463 			__u64 size;
464 		} memory_fault;
465 		/* KVM_EXIT_TDX */
466 		struct {
467 			__u64 flags;
468 			__u64 nr;
469 			union {
470 				struct {
471 					__u64 ret;
472 					__u64 data[5];
473 				} unknown;
474 				struct {
475 					__u64 ret;
476 					__u64 gpa;
477 					__u64 size;
478 				} get_quote;
479 				struct {
480 					__u64 ret;
481 					__u64 leaf;
482 					__u64 r11, r12, r13, r14;
483 				} get_tdvmcall_info;
484 				struct {
485 					__u64 ret;
486 					__u64 vector;
487 				} setup_event_notify;
488 			};
489 		} tdx;
490 		/* KVM_EXIT_ARM_SEA */
491 		struct {
492 #define KVM_EXIT_ARM_SEA_FLAG_GPA_VALID	(1ULL << 0)
493 			__u64 flags;
494 			__u64 esr;
495 			__u64 gva;
496 			__u64 gpa;
497 		} arm_sea;
498 		/* KVM_EXIT_SNP_REQ_CERTS */
499 		struct kvm_exit_snp_req_certs snp_req_certs;
500 		/* Fix the size of the union. */
501 		char padding[256];
502 	};
503 
504 	/* 2048 is the size of the char array used to bound/pad the size
505 	 * of the union that holds sync regs.
506 	 */
507 	#define SYNC_REGS_SIZE_BYTES 2048
508 	/*
509 	 * shared registers between kvm and userspace.
510 	 * kvm_valid_regs specifies the register classes set by the host
511 	 * kvm_dirty_regs specified the register classes dirtied by userspace
512 	 * struct kvm_sync_regs is architecture specific, as well as the
513 	 * bits for kvm_valid_regs and kvm_dirty_regs
514 	 */
515 	__u64 kvm_valid_regs;
516 	__u64 kvm_dirty_regs;
517 	union {
518 		struct kvm_sync_regs regs;
519 		char padding[SYNC_REGS_SIZE_BYTES];
520 	} s;
521 };
522 
523 /* for KVM_REGISTER_COALESCED_MMIO / KVM_UNREGISTER_COALESCED_MMIO */
524 
525 struct kvm_coalesced_mmio_zone {
526 	__u64 addr;
527 	__u32 size;
528 	union {
529 		__u32 pad;
530 		__u32 pio;
531 	};
532 };
533 
534 struct kvm_coalesced_mmio {
535 	__u64 phys_addr;
536 	__u32 len;
537 	union {
538 		__u32 pad;
539 		__u32 pio;
540 	};
541 	__u8  data[8];
542 };
543 
544 struct kvm_coalesced_mmio_ring {
545 	__u32 first, last;
546 	__DECLARE_FLEX_ARRAY(struct kvm_coalesced_mmio, coalesced_mmio);
547 };
548 
549 #define KVM_COALESCED_MMIO_MAX \
550 	((PAGE_SIZE - sizeof(struct kvm_coalesced_mmio_ring)) / \
551 	 sizeof(struct kvm_coalesced_mmio))
552 
553 /* for KVM_TRANSLATE */
554 struct kvm_translation {
555 	/* in */
556 	__u64 linear_address;
557 
558 	/* out */
559 	__u64 physical_address;
560 	__u8  valid;
561 	__u8  writeable;
562 	__u8  usermode;
563 	__u8  pad[5];
564 };
565 
566 /* for KVM_INTERRUPT */
567 struct kvm_interrupt {
568 	/* in */
569 	__u32 irq;
570 };
571 
572 /* for KVM_GET_DIRTY_LOG */
573 struct kvm_dirty_log {
574 	__u32 slot;
575 	__u32 padding1;
576 	union {
577 		void __user *dirty_bitmap; /* one bit per page */
578 		__u64 padding2;
579 	};
580 };
581 
582 /* for KVM_CLEAR_DIRTY_LOG */
583 struct kvm_clear_dirty_log {
584 	__u32 slot;
585 	__u32 num_pages;
586 	__u64 first_page;
587 	union {
588 		void __user *dirty_bitmap; /* one bit per page */
589 		__u64 padding2;
590 	};
591 };
592 
593 /* for KVM_SET_SIGNAL_MASK */
594 struct kvm_signal_mask {
595 	__u32 len;
596 	__DECLARE_FLEX_ARRAY(__u8, sigset);
597 };
598 
599 /* for KVM_TPR_ACCESS_REPORTING */
600 struct kvm_tpr_access_ctl {
601 	__u32 enabled;
602 	__u32 flags;
603 	__u32 reserved[8];
604 };
605 
606 /* for KVM_SET_VAPIC_ADDR */
607 struct kvm_vapic_addr {
608 	__u64 vapic_addr;
609 };
610 
611 /* for KVM_SET_MP_STATE */
612 
613 /* not all states are valid on all architectures */
614 #define KVM_MP_STATE_RUNNABLE          0
615 #define KVM_MP_STATE_UNINITIALIZED     1
616 #define KVM_MP_STATE_INIT_RECEIVED     2
617 #define KVM_MP_STATE_HALTED            3
618 #define KVM_MP_STATE_SIPI_RECEIVED     4
619 #define KVM_MP_STATE_STOPPED           5
620 #define KVM_MP_STATE_CHECK_STOP        6
621 #define KVM_MP_STATE_OPERATING         7
622 #define KVM_MP_STATE_LOAD              8
623 #define KVM_MP_STATE_AP_RESET_HOLD     9
624 #define KVM_MP_STATE_SUSPENDED         10
625 
626 struct kvm_mp_state {
627 	__u32 mp_state;
628 };
629 
630 /* for KVM_SET_GUEST_DEBUG */
631 
632 #define KVM_GUESTDBG_ENABLE		0x00000001
633 #define KVM_GUESTDBG_SINGLESTEP		0x00000002
634 
635 struct kvm_guest_debug {
636 	__u32 control;
637 	__u32 pad;
638 	struct kvm_guest_debug_arch arch;
639 };
640 
641 enum {
642 	kvm_ioeventfd_flag_nr_datamatch,
643 	kvm_ioeventfd_flag_nr_pio,
644 	kvm_ioeventfd_flag_nr_deassign,
645 	kvm_ioeventfd_flag_nr_virtio_ccw_notify,
646 	kvm_ioeventfd_flag_nr_fast_mmio,
647 	kvm_ioeventfd_flag_nr_max,
648 };
649 
650 #define KVM_IOEVENTFD_FLAG_DATAMATCH (1 << kvm_ioeventfd_flag_nr_datamatch)
651 #define KVM_IOEVENTFD_FLAG_PIO       (1 << kvm_ioeventfd_flag_nr_pio)
652 #define KVM_IOEVENTFD_FLAG_DEASSIGN  (1 << kvm_ioeventfd_flag_nr_deassign)
653 #define KVM_IOEVENTFD_FLAG_VIRTIO_CCW_NOTIFY \
654 	(1 << kvm_ioeventfd_flag_nr_virtio_ccw_notify)
655 
656 #define KVM_IOEVENTFD_VALID_FLAG_MASK  ((1 << kvm_ioeventfd_flag_nr_max) - 1)
657 
658 struct kvm_ioeventfd {
659 	__u64 datamatch;
660 	__u64 addr;        /* legal pio/mmio address */
661 	__u32 len;         /* 1, 2, 4, or 8 bytes; or 0 to ignore length */
662 	__s32 fd;
663 	__u32 flags;
664 	__u8  pad[36];
665 };
666 
667 #define KVM_X86_DISABLE_EXITS_MWAIT          (1 << 0)
668 #define KVM_X86_DISABLE_EXITS_HLT            (1 << 1)
669 #define KVM_X86_DISABLE_EXITS_PAUSE          (1 << 2)
670 #define KVM_X86_DISABLE_EXITS_CSTATE         (1 << 3)
671 #define KVM_X86_DISABLE_EXITS_APERFMPERF     (1 << 4)
672 
673 /* for KVM_ENABLE_CAP */
674 struct kvm_enable_cap {
675 	/* in */
676 	__u32 cap;
677 	__u32 flags;
678 	__u64 args[4];
679 	__u8  pad[64];
680 };
681 
682 #define KVMIO 0xAE
683 
684 /* machine type bits, to be used as argument to KVM_CREATE_VM */
685 #define KVM_VM_S390_UCONTROL	1
686 
687 /* on ppc, 0 indicate default, 1 should force HV and 2 PR */
688 #define KVM_VM_PPC_HV 1
689 #define KVM_VM_PPC_PR 2
690 
691 /* on MIPS, 0 indicates auto, 1 forces VZ ASE, 2 forces trap & emulate */
692 #define KVM_VM_MIPS_AUTO	0
693 #define KVM_VM_MIPS_VZ		1
694 #define KVM_VM_MIPS_TE		2
695 
696 #define KVM_S390_SIE_PAGE_OFFSET 1
697 
698 /*
699  * On arm64, machine type can be used to request the physical
700  * address size for the VM. Bits[7-0] are reserved for the guest
701  * PA size shift (i.e, log2(PA_Size)). For backward compatibility,
702  * value 0 implies the default IPA size, 40bits.
703  */
704 #define KVM_VM_TYPE_ARM_IPA_SIZE_MASK	0xffULL
705 #define KVM_VM_TYPE_ARM_IPA_SIZE(x)		\
706 	((x) & KVM_VM_TYPE_ARM_IPA_SIZE_MASK)
707 
708 #define KVM_VM_TYPE_ARM_PROTECTED	(1UL << 31)
709 #define KVM_VM_TYPE_ARM_MASK		(KVM_VM_TYPE_ARM_IPA_SIZE_MASK | \
710 					 KVM_VM_TYPE_ARM_PROTECTED)
711 
712 /*
713  * ioctls for /dev/kvm fds:
714  */
715 #define KVM_GET_API_VERSION       _IO(KVMIO,   0x00)
716 #define KVM_CREATE_VM             _IO(KVMIO,   0x01) /* returns a VM fd */
717 #define KVM_GET_MSR_INDEX_LIST    _IOWR(KVMIO, 0x02, struct kvm_msr_list)
718 
719 #define KVM_S390_ENABLE_SIE       _IO(KVMIO,   0x06)
720 /*
721  * Check if a kvm extension is available.  Argument is extension number,
722  * return is 1 (yes) or 0 (no, sorry).
723  */
724 #define KVM_CHECK_EXTENSION       _IO(KVMIO,   0x03)
725 /*
726  * Get size for mmap(vcpu_fd)
727  */
728 #define KVM_GET_VCPU_MMAP_SIZE    _IO(KVMIO,   0x04) /* in bytes */
729 #define KVM_GET_SUPPORTED_CPUID   _IOWR(KVMIO, 0x05, struct kvm_cpuid2)
730 #define KVM_GET_EMULATED_CPUID	  _IOWR(KVMIO, 0x09, struct kvm_cpuid2)
731 #define KVM_GET_MSR_FEATURE_INDEX_LIST    _IOWR(KVMIO, 0x0a, struct kvm_msr_list)
732 
733 /*
734  * Extension capability list.
735  */
736 #define KVM_CAP_IRQCHIP	  0
737 #define KVM_CAP_HLT	  1
738 #define KVM_CAP_MMU_SHADOW_CACHE_CONTROL 2
739 #define KVM_CAP_USER_MEMORY 3
740 #define KVM_CAP_SET_TSS_ADDR 4
741 #define KVM_CAP_VAPIC 6
742 #define KVM_CAP_EXT_CPUID 7
743 #define KVM_CAP_CLOCKSOURCE 8
744 #define KVM_CAP_NR_VCPUS 9       /* returns recommended max vcpus per vm */
745 #define KVM_CAP_NR_MEMSLOTS 10   /* returns max memory slots per vm */
746 #define KVM_CAP_PIT 11
747 #define KVM_CAP_NOP_IO_DELAY 12
748 #define KVM_CAP_PV_MMU 13
749 #define KVM_CAP_MP_STATE 14
750 #define KVM_CAP_COALESCED_MMIO 15
751 #define KVM_CAP_SYNC_MMU 16  /* Changes to host mmap are reflected in guest */
752 #define KVM_CAP_IOMMU 18
753 /* Bug in KVM_SET_USER_MEMORY_REGION fixed: */
754 #define KVM_CAP_DESTROY_MEMORY_REGION_WORKS 21
755 #define KVM_CAP_USER_NMI 22
756 #define KVM_CAP_SET_GUEST_DEBUG 23
757 #ifdef __KVM_HAVE_PIT
758 #define KVM_CAP_REINJECT_CONTROL 24
759 #endif
760 #define KVM_CAP_IRQ_ROUTING 25
761 #define KVM_CAP_IRQ_INJECT_STATUS 26
762 #define KVM_CAP_ASSIGN_DEV_IRQ 29
763 /* Another bug in KVM_SET_USER_MEMORY_REGION fixed: */
764 #define KVM_CAP_JOIN_MEMORY_REGIONS_WORKS 30
765 #ifdef __KVM_HAVE_MCE
766 #define KVM_CAP_MCE 31
767 #endif
768 #define KVM_CAP_IRQFD 32
769 #ifdef __KVM_HAVE_PIT
770 #define KVM_CAP_PIT2 33
771 #endif
772 #define KVM_CAP_SET_BOOT_CPU_ID 34
773 #ifdef __KVM_HAVE_PIT_STATE2
774 #define KVM_CAP_PIT_STATE2 35
775 #endif
776 #define KVM_CAP_IOEVENTFD 36
777 #define KVM_CAP_SET_IDENTITY_MAP_ADDR 37
778 #ifdef __KVM_HAVE_XEN_HVM
779 #define KVM_CAP_XEN_HVM 38
780 #endif
781 #define KVM_CAP_ADJUST_CLOCK 39
782 #define KVM_CAP_INTERNAL_ERROR_DATA 40
783 #ifdef __KVM_HAVE_VCPU_EVENTS
784 #define KVM_CAP_VCPU_EVENTS 41
785 #endif
786 #define KVM_CAP_S390_PSW 42
787 #define KVM_CAP_PPC_SEGSTATE 43
788 #define KVM_CAP_HYPERV 44
789 #define KVM_CAP_HYPERV_VAPIC 45
790 #define KVM_CAP_HYPERV_SPIN 46
791 #define KVM_CAP_PCI_SEGMENT 47
792 #define KVM_CAP_PPC_PAIRED_SINGLES 48
793 #define KVM_CAP_INTR_SHADOW 49
794 #ifdef __KVM_HAVE_DEBUGREGS
795 #define KVM_CAP_DEBUGREGS 50
796 #endif
797 #define KVM_CAP_X86_ROBUST_SINGLESTEP 51
798 #define KVM_CAP_PPC_OSI 52
799 #define KVM_CAP_PPC_UNSET_IRQ 53
800 #define KVM_CAP_ENABLE_CAP 54
801 #ifdef __KVM_HAVE_XSAVE
802 #define KVM_CAP_XSAVE 55
803 #endif
804 #ifdef __KVM_HAVE_XCRS
805 #define KVM_CAP_XCRS 56
806 #endif
807 #define KVM_CAP_PPC_GET_PVINFO 57
808 #define KVM_CAP_PPC_IRQ_LEVEL 58
809 #define KVM_CAP_ASYNC_PF 59
810 #define KVM_CAP_TSC_CONTROL 60
811 #define KVM_CAP_GET_TSC_KHZ 61
812 #define KVM_CAP_PPC_BOOKE_SREGS 62
813 #define KVM_CAP_SPAPR_TCE 63
814 #define KVM_CAP_PPC_SMT 64
815 #define KVM_CAP_PPC_RMA	65
816 #define KVM_CAP_MAX_VCPUS 66       /* returns max vcpus per vm */
817 #define KVM_CAP_PPC_HIOR 67
818 #define KVM_CAP_PPC_PAPR 68
819 #define KVM_CAP_SW_TLB 69
820 #define KVM_CAP_ONE_REG 70
821 #define KVM_CAP_S390_GMAP 71
822 #define KVM_CAP_TSC_DEADLINE_TIMER 72
823 #define KVM_CAP_S390_UCONTROL 73
824 #define KVM_CAP_SYNC_REGS 74
825 #define KVM_CAP_PCI_2_3 75
826 #define KVM_CAP_KVMCLOCK_CTRL 76
827 #define KVM_CAP_SIGNAL_MSI 77
828 #define KVM_CAP_PPC_GET_SMMU_INFO 78
829 #define KVM_CAP_S390_COW 79
830 #define KVM_CAP_PPC_ALLOC_HTAB 80
831 #define KVM_CAP_READONLY_MEM 81
832 #define KVM_CAP_IRQFD_RESAMPLE 82
833 #define KVM_CAP_PPC_BOOKE_WATCHDOG 83
834 #define KVM_CAP_PPC_HTAB_FD 84
835 #define KVM_CAP_S390_CSS_SUPPORT 85
836 #define KVM_CAP_PPC_EPR 86
837 #define KVM_CAP_ARM_PSCI 87
838 #define KVM_CAP_ARM_SET_DEVICE_ADDR 88
839 #define KVM_CAP_DEVICE_CTRL 89
840 #define KVM_CAP_IRQ_MPIC 90
841 #define KVM_CAP_PPC_RTAS 91
842 #define KVM_CAP_IRQ_XICS 92
843 #define KVM_CAP_ARM_EL1_32BIT 93
844 #define KVM_CAP_SPAPR_MULTITCE 94
845 #define KVM_CAP_EXT_EMUL_CPUID 95
846 #define KVM_CAP_HYPERV_TIME 96
847 #define KVM_CAP_IOAPIC_POLARITY_IGNORED 97
848 #define KVM_CAP_ENABLE_CAP_VM 98
849 #define KVM_CAP_S390_IRQCHIP 99
850 #define KVM_CAP_IOEVENTFD_NO_LENGTH 100
851 #define KVM_CAP_VM_ATTRIBUTES 101
852 #define KVM_CAP_ARM_PSCI_0_2 102
853 #define KVM_CAP_PPC_FIXUP_HCALL 103
854 #define KVM_CAP_PPC_ENABLE_HCALL 104
855 #define KVM_CAP_CHECK_EXTENSION_VM 105
856 #define KVM_CAP_S390_USER_SIGP 106
857 #define KVM_CAP_S390_VECTOR_REGISTERS 107
858 #define KVM_CAP_S390_MEM_OP 108
859 #define KVM_CAP_S390_USER_STSI 109
860 #define KVM_CAP_S390_SKEYS 110
861 #define KVM_CAP_MIPS_FPU 111
862 #define KVM_CAP_MIPS_MSA 112
863 #define KVM_CAP_S390_INJECT_IRQ 113
864 #define KVM_CAP_S390_IRQ_STATE 114
865 #define KVM_CAP_PPC_HWRNG 115
866 #define KVM_CAP_DISABLE_QUIRKS 116
867 #define KVM_CAP_X86_SMM 117
868 #define KVM_CAP_MULTI_ADDRESS_SPACE 118
869 #define KVM_CAP_GUEST_DEBUG_HW_BPS 119
870 #define KVM_CAP_GUEST_DEBUG_HW_WPS 120
871 #define KVM_CAP_SPLIT_IRQCHIP 121
872 #define KVM_CAP_IOEVENTFD_ANY_LENGTH 122
873 #define KVM_CAP_HYPERV_SYNIC 123
874 #define KVM_CAP_S390_RI 124
875 #define KVM_CAP_SPAPR_TCE_64 125
876 #define KVM_CAP_ARM_PMU_V3 126
877 #define KVM_CAP_VCPU_ATTRIBUTES 127
878 #define KVM_CAP_MAX_VCPU_ID 128
879 #define KVM_CAP_X2APIC_API 129
880 #define KVM_CAP_S390_USER_INSTR0 130
881 #define KVM_CAP_MSI_DEVID 131
882 #define KVM_CAP_PPC_HTM 132
883 #define KVM_CAP_SPAPR_RESIZE_HPT 133
884 #define KVM_CAP_PPC_MMU_RADIX 134
885 #define KVM_CAP_PPC_MMU_HASH_V3 135
886 #define KVM_CAP_IMMEDIATE_EXIT 136
887 #define KVM_CAP_MIPS_VZ 137
888 #define KVM_CAP_MIPS_TE 138
889 #define KVM_CAP_MIPS_64BIT 139
890 #define KVM_CAP_S390_GS 140
891 #define KVM_CAP_S390_AIS 141
892 #define KVM_CAP_SPAPR_TCE_VFIO 142
893 #define KVM_CAP_X86_DISABLE_EXITS 143
894 #define KVM_CAP_ARM_USER_IRQ 144
895 #define KVM_CAP_S390_CMMA_MIGRATION 145
896 #define KVM_CAP_PPC_FWNMI 146
897 #define KVM_CAP_PPC_SMT_POSSIBLE 147
898 #define KVM_CAP_HYPERV_SYNIC2 148
899 #define KVM_CAP_HYPERV_VP_INDEX 149
900 #define KVM_CAP_S390_AIS_MIGRATION 150
901 #define KVM_CAP_PPC_GET_CPU_CHAR 151
902 #define KVM_CAP_S390_BPB 152
903 #define KVM_CAP_GET_MSR_FEATURES 153
904 #define KVM_CAP_HYPERV_EVENTFD 154
905 #define KVM_CAP_HYPERV_TLBFLUSH 155
906 #define KVM_CAP_S390_HPAGE_1M 156
907 #define KVM_CAP_NESTED_STATE 157
908 #define KVM_CAP_ARM_INJECT_SERROR_ESR 158
909 #define KVM_CAP_MSR_PLATFORM_INFO 159
910 #define KVM_CAP_PPC_NESTED_HV 160
911 #define KVM_CAP_HYPERV_SEND_IPI 161
912 #define KVM_CAP_COALESCED_PIO 162
913 #define KVM_CAP_HYPERV_ENLIGHTENED_VMCS 163
914 #define KVM_CAP_EXCEPTION_PAYLOAD 164
915 #define KVM_CAP_ARM_VM_IPA_SIZE 165
916 #define KVM_CAP_MANUAL_DIRTY_LOG_PROTECT 166 /* Obsolete */
917 #define KVM_CAP_HYPERV_CPUID 167
918 #define KVM_CAP_MANUAL_DIRTY_LOG_PROTECT2 168
919 #define KVM_CAP_PPC_IRQ_XIVE 169
920 #define KVM_CAP_ARM_SVE 170
921 #define KVM_CAP_ARM_PTRAUTH_ADDRESS 171
922 #define KVM_CAP_ARM_PTRAUTH_GENERIC 172
923 #define KVM_CAP_PMU_EVENT_FILTER 173
924 #define KVM_CAP_ARM_IRQ_LINE_LAYOUT_2 174
925 #define KVM_CAP_HYPERV_DIRECT_TLBFLUSH 175
926 #define KVM_CAP_PPC_GUEST_DEBUG_SSTEP 176
927 #define KVM_CAP_ARM_NISV_TO_USER 177
928 #define KVM_CAP_ARM_INJECT_EXT_DABT 178
929 #define KVM_CAP_S390_VCPU_RESETS 179
930 #define KVM_CAP_S390_PROTECTED 180
931 #define KVM_CAP_PPC_SECURE_GUEST 181
932 #define KVM_CAP_HALT_POLL 182
933 #define KVM_CAP_ASYNC_PF_INT 183
934 #define KVM_CAP_LAST_CPU 184
935 #define KVM_CAP_SMALLER_MAXPHYADDR 185
936 #define KVM_CAP_S390_DIAG318 186
937 #define KVM_CAP_STEAL_TIME 187
938 #define KVM_CAP_X86_USER_SPACE_MSR 188
939 #define KVM_CAP_X86_MSR_FILTER 189
940 #define KVM_CAP_ENFORCE_PV_FEATURE_CPUID 190
941 #define KVM_CAP_SYS_HYPERV_CPUID 191
942 #define KVM_CAP_DIRTY_LOG_RING 192
943 #define KVM_CAP_X86_BUS_LOCK_EXIT 193
944 #define KVM_CAP_PPC_DAWR1 194
945 #define KVM_CAP_SET_GUEST_DEBUG2 195
946 #define KVM_CAP_SGX_ATTRIBUTE 196
947 #define KVM_CAP_VM_COPY_ENC_CONTEXT_FROM 197
948 #define KVM_CAP_PTP_KVM 198
949 #define KVM_CAP_HYPERV_ENFORCE_CPUID 199
950 #define KVM_CAP_SREGS2 200
951 #define KVM_CAP_EXIT_HYPERCALL 201
952 #define KVM_CAP_PPC_RPT_INVALIDATE 202
953 #define KVM_CAP_BINARY_STATS_FD 203
954 #define KVM_CAP_EXIT_ON_EMULATION_FAILURE 204
955 #define KVM_CAP_ARM_MTE 205
956 #define KVM_CAP_VM_MOVE_ENC_CONTEXT_FROM 206
957 #define KVM_CAP_VM_GPA_BITS 207
958 #define KVM_CAP_XSAVE2 208
959 #define KVM_CAP_SYS_ATTRIBUTES 209
960 #define KVM_CAP_PPC_AIL_MODE_3 210
961 #define KVM_CAP_S390_MEM_OP_EXTENSION 211
962 #define KVM_CAP_PMU_CAPABILITY 212
963 #define KVM_CAP_DISABLE_QUIRKS2 213
964 #define KVM_CAP_VM_TSC_CONTROL 214
965 #define KVM_CAP_SYSTEM_EVENT_DATA 215
966 #define KVM_CAP_ARM_SYSTEM_SUSPEND 216
967 #define KVM_CAP_S390_PROTECTED_DUMP 217
968 #define KVM_CAP_X86_TRIPLE_FAULT_EVENT 218
969 #define KVM_CAP_X86_NOTIFY_VMEXIT 219
970 #define KVM_CAP_VM_DISABLE_NX_HUGE_PAGES 220
971 #define KVM_CAP_S390_ZPCI_OP 221
972 #define KVM_CAP_S390_CPU_TOPOLOGY 222
973 #define KVM_CAP_DIRTY_LOG_RING_ACQ_REL 223
974 #define KVM_CAP_S390_PROTECTED_ASYNC_DISABLE 224
975 #define KVM_CAP_DIRTY_LOG_RING_WITH_BITMAP 225
976 #define KVM_CAP_PMU_EVENT_MASKED_EVENTS 226
977 #define KVM_CAP_COUNTER_OFFSET 227
978 #define KVM_CAP_ARM_EAGER_SPLIT_CHUNK_SIZE 228
979 #define KVM_CAP_ARM_SUPPORTED_BLOCK_SIZES 229
980 #define KVM_CAP_ARM_SUPPORTED_REG_MASK_RANGES 230
981 #define KVM_CAP_USER_MEMORY2 231
982 #define KVM_CAP_MEMORY_FAULT_INFO 232
983 #define KVM_CAP_MEMORY_ATTRIBUTES 233
984 #define KVM_CAP_GUEST_MEMFD 234
985 #define KVM_CAP_VM_TYPES 235
986 #define KVM_CAP_PRE_FAULT_MEMORY 236
987 #define KVM_CAP_X86_APIC_BUS_CYCLES_NS 237
988 #define KVM_CAP_X86_GUEST_MODE 238
989 #define KVM_CAP_ARM_WRITABLE_IMP_ID_REGS 239
990 #define KVM_CAP_ARM_EL2 240
991 #define KVM_CAP_ARM_EL2_E2H0 241
992 #define KVM_CAP_RISCV_MP_STATE_RESET 242
993 #define KVM_CAP_ARM_CACHEABLE_PFNMAP_SUPPORTED 243
994 #define KVM_CAP_GUEST_MEMFD_FLAGS 244
995 #define KVM_CAP_ARM_SEA_TO_USER 245
996 #define KVM_CAP_S390_USER_OPEREXEC 246
997 #define KVM_CAP_S390_KEYOP 247
998 #define KVM_CAP_S390_VSIE_ESAMODE 248
999 #define KVM_CAP_S390_HPAGE_2G 249
1000 
1001 struct kvm_irq_routing_irqchip {
1002 	__u32 irqchip;
1003 	__u32 pin;
1004 };
1005 
1006 struct kvm_irq_routing_msi {
1007 	__u32 address_lo;
1008 	__u32 address_hi;
1009 	__u32 data;
1010 	union {
1011 		__u32 pad;
1012 		__u32 devid;
1013 	};
1014 };
1015 
1016 struct kvm_irq_routing_s390_adapter {
1017 	__u64 ind_addr;
1018 	__u64 summary_addr;
1019 	__u64 ind_offset;
1020 	__u32 summary_offset;
1021 	__u32 adapter_id;
1022 };
1023 
1024 struct kvm_irq_routing_hv_sint {
1025 	__u32 vcpu;
1026 	__u32 sint;
1027 };
1028 
1029 struct kvm_irq_routing_xen_evtchn {
1030 	__u32 port;
1031 	__u32 vcpu;
1032 	__u32 priority;
1033 };
1034 
1035 #define KVM_IRQ_ROUTING_XEN_EVTCHN_PRIO_2LEVEL ((__u32)(-1))
1036 
1037 /* gsi routing entry types */
1038 #define KVM_IRQ_ROUTING_IRQCHIP 1
1039 #define KVM_IRQ_ROUTING_MSI 2
1040 #define KVM_IRQ_ROUTING_S390_ADAPTER 3
1041 #define KVM_IRQ_ROUTING_HV_SINT 4
1042 #define KVM_IRQ_ROUTING_XEN_EVTCHN 5
1043 
1044 struct kvm_irq_routing_entry {
1045 	__u32 gsi;
1046 	__u32 type;
1047 	__u32 flags;
1048 	__u32 pad;
1049 	union {
1050 		struct kvm_irq_routing_irqchip irqchip;
1051 		struct kvm_irq_routing_msi msi;
1052 		struct kvm_irq_routing_s390_adapter adapter;
1053 		struct kvm_irq_routing_hv_sint hv_sint;
1054 		struct kvm_irq_routing_xen_evtchn xen_evtchn;
1055 		__u32 pad[8];
1056 	} u;
1057 };
1058 
1059 struct kvm_irq_routing {
1060 	__u32 nr;
1061 	__u32 flags;
1062 	__DECLARE_FLEX_ARRAY(struct kvm_irq_routing_entry, entries);
1063 };
1064 
1065 #define KVM_IRQFD_FLAG_DEASSIGN (1 << 0)
1066 /*
1067  * Available with KVM_CAP_IRQFD_RESAMPLE
1068  *
1069  * KVM_IRQFD_FLAG_RESAMPLE indicates resamplefd is valid and specifies
1070  * the irqfd to operate in resampling mode for level triggered interrupt
1071  * emulation.  See Documentation/virt/kvm/api.rst.
1072  */
1073 #define KVM_IRQFD_FLAG_RESAMPLE (1 << 1)
1074 
1075 struct kvm_irqfd {
1076 	__u32 fd;
1077 	__u32 gsi;
1078 	__u32 flags;
1079 	__u32 resamplefd;
1080 	__u8  pad[16];
1081 };
1082 
1083 /* For KVM_CAP_ADJUST_CLOCK */
1084 
1085 /* Do not use 1, KVM_CHECK_EXTENSION returned it before we had flags.  */
1086 #define KVM_CLOCK_TSC_STABLE		2
1087 #define KVM_CLOCK_REALTIME		(1 << 2)
1088 #define KVM_CLOCK_HOST_TSC		(1 << 3)
1089 
1090 struct kvm_clock_data {
1091 	__u64 clock;
1092 	__u32 flags;
1093 	__u32 pad0;
1094 	__u64 realtime;
1095 	__u64 host_tsc;
1096 	__u32 pad[4];
1097 };
1098 
1099 /* For KVM_CAP_SW_TLB */
1100 
1101 #define KVM_MMU_FSL_BOOKE_NOHV		0
1102 #define KVM_MMU_FSL_BOOKE_HV		1
1103 
1104 struct kvm_config_tlb {
1105 	__u64 params;
1106 	__u64 array;
1107 	__u32 mmu_type;
1108 	__u32 array_len;
1109 };
1110 
1111 struct kvm_dirty_tlb {
1112 	__u64 bitmap;
1113 	__u32 num_dirty;
1114 };
1115 
1116 /* Available with KVM_CAP_ONE_REG */
1117 
1118 #define KVM_REG_ARCH_MASK	0xff00000000000000ULL
1119 #define KVM_REG_GENERIC		0x0000000000000000ULL
1120 
1121 /*
1122  * Architecture specific registers are to be defined in arch headers and
1123  * ORed with the arch identifier.
1124  */
1125 #define KVM_REG_PPC		0x1000000000000000ULL
1126 #define KVM_REG_X86		0x2000000000000000ULL
1127 #define KVM_REG_IA64		0x3000000000000000ULL
1128 #define KVM_REG_ARM		0x4000000000000000ULL
1129 #define KVM_REG_S390		0x5000000000000000ULL
1130 #define KVM_REG_ARM64		0x6000000000000000ULL
1131 #define KVM_REG_MIPS		0x7000000000000000ULL
1132 #define KVM_REG_RISCV		0x8000000000000000ULL
1133 #define KVM_REG_LOONGARCH	0x9000000000000000ULL
1134 
1135 #define KVM_REG_SIZE_SHIFT	52
1136 #define KVM_REG_SIZE_MASK	0x00f0000000000000ULL
1137 
1138 #define KVM_REG_SIZE(id)		\
1139 	(1U << (((id) & KVM_REG_SIZE_MASK) >> KVM_REG_SIZE_SHIFT))
1140 
1141 #define KVM_REG_SIZE_U8		0x0000000000000000ULL
1142 #define KVM_REG_SIZE_U16	0x0010000000000000ULL
1143 #define KVM_REG_SIZE_U32	0x0020000000000000ULL
1144 #define KVM_REG_SIZE_U64	0x0030000000000000ULL
1145 #define KVM_REG_SIZE_U128	0x0040000000000000ULL
1146 #define KVM_REG_SIZE_U256	0x0050000000000000ULL
1147 #define KVM_REG_SIZE_U512	0x0060000000000000ULL
1148 #define KVM_REG_SIZE_U1024	0x0070000000000000ULL
1149 #define KVM_REG_SIZE_U2048	0x0080000000000000ULL
1150 
1151 struct kvm_reg_list {
1152 	__u64 n; /* number of regs */
1153 	__DECLARE_FLEX_ARRAY(__u64, reg);
1154 };
1155 
1156 struct kvm_one_reg {
1157 	__u64 id;
1158 	__u64 addr;
1159 };
1160 
1161 #define KVM_MSI_VALID_DEVID	(1U << 0)
1162 struct kvm_msi {
1163 	__u32 address_lo;
1164 	__u32 address_hi;
1165 	__u32 data;
1166 	__u32 flags;
1167 	__u32 devid;
1168 	__u8  pad[12];
1169 };
1170 
1171 struct kvm_arm_device_addr {
1172 	__u64 id;
1173 	__u64 addr;
1174 };
1175 
1176 /*
1177  * Device control API, available with KVM_CAP_DEVICE_CTRL
1178  */
1179 #define KVM_CREATE_DEVICE_TEST		1
1180 
1181 struct kvm_create_device {
1182 	__u32	type;	/* in: KVM_DEV_TYPE_xxx */
1183 	__u32	fd;	/* out: device handle */
1184 	__u32	flags;	/* in: KVM_CREATE_DEVICE_xxx */
1185 };
1186 
1187 struct kvm_device_attr {
1188 	__u32	flags;		/* no flags currently defined */
1189 	__u32	group;		/* device-defined */
1190 	__u64	attr;		/* group-defined */
1191 	__u64	addr;		/* userspace address of attr data */
1192 };
1193 
1194 #define  KVM_DEV_VFIO_FILE			1
1195 
1196 #define   KVM_DEV_VFIO_FILE_ADD			1
1197 #define   KVM_DEV_VFIO_FILE_DEL			2
1198 
1199 /* KVM_DEV_VFIO_GROUP aliases are for compile time uapi compatibility */
1200 #define  KVM_DEV_VFIO_GROUP	KVM_DEV_VFIO_FILE
1201 
1202 #define   KVM_DEV_VFIO_GROUP_ADD	KVM_DEV_VFIO_FILE_ADD
1203 #define   KVM_DEV_VFIO_GROUP_DEL	KVM_DEV_VFIO_FILE_DEL
1204 #define   KVM_DEV_VFIO_GROUP_SET_SPAPR_TCE		3
1205 
1206 enum kvm_device_type {
1207 	KVM_DEV_TYPE_FSL_MPIC_20	= 1,
1208 #define KVM_DEV_TYPE_FSL_MPIC_20	KVM_DEV_TYPE_FSL_MPIC_20
1209 	KVM_DEV_TYPE_FSL_MPIC_42,
1210 #define KVM_DEV_TYPE_FSL_MPIC_42	KVM_DEV_TYPE_FSL_MPIC_42
1211 	KVM_DEV_TYPE_XICS,
1212 #define KVM_DEV_TYPE_XICS		KVM_DEV_TYPE_XICS
1213 	KVM_DEV_TYPE_VFIO,
1214 #define KVM_DEV_TYPE_VFIO		KVM_DEV_TYPE_VFIO
1215 	KVM_DEV_TYPE_ARM_VGIC_V2,
1216 #define KVM_DEV_TYPE_ARM_VGIC_V2	KVM_DEV_TYPE_ARM_VGIC_V2
1217 	KVM_DEV_TYPE_FLIC,
1218 #define KVM_DEV_TYPE_FLIC		KVM_DEV_TYPE_FLIC
1219 	KVM_DEV_TYPE_ARM_VGIC_V3,
1220 #define KVM_DEV_TYPE_ARM_VGIC_V3	KVM_DEV_TYPE_ARM_VGIC_V3
1221 	KVM_DEV_TYPE_ARM_VGIC_ITS,
1222 #define KVM_DEV_TYPE_ARM_VGIC_ITS	KVM_DEV_TYPE_ARM_VGIC_ITS
1223 	KVM_DEV_TYPE_XIVE,
1224 #define KVM_DEV_TYPE_XIVE		KVM_DEV_TYPE_XIVE
1225 	KVM_DEV_TYPE_ARM_PV_TIME,
1226 #define KVM_DEV_TYPE_ARM_PV_TIME	KVM_DEV_TYPE_ARM_PV_TIME
1227 	KVM_DEV_TYPE_RISCV_AIA,
1228 #define KVM_DEV_TYPE_RISCV_AIA		KVM_DEV_TYPE_RISCV_AIA
1229 	KVM_DEV_TYPE_LOONGARCH_IPI,
1230 #define KVM_DEV_TYPE_LOONGARCH_IPI	KVM_DEV_TYPE_LOONGARCH_IPI
1231 	KVM_DEV_TYPE_LOONGARCH_EIOINTC,
1232 #define KVM_DEV_TYPE_LOONGARCH_EIOINTC	KVM_DEV_TYPE_LOONGARCH_EIOINTC
1233 	KVM_DEV_TYPE_LOONGARCH_PCHPIC,
1234 #define KVM_DEV_TYPE_LOONGARCH_PCHPIC	KVM_DEV_TYPE_LOONGARCH_PCHPIC
1235 	KVM_DEV_TYPE_LOONGARCH_DMSINTC,
1236 #define KVM_DEV_TYPE_LOONGARCH_DMSINTC	KVM_DEV_TYPE_LOONGARCH_DMSINTC
1237 	KVM_DEV_TYPE_ARM_VGIC_V5,
1238 #define KVM_DEV_TYPE_ARM_VGIC_V5	KVM_DEV_TYPE_ARM_VGIC_V5
1239 
1240 	KVM_DEV_TYPE_MAX,
1241 
1242 };
1243 
1244 struct kvm_vfio_spapr_tce {
1245 	__s32	groupfd;
1246 	__s32	tablefd;
1247 };
1248 
1249 #define KVM_S390_KEYOP_ISKE 0x01
1250 #define KVM_S390_KEYOP_RRBE 0x02
1251 #define KVM_S390_KEYOP_SSKE 0x03
1252 struct kvm_s390_keyop {
1253 	__u64 guest_addr;
1254 	__u8  key;
1255 	__u8  operation;
1256 	__u8  pad[6];
1257 };
1258 
1259 /*
1260  * KVM_CREATE_VCPU receives as a parameter the vcpu slot, and returns
1261  * a vcpu fd.
1262  */
1263 #define KVM_CREATE_VCPU           _IO(KVMIO,   0x41)
1264 #define KVM_GET_DIRTY_LOG         _IOW(KVMIO,  0x42, struct kvm_dirty_log)
1265 #define KVM_SET_NR_MMU_PAGES      _IO(KVMIO,   0x44)
1266 #define KVM_GET_NR_MMU_PAGES      _IO(KVMIO,   0x45)  /* deprecated */
1267 #define KVM_SET_USER_MEMORY_REGION _IOW(KVMIO, 0x46, \
1268 					struct kvm_userspace_memory_region)
1269 #define KVM_SET_TSS_ADDR          _IO(KVMIO,   0x47)
1270 #define KVM_SET_IDENTITY_MAP_ADDR _IOW(KVMIO,  0x48, __u64)
1271 #define KVM_SET_USER_MEMORY_REGION2 _IOW(KVMIO, 0x49, \
1272 					 struct kvm_userspace_memory_region2)
1273 
1274 /* enable ucontrol for s390 */
1275 #define KVM_S390_UCAS_MAP        _IOW(KVMIO, 0x50, struct kvm_s390_ucas_mapping)
1276 #define KVM_S390_UCAS_UNMAP      _IOW(KVMIO, 0x51, struct kvm_s390_ucas_mapping)
1277 #define KVM_S390_VCPU_FAULT	 _IOW(KVMIO, 0x52, unsigned long)
1278 #define KVM_S390_KEYOP           _IOWR(KVMIO, 0x53, struct kvm_s390_keyop)
1279 
1280 /* Device model IOC */
1281 #define KVM_CREATE_IRQCHIP        _IO(KVMIO,   0x60)
1282 #define KVM_IRQ_LINE              _IOW(KVMIO,  0x61, struct kvm_irq_level)
1283 #define KVM_GET_IRQCHIP           _IOWR(KVMIO, 0x62, struct kvm_irqchip)
1284 #define KVM_SET_IRQCHIP           _IOR(KVMIO,  0x63, struct kvm_irqchip)
1285 #define KVM_CREATE_PIT            _IO(KVMIO,   0x64)
1286 #define KVM_GET_PIT               _IOWR(KVMIO, 0x65, struct kvm_pit_state)
1287 #define KVM_SET_PIT               _IOR(KVMIO,  0x66, struct kvm_pit_state)
1288 #define KVM_IRQ_LINE_STATUS       _IOWR(KVMIO, 0x67, struct kvm_irq_level)
1289 #define KVM_REGISTER_COALESCED_MMIO \
1290 			_IOW(KVMIO,  0x67, struct kvm_coalesced_mmio_zone)
1291 #define KVM_UNREGISTER_COALESCED_MMIO \
1292 			_IOW(KVMIO,  0x68, struct kvm_coalesced_mmio_zone)
1293 #define KVM_SET_GSI_ROUTING       _IOW(KVMIO,  0x6a, struct kvm_irq_routing)
1294 #define KVM_REINJECT_CONTROL      _IO(KVMIO,   0x71)
1295 #define KVM_IRQFD                 _IOW(KVMIO,  0x76, struct kvm_irqfd)
1296 #define KVM_CREATE_PIT2		  _IOW(KVMIO,  0x77, struct kvm_pit_config)
1297 #define KVM_SET_BOOT_CPU_ID       _IO(KVMIO,   0x78)
1298 #define KVM_IOEVENTFD             _IOW(KVMIO,  0x79, struct kvm_ioeventfd)
1299 #define KVM_XEN_HVM_CONFIG        _IOW(KVMIO,  0x7a, struct kvm_xen_hvm_config)
1300 #define KVM_SET_CLOCK             _IOW(KVMIO,  0x7b, struct kvm_clock_data)
1301 #define KVM_GET_CLOCK             _IOR(KVMIO,  0x7c, struct kvm_clock_data)
1302 /* Available with KVM_CAP_PIT_STATE2 */
1303 #define KVM_GET_PIT2              _IOR(KVMIO,  0x9f, struct kvm_pit_state2)
1304 #define KVM_SET_PIT2              _IOW(KVMIO,  0xa0, struct kvm_pit_state2)
1305 /* Available with KVM_CAP_PPC_GET_PVINFO */
1306 #define KVM_PPC_GET_PVINFO	  _IOW(KVMIO,  0xa1, struct kvm_ppc_pvinfo)
1307 /* Available with KVM_CAP_TSC_CONTROL for a vCPU, or with
1308 *  KVM_CAP_VM_TSC_CONTROL to set defaults for a VM */
1309 #define KVM_SET_TSC_KHZ           _IO(KVMIO,  0xa2)
1310 #define KVM_GET_TSC_KHZ           _IO(KVMIO,  0xa3)
1311 /* Available with KVM_CAP_SIGNAL_MSI */
1312 #define KVM_SIGNAL_MSI            _IOW(KVMIO,  0xa5, struct kvm_msi)
1313 /* Available with KVM_CAP_PPC_GET_SMMU_INFO */
1314 #define KVM_PPC_GET_SMMU_INFO	  _IOR(KVMIO,  0xa6, struct kvm_ppc_smmu_info)
1315 /* Available with KVM_CAP_PPC_ALLOC_HTAB */
1316 #define KVM_PPC_ALLOCATE_HTAB	  _IOWR(KVMIO, 0xa7, __u32)
1317 #define KVM_CREATE_SPAPR_TCE	  _IOW(KVMIO,  0xa8, struct kvm_create_spapr_tce)
1318 #define KVM_CREATE_SPAPR_TCE_64	  _IOW(KVMIO,  0xa8, \
1319 				       struct kvm_create_spapr_tce_64)
1320 /* Available with KVM_CAP_RMA */
1321 #define KVM_ALLOCATE_RMA	  _IOR(KVMIO,  0xa9, struct kvm_allocate_rma)
1322 /* Available with KVM_CAP_PPC_HTAB_FD */
1323 #define KVM_PPC_GET_HTAB_FD	  _IOW(KVMIO,  0xaa, struct kvm_get_htab_fd)
1324 /* Available with KVM_CAP_ARM_SET_DEVICE_ADDR */
1325 #define KVM_ARM_SET_DEVICE_ADDR	  _IOW(KVMIO,  0xab, struct kvm_arm_device_addr)
1326 /* Available with KVM_CAP_PPC_RTAS */
1327 #define KVM_PPC_RTAS_DEFINE_TOKEN _IOW(KVMIO,  0xac, struct kvm_rtas_token_args)
1328 /* Available with KVM_CAP_SPAPR_RESIZE_HPT */
1329 #define KVM_PPC_RESIZE_HPT_PREPARE _IOR(KVMIO, 0xad, struct kvm_ppc_resize_hpt)
1330 #define KVM_PPC_RESIZE_HPT_COMMIT  _IOR(KVMIO, 0xae, struct kvm_ppc_resize_hpt)
1331 /* Available with KVM_CAP_PPC_MMU_RADIX or KVM_CAP_PPC_MMU_HASH_V3 */
1332 #define KVM_PPC_CONFIGURE_V3_MMU  _IOW(KVMIO,  0xaf, struct kvm_ppc_mmuv3_cfg)
1333 /* Available with KVM_CAP_PPC_MMU_RADIX */
1334 #define KVM_PPC_GET_RMMU_INFO	  _IOW(KVMIO,  0xb0, struct kvm_ppc_rmmu_info)
1335 /* Available with KVM_CAP_PPC_GET_CPU_CHAR */
1336 #define KVM_PPC_GET_CPU_CHAR	  _IOR(KVMIO,  0xb1, struct kvm_ppc_cpu_char)
1337 /* Available with KVM_CAP_PMU_EVENT_FILTER */
1338 #define KVM_SET_PMU_EVENT_FILTER  _IOW(KVMIO,  0xb2, struct kvm_pmu_event_filter)
1339 #define KVM_PPC_SVM_OFF		  _IO(KVMIO,  0xb3)
1340 #define KVM_ARM_MTE_COPY_TAGS	  _IOR(KVMIO,  0xb4, struct kvm_arm_copy_mte_tags)
1341 /* Available with KVM_CAP_COUNTER_OFFSET */
1342 #define KVM_ARM_SET_COUNTER_OFFSET _IOW(KVMIO,  0xb5, struct kvm_arm_counter_offset)
1343 #define KVM_ARM_GET_REG_WRITABLE_MASKS _IOR(KVMIO,  0xb6, struct reg_mask_range)
1344 
1345 /* ioctl for vm fd */
1346 #define KVM_CREATE_DEVICE	  _IOWR(KVMIO,  0xe0, struct kvm_create_device)
1347 
1348 /* ioctls for fds returned by KVM_CREATE_DEVICE */
1349 #define KVM_SET_DEVICE_ATTR	  _IOW(KVMIO,  0xe1, struct kvm_device_attr)
1350 #define KVM_GET_DEVICE_ATTR	  _IOW(KVMIO,  0xe2, struct kvm_device_attr)
1351 #define KVM_HAS_DEVICE_ATTR	  _IOW(KVMIO,  0xe3, struct kvm_device_attr)
1352 
1353 /*
1354  * ioctls for vcpu fds
1355  */
1356 #define KVM_RUN                   _IO(KVMIO,   0x80)
1357 #define KVM_GET_REGS              _IOR(KVMIO,  0x81, struct kvm_regs)
1358 #define KVM_SET_REGS              _IOW(KVMIO,  0x82, struct kvm_regs)
1359 #define KVM_GET_SREGS             _IOR(KVMIO,  0x83, struct kvm_sregs)
1360 #define KVM_SET_SREGS             _IOW(KVMIO,  0x84, struct kvm_sregs)
1361 #define KVM_TRANSLATE             _IOWR(KVMIO, 0x85, struct kvm_translation)
1362 #define KVM_INTERRUPT             _IOW(KVMIO,  0x86, struct kvm_interrupt)
1363 #define KVM_GET_MSRS              _IOWR(KVMIO, 0x88, struct kvm_msrs)
1364 #define KVM_SET_MSRS              _IOW(KVMIO,  0x89, struct kvm_msrs)
1365 #define KVM_SET_CPUID             _IOW(KVMIO,  0x8a, struct kvm_cpuid)
1366 #define KVM_SET_SIGNAL_MASK       _IOW(KVMIO,  0x8b, struct kvm_signal_mask)
1367 #define KVM_GET_FPU               _IOR(KVMIO,  0x8c, struct kvm_fpu)
1368 #define KVM_SET_FPU               _IOW(KVMIO,  0x8d, struct kvm_fpu)
1369 #define KVM_GET_LAPIC             _IOR(KVMIO,  0x8e, struct kvm_lapic_state)
1370 #define KVM_SET_LAPIC             _IOW(KVMIO,  0x8f, struct kvm_lapic_state)
1371 #define KVM_SET_CPUID2            _IOW(KVMIO,  0x90, struct kvm_cpuid2)
1372 #define KVM_GET_CPUID2            _IOWR(KVMIO, 0x91, struct kvm_cpuid2)
1373 /* Available with KVM_CAP_VAPIC */
1374 #define KVM_TPR_ACCESS_REPORTING  _IOWR(KVMIO, 0x92, struct kvm_tpr_access_ctl)
1375 /* Available with KVM_CAP_VAPIC */
1376 #define KVM_SET_VAPIC_ADDR        _IOW(KVMIO,  0x93, struct kvm_vapic_addr)
1377 /* valid for virtual machine (for floating interrupt)_and_ vcpu */
1378 #define KVM_S390_INTERRUPT        _IOW(KVMIO,  0x94, struct kvm_s390_interrupt)
1379 /* store status for s390 */
1380 #define KVM_S390_STORE_STATUS_NOADDR    (-1ul)
1381 #define KVM_S390_STORE_STATUS_PREFIXED  (-2ul)
1382 #define KVM_S390_STORE_STATUS	  _IOW(KVMIO,  0x95, unsigned long)
1383 /* initial ipl psw for s390 */
1384 #define KVM_S390_SET_INITIAL_PSW  _IOW(KVMIO,  0x96, struct kvm_s390_psw)
1385 /* initial reset for s390 */
1386 #define KVM_S390_INITIAL_RESET    _IO(KVMIO,   0x97)
1387 #define KVM_GET_MP_STATE          _IOR(KVMIO,  0x98, struct kvm_mp_state)
1388 #define KVM_SET_MP_STATE          _IOW(KVMIO,  0x99, struct kvm_mp_state)
1389 /* Available with KVM_CAP_USER_NMI */
1390 #define KVM_NMI                   _IO(KVMIO,   0x9a)
1391 /* Available with KVM_CAP_SET_GUEST_DEBUG */
1392 #define KVM_SET_GUEST_DEBUG       _IOW(KVMIO,  0x9b, struct kvm_guest_debug)
1393 /* MCE for x86 */
1394 #define KVM_X86_SETUP_MCE         _IOW(KVMIO,  0x9c, __u64)
1395 #define KVM_X86_GET_MCE_CAP_SUPPORTED _IOR(KVMIO,  0x9d, __u64)
1396 #define KVM_X86_SET_MCE           _IOW(KVMIO,  0x9e, struct kvm_x86_mce)
1397 /* Available with KVM_CAP_VCPU_EVENTS */
1398 #define KVM_GET_VCPU_EVENTS       _IOR(KVMIO,  0x9f, struct kvm_vcpu_events)
1399 #define KVM_SET_VCPU_EVENTS       _IOW(KVMIO,  0xa0, struct kvm_vcpu_events)
1400 /* Available with KVM_CAP_DEBUGREGS */
1401 #define KVM_GET_DEBUGREGS         _IOR(KVMIO,  0xa1, struct kvm_debugregs)
1402 #define KVM_SET_DEBUGREGS         _IOW(KVMIO,  0xa2, struct kvm_debugregs)
1403 /*
1404  * vcpu version available with KVM_CAP_ENABLE_CAP
1405  * vm version available with KVM_CAP_ENABLE_CAP_VM
1406  */
1407 #define KVM_ENABLE_CAP            _IOW(KVMIO,  0xa3, struct kvm_enable_cap)
1408 /* Available with KVM_CAP_XSAVE */
1409 #define KVM_GET_XSAVE		  _IOR(KVMIO,  0xa4, struct kvm_xsave)
1410 #define KVM_SET_XSAVE		  _IOW(KVMIO,  0xa5, struct kvm_xsave)
1411 /* Available with KVM_CAP_XCRS */
1412 #define KVM_GET_XCRS		  _IOR(KVMIO,  0xa6, struct kvm_xcrs)
1413 #define KVM_SET_XCRS		  _IOW(KVMIO,  0xa7, struct kvm_xcrs)
1414 /* Available with KVM_CAP_SW_TLB */
1415 #define KVM_DIRTY_TLB		  _IOW(KVMIO,  0xaa, struct kvm_dirty_tlb)
1416 /* Available with KVM_CAP_ONE_REG */
1417 #define KVM_GET_ONE_REG		  _IOW(KVMIO,  0xab, struct kvm_one_reg)
1418 #define KVM_SET_ONE_REG		  _IOW(KVMIO,  0xac, struct kvm_one_reg)
1419 /* VM is being stopped by host */
1420 #define KVM_KVMCLOCK_CTRL	  _IO(KVMIO,   0xad)
1421 #define KVM_ARM_VCPU_INIT	  _IOW(KVMIO,  0xae, struct kvm_vcpu_init)
1422 #define KVM_ARM_PREFERRED_TARGET  _IOR(KVMIO,  0xaf, struct kvm_vcpu_init)
1423 #define KVM_GET_REG_LIST	  _IOWR(KVMIO, 0xb0, struct kvm_reg_list)
1424 /* Available with KVM_CAP_S390_MEM_OP */
1425 #define KVM_S390_MEM_OP		  _IOW(KVMIO,  0xb1, struct kvm_s390_mem_op)
1426 /* Available with KVM_CAP_S390_SKEYS */
1427 #define KVM_S390_GET_SKEYS      _IOW(KVMIO, 0xb2, struct kvm_s390_skeys)
1428 #define KVM_S390_SET_SKEYS      _IOW(KVMIO, 0xb3, struct kvm_s390_skeys)
1429 /* Available with KVM_CAP_S390_INJECT_IRQ */
1430 #define KVM_S390_IRQ              _IOW(KVMIO,  0xb4, struct kvm_s390_irq)
1431 /* Available with KVM_CAP_S390_IRQ_STATE */
1432 #define KVM_S390_SET_IRQ_STATE	  _IOW(KVMIO, 0xb5, struct kvm_s390_irq_state)
1433 #define KVM_S390_GET_IRQ_STATE	  _IOW(KVMIO, 0xb6, struct kvm_s390_irq_state)
1434 /* Available with KVM_CAP_X86_SMM */
1435 #define KVM_SMI                   _IO(KVMIO,   0xb7)
1436 /* Available with KVM_CAP_S390_CMMA_MIGRATION */
1437 #define KVM_S390_GET_CMMA_BITS      _IOWR(KVMIO, 0xb8, struct kvm_s390_cmma_log)
1438 #define KVM_S390_SET_CMMA_BITS      _IOW(KVMIO, 0xb9, struct kvm_s390_cmma_log)
1439 /* Memory Encryption Commands */
1440 #define KVM_MEMORY_ENCRYPT_OP      _IOWR(KVMIO, 0xba, unsigned long)
1441 
1442 struct kvm_enc_region {
1443 	__u64 addr;
1444 	__u64 size;
1445 };
1446 
1447 #define KVM_MEMORY_ENCRYPT_REG_REGION    _IOR(KVMIO, 0xbb, struct kvm_enc_region)
1448 #define KVM_MEMORY_ENCRYPT_UNREG_REGION  _IOR(KVMIO, 0xbc, struct kvm_enc_region)
1449 
1450 /* Available with KVM_CAP_HYPERV_EVENTFD */
1451 #define KVM_HYPERV_EVENTFD        _IOW(KVMIO,  0xbd, struct kvm_hyperv_eventfd)
1452 
1453 /* Available with KVM_CAP_NESTED_STATE */
1454 #define KVM_GET_NESTED_STATE         _IOWR(KVMIO, 0xbe, struct kvm_nested_state)
1455 #define KVM_SET_NESTED_STATE         _IOW(KVMIO,  0xbf, struct kvm_nested_state)
1456 
1457 /* Available with KVM_CAP_MANUAL_DIRTY_LOG_PROTECT_2 */
1458 #define KVM_CLEAR_DIRTY_LOG          _IOWR(KVMIO, 0xc0, struct kvm_clear_dirty_log)
1459 
1460 /* Available with KVM_CAP_HYPERV_CPUID (vcpu) / KVM_CAP_SYS_HYPERV_CPUID (system) */
1461 #define KVM_GET_SUPPORTED_HV_CPUID _IOWR(KVMIO, 0xc1, struct kvm_cpuid2)
1462 
1463 /* Available with KVM_CAP_ARM_SVE */
1464 #define KVM_ARM_VCPU_FINALIZE	  _IOW(KVMIO,  0xc2, int)
1465 
1466 /* Available with  KVM_CAP_S390_VCPU_RESETS */
1467 #define KVM_S390_NORMAL_RESET	_IO(KVMIO,   0xc3)
1468 #define KVM_S390_CLEAR_RESET	_IO(KVMIO,   0xc4)
1469 
1470 /* Available with KVM_CAP_S390_PROTECTED */
1471 #define KVM_S390_PV_COMMAND		_IOWR(KVMIO, 0xc5, struct kvm_pv_cmd)
1472 
1473 /* Available with KVM_CAP_X86_MSR_FILTER */
1474 #define KVM_X86_SET_MSR_FILTER	_IOW(KVMIO,  0xc6, struct kvm_msr_filter)
1475 
1476 /* Available with KVM_CAP_DIRTY_LOG_RING */
1477 #define KVM_RESET_DIRTY_RINGS		_IO(KVMIO, 0xc7)
1478 
1479 /* Per-VM Xen attributes */
1480 #define KVM_XEN_HVM_GET_ATTR	_IOWR(KVMIO, 0xc8, struct kvm_xen_hvm_attr)
1481 #define KVM_XEN_HVM_SET_ATTR	_IOW(KVMIO,  0xc9, struct kvm_xen_hvm_attr)
1482 
1483 /* Per-vCPU Xen attributes */
1484 #define KVM_XEN_VCPU_GET_ATTR	_IOWR(KVMIO, 0xca, struct kvm_xen_vcpu_attr)
1485 #define KVM_XEN_VCPU_SET_ATTR	_IOW(KVMIO,  0xcb, struct kvm_xen_vcpu_attr)
1486 
1487 /* Available with KVM_CAP_XEN_HVM / KVM_XEN_HVM_CONFIG_EVTCHN_SEND */
1488 #define KVM_XEN_HVM_EVTCHN_SEND	_IOW(KVMIO,  0xd0, struct kvm_irq_routing_xen_evtchn)
1489 
1490 #define KVM_GET_SREGS2             _IOR(KVMIO,  0xcc, struct kvm_sregs2)
1491 #define KVM_SET_SREGS2             _IOW(KVMIO,  0xcd, struct kvm_sregs2)
1492 
1493 #define KVM_DIRTY_LOG_MANUAL_PROTECT_ENABLE    (1 << 0)
1494 #define KVM_DIRTY_LOG_INITIALLY_SET            (1 << 1)
1495 
1496 /*
1497  * Arch needs to define the macro after implementing the dirty ring
1498  * feature.  KVM_DIRTY_LOG_PAGE_OFFSET should be defined as the
1499  * starting page offset of the dirty ring structures.
1500  */
1501 #ifndef KVM_DIRTY_LOG_PAGE_OFFSET
1502 #define KVM_DIRTY_LOG_PAGE_OFFSET 0
1503 #endif
1504 
1505 /*
1506  * KVM dirty GFN flags, defined as:
1507  *
1508  * |---------------+---------------+--------------|
1509  * | bit 1 (reset) | bit 0 (dirty) | Status       |
1510  * |---------------+---------------+--------------|
1511  * |             0 |             0 | Invalid GFN  |
1512  * |             0 |             1 | Dirty GFN    |
1513  * |             1 |             X | GFN to reset |
1514  * |---------------+---------------+--------------|
1515  *
1516  * Lifecycle of a dirty GFN goes like:
1517  *
1518  *      dirtied         harvested        reset
1519  * 00 -----------> 01 -------------> 1X -------+
1520  *  ^                                          |
1521  *  |                                          |
1522  *  +------------------------------------------+
1523  *
1524  * The userspace program is only responsible for the 01->1X state
1525  * conversion after harvesting an entry.  Also, it must not skip any
1526  * dirty bits, so that dirty bits are always harvested in sequence.
1527  */
1528 #define KVM_DIRTY_GFN_F_DIRTY           _BITUL(0)
1529 #define KVM_DIRTY_GFN_F_RESET           _BITUL(1)
1530 #define KVM_DIRTY_GFN_F_MASK            0x3
1531 
1532 /*
1533  * KVM dirty rings should be mapped at KVM_DIRTY_LOG_PAGE_OFFSET of
1534  * per-vcpu mmaped regions as an array of struct kvm_dirty_gfn.  The
1535  * size of the gfn buffer is decided by the first argument when
1536  * enabling KVM_CAP_DIRTY_LOG_RING.
1537  */
1538 struct kvm_dirty_gfn {
1539 	__u32 flags;
1540 	__u32 slot;
1541 	__u64 offset;
1542 };
1543 
1544 #define KVM_BUS_LOCK_DETECTION_OFF             (1 << 0)
1545 #define KVM_BUS_LOCK_DETECTION_EXIT            (1 << 1)
1546 
1547 #define KVM_PMU_CAP_DISABLE                    (1 << 0)
1548 
1549 /**
1550  * struct kvm_stats_header - Header of per vm/vcpu binary statistics data.
1551  * @flags: Some extra information for header, always 0 for now.
1552  * @name_size: The size in bytes of the memory which contains statistics
1553  *             name string including trailing '\0'. The memory is allocated
1554  *             at the send of statistics descriptor.
1555  * @num_desc: The number of statistics the vm or vcpu has.
1556  * @id_offset: The offset of the vm/vcpu stats' id string in the file pointed
1557  *             by vm/vcpu stats fd.
1558  * @desc_offset: The offset of the vm/vcpu stats' descriptor block in the file
1559  *               pointd by vm/vcpu stats fd.
1560  * @data_offset: The offset of the vm/vcpu stats' data block in the file
1561  *               pointed by vm/vcpu stats fd.
1562  *
1563  * This is the header userspace needs to read from stats fd before any other
1564  * readings. It is used by userspace to discover all the information about the
1565  * vm/vcpu's binary statistics.
1566  * Userspace reads this header from the start of the vm/vcpu's stats fd.
1567  */
1568 struct kvm_stats_header {
1569 	__u32 flags;
1570 	__u32 name_size;
1571 	__u32 num_desc;
1572 	__u32 id_offset;
1573 	__u32 desc_offset;
1574 	__u32 data_offset;
1575 };
1576 
1577 #define KVM_STATS_TYPE_SHIFT		0
1578 #define KVM_STATS_TYPE_MASK		(0xF << KVM_STATS_TYPE_SHIFT)
1579 #define KVM_STATS_TYPE_CUMULATIVE	(0x0 << KVM_STATS_TYPE_SHIFT)
1580 #define KVM_STATS_TYPE_INSTANT		(0x1 << KVM_STATS_TYPE_SHIFT)
1581 #define KVM_STATS_TYPE_PEAK		(0x2 << KVM_STATS_TYPE_SHIFT)
1582 #define KVM_STATS_TYPE_LINEAR_HIST	(0x3 << KVM_STATS_TYPE_SHIFT)
1583 #define KVM_STATS_TYPE_LOG_HIST		(0x4 << KVM_STATS_TYPE_SHIFT)
1584 #define KVM_STATS_TYPE_MAX		KVM_STATS_TYPE_LOG_HIST
1585 
1586 #define KVM_STATS_UNIT_SHIFT		4
1587 #define KVM_STATS_UNIT_MASK		(0xF << KVM_STATS_UNIT_SHIFT)
1588 #define KVM_STATS_UNIT_NONE		(0x0 << KVM_STATS_UNIT_SHIFT)
1589 #define KVM_STATS_UNIT_BYTES		(0x1 << KVM_STATS_UNIT_SHIFT)
1590 #define KVM_STATS_UNIT_SECONDS		(0x2 << KVM_STATS_UNIT_SHIFT)
1591 #define KVM_STATS_UNIT_CYCLES		(0x3 << KVM_STATS_UNIT_SHIFT)
1592 #define KVM_STATS_UNIT_BOOLEAN		(0x4 << KVM_STATS_UNIT_SHIFT)
1593 #define KVM_STATS_UNIT_MAX		KVM_STATS_UNIT_BOOLEAN
1594 
1595 #define KVM_STATS_BASE_SHIFT		8
1596 #define KVM_STATS_BASE_MASK		(0xF << KVM_STATS_BASE_SHIFT)
1597 #define KVM_STATS_BASE_POW10		(0x0 << KVM_STATS_BASE_SHIFT)
1598 #define KVM_STATS_BASE_POW2		(0x1 << KVM_STATS_BASE_SHIFT)
1599 #define KVM_STATS_BASE_MAX		KVM_STATS_BASE_POW2
1600 
1601 /**
1602  * struct kvm_stats_desc - Descriptor of a KVM statistics.
1603  * @flags: Annotations of the stats, like type, unit, etc.
1604  * @exponent: Used together with @flags to determine the unit.
1605  * @size: The number of data items for this stats.
1606  *        Every data item is of type __u64.
1607  * @offset: The offset of the stats to the start of stat structure in
1608  *          structure kvm or kvm_vcpu.
1609  * @bucket_size: A parameter value used for histogram stats. It is only used
1610  *		for linear histogram stats, specifying the size of the bucket;
1611  * @name: The name string for the stats. Its size is indicated by the
1612  *        &kvm_stats_header->name_size.
1613  */
1614 struct kvm_stats_desc {
1615 	__u32 flags;
1616 	__s16 exponent;
1617 	__u16 size;
1618 	__u32 offset;
1619 	__u32 bucket_size;
1620 #ifdef __KERNEL__
1621 	char name[KVM_STATS_NAME_SIZE];
1622 #else
1623 	__DECLARE_FLEX_ARRAY(char, name);
1624 #endif
1625 };
1626 
1627 #define KVM_GET_STATS_FD  _IO(KVMIO,  0xce)
1628 
1629 /* Available with KVM_CAP_XSAVE2 */
1630 #define KVM_GET_XSAVE2		  _IOR(KVMIO,  0xcf, struct kvm_xsave)
1631 
1632 /* Available with KVM_CAP_S390_PROTECTED_DUMP */
1633 #define KVM_S390_PV_CPU_COMMAND	_IOWR(KVMIO, 0xd0, struct kvm_pv_cmd)
1634 
1635 /* Available with KVM_CAP_X86_NOTIFY_VMEXIT */
1636 #define KVM_X86_NOTIFY_VMEXIT_ENABLED		(1ULL << 0)
1637 #define KVM_X86_NOTIFY_VMEXIT_USER		(1ULL << 1)
1638 
1639 /* Available with KVM_CAP_S390_ZPCI_OP */
1640 #define KVM_S390_ZPCI_OP         _IOW(KVMIO,  0xd1, struct kvm_s390_zpci_op)
1641 
1642 /* Available with KVM_CAP_MEMORY_ATTRIBUTES */
1643 #define KVM_SET_MEMORY_ATTRIBUTES              _IOW(KVMIO,  0xd2, struct kvm_memory_attributes)
1644 
1645 struct kvm_memory_attributes {
1646 	__u64 address;
1647 	__u64 size;
1648 	__u64 attributes;
1649 	__u64 flags;
1650 };
1651 
1652 #define KVM_MEMORY_ATTRIBUTE_PRIVATE           (1ULL << 3)
1653 
1654 #define KVM_CREATE_GUEST_MEMFD	_IOWR(KVMIO,  0xd4, struct kvm_create_guest_memfd)
1655 #define GUEST_MEMFD_FLAG_MMAP		(1ULL << 0)
1656 #define GUEST_MEMFD_FLAG_INIT_SHARED	(1ULL << 1)
1657 
1658 struct kvm_create_guest_memfd {
1659 	__u64 size;
1660 	__u64 flags;
1661 	__u64 reserved[6];
1662 };
1663 
1664 #define KVM_PRE_FAULT_MEMORY	_IOWR(KVMIO, 0xd5, struct kvm_pre_fault_memory)
1665 
1666 struct kvm_pre_fault_memory {
1667 	__u64 gpa;
1668 	__u64 size;
1669 	__u64 flags;
1670 	__u64 padding[5];
1671 };
1672 
1673 #endif /* __LINUX_KVM_H */
1674