首页 > 代码库 > KVM源代码解读:linux-3.17.4\include\uapi\linux\kvm.h

KVM源代码解读:linux-3.17.4\include\uapi\linux\kvm.h

#ifndef __LINUX_KVM_H

#define __LINUX_KVM_H

 

/*

 * Userspace interface for /dev/kvm - kernel based virtual machine

 *

 * Note: you must update KVM_API_VERSION if you change this interface.

 */

 

#include <linux/types.h>

#include <linux/compiler.h>

#include <linux/ioctl.h>

#include <asm/kvm.h>

 

#define KVM_API_VERSION 12

 

/* *** Deprecated interfaces *** */

//已经不用的接口

 

#define KVM_TRC_SHIFT           16

 

#define KVM_TRC_ENTRYEXIT       (1 << KVM_TRC_SHIFT)

#define KVM_TRC_HANDLER         (1 << (KVM_TRC_SHIFT + 1))

 

#define KVM_TRC_VMENTRY         (KVM_TRC_ENTRYEXIT + 0x01)

#define KVM_TRC_VMEXIT          (KVM_TRC_ENTRYEXIT + 0x02)

#define KVM_TRC_PAGE_FAULT      (KVM_TRC_HANDLER + 0x01)

 

#define KVM_TRC_HEAD_SIZE       12

#define KVM_TRC_CYCLE_SIZE      8

#define KVM_TRC_EXTRA_MAX       7

 

#define KVM_TRC_INJ_VIRQ         (KVM_TRC_HANDLER + 0x02)

#define KVM_TRC_REDELIVER_EVT    (KVM_TRC_HANDLER + 0x03)

#define KVM_TRC_PEND_INTR        (KVM_TRC_HANDLER + 0x04)

#define KVM_TRC_IO_READ          (KVM_TRC_HANDLER + 0x05)

#define KVM_TRC_IO_WRITE         (KVM_TRC_HANDLER + 0x06)

#define KVM_TRC_CR_READ          (KVM_TRC_HANDLER + 0x07)

#define KVM_TRC_CR_WRITE         (KVM_TRC_HANDLER + 0x08)

#define KVM_TRC_DR_READ          (KVM_TRC_HANDLER + 0x09)

#define KVM_TRC_DR_WRITE         (KVM_TRC_HANDLER + 0x0A)

#define KVM_TRC_MSR_READ         (KVM_TRC_HANDLER + 0x0B)

#define KVM_TRC_MSR_WRITE        (KVM_TRC_HANDLER + 0x0C)

#define KVM_TRC_CPUID            (KVM_TRC_HANDLER + 0x0D)

#define KVM_TRC_INTR             (KVM_TRC_HANDLER + 0x0E)

#define KVM_TRC_NMI              (KVM_TRC_HANDLER + 0x0F)

#define KVM_TRC_VMMCALL          (KVM_TRC_HANDLER + 0x10)

#define KVM_TRC_HLT              (KVM_TRC_HANDLER + 0x11)

#define KVM_TRC_CLTS             (KVM_TRC_HANDLER + 0x12)

#define KVM_TRC_LMSW             (KVM_TRC_HANDLER + 0x13)

#define KVM_TRC_APIC_ACCESS      (KVM_TRC_HANDLER + 0x14)

#define KVM_TRC_TDP_FAULT        (KVM_TRC_HANDLER + 0x15)

#define KVM_TRC_GTLB_WRITE       (KVM_TRC_HANDLER + 0x16)

#define KVM_TRC_STLB_WRITE       (KVM_TRC_HANDLER + 0x17)

#define KVM_TRC_STLB_INVAL       (KVM_TRC_HANDLER + 0x18)

#define KVM_TRC_PPC_INSTR        (KVM_TRC_HANDLER + 0x19)

 

struct kvm_user_trace_setup {

      __u32 buf_size;

      __u32 buf_nr;

};

 

#define __KVM_DEPRECATED_MAIN_W_0x06 \

      _IOW(KVMIO, 0x06, struct kvm_user_trace_setup)

#define __KVM_DEPRECATED_MAIN_0x07 _IO(KVMIO, 0x07)

#define __KVM_DEPRECATED_MAIN_0x08 _IO(KVMIO, 0x08)

 

#define __KVM_DEPRECATED_VM_R_0x70 _IOR(KVMIO, 0x70, struct kvm_assigned_irq)

 

struct kvm_breakpoint {

      __u32 enabled;

      __u32 padding;

      __u64 address;

};

 

struct kvm_debug_guest {

      __u32 enabled;

      __u32 pad;

      struct kvm_breakpoint breakpoints[4];

      __u32 singlestep;

};

 

#define __KVM_DEPRECATED_VCPU_W_0x87 _IOW(KVMIO, 0x87, struct kvm_debug_guest)

 

/* *** End of deprecated interfaces *** */

//hsq

 

/* for KVM_CREATE_MEMORY_REGION */

struct kvm_memory_region {

      __u32 slot;

      __u32 flags;

      __u64 guest_phys_addr;

      __u64 memory_size; /* bytes */

};

 

/* for KVM_SET_USER_MEMORY_REGION */

struct kvm_userspace_memory_region {

      __u32 slot;

      __u32 flags;

      __u64 guest_phys_addr;

      __u64 memory_size; /* bytes */

      __u64 userspace_addr; /* start of the userspace allocated memory */

};

 

/*

 * The bit 0 ~ bit 15 of kvm_memory_region::flags are visible for userspace,

 * other bits are reserved for kvm internal use which are defined in

 * include/linux/kvm_host.h.

 */

#define KVM_MEM_LOG_DIRTY_PAGES   (1UL << 0)

#define KVM_MEM_READONLY   (1UL << 1)

 

/* for KVM_IRQ_LINE */

struct kvm_irq_level {

      /*

       * ACPI gsi notion of irq.

       * For IA-64 (APIC model) IOAPIC0: irq 0-23; IOAPIC1: irq 24-47..

       * For X86 (standard AT mode) PIC0/1: irq 0-15. IOAPIC0: 0-23..

       * For ARM: See Documentation/virtual/kvm/api.txt

       */

      union {

           __u32 irq;

           __s32 status;

      };

      __u32 level;

};

 

 

struct kvm_irqchip {

      __u32 chip_id;

      __u32 pad;

        union {

           char dummy[512];  /* reserving space */

#ifdef __KVM_HAVE_PIT

           struct kvm_pic_state pic;

#endif

#ifdef __KVM_HAVE_IOAPIC

           struct kvm_ioapic_state ioapic;

#endif

      } chip;

};

 

/* for KVM_CREATE_PIT2 */

struct kvm_pit_config {

      __u32 flags;

      __u32 pad[15];

};

 

#define KVM_PIT_SPEAKER_DUMMY     1

//hsq,kvm退出的25种原因

#define KVM_EXIT_UNKNOWN          0

#define KVM_EXIT_EXCEPTION        1

#define KVM_EXIT_IO               2

#define KVM_EXIT_HYPERCALL        3

#define KVM_EXIT_DEBUG            4

#define KVM_EXIT_HLT              5

