]>
Commit | Line | Data |
---|---|---|
05330448 AL |
1 | /* |
2 | * QEMU KVM support | |
3 | * | |
4 | * Copyright IBM, Corp. 2008 | |
5 | * | |
6 | * Authors: | |
7 | * Anthony Liguori <aliguori@us.ibm.com> | |
8 | * | |
9 | * This work is licensed under the terms of the GNU GPL, version 2 or later. | |
10 | * See the COPYING file in the top-level directory. | |
11 | * | |
12 | */ | |
13 | ||
14 | #ifndef QEMU_KVM_H | |
15 | #define QEMU_KVM_H | |
16 | ||
ca821806 | 17 | #include <errno.h> |
1c14f162 | 18 | #include "config-host.h" |
1de7afc9 | 19 | #include "qemu/queue.h" |
504134d2 | 20 | #include "qom/cpu.h" |
05330448 | 21 | |
ca821806 MT |
22 | #ifdef CONFIG_KVM |
23 | #include <linux/kvm.h> | |
bc74b7db | 24 | #include <linux/kvm_para.h> |
9ca58923 EH |
25 | #else |
26 | /* These constants must never be used at runtime if kvm_enabled() is false. | |
27 | * They exist so we don't need #ifdefs around KVM-specific code that already | |
28 | * checks kvm_enabled() properly. | |
29 | */ | |
30 | #define KVM_CPUID_SIGNATURE 0 | |
31 | #define KVM_CPUID_FEATURES 0 | |
32 | #define KVM_FEATURE_CLOCKSOURCE 0 | |
33 | #define KVM_FEATURE_NOP_IO_DELAY 0 | |
34 | #define KVM_FEATURE_MMU_OP 0 | |
35 | #define KVM_FEATURE_CLOCKSOURCE2 0 | |
36 | #define KVM_FEATURE_ASYNC_PF 0 | |
37 | #define KVM_FEATURE_STEAL_TIME 0 | |
38 | #define KVM_FEATURE_PV_EOI 0 | |
d61a23ba | 39 | #define KVM_FEATURE_CLOCKSOURCE_STABLE_BIT 0 |
ca821806 | 40 | #endif |
05330448 | 41 | |
d5286af5 | 42 | extern bool kvm_allowed; |
3d4b2649 | 43 | extern bool kvm_kernel_irqchip; |
7ae26bd4 | 44 | extern bool kvm_async_interrupts_allowed; |
215e79c0 | 45 | extern bool kvm_halt_in_kernel_allowed; |
69e03ae6 | 46 | extern bool kvm_eventfds_allowed; |
cc7e0ddf | 47 | extern bool kvm_irqfds_allowed; |
614e41bc | 48 | extern bool kvm_msi_via_irqfd_allowed; |
f3e1bed8 | 49 | extern bool kvm_gsi_routing_allowed; |
76fe21de | 50 | extern bool kvm_gsi_direct_mapping; |
df9c8b75 | 51 | extern bool kvm_readonly_mem_allowed; |
98c8573e PB |
52 | |
53 | #if defined CONFIG_KVM || !defined NEED_CPU_H | |
3d4b2649 | 54 | #define kvm_enabled() (kvm_allowed) |
96fda35a PM |
55 | /** |
56 | * kvm_irqchip_in_kernel: | |
57 | * | |
58 | * Returns: true if the user asked us to create an in-kernel | |
59 | * irqchip via the "kernel_irqchip=on" machine option. | |
60 | * What this actually means is architecture and machine model | |
61 | * specific: on PC, for instance, it means that the LAPIC, | |
62 | * IOAPIC and PIT are all in kernel. This function should never | |
63 | * be used from generic target-independent code: use one of the | |
64 | * following functions or some other specific check instead. | |
65 | */ | |
3d4b2649 | 66 | #define kvm_irqchip_in_kernel() (kvm_kernel_irqchip) |
7ae26bd4 PM |
67 | |
68 | /** | |
69 | * kvm_async_interrupts_enabled: | |
70 | * | |
71 | * Returns: true if we can deliver interrupts to KVM | |
72 | * asynchronously (ie by ioctl from any thread at any time) | |
73 | * rather than having to do interrupt delivery synchronously | |
74 | * (where the vcpu must be stopped at a suitable point first). | |
75 | */ | |
76 | #define kvm_async_interrupts_enabled() (kvm_async_interrupts_allowed) | |
77 | ||
215e79c0 AG |
78 | /** |
79 | * kvm_halt_in_kernel | |
80 | * | |
81 | * Returns: true if halted cpus should still get a KVM_RUN ioctl to run | |
82 | * inside of kernel space. This only works if MP state is implemented. | |
83 | */ | |
84 | #define kvm_halt_in_kernel() (kvm_halt_in_kernel_allowed) | |
85 | ||
69e03ae6 NN |
86 | /** |
87 | * kvm_eventfds_enabled: | |
88 | * | |
89 | * Returns: true if we can use eventfds to receive notifications | |
90 | * from a KVM CPU (ie the kernel supports eventds and we are running | |
91 | * with a configuration where it is meaningful to use them). | |
92 | */ | |
93 | #define kvm_eventfds_enabled() (kvm_eventfds_allowed) | |
94 | ||
cc7e0ddf PM |
95 | /** |
96 | * kvm_irqfds_enabled: | |
97 | * | |
98 | * Returns: true if we can use irqfds to inject interrupts into | |
99 | * a KVM CPU (ie the kernel supports irqfds and we are running | |
100 | * with a configuration where it is meaningful to use them). | |
101 | */ | |
102 | #define kvm_irqfds_enabled() (kvm_irqfds_allowed) | |
103 | ||
614e41bc PM |
104 | /** |
105 | * kvm_msi_via_irqfd_enabled: | |
106 | * | |
107 | * Returns: true if we can route a PCI MSI (Message Signaled Interrupt) | |
108 | * to a KVM CPU via an irqfd. This requires that the kernel supports | |
109 | * this and that we're running in a configuration that permits it. | |
110 | */ | |
111 | #define kvm_msi_via_irqfd_enabled() (kvm_msi_via_irqfd_allowed) | |
112 | ||
f3e1bed8 PM |
113 | /** |
114 | * kvm_gsi_routing_enabled: | |
115 | * | |
116 | * Returns: true if GSI routing is enabled (ie the kernel supports | |
117 | * it and we're running in a configuration that permits it). | |
118 | */ | |
119 | #define kvm_gsi_routing_enabled() (kvm_gsi_routing_allowed) | |
120 | ||
76fe21de AK |
121 | /** |
122 | * kvm_gsi_direct_mapping: | |
123 | * | |
124 | * Returns: true if GSI direct mapping is enabled. | |
125 | */ | |
126 | #define kvm_gsi_direct_mapping() (kvm_gsi_direct_mapping) | |
127 | ||
df9c8b75 JJ |
128 | /** |
129 | * kvm_readonly_mem_enabled: | |
130 | * | |
131 | * Returns: true if KVM readonly memory is enabled (ie the kernel | |
132 | * supports it and we're running in a configuration that permits it). | |
133 | */ | |
134 | #define kvm_readonly_mem_enabled() (kvm_readonly_mem_allowed) | |
135 | ||
05330448 | 136 | #else |
3d4b2649 JK |
137 | #define kvm_enabled() (0) |
138 | #define kvm_irqchip_in_kernel() (false) | |
7ae26bd4 | 139 | #define kvm_async_interrupts_enabled() (false) |
215e79c0 | 140 | #define kvm_halt_in_kernel() (false) |
69e03ae6 | 141 | #define kvm_eventfds_enabled() (false) |
cc7e0ddf | 142 | #define kvm_irqfds_enabled() (false) |
614e41bc | 143 | #define kvm_msi_via_irqfd_enabled() (false) |
f3e1bed8 | 144 | #define kvm_gsi_routing_allowed() (false) |
76fe21de | 145 | #define kvm_gsi_direct_mapping() (false) |
df9c8b75 | 146 | #define kvm_readonly_mem_enabled() (false) |
05330448 AL |
147 | #endif |
148 | ||
149 | struct kvm_run; | |
680c1c6f | 150 | struct kvm_lapic_state; |
05330448 | 151 | |
94a8d39a JK |
152 | typedef struct KVMCapabilityInfo { |
153 | const char *name; | |
154 | int value; | |
155 | } KVMCapabilityInfo; | |
156 | ||
157 | #define KVM_CAP_INFO(CAP) { "KVM_CAP_" stringify(CAP), KVM_CAP_##CAP } | |
158 | #define KVM_CAP_LAST_INFO { NULL, 0 } | |
159 | ||
92b4e489 JK |
160 | struct KVMState; |
161 | typedef struct KVMState KVMState; | |
162 | extern KVMState *kvm_state; | |
163 | ||
05330448 AL |
164 | /* external API */ |
165 | ||
00a1555e PB |
166 | int kvm_has_sync_mmu(void); |
167 | int kvm_has_vcpu_events(void); | |
168 | int kvm_has_robust_singlestep(void); | |
ff44f1a3 | 169 | int kvm_has_debugregs(void); |
f1665b21 SY |
170 | int kvm_has_xsave(void); |
171 | int kvm_has_xcrs(void); | |
8a7c7393 | 172 | int kvm_has_pit_state2(void); |
d2f2b8a7 | 173 | int kvm_has_many_ioeventfds(void); |
84b058d7 | 174 | int kvm_has_gsi_routing(void); |
3ab73842 | 175 | int kvm_has_intx_set_mask(void); |
00a1555e | 176 | |
504134d2 | 177 | int kvm_init_vcpu(CPUState *cpu); |
1458c363 | 178 | int kvm_cpu_exec(CPUState *cpu); |
05330448 | 179 | |
504134d2 | 180 | #ifdef NEED_CPU_H |
05330448 | 181 | |
c4cfef5e | 182 | void kvm_setup_guest_memory(void *start, size_t size); |
62a2744c | 183 | void kvm_flush_coalesced_mmio_buffer(void); |
f65ed4c1 | 184 | |
62278814 | 185 | int kvm_insert_breakpoint(CPUState *cpu, target_ulong addr, |
e22a25c9 | 186 | target_ulong len, int type); |
62278814 | 187 | int kvm_remove_breakpoint(CPUState *cpu, target_ulong addr, |
e22a25c9 | 188 | target_ulong len, int type); |
1d5791f4 | 189 | void kvm_remove_all_breakpoints(CPUState *cpu); |
38e478ec | 190 | int kvm_update_guest_debug(CPUState *cpu, unsigned long reinject_trap); |
20c20526 | 191 | #ifndef _WIN32 |
491d6e80 | 192 | int kvm_set_signal_mask(CPUState *cpu, const sigset_t *sigset); |
20c20526 | 193 | #endif |
e22a25c9 | 194 | |
290adf38 | 195 | int kvm_on_sigbus_vcpu(CPUState *cpu, int code, void *addr); |
a1b87fe0 JK |
196 | int kvm_on_sigbus(int code, void *addr); |
197 | ||
05330448 AL |
198 | /* internal API */ |
199 | ||
984b5181 | 200 | int kvm_ioctl(KVMState *s, int type, ...); |
05330448 | 201 | |
984b5181 | 202 | int kvm_vm_ioctl(KVMState *s, int type, ...); |
05330448 | 203 | |
1bc22652 | 204 | int kvm_vcpu_ioctl(CPUState *cpu, int type, ...); |
05330448 | 205 | |
0a6a7cca CD |
206 | /** |
207 | * kvm_device_ioctl - call an ioctl on a kvm device | |
208 | * @fd: The KVM device file descriptor as returned from KVM_CREATE_DEVICE | |
209 | * @type: The device-ctrl ioctl number | |
210 | * | |
211 | * Returns: -errno on error, nonnegative on success | |
212 | */ | |
213 | int kvm_device_ioctl(int fd, int type, ...); | |
214 | ||
215 | /** | |
216 | * kvm_create_device - create a KVM device for the device control API | |
217 | * @KVMState: The KVMState pointer | |
218 | * @type: The KVM device type (see Documentation/virtual/kvm/devices in the | |
219 | * kernel source) | |
220 | * @test: If true, only test if device can be created, but don't actually | |
221 | * create the device. | |
222 | * | |
223 | * Returns: -errno on error, nonnegative on success: @test ? 0 : device fd; | |
224 | */ | |
225 | int kvm_create_device(KVMState *s, uint64_t type, bool test); | |
226 | ||
227 | ||
05330448 AL |
228 | /* Arch specific hooks */ |
229 | ||
94a8d39a JK |
230 | extern const KVMCapabilityInfo kvm_arch_required_capabilities[]; |
231 | ||
20d695a9 AF |
232 | void kvm_arch_pre_run(CPUState *cpu, struct kvm_run *run); |
233 | void kvm_arch_post_run(CPUState *cpu, struct kvm_run *run); | |
05330448 | 234 | |
20d695a9 | 235 | int kvm_arch_handle_exit(CPUState *cpu, struct kvm_run *run); |
05330448 | 236 | |
20d695a9 | 237 | int kvm_arch_process_async_events(CPUState *cpu); |
0af691d7 | 238 | |
20d695a9 | 239 | int kvm_arch_get_registers(CPUState *cpu); |
05330448 | 240 | |
ea375f9a JK |
241 | /* state subset only touched by the VCPU itself during runtime */ |
242 | #define KVM_PUT_RUNTIME_STATE 1 | |
243 | /* state subset modified during VCPU reset */ | |
244 | #define KVM_PUT_RESET_STATE 2 | |
245 | /* full state set, modified during initialization or on vmload */ | |
246 | #define KVM_PUT_FULL_STATE 3 | |
247 | ||
20d695a9 | 248 | int kvm_arch_put_registers(CPUState *cpu, int level); |
05330448 | 249 | |
cad1e282 | 250 | int kvm_arch_init(KVMState *s); |
05330448 | 251 | |
20d695a9 | 252 | int kvm_arch_init_vcpu(CPUState *cpu); |
05330448 | 253 | |
b164e48e EH |
254 | /* Returns VCPU ID to be used on KVM_CREATE_VCPU ioctl() */ |
255 | unsigned long kvm_arch_vcpu_id(CPUState *cpu); | |
256 | ||
20d695a9 | 257 | int kvm_arch_on_sigbus_vcpu(CPUState *cpu, int code, void *addr); |
a1b87fe0 | 258 | int kvm_arch_on_sigbus(int code, void *addr); |
c0532a76 | 259 | |
84b058d7 JK |
260 | void kvm_arch_init_irq_routing(KVMState *s); |
261 | ||
3889c3fa | 262 | int kvm_set_irq(KVMState *s, int irq, int level); |
04fa27f5 | 263 | int kvm_irqchip_send_msi(KVMState *s, MSIMessage msg); |
84b058d7 | 264 | |
1df186df | 265 | void kvm_irqchip_add_irq_route(KVMState *s, int gsi, int irqchip, int pin); |
cb925cf9 | 266 | void kvm_irqchip_commit_routes(KVMState *s); |
84b058d7 | 267 | |
680c1c6f JK |
268 | void kvm_put_apic_state(DeviceState *d, struct kvm_lapic_state *kapic); |
269 | void kvm_get_apic_state(DeviceState *d, struct kvm_lapic_state *kapic); | |
270 | ||
e22a25c9 AL |
271 | struct kvm_guest_debug; |
272 | struct kvm_debug_exit_arch; | |
273 | ||
274 | struct kvm_sw_breakpoint { | |
275 | target_ulong pc; | |
276 | target_ulong saved_insn; | |
277 | int use_count; | |
72cf2d4f | 278 | QTAILQ_ENTRY(kvm_sw_breakpoint) entry; |
e22a25c9 AL |
279 | }; |
280 | ||
72cf2d4f | 281 | QTAILQ_HEAD(kvm_sw_breakpoint_head, kvm_sw_breakpoint); |
e22a25c9 | 282 | |
a60f24b5 | 283 | struct kvm_sw_breakpoint *kvm_find_sw_breakpoint(CPUState *cpu, |
e22a25c9 AL |
284 | target_ulong pc); |
285 | ||
a60f24b5 | 286 | int kvm_sw_breakpoints_active(CPUState *cpu); |
e22a25c9 | 287 | |
80b7cd73 | 288 | int kvm_arch_insert_sw_breakpoint(CPUState *cpu, |
e22a25c9 | 289 | struct kvm_sw_breakpoint *bp); |
80b7cd73 | 290 | int kvm_arch_remove_sw_breakpoint(CPUState *cpu, |
e22a25c9 AL |
291 | struct kvm_sw_breakpoint *bp); |
292 | int kvm_arch_insert_hw_breakpoint(target_ulong addr, | |
293 | target_ulong len, int type); | |
294 | int kvm_arch_remove_hw_breakpoint(target_ulong addr, | |
295 | target_ulong len, int type); | |
296 | void kvm_arch_remove_all_hw_breakpoints(void); | |
297 | ||
20d695a9 | 298 | void kvm_arch_update_guest_debug(CPUState *cpu, struct kvm_guest_debug *dbg); |
e22a25c9 | 299 | |
20d695a9 | 300 | bool kvm_arch_stop_on_emulation_error(CPUState *cpu); |
4513d923 | 301 | |
ad7b8b33 AL |
302 | int kvm_check_extension(KVMState *s, unsigned int extension); |
303 | ||
7d0a07fa AG |
304 | int kvm_vm_check_extension(KVMState *s, unsigned int extension); |
305 | ||
40f1ee27 CH |
306 | #define kvm_vm_enable_cap(s, capability, cap_flags, ...) \ |
307 | ({ \ | |
308 | struct kvm_enable_cap cap = { \ | |
309 | .cap = capability, \ | |
310 | .flags = cap_flags, \ | |
311 | }; \ | |
312 | uint64_t args_tmp[] = { __VA_ARGS__ }; \ | |
313 | int i; \ | |
61c7bbd2 | 314 | for (i = 0; i < (int)ARRAY_SIZE(args_tmp) && \ |
40f1ee27 CH |
315 | i < ARRAY_SIZE(cap.args); i++) { \ |
316 | cap.args[i] = args_tmp[i]; \ | |
317 | } \ | |
318 | kvm_vm_ioctl(s, KVM_ENABLE_CAP, &cap); \ | |
319 | }) | |
320 | ||
321 | #define kvm_vcpu_enable_cap(cpu, capability, cap_flags, ...) \ | |
322 | ({ \ | |
323 | struct kvm_enable_cap cap = { \ | |
324 | .cap = capability, \ | |
325 | .flags = cap_flags, \ | |
326 | }; \ | |
327 | uint64_t args_tmp[] = { __VA_ARGS__ }; \ | |
328 | int i; \ | |
61c7bbd2 | 329 | for (i = 0; i < (int)ARRAY_SIZE(args_tmp) && \ |
40f1ee27 CH |
330 | i < ARRAY_SIZE(cap.args); i++) { \ |
331 | cap.args[i] = args_tmp[i]; \ | |
332 | } \ | |
333 | kvm_vcpu_ioctl(cpu, KVM_ENABLE_CAP, &cap); \ | |
334 | }) | |
335 | ||
ba9bc59e | 336 | uint32_t kvm_arch_get_supported_cpuid(KVMState *env, uint32_t function, |
c958a8bd | 337 | uint32_t index, int reg); |
e22a25c9 | 338 | |
aed6efb9 JH |
339 | void kvm_set_sigmask_len(KVMState *s, unsigned int sigmask_len); |
340 | ||
13eed94e IM |
341 | #if !defined(CONFIG_USER_ONLY) |
342 | int kvm_physical_memory_addr_from_host(KVMState *s, void *ram_addr, | |
343 | hwaddr *phys_addr); | |
344 | #endif | |
345 | ||
346 | #endif /* NEED_CPU_H */ | |
347 | ||
97577fd4 | 348 | void kvm_cpu_synchronize_state(CPUState *cpu); |
13eed94e IM |
349 | void kvm_cpu_synchronize_post_reset(CPUState *cpu); |
350 | void kvm_cpu_synchronize_post_init(CPUState *cpu); | |
de9d61e8 | 351 | void kvm_cpu_clean_state(CPUState *cpu); |
13eed94e | 352 | |
97577fd4 JH |
353 | /* generic hooks - to be moved/refactored once there are more users */ |
354 | ||
355 | static inline void cpu_synchronize_state(CPUState *cpu) | |
356 | { | |
357 | if (kvm_enabled()) { | |
358 | kvm_cpu_synchronize_state(cpu); | |
359 | } | |
360 | } | |
361 | ||
3f24a58f | 362 | static inline void cpu_synchronize_post_reset(CPUState *cpu) |
ea375f9a JK |
363 | { |
364 | if (kvm_enabled()) { | |
3f24a58f | 365 | kvm_cpu_synchronize_post_reset(cpu); |
ea375f9a JK |
366 | } |
367 | } | |
368 | ||
3f24a58f | 369 | static inline void cpu_synchronize_post_init(CPUState *cpu) |
ea375f9a JK |
370 | { |
371 | if (kvm_enabled()) { | |
3f24a58f | 372 | kvm_cpu_synchronize_post_init(cpu); |
ea375f9a JK |
373 | } |
374 | } | |
ca821806 | 375 | |
de9d61e8 MT |
376 | static inline void cpu_clean_state(CPUState *cpu) |
377 | { | |
378 | if (kvm_enabled()) { | |
379 | kvm_cpu_clean_state(cpu); | |
380 | } | |
381 | } | |
382 | ||
92b4e489 | 383 | int kvm_irqchip_add_msi_route(KVMState *s, MSIMessage msg); |
cc57407e | 384 | int kvm_irqchip_update_msi_route(KVMState *s, int virq, MSIMessage msg); |
1e2aa8be | 385 | void kvm_irqchip_release_virq(KVMState *s, int virq); |
39853bbc | 386 | |
d426d9fb CH |
387 | int kvm_irqchip_add_adapter_route(KVMState *s, AdapterInfo *adapter); |
388 | ||
ca916d37 VM |
389 | int kvm_irqchip_add_irqfd_notifier(KVMState *s, EventNotifier *n, |
390 | EventNotifier *rn, int virq); | |
b131c74a | 391 | int kvm_irqchip_remove_irqfd_notifier(KVMState *s, EventNotifier *n, int virq); |
d8ee0384 JB |
392 | void kvm_pc_gsi_handler(void *opaque, int n, int level); |
393 | void kvm_pc_setup_irq_routing(bool pci_enabled); | |
7b774593 | 394 | void kvm_init_irq_routing(KVMState *s); |
d6032e06 CD |
395 | |
396 | /** | |
397 | * kvm_arch_irqchip_create: | |
398 | * @KVMState: The KVMState pointer | |
399 | * | |
400 | * Allow architectures to create an in-kernel irq chip themselves. | |
401 | * | |
402 | * Returns: < 0: error | |
403 | * 0: irq chip was not created | |
404 | * > 0: irq chip was created | |
405 | */ | |
406 | int kvm_arch_irqchip_create(KVMState *s); | |
ada4135f CH |
407 | |
408 | /** | |
409 | * kvm_set_one_reg - set a register value in KVM via KVM_SET_ONE_REG ioctl | |
410 | * @id: The register ID | |
411 | * @source: The pointer to the value to be set. It must point to a variable | |
412 | * of the correct type/size for the register being accessed. | |
413 | * | |
414 | * Returns: 0 on success, or a negative errno on failure. | |
415 | */ | |
416 | int kvm_set_one_reg(CPUState *cs, uint64_t id, void *source); | |
417 | ||
418 | /** | |
419 | * kvm_get_one_reg - get a register value from KVM via KVM_GET_ONE_REG ioctl | |
420 | * @id: The register ID | |
421 | * @target: The pointer where the value is to be stored. It must point to a | |
422 | * variable of the correct type/size for the register being accessed. | |
423 | * | |
424 | * Returns: 0 on success, or a negative errno on failure. | |
425 | */ | |
426 | int kvm_get_one_reg(CPUState *cs, uint64_t id, void *target); | |
05330448 | 427 | #endif |