1 // SPDX-License-Identifier: GPL-2.0
3 * This file contains common KASAN error reporting code.
5 * Copyright (c) 2014 Samsung Electronics Co., Ltd.
6 * Author: Andrey Ryabinin <ryabinin.a.a@gmail.com>
8 * Some code borrowed from https://github.com/xairy/kasan-prototype by
9 * Andrey Konovalov <andreyknvl@gmail.com>
12 #include <kunit/test.h>
13 #include <kunit/visibility.h>
14 #include <linux/bitops.h>
15 #include <linux/ftrace.h>
16 #include <linux/init.h>
17 #include <linux/kernel.h>
18 #include <linux/lockdep.h>
20 #include <linux/printk.h>
21 #include <linux/sched.h>
22 #include <linux/slab.h>
23 #include <linux/stackdepot.h>
24 #include <linux/stacktrace.h>
25 #include <linux/string.h>
26 #include <linux/types.h>
27 #include <linux/vmalloc.h>
28 #include <linux/kasan.h>
29 #include <linux/module.h>
30 #include <linux/sched/task_stack.h>
31 #include <linux/uaccess.h>
32 #include <trace/events/error_report.h>
34 #include <asm/sections.h>
39 static unsigned long kasan_flags
;
41 #define KASAN_BIT_REPORTED 0
42 #define KASAN_BIT_MULTI_SHOT 1
44 enum kasan_arg_fault
{
45 KASAN_ARG_FAULT_DEFAULT
,
46 KASAN_ARG_FAULT_REPORT
,
47 KASAN_ARG_FAULT_PANIC
,
48 KASAN_ARG_FAULT_PANIC_ON_WRITE
,
51 static enum kasan_arg_fault kasan_arg_fault __ro_after_init
= KASAN_ARG_FAULT_DEFAULT
;
53 /* kasan.fault=report/panic */
54 static int __init
early_kasan_fault(char *arg
)
59 if (!strcmp(arg
, "report"))
60 kasan_arg_fault
= KASAN_ARG_FAULT_REPORT
;
61 else if (!strcmp(arg
, "panic"))
62 kasan_arg_fault
= KASAN_ARG_FAULT_PANIC
;
63 else if (!strcmp(arg
, "panic_on_write"))
64 kasan_arg_fault
= KASAN_ARG_FAULT_PANIC_ON_WRITE
;
70 early_param("kasan.fault", early_kasan_fault
);
72 static int __init
kasan_set_multi_shot(char *str
)
74 set_bit(KASAN_BIT_MULTI_SHOT
, &kasan_flags
);
77 __setup("kasan_multi_shot", kasan_set_multi_shot
);
80 * This function is used to check whether KASAN reports are suppressed for
81 * software KASAN modes via kasan_disable/enable_current() critical sections.
83 * This is done to avoid:
84 * 1. False-positive reports when accessing slab metadata,
85 * 2. Deadlocking when poisoned memory is accessed by the reporting code.
87 * Hardware Tag-Based KASAN instead relies on:
88 * For #1: Resetting tags via kasan_reset_tag().
89 * For #2: Suppression of tag checks via CPU, see report_suppress_start/end().
91 static bool report_suppressed_sw(void)
93 #if defined(CONFIG_KASAN_GENERIC) || defined(CONFIG_KASAN_SW_TAGS)
94 if (current
->kasan_depth
)
100 static void report_suppress_start(void)
102 #ifdef CONFIG_KASAN_HW_TAGS
104 * Disable preemption for the duration of printing a KASAN report, as
105 * hw_suppress_tag_checks_start() disables checks on the current CPU.
108 hw_suppress_tag_checks_start();
110 kasan_disable_current();
114 static void report_suppress_stop(void)
116 #ifdef CONFIG_KASAN_HW_TAGS
117 hw_suppress_tag_checks_stop();
120 kasan_enable_current();
125 * Used to avoid reporting more than one KASAN bug unless kasan_multi_shot
126 * is enabled. Note that KASAN tests effectively enable kasan_multi_shot
127 * for their duration.
129 static bool report_enabled(void)
131 if (test_bit(KASAN_BIT_MULTI_SHOT
, &kasan_flags
))
133 return !test_and_set_bit(KASAN_BIT_REPORTED
, &kasan_flags
);
136 #if IS_ENABLED(CONFIG_KASAN_KUNIT_TEST)
138 VISIBLE_IF_KUNIT
bool kasan_save_enable_multi_shot(void)
140 return test_and_set_bit(KASAN_BIT_MULTI_SHOT
, &kasan_flags
);
142 EXPORT_SYMBOL_IF_KUNIT(kasan_save_enable_multi_shot
);
144 VISIBLE_IF_KUNIT
void kasan_restore_multi_shot(bool enabled
)
147 clear_bit(KASAN_BIT_MULTI_SHOT
, &kasan_flags
);
149 EXPORT_SYMBOL_IF_KUNIT(kasan_restore_multi_shot
);
153 #if IS_ENABLED(CONFIG_KASAN_KUNIT_TEST)
156 * Whether the KASAN KUnit test suite is currently being executed.
157 * Updated in kasan_test.c.
159 static bool kasan_kunit_executing
;
161 VISIBLE_IF_KUNIT
void kasan_kunit_test_suite_start(void)
163 WRITE_ONCE(kasan_kunit_executing
, true);
165 EXPORT_SYMBOL_IF_KUNIT(kasan_kunit_test_suite_start
);
167 VISIBLE_IF_KUNIT
void kasan_kunit_test_suite_end(void)
169 WRITE_ONCE(kasan_kunit_executing
, false);
171 EXPORT_SYMBOL_IF_KUNIT(kasan_kunit_test_suite_end
);
173 static bool kasan_kunit_test_suite_executing(void)
175 return READ_ONCE(kasan_kunit_executing
);
178 #else /* CONFIG_KASAN_KUNIT_TEST */
180 static inline bool kasan_kunit_test_suite_executing(void) { return false; }
182 #endif /* CONFIG_KASAN_KUNIT_TEST */
184 #if IS_ENABLED(CONFIG_KUNIT)
186 static void fail_non_kasan_kunit_test(void)
190 if (kasan_kunit_test_suite_executing())
193 test
= current
->kunit_test
;
195 kunit_set_failure(test
);
198 #else /* CONFIG_KUNIT */
200 static inline void fail_non_kasan_kunit_test(void) { }
202 #endif /* CONFIG_KUNIT */
204 static DEFINE_RAW_SPINLOCK(report_lock
);
206 static void start_report(unsigned long *flags
, bool sync
)
208 fail_non_kasan_kunit_test();
209 /* Respect the /proc/sys/kernel/traceoff_on_warning interface. */
210 disable_trace_on_warning();
211 /* Do not allow LOCKDEP mangling KASAN reports. */
213 /* Make sure we don't end up in loop. */
214 report_suppress_start();
215 raw_spin_lock_irqsave(&report_lock
, *flags
);
216 pr_err("==================================================================\n");
219 static void end_report(unsigned long *flags
, const void *addr
, bool is_write
)
222 trace_error_report_end(ERROR_DETECTOR_KASAN
,
223 (unsigned long)addr
);
224 pr_err("==================================================================\n");
225 raw_spin_unlock_irqrestore(&report_lock
, *flags
);
226 if (!test_bit(KASAN_BIT_MULTI_SHOT
, &kasan_flags
))
227 check_panic_on_warn("KASAN");
228 switch (kasan_arg_fault
) {
229 case KASAN_ARG_FAULT_DEFAULT
:
230 case KASAN_ARG_FAULT_REPORT
:
232 case KASAN_ARG_FAULT_PANIC
:
233 panic("kasan.fault=panic set ...\n");
235 case KASAN_ARG_FAULT_PANIC_ON_WRITE
:
237 panic("kasan.fault=panic_on_write set ...\n");
240 add_taint(TAINT_BAD_PAGE
, LOCKDEP_NOW_UNRELIABLE
);
242 report_suppress_stop();
245 static void print_error_description(struct kasan_report_info
*info
)
247 pr_err("BUG: KASAN: %s in %pS\n", info
->bug_type
, (void *)info
->ip
);
249 if (info
->type
!= KASAN_REPORT_ACCESS
) {
250 pr_err("Free of addr %px by task %s/%d\n",
251 info
->access_addr
, current
->comm
, task_pid_nr(current
));
255 if (info
->access_size
)
256 pr_err("%s of size %zu at addr %px by task %s/%d\n",
257 info
->is_write
? "Write" : "Read", info
->access_size
,
258 info
->access_addr
, current
->comm
, task_pid_nr(current
));
260 pr_err("%s at addr %px by task %s/%d\n",
261 info
->is_write
? "Write" : "Read",
262 info
->access_addr
, current
->comm
, task_pid_nr(current
));
265 static void print_track(struct kasan_track
*track
, const char *prefix
)
267 #ifdef CONFIG_KASAN_EXTRA_INFO
268 u64 ts_nsec
= track
->timestamp
;
269 unsigned long rem_usec
;
272 rem_usec
= do_div(ts_nsec
, NSEC_PER_SEC
) / 1000;
274 pr_err("%s by task %u on cpu %d at %lu.%06lus:\n",
275 prefix
, track
->pid
, track
->cpu
,
276 (unsigned long)ts_nsec
, rem_usec
);
278 pr_err("%s by task %u:\n", prefix
, track
->pid
);
279 #endif /* CONFIG_KASAN_EXTRA_INFO */
281 stack_depot_print(track
->stack
);
283 pr_err("(stack is not available)\n");
286 static inline struct page
*addr_to_page(const void *addr
)
288 if (virt_addr_valid(addr
))
289 return virt_to_head_page(addr
);
293 static void describe_object_addr(const void *addr
, struct kasan_report_info
*info
)
295 unsigned long access_addr
= (unsigned long)addr
;
296 unsigned long object_addr
= (unsigned long)info
->object
;
297 const char *rel_type
, *region_state
= "";
300 pr_err("The buggy address belongs to the object at %px\n"
301 " which belongs to the cache %s of size %d\n",
302 info
->object
, info
->cache
->name
, info
->cache
->object_size
);
304 if (access_addr
< object_addr
) {
305 rel_type
= "to the left";
306 rel_bytes
= object_addr
- access_addr
;
307 } else if (access_addr
>= object_addr
+ info
->alloc_size
) {
308 rel_type
= "to the right";
309 rel_bytes
= access_addr
- (object_addr
+ info
->alloc_size
);
312 rel_bytes
= access_addr
- object_addr
;
316 * Tag-Based modes use the stack ring to infer the bug type, but the
317 * memory region state description is generated based on the metadata.
318 * Thus, defining the region state as below can contradict the metadata.
319 * Fixing this requires further improvements, so only infer the state
320 * for the Generic mode.
322 if (IS_ENABLED(CONFIG_KASAN_GENERIC
)) {
323 if (strcmp(info
->bug_type
, "slab-out-of-bounds") == 0)
324 region_state
= "allocated ";
325 else if (strcmp(info
->bug_type
, "slab-use-after-free") == 0)
326 region_state
= "freed ";
329 pr_err("The buggy address is located %d bytes %s of\n"
330 " %s%zu-byte region [%px, %px)\n",
331 rel_bytes
, rel_type
, region_state
, info
->alloc_size
,
332 (void *)object_addr
, (void *)(object_addr
+ info
->alloc_size
));
335 static void describe_object_stacks(struct kasan_report_info
*info
)
337 if (info
->alloc_track
.stack
) {
338 print_track(&info
->alloc_track
, "Allocated");
342 if (info
->free_track
.stack
) {
343 print_track(&info
->free_track
, "Freed");
347 kasan_print_aux_stacks(info
->cache
, info
->object
);
350 static void describe_object(const void *addr
, struct kasan_report_info
*info
)
352 if (kasan_stack_collection_enabled())
353 describe_object_stacks(info
);
354 describe_object_addr(addr
, info
);
357 static inline bool kernel_or_module_addr(const void *addr
)
359 if (is_kernel((unsigned long)addr
))
361 if (is_module_address((unsigned long)addr
))
366 static inline bool init_task_stack_addr(const void *addr
)
368 return addr
>= (void *)&init_thread_union
.stack
&&
369 (addr
<= (void *)&init_thread_union
.stack
+
370 sizeof(init_thread_union
.stack
));
373 static void print_address_description(void *addr
, u8 tag
,
374 struct kasan_report_info
*info
)
376 struct page
*page
= addr_to_page(addr
);
378 dump_stack_lvl(KERN_ERR
);
381 if (info
->cache
&& info
->object
) {
382 describe_object(addr
, info
);
386 if (kernel_or_module_addr(addr
) && !init_task_stack_addr(addr
)) {
387 pr_err("The buggy address belongs to the variable:\n");
388 pr_err(" %pS\n", addr
);
392 if (object_is_on_stack(addr
)) {
394 * Currently, KASAN supports printing frame information only
395 * for accesses to the task's own stack.
397 kasan_print_address_stack_frame(addr
);
401 if (is_vmalloc_addr(addr
)) {
402 struct vm_struct
*va
= find_vm_area(addr
);
405 pr_err("The buggy address belongs to the virtual mapping at\n"
406 " [%px, %px) created by:\n"
408 va
->addr
, va
->addr
+ va
->size
, va
->caller
);
411 page
= vmalloc_to_page(addr
);
416 pr_err("The buggy address belongs to the physical page:\n");
417 dump_page(page
, "kasan: bad access detected");
422 static bool meta_row_is_guilty(const void *row
, const void *addr
)
424 return (row
<= addr
) && (addr
< row
+ META_MEM_BYTES_PER_ROW
);
427 static int meta_pointer_offset(const void *row
, const void *addr
)
430 * Memory state around the buggy address:
431 * ff00ff00ff00ff00: 00 00 00 05 fe fe fe fe fe fe fe fe fe fe fe fe
434 * The length of ">ff00ff00ff00ff00: " is
435 * 3 + (BITS_PER_LONG / 8) * 2 chars.
436 * The length of each granule metadata is 2 bytes
437 * plus 1 byte for space.
439 return 3 + (BITS_PER_LONG
/ 8) * 2 +
440 (addr
- row
) / KASAN_GRANULE_SIZE
* 3 + 1;
443 static void print_memory_metadata(const void *addr
)
448 row
= (void *)round_down((unsigned long)addr
, META_MEM_BYTES_PER_ROW
)
449 - META_ROWS_AROUND_ADDR
* META_MEM_BYTES_PER_ROW
;
451 pr_err("Memory state around the buggy address:\n");
453 for (i
= -META_ROWS_AROUND_ADDR
; i
<= META_ROWS_AROUND_ADDR
; i
++) {
454 char buffer
[4 + (BITS_PER_LONG
/ 8) * 2];
455 char metadata
[META_BYTES_PER_ROW
];
457 snprintf(buffer
, sizeof(buffer
),
458 (i
== 0) ? ">%px: " : " %px: ", row
);
461 * We should not pass a shadow pointer to generic
462 * function, because generic functions may try to
463 * access kasan mapping for the passed address.
465 kasan_metadata_fetch_row(&metadata
[0], row
);
467 print_hex_dump(KERN_ERR
, buffer
,
468 DUMP_PREFIX_NONE
, META_BYTES_PER_ROW
, 1,
469 metadata
, META_BYTES_PER_ROW
, 0);
471 if (meta_row_is_guilty(row
, addr
))
472 pr_err("%*c\n", meta_pointer_offset(row
, addr
), '^');
474 row
+= META_MEM_BYTES_PER_ROW
;
478 static void print_report(struct kasan_report_info
*info
)
480 void *addr
= kasan_reset_tag((void *)info
->access_addr
);
481 u8 tag
= get_tag((void *)info
->access_addr
);
483 print_error_description(info
);
484 if (addr_has_metadata(addr
))
485 kasan_print_tags(tag
, info
->first_bad_addr
);
488 if (addr_has_metadata(addr
)) {
489 print_address_description(addr
, tag
, info
);
490 print_memory_metadata(info
->first_bad_addr
);
492 dump_stack_lvl(KERN_ERR
);
496 static void complete_report_info(struct kasan_report_info
*info
)
498 void *addr
= kasan_reset_tag((void *)info
->access_addr
);
501 if (info
->type
== KASAN_REPORT_ACCESS
)
502 info
->first_bad_addr
= kasan_find_first_bad_addr(
503 (void *)info
->access_addr
, info
->access_size
);
505 info
->first_bad_addr
= addr
;
507 slab
= kasan_addr_to_slab(addr
);
509 info
->cache
= slab
->slab_cache
;
510 info
->object
= nearest_obj(info
->cache
, slab
, addr
);
512 /* Try to determine allocation size based on the metadata. */
513 info
->alloc_size
= kasan_get_alloc_size(info
->object
, info
->cache
);
514 /* Fallback to the object size if failed. */
515 if (!info
->alloc_size
)
516 info
->alloc_size
= info
->cache
->object_size
;
518 info
->cache
= info
->object
= NULL
;
520 switch (info
->type
) {
521 case KASAN_REPORT_INVALID_FREE
:
522 info
->bug_type
= "invalid-free";
524 case KASAN_REPORT_DOUBLE_FREE
:
525 info
->bug_type
= "double-free";
528 /* bug_type filled in by kasan_complete_mode_report_info. */
532 /* Fill in mode-specific report info fields. */
533 kasan_complete_mode_report_info(info
);
536 void kasan_report_invalid_free(void *ptr
, unsigned long ip
, enum kasan_report_type type
)
539 struct kasan_report_info info
;
542 * Do not check report_suppressed_sw(), as an invalid-free cannot be
543 * caused by accessing poisoned memory and thus should not be suppressed
544 * by kasan_disable/enable_current() critical sections.
546 * Note that for Hardware Tag-Based KASAN, kasan_report_invalid_free()
547 * is triggered by explicit tag checks and not by the ones performed by
548 * the CPU. Thus, reporting invalid-free is not suppressed as well.
550 if (unlikely(!report_enabled()))
553 start_report(&flags
, true);
555 __memset(&info
, 0, sizeof(info
));
557 info
.access_addr
= ptr
;
558 info
.access_size
= 0;
559 info
.is_write
= false;
562 complete_report_info(&info
);
567 * Invalid free is considered a "write" since the allocator's metadata
568 * updates involves writes.
570 end_report(&flags
, ptr
, true);
574 * kasan_report() is the only reporting function that uses
575 * user_access_save/restore(): kasan_report_invalid_free() cannot be called
576 * from a UACCESS region, and kasan_report_async() is not used on x86.
578 bool kasan_report(const void *addr
, size_t size
, bool is_write
,
582 unsigned long ua_flags
= user_access_save();
583 unsigned long irq_flags
;
584 struct kasan_report_info info
;
586 if (unlikely(report_suppressed_sw()) || unlikely(!report_enabled())) {
591 start_report(&irq_flags
, true);
593 __memset(&info
, 0, sizeof(info
));
594 info
.type
= KASAN_REPORT_ACCESS
;
595 info
.access_addr
= addr
;
596 info
.access_size
= size
;
597 info
.is_write
= is_write
;
600 complete_report_info(&info
);
604 end_report(&irq_flags
, (void *)addr
, is_write
);
607 user_access_restore(ua_flags
);
612 #ifdef CONFIG_KASAN_HW_TAGS
613 void kasan_report_async(void)
618 * Do not check report_suppressed_sw(), as
619 * kasan_disable/enable_current() critical sections do not affect
620 * Hardware Tag-Based KASAN.
622 if (unlikely(!report_enabled()))
625 start_report(&flags
, false);
626 pr_err("BUG: KASAN: invalid-access\n");
627 pr_err("Asynchronous fault: no details available\n");
629 dump_stack_lvl(KERN_ERR
);
631 * Conservatively set is_write=true, because no details are available.
632 * In this mode, kasan.fault=panic_on_write is like kasan.fault=panic.
634 end_report(&flags
, NULL
, true);
636 #endif /* CONFIG_KASAN_HW_TAGS */
638 #if defined(CONFIG_KASAN_GENERIC) || defined(CONFIG_KASAN_SW_TAGS)
640 * With compiler-based KASAN modes, accesses to bogus pointers (outside of the
641 * mapped kernel address space regions) cause faults when KASAN tries to check
642 * the shadow memory before the actual memory access. This results in cryptic
643 * GPF reports, which are hard for users to interpret. This hook helps users to
644 * figure out what the original bogus pointer was.
646 void kasan_non_canonical_hook(unsigned long addr
)
648 unsigned long orig_addr
;
649 const char *bug_type
;
652 * All addresses that came as a result of the memory-to-shadow mapping
653 * (even for bogus pointers) must be >= KASAN_SHADOW_OFFSET.
655 if (addr
< KASAN_SHADOW_OFFSET
)
658 orig_addr
= (unsigned long)kasan_shadow_to_mem((void *)addr
);
661 * For faults near the shadow address for NULL, we can be fairly certain
662 * that this is a KASAN shadow memory access.
663 * For faults that correspond to the shadow for low or high canonical
664 * addresses, we can still be pretty sure: these shadow regions are a
665 * fairly narrow chunk of the address space.
666 * But the shadow for non-canonical addresses is a really large chunk
667 * of the address space. For this case, we still print the decoded
668 * address, but make it clear that this is not necessarily what's
671 if (orig_addr
< PAGE_SIZE
)
672 bug_type
= "null-ptr-deref";
673 else if (orig_addr
< TASK_SIZE
)
674 bug_type
= "probably user-memory-access";
675 else if (addr_in_shadow((void *)addr
))
676 bug_type
= "probably wild-memory-access";
678 bug_type
= "maybe wild-memory-access";
679 pr_alert("KASAN: %s in range [0x%016lx-0x%016lx]\n", bug_type
,
680 orig_addr
, orig_addr
+ KASAN_GRANULE_SIZE
- 1);