#define KVM_EXIT_MMIO             6

#define KVM_EXIT_IRQ_WINDOW_OPEN  7

#define KVM_EXIT_SHUTDOWN         8

#define KVM_EXIT_FAIL_ENTRY       9

#define KVM_EXIT_INTR             10

#define KVM_EXIT_SET_TPR          11

#define KVM_EXIT_TPR_ACCESS       12

#define KVM_EXIT_S390_SIEIC       13

#define KVM_EXIT_S390_RESET       14

#define KVM_EXIT_DCR              15 /* deprecated */

#define KVM_EXIT_NMI              16

#define KVM_EXIT_INTERNAL_ERROR   17

#define KVM_EXIT_OSI              18

#define KVM_EXIT_PAPR_HCALL   19

#define KVM_EXIT_S390_UCONTROL        20

#define KVM_EXIT_WATCHDOG         21

#define KVM_EXIT_S390_TSCH        22

#define KVM_EXIT_EPR              23

#define KVM_EXIT_SYSTEM_EVENT     24

//hsq,kvm退出的3种内部原因

 

/* For KVM_EXIT_INTERNAL_ERROR */

/* Emulate instruction failed. */

//仿真指令失败

#define KVM_INTERNAL_ERROR_EMULATION      1

/* Encounter unexpected simultaneous exceptions. */

//遇到无法预料的模拟异常

#define KVM_INTERNAL_ERROR_SIMUL_EX   2

/* Encounter unexpected vm-exit due to delivery event. */

//因为发送事件导致打的退出异常

#define KVM_INTERNAL_ERROR_DELIVERY_EV    3

 

/* for KVM_RUN, returned by mmap(vcpu_fd, offset=0) */

struct kvm_run {

      /* in */

      __u8 request_interrupt_window;//往VCPU中发出一个中断插入请求,让VCPU做好相关的准备工作

      __u8 padding1[7];

 

      /* out */

      __u32 exit_reason;//退出原因

      __u8 ready_for_interrupt_injection;//响应request_interrupt_windows中的中断请求,当此位有效时,说明可以进行中断

      __u8 if_flag;

      __u8 padding2[2];

 

      /* in (pre_kvm_run)退出之前, out (post_kvm_run)退出之后 */

      __u64 cr8;

      __u64 apic_base;

 

#ifdef __KVM_S390

      /* the processor status word for s390 */

      __u64 psw_mask; /* psw upper half */

      __u64 psw_addr; /* psw lower half */

#endif

      union {

           /* KVM_EXIT_UNKNOWN */

           struct {

                 __u64 hardware_exit_reason;

           } hw;

           /* KVM_EXIT_FAIL_ENTRY */

           struct {

                 __u64 hardware_entry_failure_reason;

           } fail_entry;

           /* KVM_EXIT_EXCEPTION */

           struct {

                 __u32 exception;

                 __u32 error_code;

           } ex;

           /* KVM_EXIT_IO */

           struct {

#define KVM_EXIT_IO_IN  0

#define KVM_EXIT_IO_OUT 1

                 __u8 direction;

                 __u8 size; /* bytes */

                 __u16 port;

                 __u32 count;

                 __u64 data_offset; /* relative to kvm_run start */

           } io;

           struct {

                 struct kvm_debug_exit_arch arch;

           } debug;

           /* KVM_EXIT_MMIO */

           struct {

                 __u64 phys_addr;

                 __u8  data[8];

                 __u32 len;

                 __u8  is_write;

           } mmio;

           /* KVM_EXIT_HYPERCALL */

           struct {

                 __u64 nr;

                 __u64 args[6];

                 __u64 ret;

                 __u32 longmode;

                 __u32 pad;

           } hypercall;

           /* KVM_EXIT_TPR_ACCESS */

           struct {

                 __u64 rip;

                 __u32 is_write;

                 __u32 pad;

           } tpr_access;

           /* KVM_EXIT_S390_SIEIC */

           struct {

                 __u8 icptcode;

                 __u16 ipa;

                 __u32 ipb;

           } s390_sieic;

           /* KVM_EXIT_S390_RESET */

#define KVM_S390_RESET_POR       1

#define KVM_S390_RESET_CLEAR     2

#define KVM_S390_RESET_SUBSYSTEM 4

#define KVM_S390_RESET_CPU_INIT  8

#define KVM_S390_RESET_IPL       16

           __u64 s390_reset_flags;

           /* KVM_EXIT_S390_UCONTROL */

           struct {

                 __u64 trans_exc_code;

                 __u32 pgm_code;

           } s390_ucontrol;

           /* KVM_EXIT_DCR (deprecated) */

           struct {

                 __u32 dcrn;

                 __u32 data;

                 __u8  is_write;

           } dcr;

           struct {

                 __u32 suberror;

                 /* Available with KVM_CAP_INTERNAL_ERROR_DATA: */

                 __u32 ndata;

                 __u64 data[16];

           } internal;

           /* KVM_EXIT_OSI */

           struct {

                 __u64 gprs[32];

           } osi;

           struct {

                 __u64 nr;

                 __u64 ret;

                 __u64 args[9];

           } papr_hcall;

           /* KVM_EXIT_S390_TSCH */

           struct {

                 __u16 subchannel_id;

                 __u16 subchannel_nr;

                 __u32 io_int_parm;

                 __u32 io_int_word;

                 __u32 ipb;

                 __u8 dequeued;

           } s390_tsch;

           /* KVM_EXIT_EPR */

           struct {

                 __u32 epr;

           } epr;

           /* KVM_EXIT_SYSTEM_EVENT */

           struct {

#define KVM_SYSTEM_EVENT_SHUTDOWN       1

#define KVM_SYSTEM_EVENT_RESET          2

                 __u32 type;

                 __u64 flags;

           } system_event;

           /* Fix the size of the union. */

           char padding[256];

      };

 

      /*

       * shared registers between kvm and userspace.

       * kvm_valid_regs specifies the register classes set by the host

       * kvm_dirty_regs specified the register classes dirtied by userspace

       * struct kvm_sync_regs is architecture specific, as well as the

       * bits for kvm_valid_regs and kvm_dirty_regs

       */

      __u64 kvm_valid_regs;

      __u64 kvm_dirty_regs;

      union {

           struct kvm_sync_regs regs;

           char padding[1024];

      } s;

};

 

/* for KVM_REGISTER_COALESCED_MMIO / KVM_UNREGISTER_COALESCED_MMIO */

 

struct kvm_coalesced_mmio_zone {

      __u64 addr;

      __u32 size;

      __u32 pad;

};

 

struct kvm_coalesced_mmio {

      __u64 phys_addr;

      __u32 len;

      __u32 pad;

      __u8  data[8];

};

 

struct kvm_coalesced_mmio_ring {

      __u32 first, last;

      struct kvm_coalesced_mmio coalesced_mmio[0];

};

 

#define KVM_COALESCED_MMIO_MAX \

      ((PAGE_SIZE - sizeof(struct kvm_coalesced_mmio_ring)) / \

       sizeof(struct kvm_coalesced_mmio))

 

/* for KVM_TRANSLATE */

