blob: ce2876717a8b1dafc45e5d534e764d3f748eebcf [file] [log] [blame]
Avi Kivity6aa8b732006-12-10 02:21:36 -08001#ifndef __LINUX_KVM_H
2#define __LINUX_KVM_H
3
4/*
5 * Userspace interface for /dev/kvm - kernel based virtual machine
6 *
Rusty Russelldea8cae2007-07-17 23:12:26 +10007 * Note: you must update KVM_API_VERSION if you change this interface.
Avi Kivity6aa8b732006-12-10 02:21:36 -08008 */
9
Jaswinder Singh Rajput00bfdda2009-01-15 13:51:26 -080010#include <linux/types.h>
Christian Borntraeger97646202008-03-12 18:10:45 +010011#include <linux/compiler.h>
Avi Kivity6aa8b732006-12-10 02:21:36 -080012#include <linux/ioctl.h>
Jerone Youngf6a40e32007-11-19 17:06:31 -060013#include <asm/kvm.h>
Avi Kivity6aa8b732006-12-10 02:21:36 -080014
Avi Kivity2ff81f72007-04-29 16:25:49 +030015#define KVM_API_VERSION 12
Avi Kivity0b76e202006-12-22 01:06:02 -080016
Jan Kiszkac54d2ab2009-11-02 17:20:28 +010017/* *** Deprecated interfaces *** */
18
19#define KVM_TRC_SHIFT 16
20
21#define KVM_TRC_ENTRYEXIT (1 << KVM_TRC_SHIFT)
22#define KVM_TRC_HANDLER (1 << (KVM_TRC_SHIFT + 1))
23
24#define KVM_TRC_VMENTRY (KVM_TRC_ENTRYEXIT + 0x01)
25#define KVM_TRC_VMEXIT (KVM_TRC_ENTRYEXIT + 0x02)
26#define KVM_TRC_PAGE_FAULT (KVM_TRC_HANDLER + 0x01)
27
28#define KVM_TRC_HEAD_SIZE 12
29#define KVM_TRC_CYCLE_SIZE 8
30#define KVM_TRC_EXTRA_MAX 7
31
32#define KVM_TRC_INJ_VIRQ (KVM_TRC_HANDLER + 0x02)
33#define KVM_TRC_REDELIVER_EVT (KVM_TRC_HANDLER + 0x03)
34#define KVM_TRC_PEND_INTR (KVM_TRC_HANDLER + 0x04)
35#define KVM_TRC_IO_READ (KVM_TRC_HANDLER + 0x05)
36#define KVM_TRC_IO_WRITE (KVM_TRC_HANDLER + 0x06)
37#define KVM_TRC_CR_READ (KVM_TRC_HANDLER + 0x07)
38#define KVM_TRC_CR_WRITE (KVM_TRC_HANDLER + 0x08)
39#define KVM_TRC_DR_READ (KVM_TRC_HANDLER + 0x09)
40#define KVM_TRC_DR_WRITE (KVM_TRC_HANDLER + 0x0A)
41#define KVM_TRC_MSR_READ (KVM_TRC_HANDLER + 0x0B)
42#define KVM_TRC_MSR_WRITE (KVM_TRC_HANDLER + 0x0C)
43#define KVM_TRC_CPUID (KVM_TRC_HANDLER + 0x0D)
44#define KVM_TRC_INTR (KVM_TRC_HANDLER + 0x0E)
45#define KVM_TRC_NMI (KVM_TRC_HANDLER + 0x0F)
46#define KVM_TRC_VMMCALL (KVM_TRC_HANDLER + 0x10)
47#define KVM_TRC_HLT (KVM_TRC_HANDLER + 0x11)
48#define KVM_TRC_CLTS (KVM_TRC_HANDLER + 0x12)
49#define KVM_TRC_LMSW (KVM_TRC_HANDLER + 0x13)
50#define KVM_TRC_APIC_ACCESS (KVM_TRC_HANDLER + 0x14)
51#define KVM_TRC_TDP_FAULT (KVM_TRC_HANDLER + 0x15)
52#define KVM_TRC_GTLB_WRITE (KVM_TRC_HANDLER + 0x16)
53#define KVM_TRC_STLB_WRITE (KVM_TRC_HANDLER + 0x17)
54#define KVM_TRC_STLB_INVAL (KVM_TRC_HANDLER + 0x18)
55#define KVM_TRC_PPC_INSTR (KVM_TRC_HANDLER + 0x19)
56
Feng (Eric) Liu2714d1d2008-04-10 15:31:10 -040057struct kvm_user_trace_setup {
Jan Kiszkac54d2ab2009-11-02 17:20:28 +010058 __u32 buf_size;
59 __u32 buf_nr;
Feng (Eric) Liu2714d1d2008-04-10 15:31:10 -040060};
61
Jan Kiszkac54d2ab2009-11-02 17:20:28 +010062#define __KVM_DEPRECATED_MAIN_W_0x06 \
63 _IOW(KVMIO, 0x06, struct kvm_user_trace_setup)
64#define __KVM_DEPRECATED_MAIN_0x07 _IO(KVMIO, 0x07)
65#define __KVM_DEPRECATED_MAIN_0x08 _IO(KVMIO, 0x08)
66
67#define __KVM_DEPRECATED_VM_R_0x70 _IOR(KVMIO, 0x70, struct kvm_assigned_irq)
68
69struct kvm_breakpoint {
70 __u32 enabled;
71 __u32 padding;
72 __u64 address;
73};
74
75struct kvm_debug_guest {
76 __u32 enabled;
77 __u32 pad;
78 struct kvm_breakpoint breakpoints[4];
79 __u32 singlestep;
80};
81
82#define __KVM_DEPRECATED_VCPU_W_0x87 _IOW(KVMIO, 0x87, struct kvm_debug_guest)
83
84/* *** End of deprecated interfaces *** */
85
86
Avi Kivity6aa8b732006-12-10 02:21:36 -080087/* for KVM_CREATE_MEMORY_REGION */
88struct kvm_memory_region {
89 __u32 slot;
90 __u32 flags;
91 __u64 guest_phys_addr;
92 __u64 memory_size; /* bytes */
93};
94
Izik Eidus6fc138d2007-10-09 19:20:39 +020095/* for KVM_SET_USER_MEMORY_REGION */
96struct kvm_userspace_memory_region {
97 __u32 slot;
98 __u32 flags;
99 __u64 guest_phys_addr;
100 __u64 memory_size; /* bytes */
101 __u64 userspace_addr; /* start of the userspace allocated memory */
102};
103
Avi Kivity6aa8b732006-12-10 02:21:36 -0800104/* for kvm_memory_region::flags */
105#define KVM_MEM_LOG_DIRTY_PAGES 1UL
Marcelo Tosattibc6678a2009-12-23 14:35:21 -0200106#define KVM_MEMSLOT_INVALID (1UL << 1)
Avi Kivity6aa8b732006-12-10 02:21:36 -0800107
Eddie Dong97222cc2007-09-12 10:58:04 +0300108/* for KVM_IRQ_LINE */
Eddie Dong85f455f2007-07-06 12:20:49 +0300109struct kvm_irq_level {
110 /*
111 * ACPI gsi notion of irq.
112 * For IA-64 (APIC model) IOAPIC0: irq 0-23; IOAPIC1: irq 24-47..
113 * For X86 (standard AT mode) PIC0/1: irq 0-15. IOAPIC0: 0-23..
114 */
Gleb Natapov49256632009-02-04 17:28:14 +0200115 union {
116 __u32 irq;
117 __s32 status;
118 };
Eddie Dong85f455f2007-07-06 12:20:49 +0300119 __u32 level;
120};
121
He, Qing6ceb9d72007-07-26 11:05:18 +0300122
123struct kvm_irqchip {
124 __u32 chip_id;
125 __u32 pad;
126 union {
127 char dummy[512]; /* reserving space */
Avi Kivity7a0eb192009-01-19 14:57:52 +0200128#ifdef __KVM_HAVE_PIT
He, Qing6ceb9d72007-07-26 11:05:18 +0300129 struct kvm_pic_state pic;
Zhang Xiantaoec10f472007-12-17 20:27:27 +0800130#endif
Avi Kivity7a0eb192009-01-19 14:57:52 +0200131#ifdef __KVM_HAVE_IOAPIC
He, Qing6bf9e962007-08-05 10:49:16 +0300132 struct kvm_ioapic_state ioapic;
Jerone Young51e29622007-11-26 08:33:53 -0600133#endif
He, Qing6ceb9d72007-07-26 11:05:18 +0300134 } chip;
135};
136
Jan Kiszkac5ff41c2009-05-14 22:42:53 +0200137/* for KVM_CREATE_PIT2 */
138struct kvm_pit_config {
139 __u32 flags;
140 __u32 pad[15];
141};
142
143#define KVM_PIT_SPEAKER_DUMMY 1
144
Avi Kivity8a454502007-10-10 14:03:16 +0200145#define KVM_EXIT_UNKNOWN 0
146#define KVM_EXIT_EXCEPTION 1
147#define KVM_EXIT_IO 2
148#define KVM_EXIT_HYPERCALL 3
149#define KVM_EXIT_DEBUG 4
150#define KVM_EXIT_HLT 5
151#define KVM_EXIT_MMIO 6
152#define KVM_EXIT_IRQ_WINDOW_OPEN 7
153#define KVM_EXIT_SHUTDOWN 8
154#define KVM_EXIT_FAIL_ENTRY 9
155#define KVM_EXIT_INTR 10
156#define KVM_EXIT_SET_TPR 11
Avi Kivityb209749f2007-10-22 16:50:39 +0200157#define KVM_EXIT_TPR_ACCESS 12
Christian Borntraeger8f2abe62008-03-25 18:47:23 +0100158#define KVM_EXIT_S390_SIEIC 13
Christian Borntraegere28acfe2008-03-25 18:47:34 +0100159#define KVM_EXIT_S390_RESET 14
Hollis Blanchardb2312f02008-04-16 23:28:07 -0500160#define KVM_EXIT_DCR 15
Jan Kiszkac4abb7c2008-09-26 09:30:55 +0200161#define KVM_EXIT_NMI 16
Avi Kivity3f5d18a2009-06-11 15:43:28 +0300162#define KVM_EXIT_INTERNAL_ERROR 17
163
164/* For KVM_EXIT_INTERNAL_ERROR */
165#define KVM_INTERNAL_ERROR_EMULATION 1
Avi Kivity65ac7262009-11-04 11:59:01 +0200166#define KVM_INTERNAL_ERROR_SIMUL_EX 2
Avi Kivity6aa8b732006-12-10 02:21:36 -0800167
Avi Kivity9a2bb7f2007-02-22 12:58:31 +0200168/* for KVM_RUN, returned by mmap(vcpu_fd, offset=0) */
Avi Kivity6aa8b732006-12-10 02:21:36 -0800169struct kvm_run {
170 /* in */
Dor Laorc1150d82007-01-05 16:36:24 -0800171 __u8 request_interrupt_window;
Jan Kiszka45312202008-12-11 16:54:54 +0100172 __u8 padding1[7];
Avi Kivity6aa8b732006-12-10 02:21:36 -0800173
174 /* out */
Avi Kivity6aa8b732006-12-10 02:21:36 -0800175 __u32 exit_reason;
Dor Laorc1150d82007-01-05 16:36:24 -0800176 __u8 ready_for_interrupt_injection;
177 __u8 if_flag;
Jan Kiszka45312202008-12-11 16:54:54 +0100178 __u8 padding2[2];
Dor Laor54810342007-02-12 00:54:39 -0800179
180 /* in (pre_kvm_run), out (post_kvm_run) */
Dor Laorc1150d82007-01-05 16:36:24 -0800181 __u64 cr8;
182 __u64 apic_base;
183
Carsten Otted7b0b5e2009-11-19 14:21:16 +0100184#ifdef __KVM_S390
185 /* the processor status word for s390 */
186 __u64 psw_mask; /* psw upper half */
187 __u64 psw_addr; /* psw lower half */
188#endif
Avi Kivity6aa8b732006-12-10 02:21:36 -0800189 union {
190 /* KVM_EXIT_UNKNOWN */
191 struct {
Avi Kivity8eb7d332007-03-04 14:17:08 +0200192 __u64 hardware_exit_reason;
Avi Kivity6aa8b732006-12-10 02:21:36 -0800193 } hw;
Avi Kivity8eb7d332007-03-04 14:17:08 +0200194 /* KVM_EXIT_FAIL_ENTRY */
195 struct {
196 __u64 hardware_entry_failure_reason;
197 } fail_entry;
Avi Kivity6aa8b732006-12-10 02:21:36 -0800198 /* KVM_EXIT_EXCEPTION */
199 struct {
200 __u32 exception;
201 __u32 error_code;
202 } ex;
203 /* KVM_EXIT_IO */
nathan binkert2f8b9ee2009-03-27 21:53:05 -0700204 struct {
Avi Kivity6aa8b732006-12-10 02:21:36 -0800205#define KVM_EXIT_IO_IN 0
206#define KVM_EXIT_IO_OUT 1
207 __u8 direction;
208 __u8 size; /* bytes */
Avi Kivity6aa8b732006-12-10 02:21:36 -0800209 __u16 port;
Avi Kivity039576c2007-03-20 12:46:50 +0200210 __u32 count;
211 __u64 data_offset; /* relative to kvm_run start */
Avi Kivity6aa8b732006-12-10 02:21:36 -0800212 } io;
213 struct {
Jan Kiszkad0bfb942008-12-15 13:52:10 +0100214 struct kvm_debug_exit_arch arch;
Avi Kivity6aa8b732006-12-10 02:21:36 -0800215 } debug;
216 /* KVM_EXIT_MMIO */
217 struct {
218 __u64 phys_addr;
219 __u8 data[8];
220 __u32 len;
221 __u8 is_write;
222 } mmio;
Avi Kivityb4e63f52007-03-04 13:59:30 +0200223 /* KVM_EXIT_HYPERCALL */
224 struct {
Jeff Dike519ef352007-07-16 15:24:47 -0400225 __u64 nr;
Avi Kivityb4e63f52007-03-04 13:59:30 +0200226 __u64 args[6];
227 __u64 ret;
228 __u32 longmode;
229 __u32 pad;
230 } hypercall;
Avi Kivityb209749f2007-10-22 16:50:39 +0200231 /* KVM_EXIT_TPR_ACCESS */
232 struct {
233 __u64 rip;
234 __u32 is_write;
235 __u32 pad;
236 } tpr_access;
Christian Borntraeger8f2abe62008-03-25 18:47:23 +0100237 /* KVM_EXIT_S390_SIEIC */
238 struct {
239 __u8 icptcode;
Christian Borntraeger8f2abe62008-03-25 18:47:23 +0100240 __u16 ipa;
241 __u32 ipb;
242 } s390_sieic;
Christian Borntraegere28acfe2008-03-25 18:47:34 +0100243 /* KVM_EXIT_S390_RESET */
244#define KVM_S390_RESET_POR 1
245#define KVM_S390_RESET_CLEAR 2
246#define KVM_S390_RESET_SUBSYSTEM 4
247#define KVM_S390_RESET_CPU_INIT 8
248#define KVM_S390_RESET_IPL 16
249 __u64 s390_reset_flags;
Hollis Blanchardb2312f02008-04-16 23:28:07 -0500250 /* KVM_EXIT_DCR */
251 struct {
252 __u32 dcrn;
253 __u32 data;
254 __u8 is_write;
255 } dcr;
Avi Kivity3f5d18a2009-06-11 15:43:28 +0300256 struct {
257 __u32 suberror;
Avi Kivitya9c73992009-11-04 11:54:59 +0200258 /* Available with KVM_CAP_INTERNAL_ERROR_DATA: */
259 __u32 ndata;
260 __u64 data[16];
Avi Kivity3f5d18a2009-06-11 15:43:28 +0300261 } internal;
Avi Kivity24cbc7e2007-07-17 11:45:55 +0300262 /* Fix the size of the union. */
263 char padding[256];
Avi Kivity6aa8b732006-12-10 02:21:36 -0800264 };
265};
266
Laurent Vivier5f94c172008-05-30 16:05:54 +0200267/* for KVM_REGISTER_COALESCED_MMIO / KVM_UNREGISTER_COALESCED_MMIO */
268
269struct kvm_coalesced_mmio_zone {
270 __u64 addr;
271 __u32 size;
272 __u32 pad;
273};
274
275struct kvm_coalesced_mmio {
276 __u64 phys_addr;
277 __u32 len;
278 __u32 pad;
279 __u8 data[8];
280};
281
282struct kvm_coalesced_mmio_ring {
283 __u32 first, last;
284 struct kvm_coalesced_mmio coalesced_mmio[0];
285};
286
287#define KVM_COALESCED_MMIO_MAX \
288 ((PAGE_SIZE - sizeof(struct kvm_coalesced_mmio_ring)) / \
289 sizeof(struct kvm_coalesced_mmio))
290
Avi Kivity6aa8b732006-12-10 02:21:36 -0800291/* for KVM_TRANSLATE */
292struct kvm_translation {
293 /* in */
294 __u64 linear_address;
Avi Kivity6aa8b732006-12-10 02:21:36 -0800295
296 /* out */
297 __u64 physical_address;
298 __u8 valid;
299 __u8 writeable;
300 __u8 usermode;
Avi Kivity8cd13302007-02-12 00:54:41 -0800301 __u8 pad[5];
Avi Kivity6aa8b732006-12-10 02:21:36 -0800302};
303
304/* for KVM_INTERRUPT */
305struct kvm_interrupt {
306 /* in */
Avi Kivity6aa8b732006-12-10 02:21:36 -0800307 __u32 irq;
308};
309
Avi Kivity6aa8b732006-12-10 02:21:36 -0800310/* for KVM_GET_DIRTY_LOG */
311struct kvm_dirty_log {
312 __u32 slot;
nathan binkert2f8b9ee2009-03-27 21:53:05 -0700313 __u32 padding1;
Avi Kivity6aa8b732006-12-10 02:21:36 -0800314 union {
315 void __user *dirty_bitmap; /* one bit per page */
nathan binkert2f8b9ee2009-03-27 21:53:05 -0700316 __u64 padding2;
Avi Kivity6aa8b732006-12-10 02:21:36 -0800317 };
318};
319
Avi Kivity1961d272007-03-05 19:46:05 +0200320/* for KVM_SET_SIGNAL_MASK */
321struct kvm_signal_mask {
322 __u32 len;
323 __u8 sigset[0];
324};
325
Avi Kivityb209749f2007-10-22 16:50:39 +0200326/* for KVM_TPR_ACCESS_REPORTING */
327struct kvm_tpr_access_ctl {
328 __u32 enabled;
329 __u32 flags;
330 __u32 reserved[8];
331};
332
Avi Kivityb93463a2007-10-25 16:52:32 +0200333/* for KVM_SET_VAPIC_ADDR */
334struct kvm_vapic_addr {
335 __u64 vapic_addr;
336};
337
Marcelo Tosatti62d9f0d2008-04-11 13:24:45 -0300338/* for KVM_SET_MPSTATE */
339
340#define KVM_MP_STATE_RUNNABLE 0
341#define KVM_MP_STATE_UNINITIALIZED 1
342#define KVM_MP_STATE_INIT_RECEIVED 2
343#define KVM_MP_STATE_HALTED 3
344#define KVM_MP_STATE_SIPI_RECEIVED 4
345
346struct kvm_mp_state {
347 __u32 mp_state;
348};
349
Heiko Carstensb0c632d2008-03-25 18:47:20 +0100350struct kvm_s390_psw {
351 __u64 mask;
352 __u64 addr;
353};
354
Carsten Otteba5c1e92008-03-25 18:47:26 +0100355/* valid values for type in kvm_s390_interrupt */
356#define KVM_S390_SIGP_STOP 0xfffe0000u
357#define KVM_S390_PROGRAM_INT 0xfffe0001u
358#define KVM_S390_SIGP_SET_PREFIX 0xfffe0002u
359#define KVM_S390_RESTART 0xfffe0003u
360#define KVM_S390_INT_VIRTIO 0xffff2603u
361#define KVM_S390_INT_SERVICE 0xffff2401u
362#define KVM_S390_INT_EMERGENCY 0xffff1201u
363
364struct kvm_s390_interrupt {
365 __u32 type;
366 __u32 parm;
367 __u64 parm64;
368};
369
Jan Kiszkad0bfb942008-12-15 13:52:10 +0100370/* for KVM_SET_GUEST_DEBUG */
371
372#define KVM_GUESTDBG_ENABLE 0x00000001
373#define KVM_GUESTDBG_SINGLESTEP 0x00000002
374
375struct kvm_guest_debug {
376 __u32 control;
377 __u32 pad;
378 struct kvm_guest_debug_arch arch;
379};
380
Gregory Haskinsd34e6b12009-07-07 17:08:49 -0400381enum {
382 kvm_ioeventfd_flag_nr_datamatch,
383 kvm_ioeventfd_flag_nr_pio,
384 kvm_ioeventfd_flag_nr_deassign,
385 kvm_ioeventfd_flag_nr_max,
386};
387
388#define KVM_IOEVENTFD_FLAG_DATAMATCH (1 << kvm_ioeventfd_flag_nr_datamatch)
389#define KVM_IOEVENTFD_FLAG_PIO (1 << kvm_ioeventfd_flag_nr_pio)
390#define KVM_IOEVENTFD_FLAG_DEASSIGN (1 << kvm_ioeventfd_flag_nr_deassign)
391
392#define KVM_IOEVENTFD_VALID_FLAG_MASK ((1 << kvm_ioeventfd_flag_nr_max) - 1)
393
394struct kvm_ioeventfd {
395 __u64 datamatch;
396 __u64 addr; /* legal pio/mmio address */
397 __u32 len; /* 1, 2, 4, or 8 bytes */
398 __s32 fd;
399 __u32 flags;
400 __u8 pad[36];
401};
402
Avi Kivity6aa8b732006-12-10 02:21:36 -0800403#define KVMIO 0xAE
404
Avi Kivityf17abe92007-02-21 19:28:04 +0200405/*
406 * ioctls for /dev/kvm fds:
407 */
Avi Kivity739872c2007-03-01 17:20:13 +0200408#define KVM_GET_API_VERSION _IO(KVMIO, 0x00)
409#define KVM_CREATE_VM _IO(KVMIO, 0x01) /* returns a VM fd */
410#define KVM_GET_MSR_INDEX_LIST _IOWR(KVMIO, 0x02, struct kvm_msr_list)
Heiko Carstensb0c632d2008-03-25 18:47:20 +0100411
412#define KVM_S390_ENABLE_SIE _IO(KVMIO, 0x06)
Avi Kivity5d308f42007-03-01 17:56:20 +0200413/*
414 * Check if a kvm extension is available. Argument is extension number,
415 * return is 1 (yes) or 0 (no, sorry).
416 */
417#define KVM_CHECK_EXTENSION _IO(KVMIO, 0x03)
Avi Kivity07c45a32007-03-07 13:05:38 +0200418/*
419 * Get size for mmap(vcpu_fd)
420 */
421#define KVM_GET_VCPU_MMAP_SIZE _IO(KVMIO, 0x04) /* in bytes */
Avi Kivity674eea02008-02-11 18:37:23 +0200422#define KVM_GET_SUPPORTED_CPUID _IOWR(KVMIO, 0x05, struct kvm_cpuid2)
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100423#define KVM_TRACE_ENABLE __KVM_DEPRECATED_MAIN_W_0x06
424#define KVM_TRACE_PAUSE __KVM_DEPRECATED_MAIN_0x07
425#define KVM_TRACE_DISABLE __KVM_DEPRECATED_MAIN_0x08
426
Avi Kivityf17abe92007-02-21 19:28:04 +0200427/*
Eddie Dong85f455f2007-07-06 12:20:49 +0300428 * Extension capability list.
429 */
430#define KVM_CAP_IRQCHIP 0
Eddie Dongb6958ce2007-07-18 12:15:21 +0300431#define KVM_CAP_HLT 1
Izik Eidus82ce2c92007-10-02 18:52:55 +0200432#define KVM_CAP_MMU_SHADOW_CACHE_CONTROL 2
Izik Eidus6fc138d2007-10-09 19:20:39 +0200433#define KVM_CAP_USER_MEMORY 3
Izik Eiduscbc94022007-10-25 00:29:55 +0200434#define KVM_CAP_SET_TSS_ADDR 4
Avi Kivityb209749f2007-10-22 16:50:39 +0200435#define KVM_CAP_VAPIC 6
Avi Kivity674eea02008-02-11 18:37:23 +0200436#define KVM_CAP_EXT_CPUID 7
Glauber de Oliveira Costa18068522008-02-15 17:52:47 -0200437#define KVM_CAP_CLOCKSOURCE 8
Avi Kivityf7252302008-02-20 11:53:16 +0200438#define KVM_CAP_NR_VCPUS 9 /* returns max vcpus per vm */
Avi Kivitya988b912008-02-20 11:59:20 +0200439#define KVM_CAP_NR_MEMSLOTS 10 /* returns max memory slots per vm */
Sheng Yang78376992008-01-28 05:10:22 +0800440#define KVM_CAP_PIT 11
Marcelo Tosattia28e4f52008-02-22 12:21:36 -0500441#define KVM_CAP_NOP_IO_DELAY 12
Marcelo Tosatti2f333bc2008-02-22 12:21:37 -0500442#define KVM_CAP_PV_MMU 13
Marcelo Tosatti62d9f0d2008-04-11 13:24:45 -0300443#define KVM_CAP_MP_STATE 14
Laurent Vivier5f94c172008-05-30 16:05:54 +0200444#define KVM_CAP_COALESCED_MMIO 15
Avi Kivityed848622008-07-29 11:30:57 +0300445#define KVM_CAP_SYNC_MMU 16 /* Changes to host mmap are reflected in guest */
Avi Kivity7a0eb192009-01-19 14:57:52 +0200446#ifdef __KVM_HAVE_DEVICE_ASSIGNMENT
Ben-Ami Yassour4d5c5d02008-07-28 19:26:26 +0300447#define KVM_CAP_DEVICE_ASSIGNMENT 17
Xiantao Zhang8a98f662008-10-06 13:47:38 +0800448#endif
Ben-Ami Yassour62c476c2008-09-14 03:48:28 +0300449#define KVM_CAP_IOMMU 18
Avi Kivity7a0eb192009-01-19 14:57:52 +0200450#ifdef __KVM_HAVE_MSI
Sheng Yang6b9cc7f2008-11-24 14:32:56 +0800451#define KVM_CAP_DEVICE_MSI 20
452#endif
Avi Kivity1a811b62008-12-08 18:25:27 +0200453/* Bug in KVM_SET_USER_MEMORY_REGION fixed: */
454#define KVM_CAP_DESTROY_MEMORY_REGION_WORKS 21
Avi Kivity7a0eb192009-01-19 14:57:52 +0200455#ifdef __KVM_HAVE_USER_NMI
Jan Kiszka45312202008-12-11 16:54:54 +0100456#define KVM_CAP_USER_NMI 22
457#endif
Avi Kivity91b2ae72009-01-19 14:57:52 +0200458#ifdef __KVM_HAVE_GUEST_DEBUG
Jan Kiszkad0bfb942008-12-15 13:52:10 +0100459#define KVM_CAP_SET_GUEST_DEBUG 23
Jan Kiszka971cc3d2008-12-19 18:13:54 +0100460#endif
Avi Kivity91b2ae72009-01-19 14:57:52 +0200461#ifdef __KVM_HAVE_PIT
Marcelo Tosatti52d939a2008-12-30 15:55:06 -0200462#define KVM_CAP_REINJECT_CONTROL 24
463#endif
Avi Kivity91b2ae72009-01-19 14:57:52 +0200464#ifdef __KVM_HAVE_IOAPIC
Avi Kivity399ec802008-11-19 13:58:46 +0200465#define KVM_CAP_IRQ_ROUTING 25
466#endif
Gleb Natapov49256632009-02-04 17:28:14 +0200467#define KVM_CAP_IRQ_INJECT_STATUS 26
Weidong Han2df8a402009-02-13 10:50:56 +0800468#ifdef __KVM_HAVE_DEVICE_ASSIGNMENT
469#define KVM_CAP_DEVICE_DEASSIGNMENT 27
470#endif
Sheng Yangd510d6c2009-02-25 17:22:28 +0800471#ifdef __KVM_HAVE_MSIX
472#define KVM_CAP_DEVICE_MSIX 28
473#endif
Sheng Yange56d5322009-03-12 21:45:39 +0800474#define KVM_CAP_ASSIGN_DEV_IRQ 29
Jan Kiszka4cd481f2009-04-13 11:59:32 +0200475/* Another bug in KVM_SET_USER_MEMORY_REGION fixed: */
476#define KVM_CAP_JOIN_MEMORY_REGIONS_WORKS 30
Huang Ying890ca9a2009-05-11 16:48:15 +0800477#ifdef __KVM_HAVE_MCE
478#define KVM_CAP_MCE 31
479#endif
Gregory Haskins721eecbf2009-05-20 10:30:49 -0400480#define KVM_CAP_IRQFD 32
Jan Kiszkac5ff41c2009-05-14 22:42:53 +0200481#ifdef __KVM_HAVE_PIT
482#define KVM_CAP_PIT2 33
483#endif
Gleb Natapov73880c82009-06-09 15:56:28 +0300484#define KVM_CAP_SET_BOOT_CPU_ID 34
Beth Kone9f42752009-07-07 11:50:38 -0400485#ifdef __KVM_HAVE_PIT_STATE2
486#define KVM_CAP_PIT_STATE2 35
487#endif
Gregory Haskinsd34e6b12009-07-07 17:08:49 -0400488#define KVM_CAP_IOEVENTFD 36
Sheng Yangb927a3c2009-07-21 10:42:48 +0800489#define KVM_CAP_SET_IDENTITY_MAP_ADDR 37
Ed Swierkffde22a2009-10-15 15:21:43 -0700490#ifdef __KVM_HAVE_XEN_HVM
491#define KVM_CAP_XEN_HVM 38
492#endif
Glauber Costaafbcf7a2009-10-16 15:28:36 -0400493#define KVM_CAP_ADJUST_CLOCK 39
Avi Kivitya9c73992009-11-04 11:54:59 +0200494#define KVM_CAP_INTERNAL_ERROR_DATA 40
Jan Kiszka3cfc3092009-11-12 01:04:25 +0100495#ifdef __KVM_HAVE_VCPU_EVENTS
496#define KVM_CAP_VCPU_EVENTS 41
497#endif
Carsten Otted7b0b5e2009-11-19 14:21:16 +0100498#define KVM_CAP_S390_PSW 42
Alexander Grafe15a1132009-11-30 03:02:02 +0000499#define KVM_CAP_PPC_SEGSTATE 43
Gleb Natapov55cd8e52010-01-17 15:51:22 +0200500#define KVM_CAP_HYPERV 44
Gleb Natapov10388a02010-01-17 15:51:23 +0200501#define KVM_CAP_HYPERV_VAPIC 45
Gleb Natapovc25bc162010-01-17 15:51:24 +0200502#define KVM_CAP_HYPERV_SPIN 46
Zhai, Edwinab9f4ec2010-01-29 14:38:44 +0800503#define KVM_CAP_PCI_SEGMENT 47
Alexander Grafc10207f2010-02-19 11:00:45 +0100504#define KVM_CAP_PPC_PAIRED_SINGLES 48
Jan Kiszka48005f62010-02-19 19:38:07 +0100505#define KVM_CAP_INTR_SHADOW 49
Jan Kiszkaa1efbe72010-02-15 10:45:43 +0100506#ifdef __KVM_HAVE_DEBUGREGS
507#define KVM_CAP_DEBUGREGS 50
508#endif
Jan Kiszkad2be1652010-02-23 17:47:57 +0100509#define KVM_CAP_X86_ROBUST_SINGLESTEP 51
Avi Kivity399ec802008-11-19 13:58:46 +0200510
511#ifdef KVM_CAP_IRQ_ROUTING
512
513struct kvm_irq_routing_irqchip {
514 __u32 irqchip;
515 __u32 pin;
516};
517
Sheng Yang79950e12009-02-10 13:57:06 +0800518struct kvm_irq_routing_msi {
519 __u32 address_lo;
520 __u32 address_hi;
521 __u32 data;
522 __u32 pad;
523};
524
Avi Kivity399ec802008-11-19 13:58:46 +0200525/* gsi routing entry types */
526#define KVM_IRQ_ROUTING_IRQCHIP 1
Sheng Yang79950e12009-02-10 13:57:06 +0800527#define KVM_IRQ_ROUTING_MSI 2
Avi Kivity399ec802008-11-19 13:58:46 +0200528
529struct kvm_irq_routing_entry {
530 __u32 gsi;
531 __u32 type;
532 __u32 flags;
533 __u32 pad;
534 union {
535 struct kvm_irq_routing_irqchip irqchip;
Sheng Yang79950e12009-02-10 13:57:06 +0800536 struct kvm_irq_routing_msi msi;
Avi Kivity399ec802008-11-19 13:58:46 +0200537 __u32 pad[8];
538 } u;
539};
540
541struct kvm_irq_routing {
542 __u32 nr;
543 __u32 flags;
544 struct kvm_irq_routing_entry entries[0];
545};
546
547#endif
Eddie Dong85f455f2007-07-06 12:20:49 +0300548
Huang Ying890ca9a2009-05-11 16:48:15 +0800549#ifdef KVM_CAP_MCE
550/* x86 MCE */
551struct kvm_x86_mce {
552 __u64 status;
553 __u64 addr;
554 __u64 misc;
555 __u64 mcg_status;
556 __u8 bank;
557 __u8 pad1[7];
558 __u64 pad2[3];
559};
560#endif
561
Ed Swierkffde22a2009-10-15 15:21:43 -0700562#ifdef KVM_CAP_XEN_HVM
563struct kvm_xen_hvm_config {
564 __u32 flags;
565 __u32 msr;
566 __u64 blob_addr_32;
567 __u64 blob_addr_64;
568 __u8 blob_size_32;
569 __u8 blob_size_64;
570 __u8 pad2[30];
571};
572#endif
573
Gregory Haskins721eecbf2009-05-20 10:30:49 -0400574#define KVM_IRQFD_FLAG_DEASSIGN (1 << 0)
575
576struct kvm_irqfd {
577 __u32 fd;
578 __u32 gsi;
579 __u32 flags;
580 __u8 pad[20];
581};
582
Glauber Costaafbcf7a2009-10-16 15:28:36 -0400583struct kvm_clock_data {
584 __u64 clock;
585 __u32 flags;
586 __u32 pad[9];
587};
588
Eddie Dong85f455f2007-07-06 12:20:49 +0300589/*
Avi Kivityf17abe92007-02-21 19:28:04 +0200590 * ioctls for VM fds
591 */
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100592#define KVM_SET_MEMORY_REGION _IOW(KVMIO, 0x40, struct kvm_memory_region)
Avi Kivitybccf2152007-02-21 18:04:26 +0200593/*
594 * KVM_CREATE_VCPU receives as a parameter the vcpu slot, and returns
595 * a vcpu fd.
596 */
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100597#define KVM_CREATE_VCPU _IO(KVMIO, 0x41)
598#define KVM_GET_DIRTY_LOG _IOW(KVMIO, 0x42, struct kvm_dirty_log)
599#define KVM_SET_MEMORY_ALIAS _IOW(KVMIO, 0x43, struct kvm_memory_alias)
600#define KVM_SET_NR_MMU_PAGES _IO(KVMIO, 0x44)
601#define KVM_GET_NR_MMU_PAGES _IO(KVMIO, 0x45)
602#define KVM_SET_USER_MEMORY_REGION _IOW(KVMIO, 0x46, \
Avi Kivity6a4a9832009-06-09 11:33:36 +0300603 struct kvm_userspace_memory_region)
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100604#define KVM_SET_TSS_ADDR _IO(KVMIO, 0x47)
605#define KVM_SET_IDENTITY_MAP_ADDR _IOW(KVMIO, 0x48, __u64)
Eddie Dong85f455f2007-07-06 12:20:49 +0300606/* Device model IOC */
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100607#define KVM_CREATE_IRQCHIP _IO(KVMIO, 0x60)
608#define KVM_IRQ_LINE _IOW(KVMIO, 0x61, struct kvm_irq_level)
609#define KVM_GET_IRQCHIP _IOWR(KVMIO, 0x62, struct kvm_irqchip)
610#define KVM_SET_IRQCHIP _IOR(KVMIO, 0x63, struct kvm_irqchip)
611#define KVM_CREATE_PIT _IO(KVMIO, 0x64)
612#define KVM_GET_PIT _IOWR(KVMIO, 0x65, struct kvm_pit_state)
613#define KVM_SET_PIT _IOR(KVMIO, 0x66, struct kvm_pit_state)
614#define KVM_IRQ_LINE_STATUS _IOWR(KVMIO, 0x67, struct kvm_irq_level)
Laurent Vivier5f94c172008-05-30 16:05:54 +0200615#define KVM_REGISTER_COALESCED_MMIO \
616 _IOW(KVMIO, 0x67, struct kvm_coalesced_mmio_zone)
617#define KVM_UNREGISTER_COALESCED_MMIO \
618 _IOW(KVMIO, 0x68, struct kvm_coalesced_mmio_zone)
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100619#define KVM_ASSIGN_PCI_DEVICE _IOR(KVMIO, 0x69, \
620 struct kvm_assigned_pci_dev)
621#define KVM_SET_GSI_ROUTING _IOW(KVMIO, 0x6a, struct kvm_irq_routing)
Sheng Yange56d5322009-03-12 21:45:39 +0800622/* deprecated, replaced by KVM_ASSIGN_DEV_IRQ */
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100623#define KVM_ASSIGN_IRQ __KVM_DEPRECATED_VM_R_0x70
624#define KVM_ASSIGN_DEV_IRQ _IOW(KVMIO, 0x70, struct kvm_assigned_irq)
625#define KVM_REINJECT_CONTROL _IO(KVMIO, 0x71)
626#define KVM_DEASSIGN_PCI_DEVICE _IOW(KVMIO, 0x72, \
627 struct kvm_assigned_pci_dev)
628#define KVM_ASSIGN_SET_MSIX_NR _IOW(KVMIO, 0x73, \
629 struct kvm_assigned_msix_nr)
630#define KVM_ASSIGN_SET_MSIX_ENTRY _IOW(KVMIO, 0x74, \
631 struct kvm_assigned_msix_entry)
632#define KVM_DEASSIGN_DEV_IRQ _IOW(KVMIO, 0x75, struct kvm_assigned_irq)
633#define KVM_IRQFD _IOW(KVMIO, 0x76, struct kvm_irqfd)
634#define KVM_CREATE_PIT2 _IOW(KVMIO, 0x77, struct kvm_pit_config)
635#define KVM_SET_BOOT_CPU_ID _IO(KVMIO, 0x78)
636#define KVM_IOEVENTFD _IOW(KVMIO, 0x79, struct kvm_ioeventfd)
637#define KVM_XEN_HVM_CONFIG _IOW(KVMIO, 0x7a, struct kvm_xen_hvm_config)
638#define KVM_SET_CLOCK _IOW(KVMIO, 0x7b, struct kvm_clock_data)
639#define KVM_GET_CLOCK _IOR(KVMIO, 0x7c, struct kvm_clock_data)
640/* Available with KVM_CAP_PIT_STATE2 */
641#define KVM_GET_PIT2 _IOR(KVMIO, 0x9f, struct kvm_pit_state2)
642#define KVM_SET_PIT2 _IOW(KVMIO, 0xa0, struct kvm_pit_state2)
Avi Kivitybccf2152007-02-21 18:04:26 +0200643
644/*
645 * ioctls for vcpu fds
646 */
Avi Kivity739872c2007-03-01 17:20:13 +0200647#define KVM_RUN _IO(KVMIO, 0x80)
648#define KVM_GET_REGS _IOR(KVMIO, 0x81, struct kvm_regs)
649#define KVM_SET_REGS _IOW(KVMIO, 0x82, struct kvm_regs)
650#define KVM_GET_SREGS _IOR(KVMIO, 0x83, struct kvm_sregs)
651#define KVM_SET_SREGS _IOW(KVMIO, 0x84, struct kvm_sregs)
652#define KVM_TRANSLATE _IOWR(KVMIO, 0x85, struct kvm_translation)
653#define KVM_INTERRUPT _IOW(KVMIO, 0x86, struct kvm_interrupt)
Jan Kiszkad0bfb942008-12-15 13:52:10 +0100654/* KVM_DEBUG_GUEST is no longer supported, use KVM_SET_GUEST_DEBUG instead */
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100655#define KVM_DEBUG_GUEST __KVM_DEPRECATED_VCPU_W_0x87
Avi Kivity739872c2007-03-01 17:20:13 +0200656#define KVM_GET_MSRS _IOWR(KVMIO, 0x88, struct kvm_msrs)
657#define KVM_SET_MSRS _IOW(KVMIO, 0x89, struct kvm_msrs)
658#define KVM_SET_CPUID _IOW(KVMIO, 0x8a, struct kvm_cpuid)
Avi Kivity1961d272007-03-05 19:46:05 +0200659#define KVM_SET_SIGNAL_MASK _IOW(KVMIO, 0x8b, struct kvm_signal_mask)
Avi Kivityb8836732007-04-01 16:34:31 +0300660#define KVM_GET_FPU _IOR(KVMIO, 0x8c, struct kvm_fpu)
661#define KVM_SET_FPU _IOW(KVMIO, 0x8d, struct kvm_fpu)
Eddie Dong96ad2cc2007-09-06 12:22:56 +0300662#define KVM_GET_LAPIC _IOR(KVMIO, 0x8e, struct kvm_lapic_state)
663#define KVM_SET_LAPIC _IOW(KVMIO, 0x8f, struct kvm_lapic_state)
Dan Kenigsberg07716712007-11-21 17:10:04 +0200664#define KVM_SET_CPUID2 _IOW(KVMIO, 0x90, struct kvm_cpuid2)
665#define KVM_GET_CPUID2 _IOWR(KVMIO, 0x91, struct kvm_cpuid2)
Avi Kivityb209749f2007-10-22 16:50:39 +0200666/* Available with KVM_CAP_VAPIC */
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100667#define KVM_TPR_ACCESS_REPORTING _IOWR(KVMIO, 0x92, struct kvm_tpr_access_ctl)
Avi Kivityb93463a2007-10-25 16:52:32 +0200668/* Available with KVM_CAP_VAPIC */
669#define KVM_SET_VAPIC_ADDR _IOW(KVMIO, 0x93, struct kvm_vapic_addr)
Carsten Otteba5c1e92008-03-25 18:47:26 +0100670/* valid for virtual machine (for floating interrupt)_and_ vcpu */
671#define KVM_S390_INTERRUPT _IOW(KVMIO, 0x94, struct kvm_s390_interrupt)
Heiko Carstensb0c632d2008-03-25 18:47:20 +0100672/* store status for s390 */
673#define KVM_S390_STORE_STATUS_NOADDR (-1ul)
674#define KVM_S390_STORE_STATUS_PREFIXED (-2ul)
675#define KVM_S390_STORE_STATUS _IOW(KVMIO, 0x95, unsigned long)
676/* initial ipl psw for s390 */
677#define KVM_S390_SET_INITIAL_PSW _IOW(KVMIO, 0x96, struct kvm_s390_psw)
678/* initial reset for s390 */
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100679#define KVM_S390_INITIAL_RESET _IO(KVMIO, 0x97)
Marcelo Tosatti62d9f0d2008-04-11 13:24:45 -0300680#define KVM_GET_MP_STATE _IOR(KVMIO, 0x98, struct kvm_mp_state)
681#define KVM_SET_MP_STATE _IOW(KVMIO, 0x99, struct kvm_mp_state)
Jan Kiszkac4abb7c2008-09-26 09:30:55 +0200682/* Available with KVM_CAP_NMI */
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100683#define KVM_NMI _IO(KVMIO, 0x9a)
Jan Kiszkad0bfb942008-12-15 13:52:10 +0100684/* Available with KVM_CAP_SET_GUEST_DEBUG */
685#define KVM_SET_GUEST_DEBUG _IOW(KVMIO, 0x9b, struct kvm_guest_debug)
Huang Ying890ca9a2009-05-11 16:48:15 +0800686/* MCE for x86 */
687#define KVM_X86_SETUP_MCE _IOW(KVMIO, 0x9c, __u64)
688#define KVM_X86_GET_MCE_CAP_SUPPORTED _IOR(KVMIO, 0x9d, __u64)
689#define KVM_X86_SET_MCE _IOW(KVMIO, 0x9e, struct kvm_x86_mce)
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100690/* IA64 stack access */
Jes Sorensene9a999f2008-12-18 12:17:51 +0100691#define KVM_IA64_VCPU_GET_STACK _IOR(KVMIO, 0x9a, void *)
692#define KVM_IA64_VCPU_SET_STACK _IOW(KVMIO, 0x9b, void *)
Jan Kiszka3cfc3092009-11-12 01:04:25 +0100693/* Available with KVM_CAP_VCPU_EVENTS */
694#define KVM_GET_VCPU_EVENTS _IOR(KVMIO, 0x9f, struct kvm_vcpu_events)
695#define KVM_SET_VCPU_EVENTS _IOW(KVMIO, 0xa0, struct kvm_vcpu_events)
Jan Kiszkaa1efbe72010-02-15 10:45:43 +0100696/* Available with KVM_CAP_DEBUGREGS */
697#define KVM_GET_DEBUGREGS _IOR(KVMIO, 0xa1, struct kvm_debugregs)
698#define KVM_SET_DEBUGREGS _IOW(KVMIO, 0xa2, struct kvm_debugregs)
Hollis Blanchardd98e6342008-07-01 16:23:49 -0500699
Sheng Yange56d5322009-03-12 21:45:39 +0800700#define KVM_DEV_ASSIGN_ENABLE_IOMMU (1 << 0)
701
Ben-Ami Yassour4d5c5d02008-07-28 19:26:26 +0300702struct kvm_assigned_pci_dev {
703 __u32 assigned_dev_id;
704 __u32 busnr;
705 __u32 devfn;
706 __u32 flags;
Zhai, Edwinab9f4ec2010-01-29 14:38:44 +0800707 __u32 segnr;
Avi Kivitybb45e202008-10-19 16:39:45 +0200708 union {
Zhai, Edwinab9f4ec2010-01-29 14:38:44 +0800709 __u32 reserved[11];
Avi Kivitybb45e202008-10-19 16:39:45 +0200710 };
Ben-Ami Yassour4d5c5d02008-07-28 19:26:26 +0300711};
712
Sheng Yange56d5322009-03-12 21:45:39 +0800713#define KVM_DEV_IRQ_HOST_INTX (1 << 0)
714#define KVM_DEV_IRQ_HOST_MSI (1 << 1)
715#define KVM_DEV_IRQ_HOST_MSIX (1 << 2)
716
717#define KVM_DEV_IRQ_GUEST_INTX (1 << 8)
718#define KVM_DEV_IRQ_GUEST_MSI (1 << 9)
719#define KVM_DEV_IRQ_GUEST_MSIX (1 << 10)
720
721#define KVM_DEV_IRQ_HOST_MASK 0x00ff
722#define KVM_DEV_IRQ_GUEST_MASK 0xff00
723
Ben-Ami Yassour4d5c5d02008-07-28 19:26:26 +0300724struct kvm_assigned_irq {
725 __u32 assigned_dev_id;
726 __u32 host_irq;
727 __u32 guest_irq;
728 __u32 flags;
Avi Kivitybb45e202008-10-19 16:39:45 +0200729 union {
Sheng Yang0937c482008-11-24 14:32:53 +0800730 struct {
731 __u32 addr_lo;
732 __u32 addr_hi;
733 __u32 data;
734 } guest_msi;
Avi Kivitybb45e202008-10-19 16:39:45 +0200735 __u32 reserved[12];
736 };
Ben-Ami Yassour4d5c5d02008-07-28 19:26:26 +0300737};
738
Sheng Yangd510d6c2009-02-25 17:22:28 +0800739
Sheng Yangc1e01512009-02-25 17:22:26 +0800740struct kvm_assigned_msix_nr {
741 __u32 assigned_dev_id;
742 __u16 entry_nr;
743 __u16 padding;
744};
745
Sheng Yange7333392009-05-21 13:50:13 +0800746#define KVM_MAX_MSIX_PER_DEV 256
Sheng Yangc1e01512009-02-25 17:22:26 +0800747struct kvm_assigned_msix_entry {
748 __u32 assigned_dev_id;
749 __u32 gsi;
750 __u16 entry; /* The index of entry in the MSI-X table */
751 __u16 padding[3];
752};
753
Jan Kiszkac54d2ab2009-11-02 17:20:28 +0100754#endif /* __LINUX_KVM_H */