zig

fork of https://codeberg.org/ziglang/zig
Log | Files | Refs | README | LICENSE

kvm.h (49344B) - Raw


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