struct kvm_translation {

      /* in */

      __u64 linear_address;

 

      /* out */

      __u64 physical_address;

      __u8  valid;

      __u8  writeable;

      __u8  usermode;

      __u8  pad[5];

};

 

/* for KVM_INTERRUPT */

struct kvm_interrupt {

      /* in */

      __u32 irq;

};

 

/* for KVM_GET_DIRTY_LOG */

struct kvm_dirty_log {

      __u32 slot;

      __u32 padding1;

      union {

           void __user *dirty_bitmap; /* one bit per page */

           __u64 padding2;

      };

};

 

/* for KVM_SET_SIGNAL_MASK */

struct kvm_signal_mask {

      __u32 len;

      __u8  sigset[0];

};

 

/* for KVM_TPR_ACCESS_REPORTING */

struct kvm_tpr_access_ctl {

      __u32 enabled;

      __u32 flags;

      __u32 reserved[8];

};

 

/* for KVM_SET_VAPIC_ADDR */

struct kvm_vapic_addr {

      __u64 vapic_addr;

};

 

/* for KVM_SET_MP_STATE */

 

/* not all states are valid on all architectures */

#define KVM_MP_STATE_RUNNABLE          0

#define KVM_MP_STATE_UNINITIALIZED     1

#define KVM_MP_STATE_INIT_RECEIVED     2

#define KVM_MP_STATE_HALTED            3

#define KVM_MP_STATE_SIPI_RECEIVED     4

#define KVM_MP_STATE_STOPPED           5

#define KVM_MP_STATE_CHECK_STOP        6

#define KVM_MP_STATE_OPERATING         7

#define KVM_MP_STATE_LOAD              8

 

struct kvm_mp_state {

      __u32 mp_state;

};

 

struct kvm_s390_psw {

      __u64 mask;

      __u64 addr;

};

 

/* valid values for type in kvm_s390_interrupt */

#define KVM_S390_SIGP_STOP        0xfffe0000u

#define KVM_S390_PROGRAM_INT         0xfffe0001u

#define KVM_S390_SIGP_SET_PREFIX     0xfffe0002u

#define KVM_S390_RESTART           0xfffe0003u

#define KVM_S390_INT_PFAULT_INIT    0xfffe0004u

#define KVM_S390_INT_PFAULT_DONE   0xfffe0005u

#define KVM_S390_MCHK                0xfffe1000u

#define KVM_S390_INT_CLOCK_COMP         0xffff1004u

#define KVM_S390_INT_CPU_TIMER       0xffff1005u

#define KVM_S390_INT_VIRTIO       0xffff2603u

#define KVM_S390_INT_SERVICE           0xffff2401u

#define KVM_S390_INT_EMERGENCY      0xffff1201u

#define KVM_S390_INT_EXTERNAL_CALL      0xffff1202u

/* Anything below 0xfffe0000u is taken by INT_IO */

#define KVM_S390_INT_IO(ai,cssid,ssid,schid)   \

      (((schid)) |                    \

       ((ssid) << 16) |                  \

       ((cssid) << 18) |                \

       ((ai) << 26))

#define KVM_S390_INT_IO_MIN      0x00000000u

#define KVM_S390_INT_IO_MAX      0xfffdffffu

 

 

struct kvm_s390_interrupt {

      __u32 type;

      __u32 parm;

      __u64 parm64;

};

 

struct kvm_s390_io_info {

      __u16 subchannel_id;

      __u16 subchannel_nr;

      __u32 io_int_parm;

      __u32 io_int_word;

};

 

struct kvm_s390_ext_info {

      __u32 ext_params;

      __u32 pad;

      __u64 ext_params2;

};

 

struct kvm_s390_pgm_info {

      __u64 trans_exc_code;

      __u64 mon_code;

      __u64 per_address;

      __u32 data_exc_code;

      __u16 code;

      __u16 mon_class_nr;

      __u8 per_code;

      __u8 per_atmid;

      __u8 exc_access_id;

      __u8 per_access_id;

      __u8 op_access_id;

      __u8 pad[3];

};

 

struct kvm_s390_prefix_info {

      __u32 address;

};

 

struct kvm_s390_extcall_info {

      __u16 code;

};

 

struct kvm_s390_emerg_info {

      __u16 code;

};

 

struct kvm_s390_mchk_info {

      __u64 cr14;

      __u64 mcic;

      __u64 failing_storage_address;

      __u32 ext_damage_code;

      __u32 pad;

      __u8 fixed_logout[16];

};

 

struct kvm_s390_irq {

      __u64 type;

      union {

           struct kvm_s390_io_info io;

           struct kvm_s390_ext_info ext;

           struct kvm_s390_pgm_info pgm;

           struct kvm_s390_emerg_info emerg;

           struct kvm_s390_extcall_info extcall;

           struct kvm_s390_prefix_info prefix;

           struct kvm_s390_mchk_info mchk;

           char reserved[64];

      } u;

};

 

/* for KVM_SET_GUEST_DEBUG */

 

#define KVM_GUESTDBG_ENABLE          0x00000001

#define KVM_GUESTDBG_SINGLESTEP          0x00000002

 

struct kvm_guest_debug {

      __u32 control;

      __u32 pad;

      struct kvm_guest_debug_arch arch;

};

 

enum {

      kvm_ioeventfd_flag_nr_datamatch,

      kvm_ioeventfd_flag_nr_pio,

      kvm_ioeventfd_flag_nr_deassign,

      kvm_ioeventfd_flag_nr_virtio_ccw_notify,

      kvm_ioeventfd_flag_nr_fast_mmio,

      kvm_ioeventfd_flag_nr_max,

};

 

#define KVM_IOEVENTFD_FLAG_DATAMATCH (1 << kvm_ioeventfd_flag_nr_datamatch)

#define KVM_IOEVENTFD_FLAG_PIO       (1 << kvm_ioeventfd_flag_nr_pio)

#define KVM_IOEVENTFD_FLAG_DEASSIGN  (1 << kvm_ioeventfd_flag_nr_deassign)

#define KVM_IOEVENTFD_FLAG_VIRTIO_CCW_NOTIFY \

      (1 << kvm_ioeventfd_flag_nr_virtio_ccw_notify)

 

#define KVM_IOEVENTFD_VALID_FLAG_MASK  ((1 << kvm_ioeventfd_flag_nr_max) - 1)

 

struct kvm_ioeventfd {

      __u64 datamatch;

      __u64 addr;        /* legal pio/mmio address */

      __u32 len;         /* 1, 2, 4, or 8 bytes; or 0 to ignore length */

      __s32 fd;

      __u32 flags;

      __u8  pad[36];

};

 

/* for KVM_ENABLE_CAP */

struct kvm_enable_cap {

      /* in */

      __u32 cap;

      __u32 flags;

      __u64 args[4];

      __u8  pad[64];

};

 

/* for KVM_PPC_GET_PVINFO */

struct kvm_ppc_pvinfo {

      /* out */

      __u32 flags;

      __u32 hcall[4];

      __u8  pad[108];

};

 

/* for KVM_PPC_GET_SMMU_INFO */

