Commit | Line | Data |
---|---|---|
6aa8b732 AK |
1 | #ifndef __LINUX_KVM_H |
2 | #define __LINUX_KVM_H | |
3 | ||
4 | /* | |
5 | * Userspace interface for /dev/kvm - kernel based virtual machine | |
6 | * | |
dea8caee | 7 | * Note: you must update KVM_API_VERSION if you change this interface. |
6aa8b732 AK |
8 | */ |
9 | ||
10 | #include <asm/types.h> | |
97646202 | 11 | #include <linux/compiler.h> |
6aa8b732 | 12 | #include <linux/ioctl.h> |
f6a40e3b | 13 | #include <asm/kvm.h> |
6aa8b732 | 14 | |
2ff81f70 | 15 | #define KVM_API_VERSION 12 |
0b76e20b | 16 | |
2714d1d3 FEL |
17 | /* for KVM_TRACE_ENABLE */ |
18 | struct kvm_user_trace_setup { | |
19 | __u32 buf_size; /* sub_buffer size of each per-cpu */ | |
20 | __u32 buf_nr; /* the number of sub_buffers of each per-cpu */ | |
21 | }; | |
22 | ||
6aa8b732 AK |
23 | /* for KVM_CREATE_MEMORY_REGION */ |
24 | struct kvm_memory_region { | |
25 | __u32 slot; | |
26 | __u32 flags; | |
27 | __u64 guest_phys_addr; | |
28 | __u64 memory_size; /* bytes */ | |
29 | }; | |
30 | ||
6fc138d2 IE |
31 | /* for KVM_SET_USER_MEMORY_REGION */ |
32 | struct kvm_userspace_memory_region { | |
33 | __u32 slot; | |
34 | __u32 flags; | |
35 | __u64 guest_phys_addr; | |
36 | __u64 memory_size; /* bytes */ | |
37 | __u64 userspace_addr; /* start of the userspace allocated memory */ | |
38 | }; | |
39 | ||
6aa8b732 AK |
40 | /* for kvm_memory_region::flags */ |
41 | #define KVM_MEM_LOG_DIRTY_PAGES 1UL | |
42 | ||
43 | ||
97222cc8 | 44 | /* for KVM_IRQ_LINE */ |
85f455f7 ED |
45 | struct kvm_irq_level { |
46 | /* | |
47 | * ACPI gsi notion of irq. | |
48 | * For IA-64 (APIC model) IOAPIC0: irq 0-23; IOAPIC1: irq 24-47.. | |
49 | * For X86 (standard AT mode) PIC0/1: irq 0-15. IOAPIC0: 0-23.. | |
50 | */ | |
51 | __u32 irq; | |
52 | __u32 level; | |
53 | }; | |
54 | ||
6ceb9d79 HQ |
55 | |
56 | struct kvm_irqchip { | |
57 | __u32 chip_id; | |
58 | __u32 pad; | |
59 | union { | |
60 | char dummy[512]; /* reserving space */ | |
51e29625 | 61 | #ifdef CONFIG_X86 |
6ceb9d79 | 62 | struct kvm_pic_state pic; |
ec10f475 ZX |
63 | #endif |
64 | #if defined(CONFIG_X86) || defined(CONFIG_IA64) | |
6bf9e962 | 65 | struct kvm_ioapic_state ioapic; |
51e29625 | 66 | #endif |
6ceb9d79 HQ |
67 | } chip; |
68 | }; | |
69 | ||
8a45450d AK |
70 | #define KVM_EXIT_UNKNOWN 0 |
71 | #define KVM_EXIT_EXCEPTION 1 | |
72 | #define KVM_EXIT_IO 2 | |
73 | #define KVM_EXIT_HYPERCALL 3 | |
74 | #define KVM_EXIT_DEBUG 4 | |
75 | #define KVM_EXIT_HLT 5 | |
76 | #define KVM_EXIT_MMIO 6 | |
77 | #define KVM_EXIT_IRQ_WINDOW_OPEN 7 | |
78 | #define KVM_EXIT_SHUTDOWN 8 | |
79 | #define KVM_EXIT_FAIL_ENTRY 9 | |
80 | #define KVM_EXIT_INTR 10 | |
81 | #define KVM_EXIT_SET_TPR 11 | |
b209749f | 82 | #define KVM_EXIT_TPR_ACCESS 12 |
8f2abe6a | 83 | #define KVM_EXIT_S390_SIEIC 13 |
e28acfea | 84 | #define KVM_EXIT_S390_RESET 14 |
6aa8b732 | 85 | |
9a2bb7f4 | 86 | /* for KVM_RUN, returned by mmap(vcpu_fd, offset=0) */ |
6aa8b732 AK |
87 | struct kvm_run { |
88 | /* in */ | |
c1150d8c | 89 | __u8 request_interrupt_window; |
02c83209 | 90 | __u8 padding1[7]; |
6aa8b732 AK |
91 | |
92 | /* out */ | |
6aa8b732 | 93 | __u32 exit_reason; |
c1150d8c DL |
94 | __u8 ready_for_interrupt_injection; |
95 | __u8 if_flag; | |
2ff81f70 | 96 | __u8 padding2[2]; |
54810342 DL |
97 | |
98 | /* in (pre_kvm_run), out (post_kvm_run) */ | |
c1150d8c DL |
99 | __u64 cr8; |
100 | __u64 apic_base; | |
101 | ||
6aa8b732 AK |
102 | union { |
103 | /* KVM_EXIT_UNKNOWN */ | |
104 | struct { | |
8eb7d334 | 105 | __u64 hardware_exit_reason; |
6aa8b732 | 106 | } hw; |
8eb7d334 AK |
107 | /* KVM_EXIT_FAIL_ENTRY */ |
108 | struct { | |
109 | __u64 hardware_entry_failure_reason; | |
110 | } fail_entry; | |
6aa8b732 AK |
111 | /* KVM_EXIT_EXCEPTION */ |
112 | struct { | |
113 | __u32 exception; | |
114 | __u32 error_code; | |
115 | } ex; | |
116 | /* KVM_EXIT_IO */ | |
46fc1477 | 117 | struct kvm_io { |
6aa8b732 AK |
118 | #define KVM_EXIT_IO_IN 0 |
119 | #define KVM_EXIT_IO_OUT 1 | |
120 | __u8 direction; | |
121 | __u8 size; /* bytes */ | |
6aa8b732 | 122 | __u16 port; |
039576c0 AK |
123 | __u32 count; |
124 | __u64 data_offset; /* relative to kvm_run start */ | |
6aa8b732 AK |
125 | } io; |
126 | struct { | |
127 | } debug; | |
128 | /* KVM_EXIT_MMIO */ | |
129 | struct { | |
130 | __u64 phys_addr; | |
131 | __u8 data[8]; | |
132 | __u32 len; | |
133 | __u8 is_write; | |
134 | } mmio; | |
b4e63f56 AK |
135 | /* KVM_EXIT_HYPERCALL */ |
136 | struct { | |
519ef353 | 137 | __u64 nr; |
b4e63f56 AK |
138 | __u64 args[6]; |
139 | __u64 ret; | |
140 | __u32 longmode; | |
141 | __u32 pad; | |
142 | } hypercall; | |
b209749f AK |
143 | /* KVM_EXIT_TPR_ACCESS */ |
144 | struct { | |
145 | __u64 rip; | |
146 | __u32 is_write; | |
147 | __u32 pad; | |
148 | } tpr_access; | |
8f2abe6a CB |
149 | /* KVM_EXIT_S390_SIEIC */ |
150 | struct { | |
151 | __u8 icptcode; | |
152 | __u64 mask; /* psw upper half */ | |
153 | __u64 addr; /* psw lower half */ | |
154 | __u16 ipa; | |
155 | __u32 ipb; | |
156 | } s390_sieic; | |
e28acfea CB |
157 | /* KVM_EXIT_S390_RESET */ |
158 | #define KVM_S390_RESET_POR 1 | |
159 | #define KVM_S390_RESET_CLEAR 2 | |
160 | #define KVM_S390_RESET_SUBSYSTEM 4 | |
161 | #define KVM_S390_RESET_CPU_INIT 8 | |
162 | #define KVM_S390_RESET_IPL 16 | |
163 | __u64 s390_reset_flags; | |
24cbc7e9 AK |
164 | /* Fix the size of the union. */ |
165 | char padding[256]; | |
6aa8b732 AK |
166 | }; |
167 | }; | |
168 | ||
6aa8b732 AK |
169 | /* for KVM_TRANSLATE */ |
170 | struct kvm_translation { | |
171 | /* in */ | |
172 | __u64 linear_address; | |
6aa8b732 AK |
173 | |
174 | /* out */ | |
175 | __u64 physical_address; | |
176 | __u8 valid; | |
177 | __u8 writeable; | |
178 | __u8 usermode; | |
8cd13307 | 179 | __u8 pad[5]; |
6aa8b732 AK |
180 | }; |
181 | ||
182 | /* for KVM_INTERRUPT */ | |
183 | struct kvm_interrupt { | |
184 | /* in */ | |
6aa8b732 AK |
185 | __u32 irq; |
186 | }; | |
187 | ||
188 | struct kvm_breakpoint { | |
189 | __u32 enabled; | |
190 | __u32 padding; | |
191 | __u64 address; | |
192 | }; | |
193 | ||
194 | /* for KVM_DEBUG_GUEST */ | |
195 | struct kvm_debug_guest { | |
196 | /* int */ | |
6aa8b732 | 197 | __u32 enabled; |
bccf2150 | 198 | __u32 pad; |
6aa8b732 AK |
199 | struct kvm_breakpoint breakpoints[4]; |
200 | __u32 singlestep; | |
201 | }; | |
202 | ||
203 | /* for KVM_GET_DIRTY_LOG */ | |
204 | struct kvm_dirty_log { | |
205 | __u32 slot; | |
206 | __u32 padding; | |
207 | union { | |
208 | void __user *dirty_bitmap; /* one bit per page */ | |
209 | __u64 padding; | |
210 | }; | |
211 | }; | |
212 | ||
1961d276 AK |
213 | /* for KVM_SET_SIGNAL_MASK */ |
214 | struct kvm_signal_mask { | |
215 | __u32 len; | |
216 | __u8 sigset[0]; | |
217 | }; | |
218 | ||
b209749f AK |
219 | /* for KVM_TPR_ACCESS_REPORTING */ |
220 | struct kvm_tpr_access_ctl { | |
221 | __u32 enabled; | |
222 | __u32 flags; | |
223 | __u32 reserved[8]; | |
224 | }; | |
225 | ||
b93463aa AK |
226 | /* for KVM_SET_VAPIC_ADDR */ |
227 | struct kvm_vapic_addr { | |
228 | __u64 vapic_addr; | |
229 | }; | |
230 | ||
b0c632db HC |
231 | struct kvm_s390_psw { |
232 | __u64 mask; | |
233 | __u64 addr; | |
234 | }; | |
235 | ||
ba5c1e9b CO |
236 | /* valid values for type in kvm_s390_interrupt */ |
237 | #define KVM_S390_SIGP_STOP 0xfffe0000u | |
238 | #define KVM_S390_PROGRAM_INT 0xfffe0001u | |
239 | #define KVM_S390_SIGP_SET_PREFIX 0xfffe0002u | |
240 | #define KVM_S390_RESTART 0xfffe0003u | |
241 | #define KVM_S390_INT_VIRTIO 0xffff2603u | |
242 | #define KVM_S390_INT_SERVICE 0xffff2401u | |
243 | #define KVM_S390_INT_EMERGENCY 0xffff1201u | |
244 | ||
245 | struct kvm_s390_interrupt { | |
246 | __u32 type; | |
247 | __u32 parm; | |
248 | __u64 parm64; | |
249 | }; | |
250 | ||
2714d1d3 FEL |
251 | #define KVM_TRC_SHIFT 16 |
252 | /* | |
253 | * kvm trace categories | |
254 | */ | |
255 | #define KVM_TRC_ENTRYEXIT (1 << KVM_TRC_SHIFT) | |
256 | #define KVM_TRC_HANDLER (1 << (KVM_TRC_SHIFT + 1)) /* only 12 bits */ | |
257 | ||
258 | /* | |
259 | * kvm trace action | |
260 | */ | |
261 | #define KVM_TRC_VMENTRY (KVM_TRC_ENTRYEXIT + 0x01) | |
262 | #define KVM_TRC_VMEXIT (KVM_TRC_ENTRYEXIT + 0x02) | |
263 | #define KVM_TRC_PAGE_FAULT (KVM_TRC_HANDLER + 0x01) | |
264 | ||
265 | #define KVM_TRC_HEAD_SIZE 12 | |
266 | #define KVM_TRC_CYCLE_SIZE 8 | |
267 | #define KVM_TRC_EXTRA_MAX 7 | |
268 | ||
269 | /* This structure represents a single trace buffer record. */ | |
270 | struct kvm_trace_rec { | |
271 | __u32 event:28; | |
272 | __u32 extra_u32:3; | |
273 | __u32 cycle_in:1; | |
274 | __u32 pid; | |
275 | __u32 vcpu_id; | |
276 | union { | |
277 | struct { | |
278 | __u32 cycle_lo, cycle_hi; | |
279 | __u32 extra_u32[KVM_TRC_EXTRA_MAX]; | |
280 | } cycle; | |
281 | struct { | |
282 | __u32 extra_u32[KVM_TRC_EXTRA_MAX]; | |
283 | } nocycle; | |
284 | } u; | |
285 | }; | |
286 | ||
6aa8b732 AK |
287 | #define KVMIO 0xAE |
288 | ||
f17abe9a AK |
289 | /* |
290 | * ioctls for /dev/kvm fds: | |
291 | */ | |
739872c5 AK |
292 | #define KVM_GET_API_VERSION _IO(KVMIO, 0x00) |
293 | #define KVM_CREATE_VM _IO(KVMIO, 0x01) /* returns a VM fd */ | |
294 | #define KVM_GET_MSR_INDEX_LIST _IOWR(KVMIO, 0x02, struct kvm_msr_list) | |
b0c632db HC |
295 | |
296 | #define KVM_S390_ENABLE_SIE _IO(KVMIO, 0x06) | |
5d308f45 AK |
297 | /* |
298 | * Check if a kvm extension is available. Argument is extension number, | |
299 | * return is 1 (yes) or 0 (no, sorry). | |
300 | */ | |
301 | #define KVM_CHECK_EXTENSION _IO(KVMIO, 0x03) | |
07c45a36 AK |
302 | /* |
303 | * Get size for mmap(vcpu_fd) | |
304 | */ | |
305 | #define KVM_GET_VCPU_MMAP_SIZE _IO(KVMIO, 0x04) /* in bytes */ | |
674eea0f | 306 | #define KVM_GET_SUPPORTED_CPUID _IOWR(KVMIO, 0x05, struct kvm_cpuid2) |
2714d1d3 FEL |
307 | /* |
308 | * ioctls for kvm trace | |
309 | */ | |
310 | #define KVM_TRACE_ENABLE _IOW(KVMIO, 0x06, struct kvm_user_trace_setup) | |
311 | #define KVM_TRACE_PAUSE _IO(KVMIO, 0x07) | |
312 | #define KVM_TRACE_DISABLE _IO(KVMIO, 0x08) | |
85f455f7 ED |
313 | /* |
314 | * Extension capability list. | |
315 | */ | |
316 | #define KVM_CAP_IRQCHIP 0 | |
b6958ce4 | 317 | #define KVM_CAP_HLT 1 |
82ce2c96 | 318 | #define KVM_CAP_MMU_SHADOW_CACHE_CONTROL 2 |
6fc138d2 | 319 | #define KVM_CAP_USER_MEMORY 3 |
cbc94022 | 320 | #define KVM_CAP_SET_TSS_ADDR 4 |
b209749f | 321 | #define KVM_CAP_VAPIC 6 |
674eea0f | 322 | #define KVM_CAP_EXT_CPUID 7 |
18068523 | 323 | #define KVM_CAP_CLOCKSOURCE 8 |
f725230a | 324 | #define KVM_CAP_NR_VCPUS 9 /* returns max vcpus per vm */ |
a988b910 | 325 | #define KVM_CAP_NR_MEMSLOTS 10 /* returns max memory slots per vm */ |
7837699f | 326 | #define KVM_CAP_PIT 11 |
a28e4f5a | 327 | #define KVM_CAP_NOP_IO_DELAY 12 |
2f333bcb | 328 | #define KVM_CAP_PV_MMU 13 |
85f455f7 | 329 | |
f17abe9a AK |
330 | /* |
331 | * ioctls for VM fds | |
332 | */ | |
739872c5 | 333 | #define KVM_SET_MEMORY_REGION _IOW(KVMIO, 0x40, struct kvm_memory_region) |
82ce2c96 IE |
334 | #define KVM_SET_NR_MMU_PAGES _IO(KVMIO, 0x44) |
335 | #define KVM_GET_NR_MMU_PAGES _IO(KVMIO, 0x45) | |
6fc138d2 IE |
336 | #define KVM_SET_USER_MEMORY_REGION _IOW(KVMIO, 0x46,\ |
337 | struct kvm_userspace_memory_region) | |
cbc94022 | 338 | #define KVM_SET_TSS_ADDR _IO(KVMIO, 0x47) |
bccf2150 AK |
339 | /* |
340 | * KVM_CREATE_VCPU receives as a parameter the vcpu slot, and returns | |
341 | * a vcpu fd. | |
342 | */ | |
739872c5 AK |
343 | #define KVM_CREATE_VCPU _IO(KVMIO, 0x41) |
344 | #define KVM_GET_DIRTY_LOG _IOW(KVMIO, 0x42, struct kvm_dirty_log) | |
e8207547 | 345 | #define KVM_SET_MEMORY_ALIAS _IOW(KVMIO, 0x43, struct kvm_memory_alias) |
85f455f7 ED |
346 | /* Device model IOC */ |
347 | #define KVM_CREATE_IRQCHIP _IO(KVMIO, 0x60) | |
97222cc8 | 348 | #define KVM_IRQ_LINE _IOW(KVMIO, 0x61, struct kvm_irq_level) |
6ceb9d79 HQ |
349 | #define KVM_GET_IRQCHIP _IOWR(KVMIO, 0x62, struct kvm_irqchip) |
350 | #define KVM_SET_IRQCHIP _IOR(KVMIO, 0x63, struct kvm_irqchip) | |
7837699f | 351 | #define KVM_CREATE_PIT _IO(KVMIO, 0x64) |
e0f63cb9 SY |
352 | #define KVM_GET_PIT _IOWR(KVMIO, 0x65, struct kvm_pit_state) |
353 | #define KVM_SET_PIT _IOR(KVMIO, 0x66, struct kvm_pit_state) | |
bccf2150 AK |
354 | |
355 | /* | |
356 | * ioctls for vcpu fds | |
357 | */ | |
739872c5 AK |
358 | #define KVM_RUN _IO(KVMIO, 0x80) |
359 | #define KVM_GET_REGS _IOR(KVMIO, 0x81, struct kvm_regs) | |
360 | #define KVM_SET_REGS _IOW(KVMIO, 0x82, struct kvm_regs) | |
361 | #define KVM_GET_SREGS _IOR(KVMIO, 0x83, struct kvm_sregs) | |
362 | #define KVM_SET_SREGS _IOW(KVMIO, 0x84, struct kvm_sregs) | |
363 | #define KVM_TRANSLATE _IOWR(KVMIO, 0x85, struct kvm_translation) | |
364 | #define KVM_INTERRUPT _IOW(KVMIO, 0x86, struct kvm_interrupt) | |
365 | #define KVM_DEBUG_GUEST _IOW(KVMIO, 0x87, struct kvm_debug_guest) | |
366 | #define KVM_GET_MSRS _IOWR(KVMIO, 0x88, struct kvm_msrs) | |
367 | #define KVM_SET_MSRS _IOW(KVMIO, 0x89, struct kvm_msrs) | |
368 | #define KVM_SET_CPUID _IOW(KVMIO, 0x8a, struct kvm_cpuid) | |
1961d276 | 369 | #define KVM_SET_SIGNAL_MASK _IOW(KVMIO, 0x8b, struct kvm_signal_mask) |
b8836737 AK |
370 | #define KVM_GET_FPU _IOR(KVMIO, 0x8c, struct kvm_fpu) |
371 | #define KVM_SET_FPU _IOW(KVMIO, 0x8d, struct kvm_fpu) | |
96ad2cc6 ED |
372 | #define KVM_GET_LAPIC _IOR(KVMIO, 0x8e, struct kvm_lapic_state) |
373 | #define KVM_SET_LAPIC _IOW(KVMIO, 0x8f, struct kvm_lapic_state) | |
07716717 DK |
374 | #define KVM_SET_CPUID2 _IOW(KVMIO, 0x90, struct kvm_cpuid2) |
375 | #define KVM_GET_CPUID2 _IOWR(KVMIO, 0x91, struct kvm_cpuid2) | |
b209749f AK |
376 | /* Available with KVM_CAP_VAPIC */ |
377 | #define KVM_TPR_ACCESS_REPORTING _IOWR(KVMIO, 0x92, struct kvm_tpr_access_ctl) | |
b93463aa AK |
378 | /* Available with KVM_CAP_VAPIC */ |
379 | #define KVM_SET_VAPIC_ADDR _IOW(KVMIO, 0x93, struct kvm_vapic_addr) | |
ba5c1e9b CO |
380 | /* valid for virtual machine (for floating interrupt)_and_ vcpu */ |
381 | #define KVM_S390_INTERRUPT _IOW(KVMIO, 0x94, struct kvm_s390_interrupt) | |
b0c632db HC |
382 | /* store status for s390 */ |
383 | #define KVM_S390_STORE_STATUS_NOADDR (-1ul) | |
384 | #define KVM_S390_STORE_STATUS_PREFIXED (-2ul) | |
385 | #define KVM_S390_STORE_STATUS _IOW(KVMIO, 0x95, unsigned long) | |
386 | /* initial ipl psw for s390 */ | |
387 | #define KVM_S390_SET_INITIAL_PSW _IOW(KVMIO, 0x96, struct kvm_s390_psw) | |
388 | /* initial reset for s390 */ | |
389 | #define KVM_S390_INITIAL_RESET _IO(KVMIO, 0x97) | |
6aa8b732 AK |
390 | |
391 | #endif |