1 #include <linux/kernel.h>
3 #include <linux/slab.h>
4 #include <linux/uaccess.h>
5 #include <linux/ktime.h>
6 #include <linux/debugfs.h>
9 static void put_back_pages(unsigned int cmd, struct page **pages,
10 unsigned long nr_pages, unsigned int gup_test_flags)
15 case GUP_FAST_BENCHMARK:
17 for (i = 0; i < nr_pages; i++)
21 case PIN_FAST_BENCHMARK:
23 case PIN_LONGTERM_BENCHMARK:
24 unpin_user_pages(pages, nr_pages);
26 case DUMP_USER_PAGES_TEST:
27 if (gup_test_flags & GUP_TEST_FLAG_DUMP_PAGES_USE_PIN) {
28 unpin_user_pages(pages, nr_pages);
30 for (i = 0; i < nr_pages; i++)
38 static void verify_dma_pinned(unsigned int cmd, struct page **pages,
39 unsigned long nr_pages)
45 case PIN_FAST_BENCHMARK:
47 case PIN_LONGTERM_BENCHMARK:
48 for (i = 0; i < nr_pages; i++) {
50 if (WARN(!page_maybe_dma_pinned(page),
51 "pages[%lu] is NOT dma-pinned\n", i)) {
53 dump_page(page, "gup_test failure");
61 static void dump_pages_test(struct gup_test *gup, struct page **pages,
62 unsigned long nr_pages)
64 unsigned int index_to_dump;
68 * Zero out any user-supplied page index that is out of range. Remember:
69 * .which_pages[] contains a 1-based set of page indices.
71 for (i = 0; i < GUP_TEST_MAX_PAGES_TO_DUMP; i++) {
72 if (gup->which_pages[i] > nr_pages) {
73 pr_warn("ZEROING due to out of range: .which_pages[%u]: %u\n",
74 i, gup->which_pages[i]);
75 gup->which_pages[i] = 0;
79 for (i = 0; i < GUP_TEST_MAX_PAGES_TO_DUMP; i++) {
80 index_to_dump = gup->which_pages[i];
83 index_to_dump--; // Decode from 1-based, to 0-based
84 pr_info("---- page #%u, starting from user virt addr: 0x%llx\n",
85 index_to_dump, gup->addr);
86 dump_page(pages[index_to_dump],
87 "gup_test: dump_pages() test");
92 static int __gup_test_ioctl(unsigned int cmd,
95 ktime_t start_time, end_time;
96 unsigned long i, nr_pages, addr, next;
100 bool needs_mmap_lock =
101 cmd != GUP_FAST_BENCHMARK && cmd != PIN_FAST_BENCHMARK;
103 if (gup->size > ULONG_MAX)
106 nr_pages = gup->size / PAGE_SIZE;
107 pages = kvcalloc(nr_pages, sizeof(void *), GFP_KERNEL);
111 if (needs_mmap_lock && mmap_read_lock_killable(current->mm)) {
117 nr = gup->nr_pages_per_call;
118 start_time = ktime_get();
119 for (addr = gup->addr; addr < gup->addr + gup->size; addr = next) {
120 if (nr != gup->nr_pages_per_call)
123 next = addr + nr * PAGE_SIZE;
124 if (next > gup->addr + gup->size) {
125 next = gup->addr + gup->size;
126 nr = (next - addr) / PAGE_SIZE;
130 case GUP_FAST_BENCHMARK:
131 nr = get_user_pages_fast(addr, nr, gup->gup_flags,
135 nr = get_user_pages(addr, nr, gup->gup_flags, pages + i,
138 case PIN_FAST_BENCHMARK:
139 nr = pin_user_pages_fast(addr, nr, gup->gup_flags,
143 nr = pin_user_pages(addr, nr, gup->gup_flags, pages + i,
146 case PIN_LONGTERM_BENCHMARK:
147 nr = pin_user_pages(addr, nr,
148 gup->gup_flags | FOLL_LONGTERM,
151 case DUMP_USER_PAGES_TEST:
152 if (gup->test_flags & GUP_TEST_FLAG_DUMP_PAGES_USE_PIN)
153 nr = pin_user_pages(addr, nr, gup->gup_flags,
156 nr = get_user_pages(addr, nr, gup->gup_flags,
168 end_time = ktime_get();
170 /* Shifting the meaning of nr_pages: now it is actual number pinned: */
173 gup->get_delta_usec = ktime_us_delta(end_time, start_time);
174 gup->size = addr - gup->addr;
177 * Take an un-benchmark-timed moment to verify DMA pinned
178 * state: print a warning if any non-dma-pinned pages are found:
180 verify_dma_pinned(cmd, pages, nr_pages);
182 if (cmd == DUMP_USER_PAGES_TEST)
183 dump_pages_test(gup, pages, nr_pages);
185 start_time = ktime_get();
187 put_back_pages(cmd, pages, nr_pages, gup->test_flags);
189 end_time = ktime_get();
190 gup->put_delta_usec = ktime_us_delta(end_time, start_time);
194 mmap_read_unlock(current->mm);
200 static long gup_test_ioctl(struct file *filep, unsigned int cmd,
207 case GUP_FAST_BENCHMARK:
208 case PIN_FAST_BENCHMARK:
209 case PIN_LONGTERM_BENCHMARK:
212 case DUMP_USER_PAGES_TEST:
218 if (copy_from_user(&gup, (void __user *)arg, sizeof(gup)))
221 ret = __gup_test_ioctl(cmd, &gup);
225 if (copy_to_user((void __user *)arg, &gup, sizeof(gup)))
231 static const struct file_operations gup_test_fops = {
232 .open = nonseekable_open,
233 .unlocked_ioctl = gup_test_ioctl,
236 static int __init gup_test_init(void)
238 debugfs_create_file_unsafe("gup_test", 0600, NULL, NULL,
244 late_initcall(gup_test_init);