#define KVM_PPC_PAGE_SIZES_MAX_SZ  8

 

struct kvm_ppc_one_page_size {

      __u32 page_shift;    /* Page shift (or 0) */

      __u32 pte_enc;       /* Encoding in the HPTE (>>12) */

};

 

struct kvm_ppc_one_seg_page_size {

      __u32 page_shift;    /* Base page shift of segment (or 0) */

      __u32 slb_enc;        /* SLB encoding for BookS */

      struct kvm_ppc_one_page_size enc[KVM_PPC_PAGE_SIZES_MAX_SZ];

};

 

#define KVM_PPC_PAGE_SIZES_REAL      0x00000001

#define KVM_PPC_1T_SEGMENTS           0x00000002

 

struct kvm_ppc_smmu_info {

      __u64 flags;

      __u32 slb_size;

      __u32 pad;

      struct kvm_ppc_one_seg_page_size sps[KVM_PPC_PAGE_SIZES_MAX_SZ];

};

 

#define KVM_PPC_PVINFO_FLAGS_EV_IDLE   (1<<0)

 

#define KVMIO 0xAE

 

/* machine type bits, to be used as argument to KVM_CREATE_VM */

#define KVM_VM_S390_UCONTROL  1

 

/* on ppc, 0 indicate default, 1 should force HV and 2 PR */

#define KVM_VM_PPC_HV 1

#define KVM_VM_PPC_PR 2

 

#define KVM_S390_SIE_PAGE_OFFSET 1

 

/*

 * hsq,ioctls for /dev/kvm fds:也就是系统调用指令

 system ioctls系统调用用于控制KVM运行环节的参数,相关工作包括全局性的参数设置和虚拟机创建等工作

 

 KVM_CREATE_VM是其中比较重要的指令字。通过该参数,KVM将返回一个文件描述符,该文件描述符指向内核控件中一个新的虚拟机。

 全新创建的虚拟机没有VCPU,也没有内存,需要通过后续的ioctl指令进行配置。使用mmap()系统调用,则会直接返回该虚拟机对应的虚拟内存空间,并且内存的偏移量为0。如果KVM支持KVM_CAP_USER_MEMORY扩展特性,则应使用其他方法。

 */

#define KVM_GET_API_VERSION       _IO(KVMIO,   0x00)

#define KVM_CREATE_VM             _IO(KVMIO,   0x01) /* returns a VM fd */

#define KVM_GET_MSR_INDEX_LIST    _IOWR(KVMIO, 0x02, struct kvm_msr_list)

 

#define KVM_S390_ENABLE_SIE       _IO(KVMIO,   0x06)

/*

 * Check if a kvm extension is available.  Argument is extension number,

 * return is 1 (yes) or 0 (no, sorry).

 */

#define KVM_CHECK_EXTENSION       _IO(KVMIO,   0x03)

/*

 * Get size for mmap(vcpu_fd)

 */

#define KVM_GET_VCPU_MMAP_SIZE    _IO(KVMIO,   0x04) /* in bytes */

#define KVM_GET_SUPPORTED_CPUID   _IOWR(KVMIO, 0x05, struct kvm_cpuid2)

#define KVM_TRACE_ENABLE          __KVM_DEPRECATED_MAIN_W_0x06

#define KVM_TRACE_PAUSE           __KVM_DEPRECATED_MAIN_0x07

#define KVM_TRACE_DISABLE         __KVM_DEPRECATED_MAIN_0x08

#define KVM_GET_EMULATED_CPUID       _IOWR(KVMIO, 0x09, struct kvm_cpuid2)

 

/*

 * Extension capability list.

 */

#define KVM_CAP_IRQCHIP    0

#define KVM_CAP_HLT     1

#define KVM_CAP_MMU_SHADOW_CACHE_CONTROL 2

#define KVM_CAP_USER_MEMORY 3

#define KVM_CAP_SET_TSS_ADDR 4

#define KVM_CAP_VAPIC 6

#define KVM_CAP_EXT_CPUID 7

#define KVM_CAP_CLOCKSOURCE 8

#define KVM_CAP_NR_VCPUS 9       /* returns recommended max vcpus per vm */

#define KVM_CAP_NR_MEMSLOTS 10   /* returns max memory slots per vm */

#define KVM_CAP_PIT 11

#define KVM_CAP_NOP_IO_DELAY 12

#define KVM_CAP_PV_MMU 13

#define KVM_CAP_MP_STATE 14

#define KVM_CAP_COALESCED_MMIO 15

#define KVM_CAP_SYNC_MMU 16  /* Changes to host mmap are reflected in guest */

#define KVM_CAP_DEVICE_ASSIGNMENT 17

#define KVM_CAP_IOMMU 18

#ifdef __KVM_HAVE_MSI

#define KVM_CAP_DEVICE_MSI 20

#endif

/* Bug in KVM_SET_USER_MEMORY_REGION fixed: */

#define KVM_CAP_DESTROY_MEMORY_REGION_WORKS 21

#ifdef __KVM_HAVE_USER_NMI

#define KVM_CAP_USER_NMI 22

#endif

#ifdef __KVM_HAVE_GUEST_DEBUG

#define KVM_CAP_SET_GUEST_DEBUG 23

#endif

#ifdef __KVM_HAVE_PIT

#define KVM_CAP_REINJECT_CONTROL 24

#endif

#define KVM_CAP_IRQ_ROUTING 25

#define KVM_CAP_IRQ_INJECT_STATUS 26

#define KVM_CAP_DEVICE_DEASSIGNMENT 27

#ifdef __KVM_HAVE_MSIX

#define KVM_CAP_DEVICE_MSIX 28

#endif

#define KVM_CAP_ASSIGN_DEV_IRQ 29

/* Another bug in KVM_SET_USER_MEMORY_REGION fixed: */

#define KVM_CAP_JOIN_MEMORY_REGIONS_WORKS 30

#ifdef __KVM_HAVE_MCE

#define KVM_CAP_MCE 31

#endif

#define KVM_CAP_IRQFD 32

#ifdef __KVM_HAVE_PIT

#define KVM_CAP_PIT2 33

#endif

#define KVM_CAP_SET_BOOT_CPU_ID 34

#ifdef __KVM_HAVE_PIT_STATE2

#define KVM_CAP_PIT_STATE2 35

#endif

#define KVM_CAP_IOEVENTFD 36

#define KVM_CAP_SET_IDENTITY_MAP_ADDR 37

#ifdef __KVM_HAVE_XEN_HVM

#define KVM_CAP_XEN_HVM 38

#endif

#define KVM_CAP_ADJUST_CLOCK 39

#define KVM_CAP_INTERNAL_ERROR_DATA 40

#ifdef __KVM_HAVE_VCPU_EVENTS

#define KVM_CAP_VCPU_EVENTS 41

#endif

#define KVM_CAP_S390_PSW 42

#define KVM_CAP_PPC_SEGSTATE 43

#define KVM_CAP_HYPERV 44

#define KVM_CAP_HYPERV_VAPIC 45

#define KVM_CAP_HYPERV_SPIN 46

