1 #ifndef _ASM_X86_KVM_PAGE_TRACK_H
2 #define _ASM_X86_KVM_PAGE_TRACK_H
3 
4 enum kvm_page_track_mode {
5 	KVM_PAGE_TRACK_WRITE,
6 	KVM_PAGE_TRACK_MAX,
7 };
8 
9 /*
10  * The notifier represented by @kvm_page_track_notifier_node is linked into
11  * the head which will be notified when guest is triggering the track event.
12  *
13  * Write access on the head is protected by kvm->mmu_lock, read access
14  * is protected by track_srcu.
15  */
16 struct kvm_page_track_notifier_head {
17 	struct srcu_struct track_srcu;
18 	struct hlist_head track_notifier_list;
19 };
20 
21 struct kvm_page_track_notifier_node {
22 	struct hlist_node node;
23 
24 	/*
25 	 * It is called when guest is writing the write-tracked page
26 	 * and write emulation is finished at that time.
27 	 *
28 	 * @vcpu: the vcpu where the write access happened.
29 	 * @gpa: the physical address written by guest.
30 	 * @new: the data was written to the address.
31 	 * @bytes: the written length.
32 	 */
33 	void (*track_write)(struct kvm_vcpu *vcpu, gpa_t gpa, const u8 *new,
34 			    int bytes);
35 	/*
36 	 * It is called when memory slot is being moved or removed
37 	 * users can drop write-protection for the pages in that memory slot
38 	 *
39 	 * @kvm: the kvm where memory slot being moved or removed
40 	 * @slot: the memory slot being moved or removed
41 	 */
42 	void (*track_flush_slot)(struct kvm *kvm, struct kvm_memory_slot *slot);
43 };
44 
45 void kvm_page_track_init(struct kvm *kvm);
46 
47 void kvm_page_track_free_memslot(struct kvm_memory_slot *free,
48 				 struct kvm_memory_slot *dont);
49 int kvm_page_track_create_memslot(struct kvm_memory_slot *slot,
50 				  unsigned long npages);
51 
52 void kvm_slot_page_track_add_page(struct kvm *kvm,
53 				  struct kvm_memory_slot *slot, gfn_t gfn,
54 				  enum kvm_page_track_mode mode);
55 void kvm_slot_page_track_remove_page(struct kvm *kvm,
56 				     struct kvm_memory_slot *slot, gfn_t gfn,
57 				     enum kvm_page_track_mode mode);
58 bool kvm_page_track_is_active(struct kvm_vcpu *vcpu, gfn_t gfn,
59 			      enum kvm_page_track_mode mode);
60 
61 void
62 kvm_page_track_register_notifier(struct kvm *kvm,
63 				 struct kvm_page_track_notifier_node *n);
64 void
65 kvm_page_track_unregister_notifier(struct kvm *kvm,
66 				   struct kvm_page_track_notifier_node *n);
67 void kvm_page_track_write(struct kvm_vcpu *vcpu, gpa_t gpa, const u8 *new,
68 			  int bytes);
69 void kvm_page_track_flush_slot(struct kvm *kvm, struct kvm_memory_slot *slot);
70 #endif
71