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