#define KVM_CAP_PCI_SEGMENT 47

#define KVM_CAP_PPC_PAIRED_SINGLES 48

#define KVM_CAP_INTR_SHADOW 49

#ifdef __KVM_HAVE_DEBUGREGS

#define KVM_CAP_DEBUGREGS 50

#endif

#define KVM_CAP_X86_ROBUST_SINGLESTEP 51

#define KVM_CAP_PPC_OSI 52

#define KVM_CAP_PPC_UNSET_IRQ 53

#define KVM_CAP_ENABLE_CAP 54

#ifdef __KVM_HAVE_XSAVE

#define KVM_CAP_XSAVE 55

#endif

#ifdef __KVM_HAVE_XCRS

#define KVM_CAP_XCRS 56

#endif

#define KVM_CAP_PPC_GET_PVINFO 57

#define KVM_CAP_PPC_IRQ_LEVEL 58

#define KVM_CAP_ASYNC_PF 59

#define KVM_CAP_TSC_CONTROL 60

#define KVM_CAP_GET_TSC_KHZ 61

#define KVM_CAP_PPC_BOOKE_SREGS 62

#define KVM_CAP_SPAPR_TCE 63

#define KVM_CAP_PPC_SMT 64

#define KVM_CAP_PPC_RMA 65

#define KVM_CAP_MAX_VCPUS 66       /* returns max vcpus per vm */

#define KVM_CAP_PPC_HIOR 67

#define KVM_CAP_PPC_PAPR 68

#define KVM_CAP_SW_TLB 69

#define KVM_CAP_ONE_REG 70

#define KVM_CAP_S390_GMAP 71

#define KVM_CAP_TSC_DEADLINE_TIMER 72

#define KVM_CAP_S390_UCONTROL 73

#define KVM_CAP_SYNC_REGS 74

#define KVM_CAP_PCI_2_3 75

#define KVM_CAP_KVMCLOCK_CTRL 76

#define KVM_CAP_SIGNAL_MSI 77

#define KVM_CAP_PPC_GET_SMMU_INFO 78

#define KVM_CAP_S390_COW 79

#define KVM_CAP_PPC_ALLOC_HTAB 80

#ifdef __KVM_HAVE_READONLY_MEM

#define KVM_CAP_READONLY_MEM 81

#endif

#define KVM_CAP_IRQFD_RESAMPLE 82

#define KVM_CAP_PPC_BOOKE_WATCHDOG 83

#define KVM_CAP_PPC_HTAB_FD 84

#define KVM_CAP_S390_CSS_SUPPORT 85

#define KVM_CAP_PPC_EPR 86

#define KVM_CAP_ARM_PSCI 87

#define KVM_CAP_ARM_SET_DEVICE_ADDR 88

#define KVM_CAP_DEVICE_CTRL 89

#define KVM_CAP_IRQ_MPIC 90

#define KVM_CAP_PPC_RTAS 91

#define KVM_CAP_IRQ_XICS 92

#define KVM_CAP_ARM_EL1_32BIT 93

#define KVM_CAP_SPAPR_MULTITCE 94

#define KVM_CAP_EXT_EMUL_CPUID 95

#define KVM_CAP_HYPERV_TIME 96

#define KVM_CAP_IOAPIC_POLARITY_IGNORED 97

#define KVM_CAP_ENABLE_CAP_VM 98

#define KVM_CAP_S390_IRQCHIP 99

#define KVM_CAP_IOEVENTFD_NO_LENGTH 100

#define KVM_CAP_VM_ATTRIBUTES 101

#define KVM_CAP_ARM_PSCI_0_2 102

#define KVM_CAP_PPC_FIXUP_HCALL 103

#define KVM_CAP_PPC_ENABLE_HCALL 104

#define KVM_CAP_CHECK_EXTENSION_VM 105

 

#ifdef KVM_CAP_IRQ_ROUTING

 

struct kvm_irq_routing_irqchip {

      __u32 irqchip;

      __u32 pin;

};

 

struct kvm_irq_routing_msi {

      __u32 address_lo;

      __u32 address_hi;

      __u32 data;

      __u32 pad;

};

 

struct kvm_irq_routing_s390_adapter {

      __u64 ind_addr;

      __u64 summary_addr;

      __u64 ind_offset;

      __u32 summary_offset;

      __u32 adapter_id;

};

 

/* gsi routing entry types */

#define KVM_IRQ_ROUTING_IRQCHIP 1

#define KVM_IRQ_ROUTING_MSI 2

#define KVM_IRQ_ROUTING_S390_ADAPTER 3

 

struct kvm_irq_routing_entry {

      __u32 gsi;

      __u32 type;

      __u32 flags;

      __u32 pad;

      union {

           struct kvm_irq_routing_irqchip irqchip;

           struct kvm_irq_routing_msi msi;

           struct kvm_irq_routing_s390_adapter adapter;

           __u32 pad[8];

      } u;

};

 

struct kvm_irq_routing {

      __u32 nr;

      __u32 flags;

      struct kvm_irq_routing_entry entries[0];

};

 

#endif

 

#ifdef KVM_CAP_MCE

/* x86 MCE */

struct kvm_x86_mce {

      __u64 status;

      __u64 addr;

      __u64 misc;

      __u64 mcg_status;

      __u8 bank;

      __u8 pad1[7];

      __u64 pad2[3];

};

#endif

 

#ifdef KVM_CAP_XEN_HVM

struct kvm_xen_hvm_config {

      __u32 flags;

      __u32 msr;

      __u64 blob_addr_32;

      __u64 blob_addr_64;

      __u8 blob_size_32;

      __u8 blob_size_64;

      __u8 pad2[30];

};

#endif

 

#define KVM_IRQFD_FLAG_DEASSIGN (1 << 0)

/*

 * Available with KVM_CAP_IRQFD_RESAMPLE

 *

 * KVM_IRQFD_FLAG_RESAMPLE indicates resamplefd is valid and specifies

 * the irqfd to operate in resampling mode for level triggered interrupt

 * emlation.  See Documentation/virtual/kvm/api.txt.

 */

#define KVM_IRQFD_FLAG_RESAMPLE (1 << 1)

 

struct kvm_irqfd {

      __u32 fd;

      __u32 gsi;

      __u32 flags;

      __u32 resamplefd;

      __u8  pad[16];

};

 

struct kvm_clock_data {

      __u64 clock;

      __u32 flags;

      __u32 pad[9];

};

 

#define KVM_MMU_FSL_BOOKE_NOHV         0

#define KVM_MMU_FSL_BOOKE_HV       1

 

struct kvm_config_tlb {

      __u64 params;

      __u64 array;

      __u32 mmu_type;

      __u32 array_len;

};

 

struct kvm_dirty_tlb {

      __u64 bitmap;

      __u32 num_dirty;

};

 

/* Available with KVM_CAP_ONE_REG */

 

#define KVM_REG_ARCH_MASK  0xff00000000000000ULL

#define KVM_REG_GENERIC       0x0000000000000000ULL

 

/*

 * Architecture specific registers are to be defined in arch headers and

 * ORed with the arch identifier.

 */

