[PATCH v3 10/14] x86: Update the KASAN non-canonical hook

From: Maciej Wieczor-Retman
Date: Fri Apr 04 2025 - 09:19:29 EST


The kasan_non_canonical_hook() is useful in pointing out that an address
which caused some kind of error could be the result of
kasan_mem_to_shadow() mapping. Currently it's called only in the general
protection handler code path but can give helpful information also in
page fault oops reports.

For example consider a page fault for address 0xffdefc0000000000 on a
5-level paging system. It could have been accessed from KASAN's
kasan_mem_to_shadow() called on 0xfef0000000000000 address. Without the
kasan_non_canonical_hook() in the page fault case it might be hard to
figure out why an error occurred.

Add kasan_non_canonical_hook() to the beginning of show_fault_oops().

Update kasan_non_canonical_hook() to take into account the possible
memory to shadow mappings in the software tag-based mode of x86.

Patch was tested with positive results by accessing the following
addresses, causing #GPs and #PFs.

Valid mappings (showing kasan_non_canonical_hook() message):
0xFFFFFFFF8FFFFFFF
0xFEF0000000000000
0x7FFFFF4FFFFFFFFF
0x7EF0000000000000
Invalid mappings (not showing kasan_non_canonical_hook() message):
0xFFFFFFFFF8FFFFFF
0xFFBFFC0000000000
0x07EFFC0000000000
0x000E000000000000

Signed-off-by: Maciej Wieczor-Retman <maciej.wieczor-retman@xxxxxxxxx>
---
Changelog v3:
- Move the report.c part from first patch in the series to this new
patch to have x86 changes in one place.
- Add the call in fault oops.
- Extend the comment in report.c with a graphical representation of what
addresses are valid and invalid in memory to shadow mapping.

arch/x86/mm/fault.c | 2 ++
mm/kasan/report.c | 36 +++++++++++++++++++++++++++++++++++-
2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/arch/x86/mm/fault.c b/arch/x86/mm/fault.c
index 697432f63c59..16366af60ae5 100644
--- a/arch/x86/mm/fault.c
+++ b/arch/x86/mm/fault.c
@@ -511,6 +511,8 @@ show_fault_oops(struct pt_regs *regs, unsigned long error_code, unsigned long ad
if (!oops_may_print())
return;

+ kasan_non_canonical_hook(address);
+
if (error_code & X86_PF_INSTR) {
unsigned int level;
bool nx, rw;
diff --git a/mm/kasan/report.c b/mm/kasan/report.c
index f24f11cc644a..135307c93c2c 100644
--- a/mm/kasan/report.c
+++ b/mm/kasan/report.c
@@ -700,7 +700,7 @@ void kasan_non_canonical_hook(unsigned long addr)
* operation would overflow only for some memory addresses. However, due
* to the chosen KASAN_SHADOW_OFFSET values and the fact the
* kasan_mem_to_shadow() only operates on pointers with the tag reset,
- * the overflow always happens.
+ * the overflow always happens (for both x86 and arm64).
*
* For arm64, the top byte of the pointer gets reset to 0xFF. Thus, the
* possible shadow addresses belong to a region that is the result of
@@ -715,6 +715,40 @@ void kasan_non_canonical_hook(unsigned long addr)
return;
}

+ /*
+ * For x86-64, only the pointer bits [62:57] get reset, and bits #63
+ * and #56 can be 0 or 1. Thus, kasan_mem_to_shadow() can be possibly
+ * applied to two regions of memory:
+ * [0x7E00000000000000, 0x7FFFFFFFFFFFFFFF] and
+ * [0xFE00000000000000, 0xFFFFFFFFFFFFFFFF]. As the overflow happens
+ * for both ends of both memory ranges, both possible shadow regions
+ * are contiguous.
+ *
+ * Given the KASAN_SHADOW_OFFSET equal to 0xffeffc0000000000, the
+ * following ranges are valid mem-to-shadow mappings:
+ *
+ * 0xFFFFFFFFFFFFFFFF
+ * INVALID
+ * 0xFFEFFBFFFFFFFFFF - kasan_mem_to_shadow(~0UL)
+ * VALID - kasan shadow mem
+ * VALID - non-canonical kernel virtual address
+ * 0xFFCFFC0000000000 - kasan_mem_to_shadow(0xFEUL << 56)
+ * INVALID
+ * 0x07EFFBFFFFFFFFFF - kasan_mem_to_shadow(~0UL >> 1)
+ * VALID - non-canonical user virtual addresses
+ * VALID - user addresses
+ * 0x07CFFC0000000000 - kasan_mem_to_shadow(0x7EUL << 56)
+ * INVALID
+ * 0x0000000000000000
+ */
+ if (IS_ENABLED(CONFIG_KASAN_SW_TAGS) && IS_ENABLED(CONFIG_X86_64)) {
+ if ((addr < (u64)kasan_mem_to_shadow((void *)(0x7EUL << 56)) ||
+ addr > (u64)kasan_mem_to_shadow((void *)(~0UL >> 1))) &&
+ (addr < (u64)kasan_mem_to_shadow((void *)(0xFEUL << 56)) ||
+ addr > (u64)kasan_mem_to_shadow((void *)(~0UL))))
+ return;
+ }
+
orig_addr = (unsigned long)kasan_shadow_to_mem((void *)addr);

/*
--
2.49.0