xref: /linux-6.15/include/linux/kvm_host.h (revision f7be3455)
1 #ifndef __KVM_HOST_H
2 #define __KVM_HOST_H
3 
4 /*
5  * This work is licensed under the terms of the GNU GPL, version 2.  See
6  * the COPYING file in the top-level directory.
7  */
8 
9 #include <linux/types.h>
10 #include <linux/hardirq.h>
11 #include <linux/list.h>
12 #include <linux/mutex.h>
13 #include <linux/spinlock.h>
14 #include <linux/signal.h>
15 #include <linux/sched.h>
16 #include <linux/mm.h>
17 #include <linux/preempt.h>
18 #include <linux/msi.h>
19 #include <linux/slab.h>
20 #include <linux/rcupdate.h>
21 #include <linux/ratelimit.h>
22 #include <asm/signal.h>
23 
24 #include <linux/kvm.h>
25 #include <linux/kvm_para.h>
26 
27 #include <linux/kvm_types.h>
28 
29 #include <asm/kvm_host.h>
30 
31 #ifndef KVM_MMIO_SIZE
32 #define KVM_MMIO_SIZE 8
33 #endif
34 
35 /*
36  * vcpu->requests bit members
37  */
38 #define KVM_REQ_TLB_FLUSH          0
39 #define KVM_REQ_MIGRATE_TIMER      1
40 #define KVM_REQ_REPORT_TPR_ACCESS  2
41 #define KVM_REQ_MMU_RELOAD         3
42 #define KVM_REQ_TRIPLE_FAULT       4
43 #define KVM_REQ_PENDING_TIMER      5
44 #define KVM_REQ_UNHALT             6
45 #define KVM_REQ_MMU_SYNC           7
46 #define KVM_REQ_CLOCK_UPDATE       8
47 #define KVM_REQ_KICK               9
48 #define KVM_REQ_DEACTIVATE_FPU    10
49 #define KVM_REQ_EVENT             11
50 #define KVM_REQ_APF_HALT          12
51 #define KVM_REQ_STEAL_UPDATE      13
52 #define KVM_REQ_NMI               14
53 
54 #define KVM_USERSPACE_IRQ_SOURCE_ID	0
55 
56 struct kvm;
57 struct kvm_vcpu;
58 extern struct kmem_cache *kvm_vcpu_cache;
59 
60 struct kvm_io_range {
61 	gpa_t addr;
62 	int len;
63 	struct kvm_io_device *dev;
64 };
65 
66 struct kvm_io_bus {
67 	int                   dev_count;
68 #define NR_IOBUS_DEVS 300
69 	struct kvm_io_range range[NR_IOBUS_DEVS];
70 };
71 
72 enum kvm_bus {
73 	KVM_MMIO_BUS,
74 	KVM_PIO_BUS,
75 	KVM_NR_BUSES
76 };
77 
78 int kvm_io_bus_write(struct kvm *kvm, enum kvm_bus bus_idx, gpa_t addr,
79 		     int len, const void *val);
80 int kvm_io_bus_read(struct kvm *kvm, enum kvm_bus bus_idx, gpa_t addr, int len,
81 		    void *val);
82 int kvm_io_bus_register_dev(struct kvm *kvm, enum kvm_bus bus_idx, gpa_t addr,
83 			    int len, struct kvm_io_device *dev);
84 int kvm_io_bus_unregister_dev(struct kvm *kvm, enum kvm_bus bus_idx,
85 			      struct kvm_io_device *dev);
86 
87 #ifdef CONFIG_KVM_ASYNC_PF
88 struct kvm_async_pf {
89 	struct work_struct work;
90 	struct list_head link;
91 	struct list_head queue;
92 	struct kvm_vcpu *vcpu;
93 	struct mm_struct *mm;
94 	gva_t gva;
95 	unsigned long addr;
96 	struct kvm_arch_async_pf arch;
97 	struct page *page;
98 	bool done;
99 };
100 
101 void kvm_clear_async_pf_completion_queue(struct kvm_vcpu *vcpu);
102 void kvm_check_async_pf_completion(struct kvm_vcpu *vcpu);
103 int kvm_setup_async_pf(struct kvm_vcpu *vcpu, gva_t gva, gfn_t gfn,
104 		       struct kvm_arch_async_pf *arch);
105 int kvm_async_pf_wakeup_all(struct kvm_vcpu *vcpu);
106 #endif
107 
108 enum {
109 	OUTSIDE_GUEST_MODE,
110 	IN_GUEST_MODE,
111 	EXITING_GUEST_MODE
112 };
113 
114 struct kvm_vcpu {
115 	struct kvm *kvm;
116 #ifdef CONFIG_PREEMPT_NOTIFIERS
117 	struct preempt_notifier preempt_notifier;
118 #endif
119 	int cpu;
120 	int vcpu_id;
121 	int srcu_idx;
122 	int mode;
123 	unsigned long requests;
124 	unsigned long guest_debug;
125 
126 	struct mutex mutex;
127 	struct kvm_run *run;
128 
129 	int fpu_active;
130 	int guest_fpu_loaded, guest_xcr0_loaded;
131 	wait_queue_head_t wq;
132 	struct pid *pid;
133 	int sigset_active;
134 	sigset_t sigset;
135 	struct kvm_vcpu_stat stat;
136 
137 #ifdef CONFIG_HAS_IOMEM
138 	int mmio_needed;
139 	int mmio_read_completed;
140 	int mmio_is_write;
141 	int mmio_size;
142 	int mmio_index;
143 	unsigned char mmio_data[KVM_MMIO_SIZE];
144 	gpa_t mmio_phys_addr;
145 #endif
146 
147 #ifdef CONFIG_KVM_ASYNC_PF
148 	struct {
149 		u32 queued;
150 		struct list_head queue;
151 		struct list_head done;
152 		spinlock_t lock;
153 	} async_pf;
154 #endif
155 
156 	struct kvm_vcpu_arch arch;
157 };
158 
159 static inline int kvm_vcpu_exiting_guest_mode(struct kvm_vcpu *vcpu)
160 {
161 	return cmpxchg(&vcpu->mode, IN_GUEST_MODE, EXITING_GUEST_MODE);
162 }
163 
164 /*
165  * Some of the bitops functions do not support too long bitmaps.
166  * This number must be determined not to exceed such limits.
167  */
168 #define KVM_MEM_MAX_NR_PAGES ((1UL << 31) - 1)
169 
170 struct kvm_lpage_info {
171 	unsigned long rmap_pde;
172 	int write_count;
173 };
174 
175 struct kvm_memory_slot {
176 	gfn_t base_gfn;
177 	unsigned long npages;
178 	unsigned long flags;
179 	unsigned long *rmap;
180 	unsigned long *dirty_bitmap;
181 	unsigned long *dirty_bitmap_head;
182 	struct kvm_lpage_info *lpage_info[KVM_NR_PAGE_SIZES - 1];
183 	unsigned long userspace_addr;
184 	int user_alloc;
185 	int id;
186 };
187 
188 static inline unsigned long kvm_dirty_bitmap_bytes(struct kvm_memory_slot *memslot)
189 {
190 	return ALIGN(memslot->npages, BITS_PER_LONG) / 8;
191 }
192 
193 struct kvm_kernel_irq_routing_entry {
194 	u32 gsi;
195 	u32 type;
196 	int (*set)(struct kvm_kernel_irq_routing_entry *e,
197 		   struct kvm *kvm, int irq_source_id, int level);
198 	union {
199 		struct {
200 			unsigned irqchip;
201 			unsigned pin;
202 		} irqchip;
203 		struct msi_msg msi;
204 	};
205 	struct hlist_node link;
206 };
207 
208 #ifdef __KVM_HAVE_IOAPIC
209 
210 struct kvm_irq_routing_table {
211 	int chip[KVM_NR_IRQCHIPS][KVM_IOAPIC_NUM_PINS];
212 	struct kvm_kernel_irq_routing_entry *rt_entries;
213 	u32 nr_rt_entries;
214 	/*
215 	 * Array indexed by gsi. Each entry contains list of irq chips
216 	 * the gsi is connected to.
217 	 */
218 	struct hlist_head map[0];
219 };
220 
221 #else
222 
223 struct kvm_irq_routing_table {};
224 
225 #endif
226 
227 struct kvm_memslots {
228 	int nmemslots;
229 	u64 generation;
230 	struct kvm_memory_slot memslots[KVM_MEMORY_SLOTS +
231 					KVM_PRIVATE_MEM_SLOTS];
232 };
233 
234 struct kvm {
235 	spinlock_t mmu_lock;
236 	struct mutex slots_lock;
237 	struct mm_struct *mm; /* userspace tied to this vm */
238 	struct kvm_memslots *memslots;
239 	struct srcu_struct srcu;
240 #ifdef CONFIG_KVM_APIC_ARCHITECTURE
241 	u32 bsp_vcpu_id;
242 	struct kvm_vcpu *bsp_vcpu;
243 #endif
244 	struct kvm_vcpu *vcpus[KVM_MAX_VCPUS];
245 	atomic_t online_vcpus;
246 	int last_boosted_vcpu;
247 	struct list_head vm_list;
248 	struct mutex lock;
249 	struct kvm_io_bus *buses[KVM_NR_BUSES];
250 #ifdef CONFIG_HAVE_KVM_EVENTFD
251 	struct {
252 		spinlock_t        lock;
253 		struct list_head  items;
254 	} irqfds;
255 	struct list_head ioeventfds;
256 #endif
257 	struct kvm_vm_stat stat;
258 	struct kvm_arch arch;
259 	atomic_t users_count;
260 #ifdef KVM_COALESCED_MMIO_PAGE_OFFSET
261 	struct kvm_coalesced_mmio_ring *coalesced_mmio_ring;
262 	spinlock_t ring_lock;
263 	struct list_head coalesced_zones;
264 #endif
265 
266 	struct mutex irq_lock;
267 #ifdef CONFIG_HAVE_KVM_IRQCHIP
268 	/*
269 	 * Update side is protected by irq_lock and,
270 	 * if configured, irqfds.lock.
271 	 */
272 	struct kvm_irq_routing_table __rcu *irq_routing;
273 	struct hlist_head mask_notifier_list;
274 	struct hlist_head irq_ack_notifier_list;
275 #endif
276 
277 #ifdef KVM_ARCH_WANT_MMU_NOTIFIER
278 	struct mmu_notifier mmu_notifier;
279 	unsigned long mmu_notifier_seq;
280 	long mmu_notifier_count;
281 #endif
282 	long tlbs_dirty;
283 };
284 
285 /* The guest did something we don't support. */
286 #define pr_unimpl(vcpu, fmt, ...)					\
287 	pr_err_ratelimited("kvm: %i: cpu%i " fmt,			\
288 			   current->tgid, (vcpu)->vcpu_id , ## __VA_ARGS__)
289 
290 #define kvm_printf(kvm, fmt ...) printk(KERN_DEBUG fmt)
291 #define vcpu_printf(vcpu, fmt...) kvm_printf(vcpu->kvm, fmt)
292 
293 static inline struct kvm_vcpu *kvm_get_vcpu(struct kvm *kvm, int i)
294 {
295 	smp_rmb();
296 	return kvm->vcpus[i];
297 }
298 
299 #define kvm_for_each_vcpu(idx, vcpup, kvm) \
300 	for (idx = 0; \
301 	     idx < atomic_read(&kvm->online_vcpus) && \
302 	     (vcpup = kvm_get_vcpu(kvm, idx)) != NULL; \
303 	     idx++)
304 
305 int kvm_vcpu_init(struct kvm_vcpu *vcpu, struct kvm *kvm, unsigned id);
306 void kvm_vcpu_uninit(struct kvm_vcpu *vcpu);
307 
308 void vcpu_load(struct kvm_vcpu *vcpu);
309 void vcpu_put(struct kvm_vcpu *vcpu);
310 
311 int kvm_init(void *opaque, unsigned vcpu_size, unsigned vcpu_align,
312 		  struct module *module);
313 void kvm_exit(void);
314 
315 void kvm_get_kvm(struct kvm *kvm);
316 void kvm_put_kvm(struct kvm *kvm);
317 
318 static inline struct kvm_memslots *kvm_memslots(struct kvm *kvm)
319 {
320 	return rcu_dereference_check(kvm->memslots,
321 			srcu_read_lock_held(&kvm->srcu)
322 			|| lockdep_is_held(&kvm->slots_lock));
323 }
324 
325 #define HPA_MSB ((sizeof(hpa_t) * 8) - 1)
326 #define HPA_ERR_MASK ((hpa_t)1 << HPA_MSB)
327 static inline int is_error_hpa(hpa_t hpa) { return hpa >> HPA_MSB; }
328 
329 extern struct page *bad_page;
330 extern struct page *fault_page;
331 
332 extern pfn_t bad_pfn;
333 extern pfn_t fault_pfn;
334 
335 int is_error_page(struct page *page);
336 int is_error_pfn(pfn_t pfn);
337 int is_hwpoison_pfn(pfn_t pfn);
338 int is_fault_pfn(pfn_t pfn);
339 int is_noslot_pfn(pfn_t pfn);
340 int is_invalid_pfn(pfn_t pfn);
341 int kvm_is_error_hva(unsigned long addr);
342 int kvm_set_memory_region(struct kvm *kvm,
343 			  struct kvm_userspace_memory_region *mem,
344 			  int user_alloc);
345 int __kvm_set_memory_region(struct kvm *kvm,
346 			    struct kvm_userspace_memory_region *mem,
347 			    int user_alloc);
348 int kvm_arch_prepare_memory_region(struct kvm *kvm,
349 				struct kvm_memory_slot *memslot,
350 				struct kvm_memory_slot old,
351 				struct kvm_userspace_memory_region *mem,
352 				int user_alloc);
353 void kvm_arch_commit_memory_region(struct kvm *kvm,
354 				struct kvm_userspace_memory_region *mem,
355 				struct kvm_memory_slot old,
356 				int user_alloc);
357 void kvm_disable_largepages(void);
358 void kvm_arch_flush_shadow(struct kvm *kvm);
359 
360 int gfn_to_page_many_atomic(struct kvm *kvm, gfn_t gfn, struct page **pages,
361 			    int nr_pages);
362 
363 struct page *gfn_to_page(struct kvm *kvm, gfn_t gfn);
364 unsigned long gfn_to_hva(struct kvm *kvm, gfn_t gfn);
365 void kvm_release_page_clean(struct page *page);
366 void kvm_release_page_dirty(struct page *page);
367 void kvm_set_page_dirty(struct page *page);
368 void kvm_set_page_accessed(struct page *page);
369 
370 pfn_t hva_to_pfn_atomic(struct kvm *kvm, unsigned long addr);
371 pfn_t gfn_to_pfn_atomic(struct kvm *kvm, gfn_t gfn);
372 pfn_t gfn_to_pfn_async(struct kvm *kvm, gfn_t gfn, bool *async,
373 		       bool write_fault, bool *writable);
374 pfn_t gfn_to_pfn(struct kvm *kvm, gfn_t gfn);
375 pfn_t gfn_to_pfn_prot(struct kvm *kvm, gfn_t gfn, bool write_fault,
376 		      bool *writable);
377 pfn_t gfn_to_pfn_memslot(struct kvm *kvm,
378 			 struct kvm_memory_slot *slot, gfn_t gfn);
379 void kvm_release_pfn_dirty(pfn_t);
380 void kvm_release_pfn_clean(pfn_t pfn);
381 void kvm_set_pfn_dirty(pfn_t pfn);
382 void kvm_set_pfn_accessed(pfn_t pfn);
383 void kvm_get_pfn(pfn_t pfn);
384 
385 int kvm_read_guest_page(struct kvm *kvm, gfn_t gfn, void *data, int offset,
386 			int len);
387 int kvm_read_guest_atomic(struct kvm *kvm, gpa_t gpa, void *data,
388 			  unsigned long len);
389 int kvm_read_guest(struct kvm *kvm, gpa_t gpa, void *data, unsigned long len);
390 int kvm_read_guest_cached(struct kvm *kvm, struct gfn_to_hva_cache *ghc,
391 			   void *data, unsigned long len);
392 int kvm_write_guest_page(struct kvm *kvm, gfn_t gfn, const void *data,
393 			 int offset, int len);
394 int kvm_write_guest(struct kvm *kvm, gpa_t gpa, const void *data,
395 		    unsigned long len);
396 int kvm_write_guest_cached(struct kvm *kvm, struct gfn_to_hva_cache *ghc,
397 			   void *data, unsigned long len);
398 int kvm_gfn_to_hva_cache_init(struct kvm *kvm, struct gfn_to_hva_cache *ghc,
399 			      gpa_t gpa);
400 int kvm_clear_guest_page(struct kvm *kvm, gfn_t gfn, int offset, int len);
401 int kvm_clear_guest(struct kvm *kvm, gpa_t gpa, unsigned long len);
402 struct kvm_memory_slot *gfn_to_memslot(struct kvm *kvm, gfn_t gfn);
403 int kvm_is_visible_gfn(struct kvm *kvm, gfn_t gfn);
404 unsigned long kvm_host_page_size(struct kvm *kvm, gfn_t gfn);
405 void mark_page_dirty(struct kvm *kvm, gfn_t gfn);
406 void mark_page_dirty_in_slot(struct kvm *kvm, struct kvm_memory_slot *memslot,
407 			     gfn_t gfn);
408 
409 void kvm_vcpu_block(struct kvm_vcpu *vcpu);
410 void kvm_vcpu_on_spin(struct kvm_vcpu *vcpu);
411 void kvm_resched(struct kvm_vcpu *vcpu);
412 void kvm_load_guest_fpu(struct kvm_vcpu *vcpu);
413 void kvm_put_guest_fpu(struct kvm_vcpu *vcpu);
414 
415 void kvm_flush_remote_tlbs(struct kvm *kvm);
416 void kvm_reload_remote_mmus(struct kvm *kvm);
417 
418 long kvm_arch_dev_ioctl(struct file *filp,
419 			unsigned int ioctl, unsigned long arg);
420 long kvm_arch_vcpu_ioctl(struct file *filp,
421 			 unsigned int ioctl, unsigned long arg);
422 
423 int kvm_dev_ioctl_check_extension(long ext);
424 
425 int kvm_get_dirty_log(struct kvm *kvm,
426 			struct kvm_dirty_log *log, int *is_dirty);
427 int kvm_vm_ioctl_get_dirty_log(struct kvm *kvm,
428 				struct kvm_dirty_log *log);
429 
430 int kvm_vm_ioctl_set_memory_region(struct kvm *kvm,
431 				   struct
432 				   kvm_userspace_memory_region *mem,
433 				   int user_alloc);
434 long kvm_arch_vm_ioctl(struct file *filp,
435 		       unsigned int ioctl, unsigned long arg);
436 
437 int kvm_arch_vcpu_ioctl_get_fpu(struct kvm_vcpu *vcpu, struct kvm_fpu *fpu);
438 int kvm_arch_vcpu_ioctl_set_fpu(struct kvm_vcpu *vcpu, struct kvm_fpu *fpu);
439 
440 int kvm_arch_vcpu_ioctl_translate(struct kvm_vcpu *vcpu,
441 				    struct kvm_translation *tr);
442 
443 int kvm_arch_vcpu_ioctl_get_regs(struct kvm_vcpu *vcpu, struct kvm_regs *regs);
444 int kvm_arch_vcpu_ioctl_set_regs(struct kvm_vcpu *vcpu, struct kvm_regs *regs);
445 int kvm_arch_vcpu_ioctl_get_sregs(struct kvm_vcpu *vcpu,
446 				  struct kvm_sregs *sregs);
447 int kvm_arch_vcpu_ioctl_set_sregs(struct kvm_vcpu *vcpu,
448 				  struct kvm_sregs *sregs);
449 int kvm_arch_vcpu_ioctl_get_mpstate(struct kvm_vcpu *vcpu,
450 				    struct kvm_mp_state *mp_state);
451 int kvm_arch_vcpu_ioctl_set_mpstate(struct kvm_vcpu *vcpu,
452 				    struct kvm_mp_state *mp_state);
453 int kvm_arch_vcpu_ioctl_set_guest_debug(struct kvm_vcpu *vcpu,
454 					struct kvm_guest_debug *dbg);
455 int kvm_arch_vcpu_ioctl_run(struct kvm_vcpu *vcpu, struct kvm_run *kvm_run);
456 
457 int kvm_arch_init(void *opaque);
458 void kvm_arch_exit(void);
459 
460 int kvm_arch_vcpu_init(struct kvm_vcpu *vcpu);
461 void kvm_arch_vcpu_uninit(struct kvm_vcpu *vcpu);
462 
463 void kvm_arch_vcpu_free(struct kvm_vcpu *vcpu);
464 void kvm_arch_vcpu_load(struct kvm_vcpu *vcpu, int cpu);
465 void kvm_arch_vcpu_put(struct kvm_vcpu *vcpu);
466 struct kvm_vcpu *kvm_arch_vcpu_create(struct kvm *kvm, unsigned int id);
467 int kvm_arch_vcpu_setup(struct kvm_vcpu *vcpu);
468 void kvm_arch_vcpu_destroy(struct kvm_vcpu *vcpu);
469 
470 int kvm_arch_vcpu_reset(struct kvm_vcpu *vcpu);
471 int kvm_arch_hardware_enable(void *garbage);
472 void kvm_arch_hardware_disable(void *garbage);
473 int kvm_arch_hardware_setup(void);
474 void kvm_arch_hardware_unsetup(void);
475 void kvm_arch_check_processor_compat(void *rtn);
476 int kvm_arch_vcpu_runnable(struct kvm_vcpu *vcpu);
477 
478 void kvm_free_physmem(struct kvm *kvm);
479 
480 #ifndef __KVM_HAVE_ARCH_VM_ALLOC
481 static inline struct kvm *kvm_arch_alloc_vm(void)
482 {
483 	return kzalloc(sizeof(struct kvm), GFP_KERNEL);
484 }
485 
486 static inline void kvm_arch_free_vm(struct kvm *kvm)
487 {
488 	kfree(kvm);
489 }
490 #endif
491 
492 int kvm_arch_init_vm(struct kvm *kvm);
493 void kvm_arch_destroy_vm(struct kvm *kvm);
494 void kvm_free_all_assigned_devices(struct kvm *kvm);
495 void kvm_arch_sync_events(struct kvm *kvm);
496 
497 int kvm_cpu_has_pending_timer(struct kvm_vcpu *vcpu);
498 void kvm_vcpu_kick(struct kvm_vcpu *vcpu);
499 
500 int kvm_is_mmio_pfn(pfn_t pfn);
501 
502 struct kvm_irq_ack_notifier {
503 	struct hlist_node link;
504 	unsigned gsi;
505 	void (*irq_acked)(struct kvm_irq_ack_notifier *kian);
506 };
507 
508 struct kvm_assigned_dev_kernel {
509 	struct kvm_irq_ack_notifier ack_notifier;
510 	struct list_head list;
511 	int assigned_dev_id;
512 	int host_segnr;
513 	int host_busnr;
514 	int host_devfn;
515 	unsigned int entries_nr;
516 	int host_irq;
517 	bool host_irq_disabled;
518 	struct msix_entry *host_msix_entries;
519 	int guest_irq;
520 	struct msix_entry *guest_msix_entries;
521 	unsigned long irq_requested_type;
522 	int irq_source_id;
523 	int flags;
524 	struct pci_dev *dev;
525 	struct kvm *kvm;
526 	spinlock_t intx_lock;
527 	char irq_name[32];
528 	struct pci_saved_state *pci_saved_state;
529 };
530 
531 struct kvm_irq_mask_notifier {
532 	void (*func)(struct kvm_irq_mask_notifier *kimn, bool masked);
533 	int irq;
534 	struct hlist_node link;
535 };
536 
537 void kvm_register_irq_mask_notifier(struct kvm *kvm, int irq,
538 				    struct kvm_irq_mask_notifier *kimn);
539 void kvm_unregister_irq_mask_notifier(struct kvm *kvm, int irq,
540 				      struct kvm_irq_mask_notifier *kimn);
541 void kvm_fire_mask_notifiers(struct kvm *kvm, unsigned irqchip, unsigned pin,
542 			     bool mask);
543 
544 #ifdef __KVM_HAVE_IOAPIC
545 void kvm_get_intr_delivery_bitmask(struct kvm_ioapic *ioapic,
546 				   union kvm_ioapic_redirect_entry *entry,
547 				   unsigned long *deliver_bitmask);
548 #endif
549 int kvm_set_irq(struct kvm *kvm, int irq_source_id, u32 irq, int level);
550 int kvm_set_msi(struct kvm_kernel_irq_routing_entry *irq_entry, struct kvm *kvm,
551 		int irq_source_id, int level);
552 void kvm_notify_acked_irq(struct kvm *kvm, unsigned irqchip, unsigned pin);
553 void kvm_register_irq_ack_notifier(struct kvm *kvm,
554 				   struct kvm_irq_ack_notifier *kian);
555 void kvm_unregister_irq_ack_notifier(struct kvm *kvm,
556 				   struct kvm_irq_ack_notifier *kian);
557 int kvm_request_irq_source_id(struct kvm *kvm);
558 void kvm_free_irq_source_id(struct kvm *kvm, int irq_source_id);
559 
560 /* For vcpu->arch.iommu_flags */
561 #define KVM_IOMMU_CACHE_COHERENCY	0x1
562 
563 #ifdef CONFIG_IOMMU_API
564 int kvm_iommu_map_pages(struct kvm *kvm, struct kvm_memory_slot *slot);
565 int kvm_iommu_map_guest(struct kvm *kvm);
566 int kvm_iommu_unmap_guest(struct kvm *kvm);
567 int kvm_assign_device(struct kvm *kvm,
568 		      struct kvm_assigned_dev_kernel *assigned_dev);
569 int kvm_deassign_device(struct kvm *kvm,
570 			struct kvm_assigned_dev_kernel *assigned_dev);
571 #else /* CONFIG_IOMMU_API */
572 static inline int kvm_iommu_map_pages(struct kvm *kvm,
573 				      struct kvm_memory_slot *slot)
574 {
575 	return 0;
576 }
577 
578 static inline int kvm_iommu_map_guest(struct kvm *kvm)
579 {
580 	return -ENODEV;
581 }
582 
583 static inline int kvm_iommu_unmap_guest(struct kvm *kvm)
584 {
585 	return 0;
586 }
587 
588 static inline int kvm_assign_device(struct kvm *kvm,
589 		struct kvm_assigned_dev_kernel *assigned_dev)
590 {
591 	return 0;
592 }
593 
594 static inline int kvm_deassign_device(struct kvm *kvm,
595 		struct kvm_assigned_dev_kernel *assigned_dev)
596 {
597 	return 0;
598 }
599 #endif /* CONFIG_IOMMU_API */
600 
601 static inline void kvm_guest_enter(void)
602 {
603 	BUG_ON(preemptible());
604 	account_system_vtime(current);
605 	current->flags |= PF_VCPU;
606 	/* KVM does not hold any references to rcu protected data when it
607 	 * switches CPU into a guest mode. In fact switching to a guest mode
608 	 * is very similar to exiting to userspase from rcu point of view. In
609 	 * addition CPU may stay in a guest mode for quite a long time (up to
610 	 * one time slice). Lets treat guest mode as quiescent state, just like
611 	 * we do with user-mode execution.
612 	 */
613 	rcu_virt_note_context_switch(smp_processor_id());
614 }
615 
616 static inline void kvm_guest_exit(void)
617 {
618 	account_system_vtime(current);
619 	current->flags &= ~PF_VCPU;
620 }
621 
622 static inline int memslot_id(struct kvm *kvm, gfn_t gfn)
623 {
624 	return gfn_to_memslot(kvm, gfn)->id;
625 }
626 
627 static inline unsigned long gfn_to_hva_memslot(struct kvm_memory_slot *slot,
628 					       gfn_t gfn)
629 {
630 	return slot->userspace_addr + (gfn - slot->base_gfn) * PAGE_SIZE;
631 }
632 
633 static inline gpa_t gfn_to_gpa(gfn_t gfn)
634 {
635 	return (gpa_t)gfn << PAGE_SHIFT;
636 }
637 
638 static inline gfn_t gpa_to_gfn(gpa_t gpa)
639 {
640 	return (gfn_t)(gpa >> PAGE_SHIFT);
641 }
642 
643 static inline hpa_t pfn_to_hpa(pfn_t pfn)
644 {
645 	return (hpa_t)pfn << PAGE_SHIFT;
646 }
647 
648 static inline void kvm_migrate_timers(struct kvm_vcpu *vcpu)
649 {
650 	set_bit(KVM_REQ_MIGRATE_TIMER, &vcpu->requests);
651 }
652 
653 enum kvm_stat_kind {
654 	KVM_STAT_VM,
655 	KVM_STAT_VCPU,
656 };
657 
658 struct kvm_stats_debugfs_item {
659 	const char *name;
660 	int offset;
661 	enum kvm_stat_kind kind;
662 	struct dentry *dentry;
663 };
664 extern struct kvm_stats_debugfs_item debugfs_entries[];
665 extern struct dentry *kvm_debugfs_dir;
666 
667 #ifdef KVM_ARCH_WANT_MMU_NOTIFIER
668 static inline int mmu_notifier_retry(struct kvm_vcpu *vcpu, unsigned long mmu_seq)
669 {
670 	if (unlikely(vcpu->kvm->mmu_notifier_count))
671 		return 1;
672 	/*
673 	 * Both reads happen under the mmu_lock and both values are
674 	 * modified under mmu_lock, so there's no need of smb_rmb()
675 	 * here in between, otherwise mmu_notifier_count should be
676 	 * read before mmu_notifier_seq, see
677 	 * mmu_notifier_invalidate_range_end write side.
678 	 */
679 	if (vcpu->kvm->mmu_notifier_seq != mmu_seq)
680 		return 1;
681 	return 0;
682 }
683 #endif
684 
685 #ifdef CONFIG_HAVE_KVM_IRQCHIP
686 
687 #define KVM_MAX_IRQ_ROUTES 1024
688 
689 int kvm_setup_default_irq_routing(struct kvm *kvm);
690 int kvm_set_irq_routing(struct kvm *kvm,
691 			const struct kvm_irq_routing_entry *entries,
692 			unsigned nr,
693 			unsigned flags);
694 void kvm_free_irq_routing(struct kvm *kvm);
695 
696 #else
697 
698 static inline void kvm_free_irq_routing(struct kvm *kvm) {}
699 
700 #endif
701 
702 #ifdef CONFIG_HAVE_KVM_EVENTFD
703 
704 void kvm_eventfd_init(struct kvm *kvm);
705 int kvm_irqfd(struct kvm *kvm, int fd, int gsi, int flags);
706 void kvm_irqfd_release(struct kvm *kvm);
707 void kvm_irq_routing_update(struct kvm *, struct kvm_irq_routing_table *);
708 int kvm_ioeventfd(struct kvm *kvm, struct kvm_ioeventfd *args);
709 
710 #else
711 
712 static inline void kvm_eventfd_init(struct kvm *kvm) {}
713 
714 static inline int kvm_irqfd(struct kvm *kvm, int fd, int gsi, int flags)
715 {
716 	return -EINVAL;
717 }
718 
719 static inline void kvm_irqfd_release(struct kvm *kvm) {}
720 
721 #ifdef CONFIG_HAVE_KVM_IRQCHIP
722 static inline void kvm_irq_routing_update(struct kvm *kvm,
723 					  struct kvm_irq_routing_table *irq_rt)
724 {
725 	rcu_assign_pointer(kvm->irq_routing, irq_rt);
726 }
727 #endif
728 
729 static inline int kvm_ioeventfd(struct kvm *kvm, struct kvm_ioeventfd *args)
730 {
731 	return -ENOSYS;
732 }
733 
734 #endif /* CONFIG_HAVE_KVM_EVENTFD */
735 
736 #ifdef CONFIG_KVM_APIC_ARCHITECTURE
737 static inline bool kvm_vcpu_is_bsp(struct kvm_vcpu *vcpu)
738 {
739 	return vcpu->kvm->bsp_vcpu_id == vcpu->vcpu_id;
740 }
741 #endif
742 
743 #ifdef __KVM_HAVE_DEVICE_ASSIGNMENT
744 
745 long kvm_vm_ioctl_assigned_device(struct kvm *kvm, unsigned ioctl,
746 				  unsigned long arg);
747 
748 #else
749 
750 static inline long kvm_vm_ioctl_assigned_device(struct kvm *kvm, unsigned ioctl,
751 						unsigned long arg)
752 {
753 	return -ENOTTY;
754 }
755 
756 #endif
757 
758 static inline void kvm_make_request(int req, struct kvm_vcpu *vcpu)
759 {
760 	set_bit(req, &vcpu->requests);
761 }
762 
763 static inline bool kvm_check_request(int req, struct kvm_vcpu *vcpu)
764 {
765 	if (test_bit(req, &vcpu->requests)) {
766 		clear_bit(req, &vcpu->requests);
767 		return true;
768 	} else {
769 		return false;
770 	}
771 }
772 
773 #endif
774 
775