#define KVM_REG_PPC        0x1000000000000000ULL

#define KVM_REG_X86        0x2000000000000000ULL

#define KVM_REG_IA64       0x3000000000000000ULL

#define KVM_REG_ARM       0x4000000000000000ULL

#define KVM_REG_S390       0x5000000000000000ULL

#define KVM_REG_ARM64          0x6000000000000000ULL

#define KVM_REG_MIPS       0x7000000000000000ULL

 

#define KVM_REG_SIZE_SHIFT   52

#define KVM_REG_SIZE_MASK    0x00f0000000000000ULL

#define KVM_REG_SIZE_U8        0x0000000000000000ULL

#define KVM_REG_SIZE_U16 0x0010000000000000ULL

#define KVM_REG_SIZE_U32 0x0020000000000000ULL

#define KVM_REG_SIZE_U64 0x0030000000000000ULL

#define KVM_REG_SIZE_U128     0x0040000000000000ULL

#define KVM_REG_SIZE_U256     0x0050000000000000ULL

#define KVM_REG_SIZE_U512     0x0060000000000000ULL

#define KVM_REG_SIZE_U1024   0x0070000000000000ULL

 

struct kvm_reg_list {

      __u64 n; /* number of regs */

      __u64 reg[0];

};

 

struct kvm_one_reg {

      __u64 id;

      __u64 addr;

};

 

struct kvm_msi {

      __u32 address_lo;

      __u32 address_hi;

      __u32 data;

      __u32 flags;

      __u8  pad[16];

};

 

struct kvm_arm_device_addr {

      __u64 id;

      __u64 addr;

};

 

/*

 * Device control API, available with KVM_CAP_DEVICE_CTRL

 */

#define KVM_CREATE_DEVICE_TEST       1

//hsq,KVM创建设备数据结构

struct kvm_create_device {

      __u32   type;    /* in: KVM_DEV_TYPE_xxx */

      __u32   fd;  /* out: device handle */

      __u32   flags;    /* in: KVM_CREATE_DEVICE_xxx */

};

//hsq,KVM设备属性

struct kvm_device_attr {

      __u32   flags;          /* no flags currently defined */

      __u32   group;        /* device-defined */

      __u64   attr;           /* group-defined */

      __u64   addr;          /* userspace address of attr data */

};

 

#define KVM_DEV_TYPE_FSL_MPIC_20    1

#define KVM_DEV_TYPE_FSL_MPIC_42    2

#define KVM_DEV_TYPE_XICS          3

#define KVM_DEV_TYPE_VFIO         4

#define  KVM_DEV_VFIO_GROUP                1

#define   KVM_DEV_VFIO_GROUP_ADD             1

#define   KVM_DEV_VFIO_GROUP_DEL             2

#define KVM_DEV_TYPE_ARM_VGIC_V2  5

#define KVM_DEV_TYPE_FLIC          6

 

/*

 * hsq,ioctls for VM fds,vm ioctl系统调用实现了对虚拟机的控制。vm ioctl控制指令的参数大多需要从KVM_CREATE_VM中返回的fd文件描述符来进行操作,涉及的操作主要针对某一个虚拟机进行控制,如配置内存、配置VCPU等。

 */

#define KVM_SET_MEMORY_REGION     _IOW(KVMIO,  0x40, struct kvm_memory_region)

/*

 * KVM_CREATE_VCPU receives as a parameter the vcpu slot, and returns

 * a vcpu fd.

 创建vcpu的指令,返回值为描述符

 */

#define KVM_CREATE_VCPU           _IO(KVMIO,   0x41)

#define KVM_GET_DIRTY_LOG         _IOW(KVMIO,  0x42, struct kvm_dirty_log)

/* KVM_SET_MEMORY_ALIAS is obsolete: */

#define KVM_SET_MEMORY_ALIAS      _IOW(KVMIO,  0x43, struct kvm_memory_alias)

#define KVM_SET_NR_MMU_PAGES      _IO(KVMIO,   0x44)

#define KVM_GET_NR_MMU_PAGES      _IO(KVMIO,   0x45)

//修改VCPU的内存区域

#define KVM_SET_USER_MEMORY_REGION _IOW(KVMIO, 0x46, \

                            struct kvm_userspace_memory_region)

//(Intel架构专用)初始化TSS内存区域

#define KVM_SET_TSS_ADDR          _IO(KVMIO,   0x47)

#define KVM_SET_IDENTITY_MAP_ADDR _IOW(KVMIO,  0x48, __u64)

 

/* enable ucontrol for s390 */

struct kvm_s390_ucas_mapping {

      __u64 user_addr;

      __u64 vcpu_addr;

      __u64 length;

};

#define KVM_S390_UCAS_MAP        _IOW(KVMIO, 0x50, struct kvm_s390_ucas_mapping)

#define KVM_S390_UCAS_UNMAP      _IOW(KVMIO, 0x51, struct kvm_s390_ucas_mapping)

#define KVM_S390_VCPU_FAULT _IOW(KVMIO, 0x52, unsigned long)

 

/* Device model IOC */

#define KVM_CREATE_IRQCHIP        _IO(KVMIO,   0x60)

#define KVM_IRQ_LINE              _IOW(KVMIO,  0x61, struct kvm_irq_level)

#define KVM_GET_IRQCHIP           _IOWR(KVMIO, 0x62, struct kvm_irqchip)

#define KVM_SET_IRQCHIP           _IOR(KVMIO,  0x63, struct kvm_irqchip)

#define KVM_CREATE_PIT            _IO(KVMIO,   0x64)

#define KVM_GET_PIT               _IOWR(KVMIO, 0x65, struct kvm_pit_state)

#define KVM_SET_PIT               _IOR(KVMIO,  0x66, struct kvm_pit_state)

#define KVM_IRQ_LINE_STATUS       _IOWR(KVMIO, 0x67, struct kvm_irq_level)

#define KVM_REGISTER_COALESCED_MMIO \

                 _IOW(KVMIO,  0x67, struct kvm_coalesced_mmio_zone)

#define KVM_UNREGISTER_COALESCED_MMIO \

                 _IOW(KVMIO,  0x68, struct kvm_coalesced_mmio_zone)

#define KVM_ASSIGN_PCI_DEVICE     _IOR(KVMIO,  0x69, \

                             struct kvm_assigned_pci_dev)

#define KVM_SET_GSI_ROUTING       _IOW(KVMIO,  0x6a, struct kvm_irq_routing)

/* deprecated, replaced by KVM_ASSIGN_DEV_IRQ */

#define KVM_ASSIGN_IRQ            __KVM_DEPRECATED_VM_R_0x70

#define KVM_ASSIGN_DEV_IRQ        _IOW(KVMIO,  0x70, struct kvm_assigned_irq)

#define KVM_REINJECT_CONTROL      _IO(KVMIO,   0x71)

#define KVM_DEASSIGN_PCI_DEVICE   _IOW(KVMIO,  0x72, \

                             struct kvm_assigned_pci_dev)

#define KVM_ASSIGN_SET_MSIX_NR    _IOW(KVMIO,  0x73, \

                             struct kvm_assigned_msix_nr)

