kvm.h 9.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344
  1. #ifndef __LINUX_KVM_H
  2. #define __LINUX_KVM_H
  3. /*
  4. * Userspace interface for /dev/kvm - kernel based virtual machine
  5. *
  6. * Note: you must update KVM_API_VERSION if you change this interface.
  7. */
  8. #include <asm/types.h>
  9. #include <linux/compiler.h>
  10. #include <linux/ioctl.h>
  11. #include <asm/kvm.h>
  12. #define KVM_API_VERSION 12
  13. /* for KVM_CREATE_MEMORY_REGION */
  14. struct kvm_memory_region {
  15. __u32 slot;
  16. __u32 flags;
  17. __u64 guest_phys_addr;
  18. __u64 memory_size; /* bytes */
  19. };
  20. /* for KVM_SET_USER_MEMORY_REGION */
  21. struct kvm_userspace_memory_region {
  22. __u32 slot;
  23. __u32 flags;
  24. __u64 guest_phys_addr;
  25. __u64 memory_size; /* bytes */
  26. __u64 userspace_addr; /* start of the userspace allocated memory */
  27. };
  28. /* for kvm_memory_region::flags */
  29. #define KVM_MEM_LOG_DIRTY_PAGES 1UL
  30. /* for KVM_IRQ_LINE */
  31. struct kvm_irq_level {
  32. /*
  33. * ACPI gsi notion of irq.
  34. * For IA-64 (APIC model) IOAPIC0: irq 0-23; IOAPIC1: irq 24-47..
  35. * For X86 (standard AT mode) PIC0/1: irq 0-15. IOAPIC0: 0-23..
  36. */
  37. __u32 irq;
  38. __u32 level;
  39. };
  40. struct kvm_irqchip {
  41. __u32 chip_id;
  42. __u32 pad;
  43. union {
  44. char dummy[512]; /* reserving space */
  45. #ifdef CONFIG_X86
  46. struct kvm_pic_state pic;
  47. #endif
  48. #if defined(CONFIG_X86) || defined(CONFIG_IA64)
  49. struct kvm_ioapic_state ioapic;
  50. #endif
  51. } chip;
  52. };
  53. #define KVM_EXIT_UNKNOWN 0
  54. #define KVM_EXIT_EXCEPTION 1
  55. #define KVM_EXIT_IO 2
  56. #define KVM_EXIT_HYPERCALL 3
  57. #define KVM_EXIT_DEBUG 4
  58. #define KVM_EXIT_HLT 5
  59. #define KVM_EXIT_MMIO 6
  60. #define KVM_EXIT_IRQ_WINDOW_OPEN 7
  61. #define KVM_EXIT_SHUTDOWN 8
  62. #define KVM_EXIT_FAIL_ENTRY 9
  63. #define KVM_EXIT_INTR 10
  64. #define KVM_EXIT_SET_TPR 11
  65. #define KVM_EXIT_TPR_ACCESS 12
  66. #define KVM_EXIT_S390_SIEIC 13
  67. #define KVM_EXIT_S390_RESET 14
  68. /* for KVM_RUN, returned by mmap(vcpu_fd, offset=0) */
  69. struct kvm_run {
  70. /* in */
  71. __u8 request_interrupt_window;
  72. __u8 padding1[7];
  73. /* out */
  74. __u32 exit_reason;
  75. __u8 ready_for_interrupt_injection;
  76. __u8 if_flag;
  77. __u8 padding2[2];
  78. /* in (pre_kvm_run), out (post_kvm_run) */
  79. __u64 cr8;
  80. __u64 apic_base;
  81. union {
  82. /* KVM_EXIT_UNKNOWN */
  83. struct {
  84. __u64 hardware_exit_reason;
  85. } hw;
  86. /* KVM_EXIT_FAIL_ENTRY */
  87. struct {
  88. __u64 hardware_entry_failure_reason;
  89. } fail_entry;
  90. /* KVM_EXIT_EXCEPTION */
  91. struct {
  92. __u32 exception;
  93. __u32 error_code;
  94. } ex;
  95. /* KVM_EXIT_IO */
  96. struct kvm_io {
  97. #define KVM_EXIT_IO_IN 0
  98. #define KVM_EXIT_IO_OUT 1
  99. __u8 direction;
  100. __u8 size; /* bytes */
  101. __u16 port;
  102. __u32 count;
  103. __u64 data_offset; /* relative to kvm_run start */
  104. } io;
  105. struct {
  106. } debug;
  107. /* KVM_EXIT_MMIO */
  108. struct {
  109. __u64 phys_addr;
  110. __u8 data[8];
  111. __u32 len;
  112. __u8 is_write;
  113. } mmio;
  114. /* KVM_EXIT_HYPERCALL */
  115. struct {
  116. __u64 nr;
  117. __u64 args[6];
  118. __u64 ret;
  119. __u32 longmode;
  120. __u32 pad;
  121. } hypercall;
  122. /* KVM_EXIT_TPR_ACCESS */
  123. struct {
  124. __u64 rip;
  125. __u32 is_write;
  126. __u32 pad;
  127. } tpr_access;
  128. /* KVM_EXIT_S390_SIEIC */
  129. struct {
  130. __u8 icptcode;
  131. __u64 mask; /* psw upper half */
  132. __u64 addr; /* psw lower half */
  133. __u16 ipa;
  134. __u32 ipb;
  135. } s390_sieic;
  136. /* KVM_EXIT_S390_RESET */
  137. #define KVM_S390_RESET_POR 1
  138. #define KVM_S390_RESET_CLEAR 2
  139. #define KVM_S390_RESET_SUBSYSTEM 4
  140. #define KVM_S390_RESET_CPU_INIT 8
  141. #define KVM_S390_RESET_IPL 16
  142. __u64 s390_reset_flags;
  143. /* Fix the size of the union. */
  144. char padding[256];
  145. };
  146. };
  147. /* for KVM_TRANSLATE */
  148. struct kvm_translation {
  149. /* in */
  150. __u64 linear_address;
  151. /* out */
  152. __u64 physical_address;
  153. __u8 valid;
  154. __u8 writeable;
  155. __u8 usermode;
  156. __u8 pad[5];
  157. };
  158. /* for KVM_INTERRUPT */
  159. struct kvm_interrupt {
  160. /* in */
  161. __u32 irq;
  162. };
  163. struct kvm_breakpoint {
  164. __u32 enabled;
  165. __u32 padding;
  166. __u64 address;
  167. };
  168. /* for KVM_DEBUG_GUEST */
  169. struct kvm_debug_guest {
  170. /* int */
  171. __u32 enabled;
  172. __u32 pad;
  173. struct kvm_breakpoint breakpoints[4];
  174. __u32 singlestep;
  175. };
  176. /* for KVM_GET_DIRTY_LOG */
  177. struct kvm_dirty_log {
  178. __u32 slot;
  179. __u32 padding;
  180. union {
  181. void __user *dirty_bitmap; /* one bit per page */
  182. __u64 padding;
  183. };
  184. };
  185. /* for KVM_SET_SIGNAL_MASK */
  186. struct kvm_signal_mask {
  187. __u32 len;
  188. __u8 sigset[0];
  189. };
  190. /* for KVM_TPR_ACCESS_REPORTING */
  191. struct kvm_tpr_access_ctl {
  192. __u32 enabled;
  193. __u32 flags;
  194. __u32 reserved[8];
  195. };
  196. /* for KVM_SET_VAPIC_ADDR */
  197. struct kvm_vapic_addr {
  198. __u64 vapic_addr;
  199. };
  200. struct kvm_s390_psw {
  201. __u64 mask;
  202. __u64 addr;
  203. };
  204. /* valid values for type in kvm_s390_interrupt */
  205. #define KVM_S390_SIGP_STOP 0xfffe0000u
  206. #define KVM_S390_PROGRAM_INT 0xfffe0001u
  207. #define KVM_S390_SIGP_SET_PREFIX 0xfffe0002u
  208. #define KVM_S390_RESTART 0xfffe0003u
  209. #define KVM_S390_INT_VIRTIO 0xffff2603u
  210. #define KVM_S390_INT_SERVICE 0xffff2401u
  211. #define KVM_S390_INT_EMERGENCY 0xffff1201u
  212. struct kvm_s390_interrupt {
  213. __u32 type;
  214. __u32 parm;
  215. __u64 parm64;
  216. };
  217. #define KVMIO 0xAE
  218. /*
  219. * ioctls for /dev/kvm fds:
  220. */
  221. #define KVM_GET_API_VERSION _IO(KVMIO, 0x00)
  222. #define KVM_CREATE_VM _IO(KVMIO, 0x01) /* returns a VM fd */
  223. #define KVM_GET_MSR_INDEX_LIST _IOWR(KVMIO, 0x02, struct kvm_msr_list)
  224. #define KVM_S390_ENABLE_SIE _IO(KVMIO, 0x06)
  225. /*
  226. * Check if a kvm extension is available. Argument is extension number,
  227. * return is 1 (yes) or 0 (no, sorry).
  228. */
  229. #define KVM_CHECK_EXTENSION _IO(KVMIO, 0x03)
  230. /*
  231. * Get size for mmap(vcpu_fd)
  232. */
  233. #define KVM_GET_VCPU_MMAP_SIZE _IO(KVMIO, 0x04) /* in bytes */
  234. #define KVM_GET_SUPPORTED_CPUID _IOWR(KVMIO, 0x05, struct kvm_cpuid2)
  235. /*
  236. * Extension capability list.
  237. */
  238. #define KVM_CAP_IRQCHIP 0
  239. #define KVM_CAP_HLT 1
  240. #define KVM_CAP_MMU_SHADOW_CACHE_CONTROL 2
  241. #define KVM_CAP_USER_MEMORY 3
  242. #define KVM_CAP_SET_TSS_ADDR 4
  243. #define KVM_CAP_VAPIC 6
  244. #define KVM_CAP_EXT_CPUID 7
  245. #define KVM_CAP_CLOCKSOURCE 8
  246. #define KVM_CAP_NR_VCPUS 9 /* returns max vcpus per vm */
  247. #define KVM_CAP_NR_MEMSLOTS 10 /* returns max memory slots per vm */
  248. #define KVM_CAP_PIT 11
  249. #define KVM_CAP_NOP_IO_DELAY 12
  250. #define KVM_CAP_PV_MMU 13
  251. /*
  252. * ioctls for VM fds
  253. */
  254. #define KVM_SET_MEMORY_REGION _IOW(KVMIO, 0x40, struct kvm_memory_region)
  255. #define KVM_SET_NR_MMU_PAGES _IO(KVMIO, 0x44)
  256. #define KVM_GET_NR_MMU_PAGES _IO(KVMIO, 0x45)
  257. #define KVM_SET_USER_MEMORY_REGION _IOW(KVMIO, 0x46,\
  258. struct kvm_userspace_memory_region)
  259. #define KVM_SET_TSS_ADDR _IO(KVMIO, 0x47)
  260. /*
  261. * KVM_CREATE_VCPU receives as a parameter the vcpu slot, and returns
  262. * a vcpu fd.
  263. */
  264. #define KVM_CREATE_VCPU _IO(KVMIO, 0x41)
  265. #define KVM_GET_DIRTY_LOG _IOW(KVMIO, 0x42, struct kvm_dirty_log)
  266. #define KVM_SET_MEMORY_ALIAS _IOW(KVMIO, 0x43, struct kvm_memory_alias)
  267. /* Device model IOC */
  268. #define KVM_CREATE_IRQCHIP _IO(KVMIO, 0x60)
  269. #define KVM_IRQ_LINE _IOW(KVMIO, 0x61, struct kvm_irq_level)
  270. #define KVM_GET_IRQCHIP _IOWR(KVMIO, 0x62, struct kvm_irqchip)
  271. #define KVM_SET_IRQCHIP _IOR(KVMIO, 0x63, struct kvm_irqchip)
  272. #define KVM_CREATE_PIT _IO(KVMIO, 0x64)
  273. #define KVM_GET_PIT _IOWR(KVMIO, 0x65, struct kvm_pit_state)
  274. #define KVM_SET_PIT _IOR(KVMIO, 0x66, struct kvm_pit_state)
  275. /*
  276. * ioctls for vcpu fds
  277. */
  278. #define KVM_RUN _IO(KVMIO, 0x80)
  279. #define KVM_GET_REGS _IOR(KVMIO, 0x81, struct kvm_regs)
  280. #define KVM_SET_REGS _IOW(KVMIO, 0x82, struct kvm_regs)
  281. #define KVM_GET_SREGS _IOR(KVMIO, 0x83, struct kvm_sregs)
  282. #define KVM_SET_SREGS _IOW(KVMIO, 0x84, struct kvm_sregs)
  283. #define KVM_TRANSLATE _IOWR(KVMIO, 0x85, struct kvm_translation)
  284. #define KVM_INTERRUPT _IOW(KVMIO, 0x86, struct kvm_interrupt)
  285. #define KVM_DEBUG_GUEST _IOW(KVMIO, 0x87, struct kvm_debug_guest)
  286. #define KVM_GET_MSRS _IOWR(KVMIO, 0x88, struct kvm_msrs)
  287. #define KVM_SET_MSRS _IOW(KVMIO, 0x89, struct kvm_msrs)
  288. #define KVM_SET_CPUID _IOW(KVMIO, 0x8a, struct kvm_cpuid)
  289. #define KVM_SET_SIGNAL_MASK _IOW(KVMIO, 0x8b, struct kvm_signal_mask)
  290. #define KVM_GET_FPU _IOR(KVMIO, 0x8c, struct kvm_fpu)
  291. #define KVM_SET_FPU _IOW(KVMIO, 0x8d, struct kvm_fpu)
  292. #define KVM_GET_LAPIC _IOR(KVMIO, 0x8e, struct kvm_lapic_state)
  293. #define KVM_SET_LAPIC _IOW(KVMIO, 0x8f, struct kvm_lapic_state)
  294. #define KVM_SET_CPUID2 _IOW(KVMIO, 0x90, struct kvm_cpuid2)
  295. #define KVM_GET_CPUID2 _IOWR(KVMIO, 0x91, struct kvm_cpuid2)
  296. /* Available with KVM_CAP_VAPIC */
  297. #define KVM_TPR_ACCESS_REPORTING _IOWR(KVMIO, 0x92, struct kvm_tpr_access_ctl)
  298. /* Available with KVM_CAP_VAPIC */
  299. #define KVM_SET_VAPIC_ADDR _IOW(KVMIO, 0x93, struct kvm_vapic_addr)
  300. /* valid for virtual machine (for floating interrupt)_and_ vcpu */
  301. #define KVM_S390_INTERRUPT _IOW(KVMIO, 0x94, struct kvm_s390_interrupt)
  302. /* store status for s390 */
  303. #define KVM_S390_STORE_STATUS_NOADDR (-1ul)
  304. #define KVM_S390_STORE_STATUS_PREFIXED (-2ul)
  305. #define KVM_S390_STORE_STATUS _IOW(KVMIO, 0x95, unsigned long)
  306. /* initial ipl psw for s390 */
  307. #define KVM_S390_SET_INITIAL_PSW _IOW(KVMIO, 0x96, struct kvm_s390_psw)
  308. /* initial reset for s390 */
  309. #define KVM_S390_INITIAL_RESET _IO(KVMIO, 0x97)
  310. #endif