2 * Support KVM gust page tracking
4 * This feature allows us to track page access in guest. Currently, only
5 * write access is tracked.
7 * Copyright(C) 2015 Intel Corporation.
10 * Xiao Guangrong <guangrong.xiao@linux.intel.com>
12 * This work is licensed under the terms of the GNU GPL, version 2. See
13 * the COPYING file in the top-level directory.
16 #include <linux/kvm_host.h>
17 #include <linux/rculist.h>
19 #include <asm/kvm_host.h>
20 #include <asm/kvm_page_track.h>
24 void kvm_page_track_free_memslot(struct kvm_memory_slot *free,
25 struct kvm_memory_slot *dont)
29 for (i = 0; i < KVM_PAGE_TRACK_MAX; i++)
30 if (!dont || free->arch.gfn_track[i] !=
31 dont->arch.gfn_track[i]) {
32 kvfree(free->arch.gfn_track[i]);
33 free->arch.gfn_track[i] = NULL;
37 int kvm_page_track_create_memslot(struct kvm_memory_slot *slot,
42 for (i = 0; i < KVM_PAGE_TRACK_MAX; i++) {
43 slot->arch.gfn_track[i] = kvzalloc(npages *
44 sizeof(*slot->arch.gfn_track[i]), GFP_KERNEL);
45 if (!slot->arch.gfn_track[i])
52 kvm_page_track_free_memslot(slot, NULL);
56 static inline bool page_track_mode_is_valid(enum kvm_page_track_mode mode)
58 if (mode < 0 || mode >= KVM_PAGE_TRACK_MAX)
64 static void update_gfn_track(struct kvm_memory_slot *slot, gfn_t gfn,
65 enum kvm_page_track_mode mode, short count)
69 index = gfn_to_index(gfn, slot->base_gfn, PT_PAGE_TABLE_LEVEL);
71 val = slot->arch.gfn_track[mode][index];
73 if (WARN_ON(val + count < 0 || val + count > USHRT_MAX))
76 slot->arch.gfn_track[mode][index] += count;
80 * add guest page to the tracking pool so that corresponding access on that
81 * page will be intercepted.
83 * It should be called under the protection both of mmu-lock and kvm->srcu
86 * @kvm: the guest instance we are interested in.
87 * @slot: the @gfn belongs to.
88 * @gfn: the guest page.
89 * @mode: tracking mode, currently only write track is supported.
91 void kvm_slot_page_track_add_page(struct kvm *kvm,
92 struct kvm_memory_slot *slot, gfn_t gfn,
93 enum kvm_page_track_mode mode)
96 if (WARN_ON(!page_track_mode_is_valid(mode)))
99 update_gfn_track(slot, gfn, mode, 1);
102 * new track stops large page mapping for the
105 kvm_mmu_gfn_disallow_lpage(slot, gfn);
107 if (mode == KVM_PAGE_TRACK_WRITE)
108 if (kvm_mmu_slot_gfn_write_protect(kvm, slot, gfn))
109 kvm_flush_remote_tlbs(kvm);
111 EXPORT_SYMBOL_GPL(kvm_slot_page_track_add_page);
114 * remove the guest page from the tracking pool which stops the interception
115 * of corresponding access on that page. It is the opposed operation of
116 * kvm_slot_page_track_add_page().
118 * It should be called under the protection both of mmu-lock and kvm->srcu
119 * or kvm->slots_lock.
121 * @kvm: the guest instance we are interested in.
122 * @slot: the @gfn belongs to.
123 * @gfn: the guest page.
124 * @mode: tracking mode, currently only write track is supported.
126 void kvm_slot_page_track_remove_page(struct kvm *kvm,
127 struct kvm_memory_slot *slot, gfn_t gfn,
128 enum kvm_page_track_mode mode)
130 if (WARN_ON(!page_track_mode_is_valid(mode)))
133 update_gfn_track(slot, gfn, mode, -1);
136 * allow large page mapping for the tracked page
137 * after the tracker is gone.
139 kvm_mmu_gfn_allow_lpage(slot, gfn);
141 EXPORT_SYMBOL_GPL(kvm_slot_page_track_remove_page);
144 * check if the corresponding access on the specified guest page is tracked.
146 bool kvm_page_track_is_active(struct kvm_vcpu *vcpu, gfn_t gfn,
147 enum kvm_page_track_mode mode)
149 struct kvm_memory_slot *slot;
152 if (WARN_ON(!page_track_mode_is_valid(mode)))
155 slot = kvm_vcpu_gfn_to_memslot(vcpu, gfn);
159 index = gfn_to_index(gfn, slot->base_gfn, PT_PAGE_TABLE_LEVEL);
160 return !!ACCESS_ONCE(slot->arch.gfn_track[mode][index]);
163 void kvm_page_track_cleanup(struct kvm *kvm)
165 struct kvm_page_track_notifier_head *head;
167 head = &kvm->arch.track_notifier_head;
168 cleanup_srcu_struct(&head->track_srcu);
171 void kvm_page_track_init(struct kvm *kvm)
173 struct kvm_page_track_notifier_head *head;
175 head = &kvm->arch.track_notifier_head;
176 init_srcu_struct(&head->track_srcu);
177 INIT_HLIST_HEAD(&head->track_notifier_list);
181 * register the notifier so that event interception for the tracked guest
182 * pages can be received.
185 kvm_page_track_register_notifier(struct kvm *kvm,
186 struct kvm_page_track_notifier_node *n)
188 struct kvm_page_track_notifier_head *head;
190 head = &kvm->arch.track_notifier_head;
192 spin_lock(&kvm->mmu_lock);
193 hlist_add_head_rcu(&n->node, &head->track_notifier_list);
194 spin_unlock(&kvm->mmu_lock);
196 EXPORT_SYMBOL_GPL(kvm_page_track_register_notifier);
199 * stop receiving the event interception. It is the opposed operation of
200 * kvm_page_track_register_notifier().
203 kvm_page_track_unregister_notifier(struct kvm *kvm,
204 struct kvm_page_track_notifier_node *n)
206 struct kvm_page_track_notifier_head *head;
208 head = &kvm->arch.track_notifier_head;
210 spin_lock(&kvm->mmu_lock);
211 hlist_del_rcu(&n->node);
212 spin_unlock(&kvm->mmu_lock);
213 synchronize_srcu(&head->track_srcu);
215 EXPORT_SYMBOL_GPL(kvm_page_track_unregister_notifier);
218 * Notify the node that write access is intercepted and write emulation is
219 * finished at this time.
221 * The node should figure out if the written page is the one that node is
222 * interested in by itself.
224 void kvm_page_track_write(struct kvm_vcpu *vcpu, gpa_t gpa, const u8 *new,
227 struct kvm_page_track_notifier_head *head;
228 struct kvm_page_track_notifier_node *n;
231 head = &vcpu->kvm->arch.track_notifier_head;
233 if (hlist_empty(&head->track_notifier_list))
236 idx = srcu_read_lock(&head->track_srcu);
237 hlist_for_each_entry_rcu(n, &head->track_notifier_list, node)
239 n->track_write(vcpu, gpa, new, bytes, n);
240 srcu_read_unlock(&head->track_srcu, idx);
244 * Notify the node that memory slot is being removed or moved so that it can
245 * drop write-protection for the pages in the memory slot.
247 * The node should figure out it has any write-protected pages in this slot
250 void kvm_page_track_flush_slot(struct kvm *kvm, struct kvm_memory_slot *slot)
252 struct kvm_page_track_notifier_head *head;
253 struct kvm_page_track_notifier_node *n;
256 head = &kvm->arch.track_notifier_head;
258 if (hlist_empty(&head->track_notifier_list))
261 idx = srcu_read_lock(&head->track_srcu);
262 hlist_for_each_entry_rcu(n, &head->track_notifier_list, node)
263 if (n->track_flush_slot)
264 n->track_flush_slot(kvm, slot, n);
265 srcu_read_unlock(&head->track_srcu, idx);