#define KVM_ASSIGN_SET_MSIX_ENTRY _IOW(KVMIO,  0x74, \

                             struct kvm_assigned_msix_entry)

#define KVM_DEASSIGN_DEV_IRQ      _IOW(KVMIO,  0x75, struct kvm_assigned_irq)

#define KVM_IRQFD                 _IOW(KVMIO,  0x76, struct kvm_irqfd)

#define KVM_CREATE_PIT2          _IOW(KVMIO,  0x77, struct kvm_pit_config)

//设置系统启动的VCPU号,默认为0

#define KVM_SET_BOOT_CPU_ID       _IO(KVMIO,   0x78)

#define KVM_IOEVENTFD             _IOW(KVMIO,  0x79, struct kvm_ioeventfd)

#define KVM_XEN_HVM_CONFIG        _IOW(KVMIO,  0x7a, struct kvm_xen_hvm_config)

#define KVM_SET_CLOCK             _IOW(KVMIO,  0x7b, struct kvm_clock_data)

#define KVM_GET_CLOCK             _IOR(KVMIO,  0x7c, struct kvm_clock_data)

/* Available with KVM_CAP_PIT_STATE2 */

#define KVM_GET_PIT2              _IOR(KVMIO,  0x9f, struct kvm_pit_state2)

#define KVM_SET_PIT2              _IOW(KVMIO,  0xa0, struct kvm_pit_state2)

/* Available with KVM_CAP_PPC_GET_PVINFO */

#define KVM_PPC_GET_PVINFO    _IOW(KVMIO,  0xa1, struct kvm_ppc_pvinfo)

/* Available with KVM_CAP_TSC_CONTROL */

#define KVM_SET_TSC_KHZ           _IO(KVMIO,  0xa2)

#define KVM_GET_TSC_KHZ           _IO(KVMIO,  0xa3)

/* Available with KVM_CAP_PCI_2_3 */

#define KVM_ASSIGN_SET_INTX_MASK  _IOW(KVMIO,  0xa4, \

                             struct kvm_assigned_pci_dev)

/* Available with KVM_CAP_SIGNAL_MSI */

#define KVM_SIGNAL_MSI            _IOW(KVMIO,  0xa5, struct kvm_msi)

/* Available with KVM_CAP_PPC_GET_SMMU_INFO */

#define KVM_PPC_GET_SMMU_INFO   _IOR(KVMIO,  0xa6, struct kvm_ppc_smmu_info)

/* Available with KVM_CAP_PPC_ALLOC_HTAB */

#define KVM_PPC_ALLOCATE_HTAB    _IOWR(KVMIO, 0xa7, __u32)

#define KVM_CREATE_SPAPR_TCE      _IOW(KVMIO,  0xa8, struct kvm_create_spapr_tce)

/* Available with KVM_CAP_RMA */

#define KVM_ALLOCATE_RMA      _IOR(KVMIO,  0xa9, struct kvm_allocate_rma)

/* Available with KVM_CAP_PPC_HTAB_FD */

#define KVM_PPC_GET_HTAB_FD       _IOW(KVMIO,  0xaa, struct kvm_get_htab_fd)

/* Available with KVM_CAP_ARM_SET_DEVICE_ADDR */

#define KVM_ARM_SET_DEVICE_ADDR      _IOW(KVMIO,  0xab, struct kvm_arm_device_addr)

/* Available with KVM_CAP_PPC_RTAS */

#define KVM_PPC_RTAS_DEFINE_TOKEN _IOW(KVMIO,  0xac, struct kvm_rtas_token_args)

 

/* ioctl for vm fd */

#define KVM_CREATE_DEVICE      _IOWR(KVMIO,  0xe0, struct kvm_create_device)

 

/* ioctls for fds returned by KVM_CREATE_DEVICE */

#define KVM_SET_DEVICE_ATTR   _IOW(KVMIO,  0xe1, struct kvm_device_attr)

#define KVM_GET_DEVICE_ATTR        _IOW(KVMIO,  0xe2, struct kvm_device_attr)

#define KVM_HAS_DEVICE_ATTR        _IOW(KVMIO,  0xe3, struct kvm_device_attr)

 

/*

 *hsq, ioctls for vcpu fds,vcpu ioctl系统调用主要针对具体的每一个虚拟的vCPU进行配置,包括寄存器读/写、中断设置、内存设置、调试开关、时钟管理等功能,能够对KVM的虚拟机进行精确的运行时配置。

 对于一个VM的CPU来说,寄存器控制是最重要的一个环节,vcpu ioctl在寄存器控制方面提供了丰富的指令字

 */

 //KVM_RUN和KVM_CREATE_VCPU是vm ioctl系统调用的两个重要指令字。在通过KVM_CREATE_VCPU为VM虚拟机创建VCPU,并且获得VCPU对应的fd文件描述符之后,可以进行KVM_RUN启动虚拟机的操作。

 //KVM_RUN指令字虽然没有任何参数,但是在调用KVM_RUN启动了虚拟机之后,可以通过mmap()系统调用映射VCPU的fd所在的内存空间来获得kvm_run结构体信息。该结构体位于内存偏移量0,结束位置在KVM_GET_ VCPU_MMAP_SIZE指令所返回的大小中。

#define KVM_RUN                   _IO(KVMIO,   0x80)

//获取通用寄存器信息

#define KVM_GET_REGS              _IOR(KVMIO,  0x81, struct kvm_regs)

#define KVM_SET_REGS              _IOW(KVMIO,  0x82, struct kvm_regs)

#define KVM_GET_SREGS             _IOR(KVMIO,  0x83, struct kvm_sregs)

#define KVM_SET_SREGS             _IOW(KVMIO,  0x84, struct kvm_sregs)

//将VCPU的物理地址翻译成host主机中的物理地址

#define KVM_TRANSLATE             _IOWR(KVMIO, 0x85, struct kvm_translation)

//通过插入一个中断向量,在VCPU上产生中断(当APIC无效时)

#define KVM_INTERRUPT             _IOW(KVMIO,  0x86, struct kvm_interrupt)

/* KVM_DEBUG_GUEST is no longer supported, use KVM_SET_GUEST_DEBUG instead */

#define KVM_DEBUG_GUEST           __KVM_DEPRECATED_VCPU_W_0x87

#define KVM_GET_MSRS              _IOWR(KVMIO, 0x88, struct kvm_msrs)

#define KVM_SET_MSRS              _IOW(KVMIO,  0x89, struct kvm_msrs)

//设置VCPU的CPUID信息

#define KVM_SET_CPUID             _IOW(KVMIO,  0x8a, struct kvm_cpuid)

//设置某一个VCPU的中断信号屏蔽

#define KVM_SET_SIGNAL_MASK       _IOW(KVMIO,  0x8b, struct kvm_signal_mask)

#define KVM_GET_FPU               _IOR(KVMIO,  0x8c, struct kvm_fpu)

#define KVM_SET_FPU               _IOW(KVMIO,  0x8d, struct kvm_fpu)

