1 // SPDX-License-Identifier: GPL-2.0-only
4 * Copyright (c) 2014 Samsung Electronics Co., Ltd.
5 * Author: Andrey Ryabinin <a.ryabinin@samsung.com>
8 #include <linux/bitops.h>
9 #include <linux/delay.h>
10 #include <linux/kasan.h>
11 #include <linux/kernel.h>
13 #include <linux/mman.h>
14 #include <linux/module.h>
15 #include <linux/printk.h>
16 #include <linux/random.h>
17 #include <linux/slab.h>
18 #include <linux/string.h>
19 #include <linux/uaccess.h>
21 #include <linux/vmalloc.h>
25 #include <kunit/test.h>
27 #include "../mm/kasan/kasan.h"
29 #define OOB_TAG_OFF (IS_ENABLED(CONFIG_KASAN_GENERIC) ? 0 : KASAN_GRANULE_SIZE)
32 * Some tests use these global variables to store return values from function
33 * calls that could otherwise be eliminated by the compiler as dead code.
35 void *kasan_ptr_result;
38 static struct kunit_resource resource;
39 static struct kunit_kasan_expectation fail_data;
40 static bool multishot;
43 * Temporarily enable multi-shot mode. Otherwise, KASAN would only report the
44 * first detected bug and panic the kernel if panic_on_warn is enabled. For
45 * hardware tag-based KASAN also allow tag checking to be reenabled for each
46 * test, see the comment for KUNIT_EXPECT_KASAN_FAIL().
48 static int kasan_test_init(struct kunit *test)
50 if (!kasan_enabled()) {
51 kunit_err(test, "can't run KASAN tests with KASAN disabled");
55 multishot = kasan_save_enable_multi_shot();
56 kasan_set_tagging_report_once(false);
60 static void kasan_test_exit(struct kunit *test)
62 kasan_set_tagging_report_once(true);
63 kasan_restore_multi_shot(multishot);
67 * KUNIT_EXPECT_KASAN_FAIL() - check that the executed expression produces a
68 * KASAN report; causes a test failure otherwise. This relies on a KUnit
69 * resource named "kasan_data". Do not use this name for KUnit resources
70 * outside of KASAN tests.
72 * For hardware tag-based KASAN, when a tag fault happens, tag checking is
73 * normally auto-disabled. When this happens, this test handler reenables
74 * tag checking. As tag checking can be only disabled or enabled per CPU, this
75 * handler disables migration (preemption).
77 * Since the compiler doesn't see that the expression can change the fail_data
78 * fields, it can reorder or optimize away the accesses to those fields.
79 * Use READ/WRITE_ONCE() for the accesses and compiler barriers around the
80 * expression to prevent that.
82 #define KUNIT_EXPECT_KASAN_FAIL(test, expression) do { \
83 if (IS_ENABLED(CONFIG_KASAN_HW_TAGS)) \
85 WRITE_ONCE(fail_data.report_expected, true); \
86 WRITE_ONCE(fail_data.report_found, false); \
87 kunit_add_named_resource(test, \
91 "kasan_data", &fail_data); \
95 KUNIT_EXPECT_EQ(test, \
96 READ_ONCE(fail_data.report_expected), \
97 READ_ONCE(fail_data.report_found)); \
98 if (IS_ENABLED(CONFIG_KASAN_HW_TAGS)) { \
99 if (READ_ONCE(fail_data.report_found)) \
100 kasan_enable_tagging(); \
105 #define KASAN_TEST_NEEDS_CONFIG_ON(test, config) do { \
106 if (!IS_ENABLED(config)) { \
107 kunit_info((test), "skipping, " #config " required"); \
112 #define KASAN_TEST_NEEDS_CONFIG_OFF(test, config) do { \
113 if (IS_ENABLED(config)) { \
114 kunit_info((test), "skipping, " #config " enabled"); \
119 static void kmalloc_oob_right(struct kunit *test)
124 ptr = kmalloc(size, GFP_KERNEL);
125 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
127 KUNIT_EXPECT_KASAN_FAIL(test, ptr[size + OOB_TAG_OFF] = 'x');
131 static void kmalloc_oob_left(struct kunit *test)
136 ptr = kmalloc(size, GFP_KERNEL);
137 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
139 KUNIT_EXPECT_KASAN_FAIL(test, *ptr = *(ptr - 1));
143 static void kmalloc_node_oob_right(struct kunit *test)
148 ptr = kmalloc_node(size, GFP_KERNEL, 0);
149 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
151 KUNIT_EXPECT_KASAN_FAIL(test, ptr[size] = 0);
156 * These kmalloc_pagealloc_* tests try allocating a memory chunk that doesn't
157 * fit into a slab cache and therefore is allocated via the page allocator
158 * fallback. Since this kind of fallback is only implemented for SLUB, these
159 * tests are limited to that allocator.
161 static void kmalloc_pagealloc_oob_right(struct kunit *test)
164 size_t size = KMALLOC_MAX_CACHE_SIZE + 10;
166 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_SLUB);
168 ptr = kmalloc(size, GFP_KERNEL);
169 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
171 KUNIT_EXPECT_KASAN_FAIL(test, ptr[size + OOB_TAG_OFF] = 0);
176 static void kmalloc_pagealloc_uaf(struct kunit *test)
179 size_t size = KMALLOC_MAX_CACHE_SIZE + 10;
181 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_SLUB);
183 ptr = kmalloc(size, GFP_KERNEL);
184 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
187 KUNIT_EXPECT_KASAN_FAIL(test, ptr[0] = 0);
190 static void kmalloc_pagealloc_invalid_free(struct kunit *test)
193 size_t size = KMALLOC_MAX_CACHE_SIZE + 10;
195 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_SLUB);
197 ptr = kmalloc(size, GFP_KERNEL);
198 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
200 KUNIT_EXPECT_KASAN_FAIL(test, kfree(ptr + 1));
203 static void pagealloc_oob_right(struct kunit *test)
208 size_t size = (1UL << (PAGE_SHIFT + order));
211 * With generic KASAN page allocations have no redzones, thus
212 * out-of-bounds detection is not guaranteed.
213 * See https://bugzilla.kernel.org/show_bug.cgi?id=210503.
215 KASAN_TEST_NEEDS_CONFIG_OFF(test, CONFIG_KASAN_GENERIC);
217 pages = alloc_pages(GFP_KERNEL, order);
218 ptr = page_address(pages);
219 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
221 KUNIT_EXPECT_KASAN_FAIL(test, ptr[size] = 0);
222 free_pages((unsigned long)ptr, order);
225 static void pagealloc_uaf(struct kunit *test)
231 pages = alloc_pages(GFP_KERNEL, order);
232 ptr = page_address(pages);
233 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
234 free_pages((unsigned long)ptr, order);
236 KUNIT_EXPECT_KASAN_FAIL(test, ptr[0] = 0);
239 static void kmalloc_large_oob_right(struct kunit *test)
242 size_t size = KMALLOC_MAX_CACHE_SIZE - 256;
245 * Allocate a chunk that is large enough, but still fits into a slab
246 * and does not trigger the page allocator fallback in SLUB.
248 ptr = kmalloc(size, GFP_KERNEL);
249 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
251 KUNIT_EXPECT_KASAN_FAIL(test, ptr[size] = 0);
255 static void krealloc_more_oob_helper(struct kunit *test,
256 size_t size1, size_t size2)
261 KUNIT_ASSERT_LT(test, size1, size2);
262 middle = size1 + (size2 - size1) / 2;
264 ptr1 = kmalloc(size1, GFP_KERNEL);
265 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr1);
267 ptr2 = krealloc(ptr1, size2, GFP_KERNEL);
268 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr2);
270 /* All offsets up to size2 must be accessible. */
271 ptr2[size1 - 1] = 'x';
274 ptr2[size2 - 1] = 'x';
276 /* Generic mode is precise, so unaligned size2 must be inaccessible. */
277 if (IS_ENABLED(CONFIG_KASAN_GENERIC))
278 KUNIT_EXPECT_KASAN_FAIL(test, ptr2[size2] = 'x');
280 /* For all modes first aligned offset after size2 must be inaccessible. */
281 KUNIT_EXPECT_KASAN_FAIL(test,
282 ptr2[round_up(size2, KASAN_GRANULE_SIZE)] = 'x');
287 static void krealloc_less_oob_helper(struct kunit *test,
288 size_t size1, size_t size2)
293 KUNIT_ASSERT_LT(test, size2, size1);
294 middle = size2 + (size1 - size2) / 2;
296 ptr1 = kmalloc(size1, GFP_KERNEL);
297 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr1);
299 ptr2 = krealloc(ptr1, size2, GFP_KERNEL);
300 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr2);
302 /* Must be accessible for all modes. */
303 ptr2[size2 - 1] = 'x';
305 /* Generic mode is precise, so unaligned size2 must be inaccessible. */
306 if (IS_ENABLED(CONFIG_KASAN_GENERIC))
307 KUNIT_EXPECT_KASAN_FAIL(test, ptr2[size2] = 'x');
309 /* For all modes first aligned offset after size2 must be inaccessible. */
310 KUNIT_EXPECT_KASAN_FAIL(test,
311 ptr2[round_up(size2, KASAN_GRANULE_SIZE)] = 'x');
314 * For all modes all size2, middle, and size1 should land in separate
315 * granules and thus the latter two offsets should be inaccessible.
317 KUNIT_EXPECT_LE(test, round_up(size2, KASAN_GRANULE_SIZE),
318 round_down(middle, KASAN_GRANULE_SIZE));
319 KUNIT_EXPECT_LE(test, round_up(middle, KASAN_GRANULE_SIZE),
320 round_down(size1, KASAN_GRANULE_SIZE));
321 KUNIT_EXPECT_KASAN_FAIL(test, ptr2[middle] = 'x');
322 KUNIT_EXPECT_KASAN_FAIL(test, ptr2[size1 - 1] = 'x');
323 KUNIT_EXPECT_KASAN_FAIL(test, ptr2[size1] = 'x');
328 static void krealloc_more_oob(struct kunit *test)
330 krealloc_more_oob_helper(test, 201, 235);
333 static void krealloc_less_oob(struct kunit *test)
335 krealloc_less_oob_helper(test, 235, 201);
338 static void krealloc_pagealloc_more_oob(struct kunit *test)
340 /* page_alloc fallback in only implemented for SLUB. */
341 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_SLUB);
343 krealloc_more_oob_helper(test, KMALLOC_MAX_CACHE_SIZE + 201,
344 KMALLOC_MAX_CACHE_SIZE + 235);
347 static void krealloc_pagealloc_less_oob(struct kunit *test)
349 /* page_alloc fallback in only implemented for SLUB. */
350 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_SLUB);
352 krealloc_less_oob_helper(test, KMALLOC_MAX_CACHE_SIZE + 235,
353 KMALLOC_MAX_CACHE_SIZE + 201);
356 static void kmalloc_oob_16(struct kunit *test)
362 /* This test is specifically crafted for the generic mode. */
363 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_KASAN_GENERIC);
365 ptr1 = kmalloc(sizeof(*ptr1) - 3, GFP_KERNEL);
366 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr1);
368 ptr2 = kmalloc(sizeof(*ptr2), GFP_KERNEL);
369 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr2);
371 KUNIT_EXPECT_KASAN_FAIL(test, *ptr1 = *ptr2);
376 static void kmalloc_uaf_16(struct kunit *test)
382 ptr1 = kmalloc(sizeof(*ptr1), GFP_KERNEL);
383 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr1);
385 ptr2 = kmalloc(sizeof(*ptr2), GFP_KERNEL);
386 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr2);
389 KUNIT_EXPECT_KASAN_FAIL(test, *ptr1 = *ptr2);
393 static void kmalloc_oob_memset_2(struct kunit *test)
398 ptr = kmalloc(size, GFP_KERNEL);
399 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
401 KUNIT_EXPECT_KASAN_FAIL(test, memset(ptr + 7 + OOB_TAG_OFF, 0, 2));
405 static void kmalloc_oob_memset_4(struct kunit *test)
410 ptr = kmalloc(size, GFP_KERNEL);
411 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
413 KUNIT_EXPECT_KASAN_FAIL(test, memset(ptr + 5 + OOB_TAG_OFF, 0, 4));
418 static void kmalloc_oob_memset_8(struct kunit *test)
423 ptr = kmalloc(size, GFP_KERNEL);
424 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
426 KUNIT_EXPECT_KASAN_FAIL(test, memset(ptr + 1 + OOB_TAG_OFF, 0, 8));
430 static void kmalloc_oob_memset_16(struct kunit *test)
435 ptr = kmalloc(size, GFP_KERNEL);
436 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
438 KUNIT_EXPECT_KASAN_FAIL(test, memset(ptr + 1 + OOB_TAG_OFF, 0, 16));
442 static void kmalloc_oob_in_memset(struct kunit *test)
447 ptr = kmalloc(size, GFP_KERNEL);
448 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
450 KUNIT_EXPECT_KASAN_FAIL(test, memset(ptr, 0, size + 5 + OOB_TAG_OFF));
454 static void kmalloc_memmove_invalid_size(struct kunit *test)
458 volatile size_t invalid_size = -2;
460 ptr = kmalloc(size, GFP_KERNEL);
461 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
463 memset((char *)ptr, 0, 64);
465 KUNIT_EXPECT_KASAN_FAIL(test,
466 memmove((char *)ptr, (char *)ptr + 4, invalid_size));
470 static void kmalloc_uaf(struct kunit *test)
475 ptr = kmalloc(size, GFP_KERNEL);
476 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
479 KUNIT_EXPECT_KASAN_FAIL(test, *(ptr + 8) = 'x');
482 static void kmalloc_uaf_memset(struct kunit *test)
487 ptr = kmalloc(size, GFP_KERNEL);
488 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
491 KUNIT_EXPECT_KASAN_FAIL(test, memset(ptr, 0, size));
494 static void kmalloc_uaf2(struct kunit *test)
501 ptr1 = kmalloc(size, GFP_KERNEL);
502 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr1);
506 ptr2 = kmalloc(size, GFP_KERNEL);
507 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr2);
510 * For tag-based KASAN ptr1 and ptr2 tags might happen to be the same.
511 * Allow up to 16 attempts at generating different tags.
513 if (!IS_ENABLED(CONFIG_KASAN_GENERIC) && ptr1 == ptr2 && counter++ < 16) {
518 KUNIT_EXPECT_KASAN_FAIL(test, ptr1[40] = 'x');
519 KUNIT_EXPECT_PTR_NE(test, ptr1, ptr2);
524 static void kfree_via_page(struct kunit *test)
529 unsigned long offset;
531 ptr = kmalloc(size, GFP_KERNEL);
532 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
534 page = virt_to_page(ptr);
535 offset = offset_in_page(ptr);
536 kfree(page_address(page) + offset);
539 static void kfree_via_phys(struct kunit *test)
545 ptr = kmalloc(size, GFP_KERNEL);
546 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
548 phys = virt_to_phys(ptr);
549 kfree(phys_to_virt(phys));
552 static void kmem_cache_oob(struct kunit *test)
556 struct kmem_cache *cache;
558 cache = kmem_cache_create("test_cache", size, 0, 0, NULL);
559 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, cache);
561 p = kmem_cache_alloc(cache, GFP_KERNEL);
563 kunit_err(test, "Allocation failed: %s\n", __func__);
564 kmem_cache_destroy(cache);
568 KUNIT_EXPECT_KASAN_FAIL(test, *p = p[size + OOB_TAG_OFF]);
570 kmem_cache_free(cache, p);
571 kmem_cache_destroy(cache);
574 static void kmem_cache_accounted(struct kunit *test)
579 struct kmem_cache *cache;
581 cache = kmem_cache_create("test_cache", size, 0, SLAB_ACCOUNT, NULL);
582 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, cache);
585 * Several allocations with a delay to allow for lazy per memcg kmem
588 for (i = 0; i < 5; i++) {
589 p = kmem_cache_alloc(cache, GFP_KERNEL);
593 kmem_cache_free(cache, p);
598 kmem_cache_destroy(cache);
601 static void kmem_cache_bulk(struct kunit *test)
603 struct kmem_cache *cache;
609 cache = kmem_cache_create("test_cache", size, 0, 0, NULL);
610 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, cache);
612 ret = kmem_cache_alloc_bulk(cache, GFP_KERNEL, ARRAY_SIZE(p), (void **)&p);
614 kunit_err(test, "Allocation failed: %s\n", __func__);
615 kmem_cache_destroy(cache);
619 for (i = 0; i < ARRAY_SIZE(p); i++)
620 p[i][0] = p[i][size - 1] = 42;
622 kmem_cache_free_bulk(cache, ARRAY_SIZE(p), (void **)&p);
623 kmem_cache_destroy(cache);
626 static char global_array[10];
628 static void kasan_global_oob(struct kunit *test)
631 char *p = &global_array[ARRAY_SIZE(global_array) + i];
633 /* Only generic mode instruments globals. */
634 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_KASAN_GENERIC);
636 KUNIT_EXPECT_KASAN_FAIL(test, *(volatile char *)p);
639 /* Check that ksize() makes the whole object accessible. */
640 static void ksize_unpoisons_memory(struct kunit *test)
643 size_t size = 123, real_size;
645 ptr = kmalloc(size, GFP_KERNEL);
646 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
647 real_size = ksize(ptr);
649 /* This access shouldn't trigger a KASAN report. */
653 KUNIT_EXPECT_KASAN_FAIL(test, ptr[real_size] = 'y');
659 * Check that a use-after-free is detected by ksize() and via normal accesses
662 static void ksize_uaf(struct kunit *test)
665 int size = 128 - KASAN_GRANULE_SIZE;
667 ptr = kmalloc(size, GFP_KERNEL);
668 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
671 KUNIT_EXPECT_KASAN_FAIL(test, ksize(ptr));
672 KUNIT_EXPECT_KASAN_FAIL(test, kasan_int_result = *ptr);
673 KUNIT_EXPECT_KASAN_FAIL(test, kasan_int_result = *(ptr + size));
676 static void kasan_stack_oob(struct kunit *test)
678 char stack_array[10];
679 volatile int i = OOB_TAG_OFF;
680 char *p = &stack_array[ARRAY_SIZE(stack_array) + i];
682 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_KASAN_STACK);
684 KUNIT_EXPECT_KASAN_FAIL(test, *(volatile char *)p);
687 static void kasan_alloca_oob_left(struct kunit *test)
690 char alloca_array[i];
691 char *p = alloca_array - 1;
693 /* Only generic mode instruments dynamic allocas. */
694 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_KASAN_GENERIC);
695 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_KASAN_STACK);
697 KUNIT_EXPECT_KASAN_FAIL(test, *(volatile char *)p);
700 static void kasan_alloca_oob_right(struct kunit *test)
703 char alloca_array[i];
704 char *p = alloca_array + i;
706 /* Only generic mode instruments dynamic allocas. */
707 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_KASAN_GENERIC);
708 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_KASAN_STACK);
710 KUNIT_EXPECT_KASAN_FAIL(test, *(volatile char *)p);
713 static void kmem_cache_double_free(struct kunit *test)
717 struct kmem_cache *cache;
719 cache = kmem_cache_create("test_cache", size, 0, 0, NULL);
720 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, cache);
722 p = kmem_cache_alloc(cache, GFP_KERNEL);
724 kunit_err(test, "Allocation failed: %s\n", __func__);
725 kmem_cache_destroy(cache);
729 kmem_cache_free(cache, p);
730 KUNIT_EXPECT_KASAN_FAIL(test, kmem_cache_free(cache, p));
731 kmem_cache_destroy(cache);
734 static void kmem_cache_invalid_free(struct kunit *test)
738 struct kmem_cache *cache;
740 cache = kmem_cache_create("test_cache", size, 0, SLAB_TYPESAFE_BY_RCU,
742 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, cache);
744 p = kmem_cache_alloc(cache, GFP_KERNEL);
746 kunit_err(test, "Allocation failed: %s\n", __func__);
747 kmem_cache_destroy(cache);
751 /* Trigger invalid free, the object doesn't get freed. */
752 KUNIT_EXPECT_KASAN_FAIL(test, kmem_cache_free(cache, p + 1));
755 * Properly free the object to prevent the "Objects remaining in
756 * test_cache on __kmem_cache_shutdown" BUG failure.
758 kmem_cache_free(cache, p);
760 kmem_cache_destroy(cache);
763 static void kasan_memchr(struct kunit *test)
769 * str* functions are not instrumented with CONFIG_AMD_MEM_ENCRYPT.
770 * See https://bugzilla.kernel.org/show_bug.cgi?id=206337 for details.
772 KASAN_TEST_NEEDS_CONFIG_OFF(test, CONFIG_AMD_MEM_ENCRYPT);
775 size = round_up(size, OOB_TAG_OFF);
777 ptr = kmalloc(size, GFP_KERNEL | __GFP_ZERO);
778 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
780 KUNIT_EXPECT_KASAN_FAIL(test,
781 kasan_ptr_result = memchr(ptr, '1', size + 1));
786 static void kasan_memcmp(struct kunit *test)
793 * str* functions are not instrumented with CONFIG_AMD_MEM_ENCRYPT.
794 * See https://bugzilla.kernel.org/show_bug.cgi?id=206337 for details.
796 KASAN_TEST_NEEDS_CONFIG_OFF(test, CONFIG_AMD_MEM_ENCRYPT);
799 size = round_up(size, OOB_TAG_OFF);
801 ptr = kmalloc(size, GFP_KERNEL | __GFP_ZERO);
802 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
803 memset(arr, 0, sizeof(arr));
805 KUNIT_EXPECT_KASAN_FAIL(test,
806 kasan_int_result = memcmp(ptr, arr, size+1));
810 static void kasan_strings(struct kunit *test)
816 * str* functions are not instrumented with CONFIG_AMD_MEM_ENCRYPT.
817 * See https://bugzilla.kernel.org/show_bug.cgi?id=206337 for details.
819 KASAN_TEST_NEEDS_CONFIG_OFF(test, CONFIG_AMD_MEM_ENCRYPT);
821 ptr = kmalloc(size, GFP_KERNEL | __GFP_ZERO);
822 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
827 * Try to cause only 1 invalid access (less spam in dmesg).
828 * For that we need ptr to point to zeroed byte.
829 * Skip metadata that could be stored in freed object so ptr
830 * will likely point to zeroed byte.
833 KUNIT_EXPECT_KASAN_FAIL(test, kasan_ptr_result = strchr(ptr, '1'));
835 KUNIT_EXPECT_KASAN_FAIL(test, kasan_ptr_result = strrchr(ptr, '1'));
837 KUNIT_EXPECT_KASAN_FAIL(test, kasan_int_result = strcmp(ptr, "2"));
839 KUNIT_EXPECT_KASAN_FAIL(test, kasan_int_result = strncmp(ptr, "2", 1));
841 KUNIT_EXPECT_KASAN_FAIL(test, kasan_int_result = strlen(ptr));
843 KUNIT_EXPECT_KASAN_FAIL(test, kasan_int_result = strnlen(ptr, 1));
846 static void kasan_bitops_modify(struct kunit *test, int nr, void *addr)
848 KUNIT_EXPECT_KASAN_FAIL(test, set_bit(nr, addr));
849 KUNIT_EXPECT_KASAN_FAIL(test, __set_bit(nr, addr));
850 KUNIT_EXPECT_KASAN_FAIL(test, clear_bit(nr, addr));
851 KUNIT_EXPECT_KASAN_FAIL(test, __clear_bit(nr, addr));
852 KUNIT_EXPECT_KASAN_FAIL(test, clear_bit_unlock(nr, addr));
853 KUNIT_EXPECT_KASAN_FAIL(test, __clear_bit_unlock(nr, addr));
854 KUNIT_EXPECT_KASAN_FAIL(test, change_bit(nr, addr));
855 KUNIT_EXPECT_KASAN_FAIL(test, __change_bit(nr, addr));
858 static void kasan_bitops_test_and_modify(struct kunit *test, int nr, void *addr)
860 KUNIT_EXPECT_KASAN_FAIL(test, test_and_set_bit(nr, addr));
861 KUNIT_EXPECT_KASAN_FAIL(test, __test_and_set_bit(nr, addr));
862 KUNIT_EXPECT_KASAN_FAIL(test, test_and_set_bit_lock(nr, addr));
863 KUNIT_EXPECT_KASAN_FAIL(test, test_and_clear_bit(nr, addr));
864 KUNIT_EXPECT_KASAN_FAIL(test, __test_and_clear_bit(nr, addr));
865 KUNIT_EXPECT_KASAN_FAIL(test, test_and_change_bit(nr, addr));
866 KUNIT_EXPECT_KASAN_FAIL(test, __test_and_change_bit(nr, addr));
867 KUNIT_EXPECT_KASAN_FAIL(test, kasan_int_result = test_bit(nr, addr));
869 #if defined(clear_bit_unlock_is_negative_byte)
870 KUNIT_EXPECT_KASAN_FAIL(test, kasan_int_result =
871 clear_bit_unlock_is_negative_byte(nr, addr));
875 static void kasan_bitops_generic(struct kunit *test)
879 /* This test is specifically crafted for the generic mode. */
880 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_KASAN_GENERIC);
883 * Allocate 1 more byte, which causes kzalloc to round up to 16 bytes;
884 * this way we do not actually corrupt other memory.
886 bits = kzalloc(sizeof(*bits) + 1, GFP_KERNEL);
887 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, bits);
890 * Below calls try to access bit within allocated memory; however, the
891 * below accesses are still out-of-bounds, since bitops are defined to
892 * operate on the whole long the bit is in.
894 kasan_bitops_modify(test, BITS_PER_LONG, bits);
897 * Below calls try to access bit beyond allocated memory.
899 kasan_bitops_test_and_modify(test, BITS_PER_LONG + BITS_PER_BYTE, bits);
904 static void kasan_bitops_tags(struct kunit *test)
908 /* This test is specifically crafted for tag-based modes. */
909 KASAN_TEST_NEEDS_CONFIG_OFF(test, CONFIG_KASAN_GENERIC);
911 /* kmalloc-64 cache will be used and the last 16 bytes will be the redzone. */
912 bits = kzalloc(48, GFP_KERNEL);
913 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, bits);
915 /* Do the accesses past the 48 allocated bytes, but within the redone. */
916 kasan_bitops_modify(test, BITS_PER_LONG, (void *)bits + 48);
917 kasan_bitops_test_and_modify(test, BITS_PER_LONG + BITS_PER_BYTE, (void *)bits + 48);
922 static void kmalloc_double_kzfree(struct kunit *test)
927 ptr = kmalloc(size, GFP_KERNEL);
928 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
930 kfree_sensitive(ptr);
931 KUNIT_EXPECT_KASAN_FAIL(test, kfree_sensitive(ptr));
934 static void vmalloc_oob(struct kunit *test)
938 KASAN_TEST_NEEDS_CONFIG_ON(test, CONFIG_KASAN_VMALLOC);
941 * We have to be careful not to hit the guard page.
942 * The MMU will catch that and crash us.
944 area = vmalloc(3000);
945 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, area);
947 KUNIT_EXPECT_KASAN_FAIL(test, ((volatile char *)area)[3100]);
952 * Check that the assigned pointer tag falls within the [KASAN_TAG_MIN,
953 * KASAN_TAG_KERNEL) range (note: excluding the match-all tag) for tag-based
956 static void match_all_not_assigned(struct kunit *test)
962 KASAN_TEST_NEEDS_CONFIG_OFF(test, CONFIG_KASAN_GENERIC);
964 for (i = 0; i < 256; i++) {
965 size = (get_random_int() % 1024) + 1;
966 ptr = kmalloc(size, GFP_KERNEL);
967 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
968 KUNIT_EXPECT_GE(test, (u8)get_tag(ptr), (u8)KASAN_TAG_MIN);
969 KUNIT_EXPECT_LT(test, (u8)get_tag(ptr), (u8)KASAN_TAG_KERNEL);
973 for (i = 0; i < 256; i++) {
974 order = (get_random_int() % 4) + 1;
975 pages = alloc_pages(GFP_KERNEL, order);
976 ptr = page_address(pages);
977 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
978 KUNIT_EXPECT_GE(test, (u8)get_tag(ptr), (u8)KASAN_TAG_MIN);
979 KUNIT_EXPECT_LT(test, (u8)get_tag(ptr), (u8)KASAN_TAG_KERNEL);
980 free_pages((unsigned long)ptr, order);
984 /* Check that 0xff works as a match-all pointer tag for tag-based modes. */
985 static void match_all_ptr_tag(struct kunit *test)
990 KASAN_TEST_NEEDS_CONFIG_OFF(test, CONFIG_KASAN_GENERIC);
992 ptr = kmalloc(128, GFP_KERNEL);
993 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
995 /* Backup the assigned tag. */
997 KUNIT_EXPECT_NE(test, tag, (u8)KASAN_TAG_KERNEL);
999 /* Reset the tag to 0xff.*/
1000 ptr = set_tag(ptr, KASAN_TAG_KERNEL);
1002 /* This access shouldn't trigger a KASAN report. */
1005 /* Recover the pointer tag and free. */
1006 ptr = set_tag(ptr, tag);
1010 /* Check that there are no match-all memory tags for tag-based modes. */
1011 static void match_all_mem_tag(struct kunit *test)
1016 KASAN_TEST_NEEDS_CONFIG_OFF(test, CONFIG_KASAN_GENERIC);
1018 ptr = kmalloc(128, GFP_KERNEL);
1019 KUNIT_ASSERT_NOT_ERR_OR_NULL(test, ptr);
1020 KUNIT_EXPECT_NE(test, (u8)get_tag(ptr), (u8)KASAN_TAG_KERNEL);
1022 /* For each possible tag value not matching the pointer tag. */
1023 for (tag = KASAN_TAG_MIN; tag <= KASAN_TAG_KERNEL; tag++) {
1024 if (tag == get_tag(ptr))
1027 /* Mark the first memory granule with the chosen memory tag. */
1028 kasan_poison(ptr, KASAN_GRANULE_SIZE, (u8)tag);
1030 /* This access must cause a KASAN report. */
1031 KUNIT_EXPECT_KASAN_FAIL(test, *ptr = 0);
1034 /* Recover the memory tag and free. */
1035 kasan_poison(ptr, KASAN_GRANULE_SIZE, get_tag(ptr));
1039 static struct kunit_case kasan_kunit_test_cases[] = {
1040 KUNIT_CASE(kmalloc_oob_right),
1041 KUNIT_CASE(kmalloc_oob_left),
1042 KUNIT_CASE(kmalloc_node_oob_right),
1043 KUNIT_CASE(kmalloc_pagealloc_oob_right),
1044 KUNIT_CASE(kmalloc_pagealloc_uaf),
1045 KUNIT_CASE(kmalloc_pagealloc_invalid_free),
1046 KUNIT_CASE(pagealloc_oob_right),
1047 KUNIT_CASE(pagealloc_uaf),
1048 KUNIT_CASE(kmalloc_large_oob_right),
1049 KUNIT_CASE(krealloc_more_oob),
1050 KUNIT_CASE(krealloc_less_oob),
1051 KUNIT_CASE(krealloc_pagealloc_more_oob),
1052 KUNIT_CASE(krealloc_pagealloc_less_oob),
1053 KUNIT_CASE(kmalloc_oob_16),
1054 KUNIT_CASE(kmalloc_uaf_16),
1055 KUNIT_CASE(kmalloc_oob_in_memset),
1056 KUNIT_CASE(kmalloc_oob_memset_2),
1057 KUNIT_CASE(kmalloc_oob_memset_4),
1058 KUNIT_CASE(kmalloc_oob_memset_8),
1059 KUNIT_CASE(kmalloc_oob_memset_16),
1060 KUNIT_CASE(kmalloc_memmove_invalid_size),
1061 KUNIT_CASE(kmalloc_uaf),
1062 KUNIT_CASE(kmalloc_uaf_memset),
1063 KUNIT_CASE(kmalloc_uaf2),
1064 KUNIT_CASE(kfree_via_page),
1065 KUNIT_CASE(kfree_via_phys),
1066 KUNIT_CASE(kmem_cache_oob),
1067 KUNIT_CASE(kmem_cache_accounted),
1068 KUNIT_CASE(kmem_cache_bulk),
1069 KUNIT_CASE(kasan_global_oob),
1070 KUNIT_CASE(kasan_stack_oob),
1071 KUNIT_CASE(kasan_alloca_oob_left),
1072 KUNIT_CASE(kasan_alloca_oob_right),
1073 KUNIT_CASE(ksize_unpoisons_memory),
1074 KUNIT_CASE(ksize_uaf),
1075 KUNIT_CASE(kmem_cache_double_free),
1076 KUNIT_CASE(kmem_cache_invalid_free),
1077 KUNIT_CASE(kasan_memchr),
1078 KUNIT_CASE(kasan_memcmp),
1079 KUNIT_CASE(kasan_strings),
1080 KUNIT_CASE(kasan_bitops_generic),
1081 KUNIT_CASE(kasan_bitops_tags),
1082 KUNIT_CASE(kmalloc_double_kzfree),
1083 KUNIT_CASE(vmalloc_oob),
1084 KUNIT_CASE(match_all_not_assigned),
1085 KUNIT_CASE(match_all_ptr_tag),
1086 KUNIT_CASE(match_all_mem_tag),
1090 static struct kunit_suite kasan_kunit_test_suite = {
1092 .init = kasan_test_init,
1093 .test_cases = kasan_kunit_test_cases,
1094 .exit = kasan_test_exit,
1097 kunit_test_suite(kasan_kunit_test_suite);
1099 MODULE_LICENSE("GPL");