19c17d615SPaolo Bonzini /*
29c17d615SPaolo Bonzini * QEMU KVM support
39c17d615SPaolo Bonzini *
49c17d615SPaolo Bonzini * Copyright IBM, Corp. 2008
59c17d615SPaolo Bonzini *
69c17d615SPaolo Bonzini * Authors:
79c17d615SPaolo Bonzini * Anthony Liguori <aliguori@us.ibm.com>
89c17d615SPaolo Bonzini *
99c17d615SPaolo Bonzini * This work is licensed under the terms of the GNU GPL, version 2 or later.
109c17d615SPaolo Bonzini * See the COPYING file in the top-level directory.
119c17d615SPaolo Bonzini *
129c17d615SPaolo Bonzini */
139c17d615SPaolo Bonzini
1469700301SPhilippe Mathieu-Daudé /* header to be included in non-KVM-specific code */
1569700301SPhilippe Mathieu-Daudé
169c17d615SPaolo Bonzini #ifndef QEMU_KVM_H
179c17d615SPaolo Bonzini #define QEMU_KVM_H
189c17d615SPaolo Bonzini
19217a190eSPhilippe Mathieu-Daudé #include "exec/memattrs.h"
20940e43aaSClaudio Fontana #include "qemu/accel.h"
21db1015e9SEduardo Habkost #include "qom/object.h"
229c17d615SPaolo Bonzini
237d7a21baSPhilippe Mathieu-Daudé #ifdef COMPILING_PER_TARGET
249c17d615SPaolo Bonzini # ifdef CONFIG_KVM
259c17d615SPaolo Bonzini # include <linux/kvm.h>
26cbca3722SThomas Huth # define CONFIG_KVM_IS_POSSIBLE
279c17d615SPaolo Bonzini # endif
28cbca3722SThomas Huth #else
29cbca3722SThomas Huth # define CONFIG_KVM_IS_POSSIBLE
30cbca3722SThomas Huth #endif
31cbca3722SThomas Huth
32cbca3722SThomas Huth #ifdef CONFIG_KVM_IS_POSSIBLE
339c17d615SPaolo Bonzini
34d5286af5Sliguang extern bool kvm_allowed;
359c17d615SPaolo Bonzini extern bool kvm_kernel_irqchip;
3632c18a2dSMatt Gingell extern bool kvm_split_irqchip;
379c17d615SPaolo Bonzini extern bool kvm_async_interrupts_allowed;
38215e79c0SAlexander Graf extern bool kvm_halt_in_kernel_allowed;
39f41389aeSEric Auger extern bool kvm_resamplefds_allowed;
409c17d615SPaolo Bonzini extern bool kvm_msi_via_irqfd_allowed;
419c17d615SPaolo Bonzini extern bool kvm_gsi_routing_allowed;
4276fe21deSAlexey Kardashevskiy extern bool kvm_gsi_direct_mapping;
43df9c8b75SJordan Justen extern bool kvm_readonly_mem_allowed;
44767a554aSPavel Fedin extern bool kvm_msi_use_devid;
459c17d615SPaolo Bonzini
469c17d615SPaolo Bonzini #define kvm_enabled() (kvm_allowed)
479c17d615SPaolo Bonzini /**
489c17d615SPaolo Bonzini * kvm_irqchip_in_kernel:
499c17d615SPaolo Bonzini *
5031c707fbSEduardo Habkost * Returns: true if an in-kernel irqchip was created.
519c17d615SPaolo Bonzini * What this actually means is architecture and machine model
5231c707fbSEduardo Habkost * specific: on PC, for instance, it means that the LAPIC
5331c707fbSEduardo Habkost * is in kernel. This function should never be used from generic
5431c707fbSEduardo Habkost * target-independent code: use one of the following functions or
5531c707fbSEduardo Habkost * some other specific check instead.
569c17d615SPaolo Bonzini */
579c17d615SPaolo Bonzini #define kvm_irqchip_in_kernel() (kvm_kernel_irqchip)
589c17d615SPaolo Bonzini
599c17d615SPaolo Bonzini /**
6032c18a2dSMatt Gingell * kvm_irqchip_is_split:
6132c18a2dSMatt Gingell *
6231c707fbSEduardo Habkost * Returns: true if the irqchip implementation is split between
6331c707fbSEduardo Habkost * user and kernel space. The details are architecture and
6431c707fbSEduardo Habkost * machine specific. On PC, it means that the PIC, IOAPIC, and
6531c707fbSEduardo Habkost * PIT are in user space while the LAPIC is in the kernel.
6632c18a2dSMatt Gingell */
6732c18a2dSMatt Gingell #define kvm_irqchip_is_split() (kvm_split_irqchip)
6832c18a2dSMatt Gingell
6932c18a2dSMatt Gingell /**
709c17d615SPaolo Bonzini * kvm_async_interrupts_enabled:
719c17d615SPaolo Bonzini *
729c17d615SPaolo Bonzini * Returns: true if we can deliver interrupts to KVM
739c17d615SPaolo Bonzini * asynchronously (ie by ioctl from any thread at any time)
749c17d615SPaolo Bonzini * rather than having to do interrupt delivery synchronously
759c17d615SPaolo Bonzini * (where the vcpu must be stopped at a suitable point first).
769c17d615SPaolo Bonzini */
779c17d615SPaolo Bonzini #define kvm_async_interrupts_enabled() (kvm_async_interrupts_allowed)
789c17d615SPaolo Bonzini
799c17d615SPaolo Bonzini /**
80215e79c0SAlexander Graf * kvm_halt_in_kernel
81215e79c0SAlexander Graf *
82215e79c0SAlexander Graf * Returns: true if halted cpus should still get a KVM_RUN ioctl to run
83215e79c0SAlexander Graf * inside of kernel space. This only works if MP state is implemented.
84215e79c0SAlexander Graf */
85215e79c0SAlexander Graf #define kvm_halt_in_kernel() (kvm_halt_in_kernel_allowed)
86215e79c0SAlexander Graf
87215e79c0SAlexander Graf /**
889c17d615SPaolo Bonzini * kvm_irqfds_enabled:
899c17d615SPaolo Bonzini *
909c17d615SPaolo Bonzini * Returns: true if we can use irqfds to inject interrupts into
919c17d615SPaolo Bonzini * a KVM CPU (ie the kernel supports irqfds and we are running
929c17d615SPaolo Bonzini * with a configuration where it is meaningful to use them).
93a788260bSPaolo Bonzini *
94a788260bSPaolo Bonzini * Always available if running with in-kernel irqchip.
959c17d615SPaolo Bonzini */
96a788260bSPaolo Bonzini #define kvm_irqfds_enabled() kvm_irqchip_in_kernel()
979c17d615SPaolo Bonzini
989c17d615SPaolo Bonzini /**
99f41389aeSEric Auger * kvm_resamplefds_enabled:
100f41389aeSEric Auger *
101f41389aeSEric Auger * Returns: true if we can use resamplefds to inject interrupts into
102f41389aeSEric Auger * a KVM CPU (ie the kernel supports resamplefds and we are running
103f41389aeSEric Auger * with a configuration where it is meaningful to use them).
104f41389aeSEric Auger */
105f41389aeSEric Auger #define kvm_resamplefds_enabled() (kvm_resamplefds_allowed)
106f41389aeSEric Auger
107f41389aeSEric Auger /**
1089c17d615SPaolo Bonzini * kvm_msi_via_irqfd_enabled:
1099c17d615SPaolo Bonzini *
1109c17d615SPaolo Bonzini * Returns: true if we can route a PCI MSI (Message Signaled Interrupt)
1119c17d615SPaolo Bonzini * to a KVM CPU via an irqfd. This requires that the kernel supports
1129c17d615SPaolo Bonzini * this and that we're running in a configuration that permits it.
1139c17d615SPaolo Bonzini */
1149c17d615SPaolo Bonzini #define kvm_msi_via_irqfd_enabled() (kvm_msi_via_irqfd_allowed)
1159c17d615SPaolo Bonzini
1169c17d615SPaolo Bonzini /**
1179c17d615SPaolo Bonzini * kvm_gsi_routing_enabled:
1189c17d615SPaolo Bonzini *
1199c17d615SPaolo Bonzini * Returns: true if GSI routing is enabled (ie the kernel supports
1209c17d615SPaolo Bonzini * it and we're running in a configuration that permits it).
1219c17d615SPaolo Bonzini */
1229c17d615SPaolo Bonzini #define kvm_gsi_routing_enabled() (kvm_gsi_routing_allowed)
1239c17d615SPaolo Bonzini
124df9c8b75SJordan Justen /**
12576fe21deSAlexey Kardashevskiy * kvm_gsi_direct_mapping:
12676fe21deSAlexey Kardashevskiy *
12776fe21deSAlexey Kardashevskiy * Returns: true if GSI direct mapping is enabled.
12876fe21deSAlexey Kardashevskiy */
12976fe21deSAlexey Kardashevskiy #define kvm_gsi_direct_mapping() (kvm_gsi_direct_mapping)
13076fe21deSAlexey Kardashevskiy
13176fe21deSAlexey Kardashevskiy /**
132df9c8b75SJordan Justen * kvm_readonly_mem_enabled:
133df9c8b75SJordan Justen *
134df9c8b75SJordan Justen * Returns: true if KVM readonly memory is enabled (ie the kernel
135df9c8b75SJordan Justen * supports it and we're running in a configuration that permits it).
136df9c8b75SJordan Justen */
137df9c8b75SJordan Justen #define kvm_readonly_mem_enabled() (kvm_readonly_mem_allowed)
138df9c8b75SJordan Justen
13950bf31b9SPavel Fedin /**
140767a554aSPavel Fedin * kvm_msi_devid_required:
141767a554aSPavel Fedin * Returns: true if KVM requires a device id to be provided while
142767a554aSPavel Fedin * defining an MSI routing entry.
143767a554aSPavel Fedin */
144767a554aSPavel Fedin #define kvm_msi_devid_required() (kvm_msi_use_devid)
145767a554aSPavel Fedin
1469c17d615SPaolo Bonzini #else
147cbca3722SThomas Huth
1489c17d615SPaolo Bonzini #define kvm_enabled() (0)
1499c17d615SPaolo Bonzini #define kvm_irqchip_in_kernel() (false)
15015eafc2eSPaolo Bonzini #define kvm_irqchip_is_split() (false)
1519c17d615SPaolo Bonzini #define kvm_async_interrupts_enabled() (false)
152215e79c0SAlexander Graf #define kvm_halt_in_kernel() (false)
153f8c0687fSPaolo Bonzini #define kvm_irqfds_enabled() (false)
154879904e8SEric Auger #define kvm_resamplefds_enabled() (false)
1559c17d615SPaolo Bonzini #define kvm_msi_via_irqfd_enabled() (false)
1569c17d615SPaolo Bonzini #define kvm_gsi_routing_allowed() (false)
15776fe21deSAlexey Kardashevskiy #define kvm_gsi_direct_mapping() (false)
158df9c8b75SJordan Justen #define kvm_readonly_mem_enabled() (false)
159767a554aSPavel Fedin #define kvm_msi_devid_required() (false)
160cbca3722SThomas Huth
161cbca3722SThomas Huth #endif /* CONFIG_KVM_IS_POSSIBLE */
1629c17d615SPaolo Bonzini
1639c17d615SPaolo Bonzini struct kvm_run;
1649e03a040SFrank Blaschka struct kvm_irq_routing_entry;
1659c17d615SPaolo Bonzini
1669c17d615SPaolo Bonzini typedef struct KVMCapabilityInfo {
1679c17d615SPaolo Bonzini const char *name;
1689c17d615SPaolo Bonzini int value;
1699c17d615SPaolo Bonzini } KVMCapabilityInfo;
1709c17d615SPaolo Bonzini
1719c17d615SPaolo Bonzini #define KVM_CAP_INFO(CAP) { "KVM_CAP_" stringify(CAP), KVM_CAP_##CAP }
1729c17d615SPaolo Bonzini #define KVM_CAP_LAST_INFO { NULL, 0 }
1739c17d615SPaolo Bonzini
1749c17d615SPaolo Bonzini struct KVMState;
17597e622deSEduardo Habkost
17697e622deSEduardo Habkost #define TYPE_KVM_ACCEL ACCEL_CLASS_NAME("kvm")
1779c17d615SPaolo Bonzini typedef struct KVMState KVMState;
1788110fa1dSEduardo Habkost DECLARE_INSTANCE_CHECKER(KVMState, KVM_STATE,
1798110fa1dSEduardo Habkost TYPE_KVM_ACCEL)
18097e622deSEduardo Habkost
1819c17d615SPaolo Bonzini extern KVMState *kvm_state;
1823607715aSDavid Gibson typedef struct Notifier Notifier;
1839c17d615SPaolo Bonzini
18495686908SLongpeng(Mike) typedef struct KVMRouteChange {
18595686908SLongpeng(Mike) KVMState *s;
18695686908SLongpeng(Mike) int changes;
18795686908SLongpeng(Mike) } KVMRouteChange;
18895686908SLongpeng(Mike)
1899c17d615SPaolo Bonzini /* external API */
1909c17d615SPaolo Bonzini
19116ab2edaSDavid Hildenbrand unsigned int kvm_get_max_memslots(void);
1925b23186aSDavid Hildenbrand unsigned int kvm_get_free_memslots(void);
19362dd4edaSGreg Kurz bool kvm_has_sync_mmu(void);
1949c17d615SPaolo Bonzini int kvm_has_vcpu_events(void);
195ebbfef2fSLiran Alon int kvm_max_nested_state_length(void);
1969c17d615SPaolo Bonzini int kvm_has_gsi_routing(void);
1979c17d615SPaolo Bonzini
1985d721b78SAlexander Graf /**
1995d721b78SAlexander Graf * kvm_arm_supports_user_irq
2005d721b78SAlexander Graf *
2015d721b78SAlexander Graf * Not all KVM implementations support notifications for kernel generated
2025d721b78SAlexander Graf * interrupt events to user space. This function indicates whether the current
2035d721b78SAlexander Graf * KVM implementation does support them.
2045d721b78SAlexander Graf *
2055d721b78SAlexander Graf * Returns: true if KVM supports using kernel generated IRQs from user space
2065d721b78SAlexander Graf */
2075d721b78SAlexander Graf bool kvm_arm_supports_user_irq(void);
2085d721b78SAlexander Graf
209b20e3780SBrijesh Singh
21082bd4ca3SPhilippe Mathieu-Daudé int kvm_on_sigbus_vcpu(CPUState *cpu, int code, void *addr);
21182bd4ca3SPhilippe Mathieu-Daudé int kvm_on_sigbus(int code, void *addr);
21282bd4ca3SPhilippe Mathieu-Daudé
2137d7a21baSPhilippe Mathieu-Daudé #ifdef COMPILING_PER_TARGET
21433c11879SPaolo Bonzini #include "cpu.h"
2159c17d615SPaolo Bonzini
216c4cfef5eSIgor Mammedov void kvm_flush_coalesced_mmio_buffer(void);
217c4cfef5eSIgor Mammedov
218c7f1c537SAlex Bennée /**
219c7f1c537SAlex Bennée * kvm_update_guest_debug(): ensure KVM debug structures updated
220c7f1c537SAlex Bennée * @cs: the CPUState for this cpu
221c7f1c537SAlex Bennée * @reinject_trap: KVM trap injection control
222c7f1c537SAlex Bennée *
223c7f1c537SAlex Bennée * There are usually per-arch specifics which will be handled by
224c7f1c537SAlex Bennée * calling down to kvm_arch_update_guest_debug after the generic
225c7f1c537SAlex Bennée * fields have been set.
226c7f1c537SAlex Bennée */
2271e1e4879SPaolo Bonzini #ifdef TARGET_KVM_HAVE_GUEST_DEBUG
22838e478ecSStefan Weil int kvm_update_guest_debug(CPUState *cpu, unsigned long reinject_trap);
229c7f1c537SAlex Bennée #else
kvm_update_guest_debug(CPUState * cpu,unsigned long reinject_trap)230c7f1c537SAlex Bennée static inline int kvm_update_guest_debug(CPUState *cpu, unsigned long reinject_trap)
231c7f1c537SAlex Bennée {
232c7f1c537SAlex Bennée return -EINVAL;
233c7f1c537SAlex Bennée }
234c7f1c537SAlex Bennée #endif
2359c17d615SPaolo Bonzini
2369c17d615SPaolo Bonzini /* internal API */
2379c17d615SPaolo Bonzini
2389c17d615SPaolo Bonzini int kvm_ioctl(KVMState *s, int type, ...);
2399c17d615SPaolo Bonzini
2409c17d615SPaolo Bonzini int kvm_vm_ioctl(KVMState *s, int type, ...);
2419c17d615SPaolo Bonzini
242501a7ce7SAndreas Färber int kvm_vcpu_ioctl(CPUState *cpu, int type, ...);
2439c17d615SPaolo Bonzini
2440a6a7ccaSChristoffer Dall /**
2450a6a7ccaSChristoffer Dall * kvm_device_ioctl - call an ioctl on a kvm device
2460a6a7ccaSChristoffer Dall * @fd: The KVM device file descriptor as returned from KVM_CREATE_DEVICE
2470a6a7ccaSChristoffer Dall * @type: The device-ctrl ioctl number
2480a6a7ccaSChristoffer Dall *
2490a6a7ccaSChristoffer Dall * Returns: -errno on error, nonnegative on success
2500a6a7ccaSChristoffer Dall */
2510a6a7ccaSChristoffer Dall int kvm_device_ioctl(int fd, int type, ...);
2520a6a7ccaSChristoffer Dall
2530a6a7ccaSChristoffer Dall /**
254d0a073a1SDominik Dingel * kvm_vm_check_attr - check for existence of a specific vm attribute
255d0a073a1SDominik Dingel * @s: The KVMState pointer
256d0a073a1SDominik Dingel * @group: the group
257d0a073a1SDominik Dingel * @attr: the attribute of that group to query for
258d0a073a1SDominik Dingel *
259d0a073a1SDominik Dingel * Returns: 1 if the attribute exists
260d0a073a1SDominik Dingel * 0 if the attribute either does not exist or if the vm device
261d0a073a1SDominik Dingel * interface is unavailable
262d0a073a1SDominik Dingel */
263d0a073a1SDominik Dingel int kvm_vm_check_attr(KVMState *s, uint32_t group, uint64_t attr);
264d0a073a1SDominik Dingel
265d0a073a1SDominik Dingel /**
2664b3cfe72SPavel Fedin * kvm_device_check_attr - check for existence of a specific device attribute
2674b3cfe72SPavel Fedin * @fd: The device file descriptor
2684b3cfe72SPavel Fedin * @group: the group
2694b3cfe72SPavel Fedin * @attr: the attribute of that group to query for
2704b3cfe72SPavel Fedin *
2714b3cfe72SPavel Fedin * Returns: 1 if the attribute exists
2724b3cfe72SPavel Fedin * 0 if the attribute either does not exist or if the vm device
2734b3cfe72SPavel Fedin * interface is unavailable
2744b3cfe72SPavel Fedin */
2754b3cfe72SPavel Fedin int kvm_device_check_attr(int fd, uint32_t group, uint64_t attr);
2764b3cfe72SPavel Fedin
2774b3cfe72SPavel Fedin /**
27884b6ea05SGreg Kurz * kvm_device_access - set or get value of a specific device attribute
2794b3cfe72SPavel Fedin * @fd: The device file descriptor
2804b3cfe72SPavel Fedin * @group: the group
2814b3cfe72SPavel Fedin * @attr: the attribute of that group to set or get
2824b3cfe72SPavel Fedin * @val: pointer to a storage area for the value
2834b3cfe72SPavel Fedin * @write: true for set and false for get operation
284556969e9SEric Auger * @errp: error object handle
2854b3cfe72SPavel Fedin *
286556969e9SEric Auger * Returns: 0 on success
287556969e9SEric Auger * < 0 on error
288556969e9SEric Auger * Use kvm_device_check_attr() in order to check for the availability
289556969e9SEric Auger * of optional attributes.
2904b3cfe72SPavel Fedin */
291556969e9SEric Auger int kvm_device_access(int fd, int group, uint64_t attr,
292556969e9SEric Auger void *val, bool write, Error **errp);
2934b3cfe72SPavel Fedin
2944b3cfe72SPavel Fedin /**
2950a6a7ccaSChristoffer Dall * kvm_create_device - create a KVM device for the device control API
2960a6a7ccaSChristoffer Dall * @KVMState: The KVMState pointer
2970a6a7ccaSChristoffer Dall * @type: The KVM device type (see Documentation/virtual/kvm/devices in the
2980a6a7ccaSChristoffer Dall * kernel source)
2990a6a7ccaSChristoffer Dall * @test: If true, only test if device can be created, but don't actually
3000a6a7ccaSChristoffer Dall * create the device.
3010a6a7ccaSChristoffer Dall *
3020a6a7ccaSChristoffer Dall * Returns: -errno on error, nonnegative on success: @test ? 0 : device fd;
3030a6a7ccaSChristoffer Dall */
3040a6a7ccaSChristoffer Dall int kvm_create_device(KVMState *s, uint64_t type, bool test);
3050a6a7ccaSChristoffer Dall
30629039acfSPeter Xu /**
30729039acfSPeter Xu * kvm_device_supported - probe whether KVM supports specific device
30829039acfSPeter Xu *
30929039acfSPeter Xu * @vmfd: The fd handler for VM
31029039acfSPeter Xu * @type: type of device
31129039acfSPeter Xu *
31229039acfSPeter Xu * @return: true if supported, otherwise false.
31329039acfSPeter Xu */
31429039acfSPeter Xu bool kvm_device_supported(int vmfd, uint64_t type);
3150a6a7ccaSChristoffer Dall
31608c32868SSalil Mehta /**
31708c32868SSalil Mehta * kvm_create_vcpu - Gets a parked KVM vCPU or creates a KVM vCPU
31808c32868SSalil Mehta * @cpu: QOM CPUState object for which KVM vCPU has to be fetched/created.
31908c32868SSalil Mehta *
32008c32868SSalil Mehta * @returns: 0 when success, errno (<0) when failed.
32108c32868SSalil Mehta */
32208c32868SSalil Mehta int kvm_create_vcpu(CPUState *cpu);
32308c32868SSalil Mehta
32408c32868SSalil Mehta /**
32508c32868SSalil Mehta * kvm_park_vcpu - Park QEMU KVM vCPU context
32608c32868SSalil Mehta * @cpu: QOM CPUState object for which QEMU KVM vCPU context has to be parked.
32708c32868SSalil Mehta *
32808c32868SSalil Mehta * @returns: none
32908c32868SSalil Mehta */
33008c32868SSalil Mehta void kvm_park_vcpu(CPUState *cpu);
33108c32868SSalil Mehta
33208c32868SSalil Mehta /**
33308c32868SSalil Mehta * kvm_unpark_vcpu - unpark QEMU KVM vCPU context
33408c32868SSalil Mehta * @s: KVM State
33508c32868SSalil Mehta * @vcpu_id: Architecture vCPU ID of the parked vCPU
33608c32868SSalil Mehta *
33708c32868SSalil Mehta * @returns: KVM fd
33808c32868SSalil Mehta */
33908c32868SSalil Mehta int kvm_unpark_vcpu(KVMState *s, unsigned long vcpu_id);
34008c32868SSalil Mehta
341*c6a3d7bcSHarsh Prateek Bora /**
342*c6a3d7bcSHarsh Prateek Bora * kvm_create_and_park_vcpu - Create and park a KVM vCPU
343*c6a3d7bcSHarsh Prateek Bora * @cpu: QOM CPUState object for which KVM vCPU has to be created and parked.
344*c6a3d7bcSHarsh Prateek Bora *
345*c6a3d7bcSHarsh Prateek Bora * @returns: 0 when success, errno (<0) when failed.
346*c6a3d7bcSHarsh Prateek Bora */
347*c6a3d7bcSHarsh Prateek Bora int kvm_create_and_park_vcpu(CPUState *cpu);
348*c6a3d7bcSHarsh Prateek Bora
3499c17d615SPaolo Bonzini /* Arch specific hooks */
3509c17d615SPaolo Bonzini
3519c17d615SPaolo Bonzini extern const KVMCapabilityInfo kvm_arch_required_capabilities[];
3529c17d615SPaolo Bonzini
3533dba0a33SPaolo Bonzini void kvm_arch_accel_class_init(ObjectClass *oc);
3543dba0a33SPaolo Bonzini
355501a7ce7SAndreas Färber void kvm_arch_pre_run(CPUState *cpu, struct kvm_run *run);
3564c663752SPaolo Bonzini MemTxAttrs kvm_arch_post_run(CPUState *cpu, struct kvm_run *run);
3579c17d615SPaolo Bonzini
358501a7ce7SAndreas Färber int kvm_arch_handle_exit(CPUState *cpu, struct kvm_run *run);
3599c17d615SPaolo Bonzini
360501a7ce7SAndreas Färber int kvm_arch_process_async_events(CPUState *cpu);
3619c17d615SPaolo Bonzini
362501a7ce7SAndreas Färber int kvm_arch_get_registers(CPUState *cpu);
3639c17d615SPaolo Bonzini
3649c17d615SPaolo Bonzini /* state subset only touched by the VCPU itself during runtime */
3659c17d615SPaolo Bonzini #define KVM_PUT_RUNTIME_STATE 1
3669c17d615SPaolo Bonzini /* state subset modified during VCPU reset */
3679c17d615SPaolo Bonzini #define KVM_PUT_RESET_STATE 2
3689c17d615SPaolo Bonzini /* full state set, modified during initialization or on vmload */
3699c17d615SPaolo Bonzini #define KVM_PUT_FULL_STATE 3
3709c17d615SPaolo Bonzini
371501a7ce7SAndreas Färber int kvm_arch_put_registers(CPUState *cpu, int level);
3729c17d615SPaolo Bonzini
3735e0d6590SAkihiko Odaki int kvm_arch_get_default_type(MachineState *ms);
3745e0d6590SAkihiko Odaki
375b16565b3SMarcel Apfelbaum int kvm_arch_init(MachineState *ms, KVMState *s);
3769c17d615SPaolo Bonzini
377501a7ce7SAndreas Färber int kvm_arch_init_vcpu(CPUState *cpu);
378b1115c99SLiran Alon int kvm_arch_destroy_vcpu(CPUState *cpu);
3799c17d615SPaolo Bonzini
38041264b38SGreg Kurz bool kvm_vcpu_id_is_valid(int vcpu_id);
38141264b38SGreg Kurz
382b164e48eSEduardo Habkost /* Returns VCPU ID to be used on KVM_CREATE_VCPU ioctl() */
383b164e48eSEduardo Habkost unsigned long kvm_arch_vcpu_id(CPUState *cpu);
384b164e48eSEduardo Habkost
385e24fd076SDongjiu Geng #ifdef KVM_HAVE_MCE_INJECTION
3862ae41db2SPaolo Bonzini void kvm_arch_on_sigbus_vcpu(CPUState *cpu, int code, void *addr);
3872ae41db2SPaolo Bonzini #endif
3889c17d615SPaolo Bonzini
3899c17d615SPaolo Bonzini void kvm_arch_init_irq_routing(KVMState *s);
3909c17d615SPaolo Bonzini
3919e03a040SFrank Blaschka int kvm_arch_fixup_msi_route(struct kvm_irq_routing_entry *route,
392dc9f06caSPavel Fedin uint64_t address, uint32_t data, PCIDevice *dev);
3939e03a040SFrank Blaschka
39438d87493SPeter Xu /* Notify arch about newly added MSI routes */
39538d87493SPeter Xu int kvm_arch_add_msi_route_post(struct kvm_irq_routing_entry *route,
39638d87493SPeter Xu int vector, PCIDevice *dev);
39738d87493SPeter Xu /* Notify arch about released MSI routes */
39838d87493SPeter Xu int kvm_arch_release_virq_post(int virq);
39938d87493SPeter Xu
4001850b6b7SEric Auger int kvm_arch_msi_data_to_gsi(uint32_t data);
4011850b6b7SEric Auger
4029c17d615SPaolo Bonzini int kvm_set_irq(KVMState *s, int irq, int level);
4039c17d615SPaolo Bonzini int kvm_irqchip_send_msi(KVMState *s, MSIMessage msg);
4049c17d615SPaolo Bonzini
4059c17d615SPaolo Bonzini void kvm_irqchip_add_irq_route(KVMState *s, int gsi, int irqchip, int pin);
4069c17d615SPaolo Bonzini
4073607715aSDavid Gibson void kvm_irqchip_add_change_notifier(Notifier *n);
4083607715aSDavid Gibson void kvm_irqchip_remove_change_notifier(Notifier *n);
4093607715aSDavid Gibson void kvm_irqchip_change_notify(void);
4103607715aSDavid Gibson
4119c17d615SPaolo Bonzini struct kvm_guest_debug;
4129c17d615SPaolo Bonzini struct kvm_debug_exit_arch;
4139c17d615SPaolo Bonzini
4149c17d615SPaolo Bonzini struct kvm_sw_breakpoint {
415b67be03eSAnton Johansson vaddr pc;
416b67be03eSAnton Johansson vaddr saved_insn;
4179c17d615SPaolo Bonzini int use_count;
4189c17d615SPaolo Bonzini QTAILQ_ENTRY(kvm_sw_breakpoint) entry;
4199c17d615SPaolo Bonzini };
4209c17d615SPaolo Bonzini
421501a7ce7SAndreas Färber struct kvm_sw_breakpoint *kvm_find_sw_breakpoint(CPUState *cpu,
422b67be03eSAnton Johansson vaddr pc);
4239c17d615SPaolo Bonzini
424501a7ce7SAndreas Färber int kvm_sw_breakpoints_active(CPUState *cpu);
4259c17d615SPaolo Bonzini
42680b7cd73SAndreas Färber int kvm_arch_insert_sw_breakpoint(CPUState *cpu,
4279c17d615SPaolo Bonzini struct kvm_sw_breakpoint *bp);
42880b7cd73SAndreas Färber int kvm_arch_remove_sw_breakpoint(CPUState *cpu,
4299c17d615SPaolo Bonzini struct kvm_sw_breakpoint *bp);
430b8a6eb18SAnton Johansson int kvm_arch_insert_hw_breakpoint(vaddr addr, vaddr len, int type);
431b8a6eb18SAnton Johansson int kvm_arch_remove_hw_breakpoint(vaddr addr, vaddr len, int type);
4329c17d615SPaolo Bonzini void kvm_arch_remove_all_hw_breakpoints(void);
4339c17d615SPaolo Bonzini
434501a7ce7SAndreas Färber void kvm_arch_update_guest_debug(CPUState *cpu, struct kvm_guest_debug *dbg);
4359c17d615SPaolo Bonzini
436501a7ce7SAndreas Färber bool kvm_arch_stop_on_emulation_error(CPUState *cpu);
4379c17d615SPaolo Bonzini
4389c17d615SPaolo Bonzini int kvm_check_extension(KVMState *s, unsigned int extension);
4399c17d615SPaolo Bonzini
4407d0a07faSAlexander Graf int kvm_vm_check_extension(KVMState *s, unsigned int extension);
4417d0a07faSAlexander Graf
44240f1ee27SCornelia Huck #define kvm_vm_enable_cap(s, capability, cap_flags, ...) \
44340f1ee27SCornelia Huck ({ \
44440f1ee27SCornelia Huck struct kvm_enable_cap cap = { \
44540f1ee27SCornelia Huck .cap = capability, \
44640f1ee27SCornelia Huck .flags = cap_flags, \
44740f1ee27SCornelia Huck }; \
44840f1ee27SCornelia Huck uint64_t args_tmp[] = { __VA_ARGS__ }; \
4491b7ac7caSGreg Kurz size_t n = MIN(ARRAY_SIZE(args_tmp), ARRAY_SIZE(cap.args)); \
4501b7ac7caSGreg Kurz memcpy(cap.args, args_tmp, n * sizeof(cap.args[0])); \
45140f1ee27SCornelia Huck kvm_vm_ioctl(s, KVM_ENABLE_CAP, &cap); \
45240f1ee27SCornelia Huck })
45340f1ee27SCornelia Huck
45440f1ee27SCornelia Huck #define kvm_vcpu_enable_cap(cpu, capability, cap_flags, ...) \
45540f1ee27SCornelia Huck ({ \
45640f1ee27SCornelia Huck struct kvm_enable_cap cap = { \
45740f1ee27SCornelia Huck .cap = capability, \
45840f1ee27SCornelia Huck .flags = cap_flags, \
45940f1ee27SCornelia Huck }; \
46040f1ee27SCornelia Huck uint64_t args_tmp[] = { __VA_ARGS__ }; \
4611b7ac7caSGreg Kurz size_t n = MIN(ARRAY_SIZE(args_tmp), ARRAY_SIZE(cap.args)); \
4621b7ac7caSGreg Kurz memcpy(cap.args, args_tmp, n * sizeof(cap.args[0])); \
46340f1ee27SCornelia Huck kvm_vcpu_ioctl(cpu, KVM_ENABLE_CAP, &cap); \
46440f1ee27SCornelia Huck })
46540f1ee27SCornelia Huck
466aed6efb9SJames Hogan void kvm_set_sigmask_len(KVMState *s, unsigned int sigmask_len);
467aed6efb9SJames Hogan
46897577fd4SJames Hogan int kvm_physical_memory_addr_from_host(KVMState *s, void *ram_addr,
46997577fd4SJames Hogan hwaddr *phys_addr);
47097577fd4SJames Hogan
4717d7a21baSPhilippe Mathieu-Daudé #endif /* COMPILING_PER_TARGET */
47297577fd4SJames Hogan
473dd1750d7SAndreas Färber void kvm_cpu_synchronize_state(CPUState *cpu);
4749c17d615SPaolo Bonzini
47518268b60SPaolo Bonzini void kvm_init_cpu_signals(CPUState *cpu);
47618268b60SPaolo Bonzini
477d1f6af6aSPeter Xu /**
478d1f6af6aSPeter Xu * kvm_irqchip_add_msi_route - Add MSI route for specific vector
479def4c557SLongpeng(Mike) * @c: KVMRouteChange instance.
480d1f6af6aSPeter Xu * @vector: which vector to add. This can be either MSI/MSIX
481d1f6af6aSPeter Xu * vector. The function will automatically detect whether
482d1f6af6aSPeter Xu * MSI/MSIX is enabled, and fetch corresponding MSI
483d1f6af6aSPeter Xu * message.
484d1f6af6aSPeter Xu * @dev: Owner PCI device to add the route. If @dev is specified
485d1f6af6aSPeter Xu * as @NULL, an empty MSI message will be inited.
486d1f6af6aSPeter Xu * @return: virq (>=0) when success, errno (<0) when failed.
487d1f6af6aSPeter Xu */
488def4c557SLongpeng(Mike) int kvm_irqchip_add_msi_route(KVMRouteChange *c, int vector, PCIDevice *dev);
489dc9f06caSPavel Fedin int kvm_irqchip_update_msi_route(KVMState *s, int virq, MSIMessage msg,
490dc9f06caSPavel Fedin PCIDevice *dev);
4913f1fea0fSPeter Xu void kvm_irqchip_commit_routes(KVMState *s);
49295686908SLongpeng(Mike)
kvm_irqchip_begin_route_changes(KVMState * s)49395686908SLongpeng(Mike) static inline KVMRouteChange kvm_irqchip_begin_route_changes(KVMState *s)
49495686908SLongpeng(Mike) {
49595686908SLongpeng(Mike) return (KVMRouteChange) { .s = s, .changes = 0 };
49695686908SLongpeng(Mike) }
49795686908SLongpeng(Mike)
kvm_irqchip_commit_route_changes(KVMRouteChange * c)49895686908SLongpeng(Mike) static inline void kvm_irqchip_commit_route_changes(KVMRouteChange *c)
49995686908SLongpeng(Mike) {
50095686908SLongpeng(Mike) if (c->changes) {
50195686908SLongpeng(Mike) kvm_irqchip_commit_routes(c->s);
50295686908SLongpeng(Mike) c->changes = 0;
50395686908SLongpeng(Mike) }
50495686908SLongpeng(Mike) }
50595686908SLongpeng(Mike)
50648663349SPaolo Bonzini int kvm_irqchip_get_virq(KVMState *s);
5079c17d615SPaolo Bonzini void kvm_irqchip_release_virq(KVMState *s, int virq);
5089c17d615SPaolo Bonzini
50948663349SPaolo Bonzini void kvm_add_routing_entry(KVMState *s,
51048663349SPaolo Bonzini struct kvm_irq_routing_entry *entry);
511d426d9fbSCornelia Huck
5121c9b71a7SEric Auger int kvm_irqchip_add_irqfd_notifier_gsi(KVMState *s, EventNotifier *n,
513ca916d37SVincenzo Maffione EventNotifier *rn, int virq);
5141c9b71a7SEric Auger int kvm_irqchip_remove_irqfd_notifier_gsi(KVMState *s, EventNotifier *n,
5151c9b71a7SEric Auger int virq);
516197e3524SEric Auger int kvm_irqchip_add_irqfd_notifier(KVMState *s, EventNotifier *n,
517197e3524SEric Auger EventNotifier *rn, qemu_irq irq);
518197e3524SEric Auger int kvm_irqchip_remove_irqfd_notifier(KVMState *s, EventNotifier *n,
519197e3524SEric Auger qemu_irq irq);
520197e3524SEric Auger void kvm_irqchip_set_qemuirq_gsi(KVMState *s, qemu_irq irq, int gsi);
5217b774593SAlexander Graf void kvm_init_irq_routing(KVMState *s);
522d6032e06SChristoffer Dall
5234376c40dSPaolo Bonzini bool kvm_kernel_irqchip_allowed(void);
5244376c40dSPaolo Bonzini bool kvm_kernel_irqchip_required(void);
5254376c40dSPaolo Bonzini bool kvm_kernel_irqchip_split(void);
5264376c40dSPaolo Bonzini
527d6032e06SChristoffer Dall /**
528d6032e06SChristoffer Dall * kvm_arch_irqchip_create:
529d6032e06SChristoffer Dall * @KVMState: The KVMState pointer
530d6032e06SChristoffer Dall *
531d6032e06SChristoffer Dall * Allow architectures to create an in-kernel irq chip themselves.
532d6032e06SChristoffer Dall *
533d6032e06SChristoffer Dall * Returns: < 0: error
534d6032e06SChristoffer Dall * 0: irq chip was not created
535d6032e06SChristoffer Dall * > 0: irq chip was created
536d6032e06SChristoffer Dall */
5374376c40dSPaolo Bonzini int kvm_arch_irqchip_create(KVMState *s);
538ada4135fSCornelia Huck
539ada4135fSCornelia Huck /**
540ada4135fSCornelia Huck * kvm_set_one_reg - set a register value in KVM via KVM_SET_ONE_REG ioctl
541ada4135fSCornelia Huck * @id: The register ID
542ada4135fSCornelia Huck * @source: The pointer to the value to be set. It must point to a variable
543ada4135fSCornelia Huck * of the correct type/size for the register being accessed.
544ada4135fSCornelia Huck *
545ada4135fSCornelia Huck * Returns: 0 on success, or a negative errno on failure.
546ada4135fSCornelia Huck */
547ada4135fSCornelia Huck int kvm_set_one_reg(CPUState *cs, uint64_t id, void *source);
548ada4135fSCornelia Huck
549ada4135fSCornelia Huck /**
550ada4135fSCornelia Huck * kvm_get_one_reg - get a register value from KVM via KVM_GET_ONE_REG ioctl
551ada4135fSCornelia Huck * @id: The register ID
552ada4135fSCornelia Huck * @target: The pointer where the value is to be stored. It must point to a
553ada4135fSCornelia Huck * variable of the correct type/size for the register being accessed.
554ada4135fSCornelia Huck *
555ada4135fSCornelia Huck * Returns: 0 on success, or a negative errno on failure.
556ada4135fSCornelia Huck */
557ada4135fSCornelia Huck int kvm_get_one_reg(CPUState *cs, uint64_t id, void *target);
558c82d9d43SPeter Xu
559c82d9d43SPeter Xu /* Notify resamplefd for EOI of specific interrupts. */
560c82d9d43SPeter Xu void kvm_resample_fd_notify(int gsi);
561c82d9d43SPeter Xu
5627786ae40SHyman Huang(黄勇) bool kvm_dirty_ring_enabled(void);
5634a06a7ccSHyman Huang(黄勇)
5644a06a7ccSHyman Huang(黄勇) uint32_t kvm_dirty_ring_size(void);
56506152b89SWilliam Roche
5665c3131c3SPaolo Bonzini void kvm_mark_guest_state_protected(void);
5675c3131c3SPaolo Bonzini
56806152b89SWilliam Roche /**
56906152b89SWilliam Roche * kvm_hwpoisoned_mem - indicate if there is any hwpoisoned page
57006152b89SWilliam Roche * reported for the VM.
57106152b89SWilliam Roche */
57206152b89SWilliam Roche bool kvm_hwpoisoned_mem(void);
5730811baedSXiaoyao Li
57415f7a80cSXiaoyao Li int kvm_create_guest_memfd(uint64_t size, uint64_t flags, Error **errp);
57515f7a80cSXiaoyao Li
5760811baedSXiaoyao Li int kvm_set_memory_attributes_private(hwaddr start, uint64_t size);
5770811baedSXiaoyao Li int kvm_set_memory_attributes_shared(hwaddr start, uint64_t size);
5780811baedSXiaoyao Li
579c15e5684SChao Peng int kvm_convert_memory(hwaddr start, hwaddr size, bool to_private);
580c15e5684SChao Peng
5819c17d615SPaolo Bonzini #endif
582