#define KVM_GET_LAPIC             _IOR(KVMIO,  0x8e, struct kvm_lapic_state)

#define KVM_SET_LAPIC             _IOW(KVMIO,  0x8f, struct kvm_lapic_state)

#define KVM_SET_CPUID2            _IOW(KVMIO,  0x90, struct kvm_cpuid2)

#define KVM_GET_CPUID2            _IOWR(KVMIO, 0x91, struct kvm_cpuid2)

/* Available with KVM_CAP_VAPIC */

#define KVM_TPR_ACCESS_REPORTING  _IOWR(KVMIO, 0x92, struct kvm_tpr_access_ctl)

/* Available with KVM_CAP_VAPIC */

#define KVM_SET_VAPIC_ADDR        _IOW(KVMIO,  0x93, struct kvm_vapic_addr)

/* valid for virtual machine (for floating interrupt)_and_ vcpu */

#define KVM_S390_INTERRUPT        _IOW(KVMIO,  0x94, struct kvm_s390_interrupt)

/* store status for s390 */

#define KVM_S390_STORE_STATUS_NOADDR    (-1ul)

#define KVM_S390_STORE_STATUS_PREFIXED  (-2ul)

#define KVM_S390_STORE_STATUS    _IOW(KVMIO,  0x95, unsigned long)

/* initial ipl psw for s390 */

#define KVM_S390_SET_INITIAL_PSW  _IOW(KVMIO,  0x96, struct kvm_s390_psw)

/* initial reset for s390 */

#define KVM_S390_INITIAL_RESET    _IO(KVMIO,   0x97)

#define KVM_GET_MP_STATE          _IOR(KVMIO,  0x98, struct kvm_mp_state)

#define KVM_SET_MP_STATE          _IOW(KVMIO,  0x99, struct kvm_mp_state)

/* Available with KVM_CAP_NMI */

#define KVM_NMI                   _IO(KVMIO,   0x9a)

/* Available with KVM_CAP_SET_GUEST_DEBUG */

#define KVM_SET_GUEST_DEBUG       _IOW(KVMIO,  0x9b, struct kvm_guest_debug)

/* MCE for x86 */

#define KVM_X86_SETUP_MCE         _IOW(KVMIO,  0x9c, __u64)

#define KVM_X86_GET_MCE_CAP_SUPPORTED _IOR(KVMIO,  0x9d, __u64)

#define KVM_X86_SET_MCE           _IOW(KVMIO,  0x9e, struct kvm_x86_mce)

/* IA64 stack access */

#define KVM_IA64_VCPU_GET_STACK   _IOR(KVMIO,  0x9a, void *)

#define KVM_IA64_VCPU_SET_STACK   _IOW(KVMIO,  0x9b, void *)

/* Available with KVM_CAP_VCPU_EVENTS */

//获取VCPU中被挂起待延时处理的信号,如中断、NMI和异常

#define KVM_GET_VCPU_EVENTS       _IOR(KVMIO,  0x9f, struct kvm_vcpu_events)

//设置VCPU的信号,如中断、NMI和异常

#define KVM_SET_VCPU_EVENTS       _IOW(KVMIO,  0xa0, struct kvm_vcpu_events)

/* Available with KVM_CAP_DEBUGREGS */

#define KVM_GET_DEBUGREGS         _IOR(KVMIO,  0xa1, struct kvm_debugregs)

#define KVM_SET_DEBUGREGS         _IOW(KVMIO,  0xa2, struct kvm_debugregs)

/*

 * vcpu version available with KVM_ENABLE_CAP

 * vm version available with KVM_CAP_ENABLE_CAP_VM

 */

#define KVM_ENABLE_CAP            _IOW(KVMIO,  0xa3, struct kvm_enable_cap)

/* Available with KVM_CAP_XSAVE */

#define KVM_GET_XSAVE            _IOR(KVMIO,  0xa4, struct kvm_xsave)

#define KVM_SET_XSAVE             _IOW(KVMIO,  0xa5, struct kvm_xsave)

/* Available with KVM_CAP_XCRS */

#define KVM_GET_XCRS        _IOR(KVMIO,  0xa6, struct kvm_xcrs)

#define KVM_SET_XCRS         _IOW(KVMIO,  0xa7, struct kvm_xcrs)

/* Available with KVM_CAP_SW_TLB */

#define KVM_DIRTY_TLB             _IOW(KVMIO,  0xaa, struct kvm_dirty_tlb)

/* Available with KVM_CAP_ONE_REG */

#define KVM_GET_ONE_REG        _IOW(KVMIO,  0xab, struct kvm_one_reg)

#define KVM_SET_ONE_REG         _IOW(KVMIO,  0xac, struct kvm_one_reg)

/* VM is being stopped by host */

#define KVM_KVMCLOCK_CTRL    _IO(KVMIO,   0xad)

#define KVM_ARM_VCPU_INIT     _IOW(KVMIO,  0xae, struct kvm_vcpu_init)

#define KVM_ARM_PREFERRED_TARGET  _IOR(KVMIO,  0xaf, struct kvm_vcpu_init)

#define KVM_GET_REG_LIST        _IOWR(KVMIO, 0xb0, struct kvm_reg_list)

 

#define KVM_DEV_ASSIGN_ENABLE_IOMMU  (1 << 0)

#define KVM_DEV_ASSIGN_PCI_2_3       (1 << 1)

#define KVM_DEV_ASSIGN_MASK_INTX  (1 << 2)

//kvm分配pci设备

struct kvm_assigned_pci_dev {

      __u32 assigned_dev_id;

      __u32 busnr;

      __u32 devfn;

      __u32 flags;

      __u32 segnr;

      union {

           __u32 reserved[11];

      };

};

 

#define KVM_DEV_IRQ_HOST_INTX    (1 << 0)

#define KVM_DEV_IRQ_HOST_MSI     (1 << 1)

#define KVM_DEV_IRQ_HOST_MSIX    (1 << 2)

 

#define KVM_DEV_IRQ_GUEST_INTX   (1 << 8)

#define KVM_DEV_IRQ_GUEST_MSI    (1 << 9)

#define KVM_DEV_IRQ_GUEST_MSIX   (1 << 10)

 

#define KVM_DEV_IRQ_HOST_MASK 0x00ff

#define KVM_DEV_IRQ_GUEST_MASK   0xff00

 

struct kvm_assigned_irq {

      __u32 assigned_dev_id;

      __u32 host_irq; /* ignored (legacy field) */

      __u32 guest_irq;

      __u32 flags;

      union {

           __u32 reserved[12];

      };

};

 

struct kvm_assigned_msix_nr {

      __u32 assigned_dev_id;

      __u16 entry_nr;

      __u16 padding;

};

 

#define KVM_MAX_MSIX_PER_DEV         256

//kvm分配的msi入口

struct kvm_assigned_msix_entry {

      __u32 assigned_dev_id;

      __u32 gsi;

      __u16 entry; /* The index of entry in the MSI-X table */

      __u16 padding[3];

};

 

#endif /* __LINUX_KVM_H */

KVM源代码解读:linux-3.17.4\include\uapi\linux\kvm.h