[PATCH v2 0/7] KMSAN: Move per-page metadata out of struct page

From: Muchun Song

Date: Tue Nov 17 2026 - 07:07:11 EST


This series fixes a KMSAN metadata-loss bug triggered when boot-time
gigantic HugeTLB pages reinitialize their page descriptors after
kmsan_init_shadow(). KMSAN currently stores each page's shadow and
origin pointers in struct page, so the later initialization drops the
metadata mappings and leaves their backing pages unreachable.

Preserving the pointers around the HugeTLB initialization would add
KMSAN-specific state handling to the memmap path. Moving
kmsan_init_shadow() later is not viable either, because it allocates
metadata from memblock while gigantic page descriptors are initialized
after memblock teardown.

Move the metadata pointers to page_ext instead. page_ext storage is
independent of struct page contents and is made available before
kmsan_init_shadow(), so later page-descriptor initialization cannot
erase the mappings.

The series first decouples KMSAN metadata access from its storage, then
makes page_ext safe and available during early boot, and finally moves
the metadata pointers. The move also shrinks struct page from 80 to 64
bytes on x86-64 KMSAN builds, allowing HugeTLB Vmemmap Optimization to
be used with KMSAN.

v2:
- Fetch shadow and origin through one masked metadata resolver
(suggested by Chris Down).
- Add a fix for pre-existing page_ext client misalignment.
- Use vmalloc for runtime SPARSEMEM page_ext backing
(suggested by Mike Rapoport).
- Unify page_ext allocation and initialization entry points and document
the later FLATMEM callback timing (noted by Chris Down).
- Allocate all boot-time SPARSEMEM page_ext from memblock
(suggested by Mike Rapoport).
- Keep memblock allocations above DMA and suppress per-section free
messages (suggested by Chris Down).
- Inline the unchecked page_ext lookup while keeping page_ext.c
instrumented (suggested by Chris Down).
- Update the KMSAN metadata documentation and describe HVO enablement
(suggested by Chris Down).
- Expand the series from three to seven patches.
- Drop all v1 Reviewed-by tags because the affected patches were
substantially reworked and split.

v1: https://lore.kernel.org/20261114104150.58424-1-songmuchun@xxxxxxxxxxxxx/

Muchun Song (7):
kmsan: encapsulate per-page metadata access
mm/page_ext: fix client data alignment
mm/page_ext: always use vmalloc for section page extensions
mm/page_ext: use common allocation and initialization entry points
mm/page_ext: allocate page extensions early for SPARSEMEM
mm/page_ext: inline unchecked page extension lookup
kmsan: fix metadata loss during HugeTLB struct page reinitialization

Documentation/dev-tools/kmsan.rst | 8 +-
include/linux/kmsan.h | 2 +
include/linux/mm.h | 12 +-
include/linux/mm_types.h | 12 --
include/linux/page_ext.h | 61 +++++++--
lib/Kconfig.kmsan | 1 +
mm/kmsan/shadow.c | 199 +++++++++++++++++++--------
mm/mm_init.c | 11 +-
mm/page_ext.c | 218 ++++++++++++------------------
9 files changed, 286 insertions(+), 238 deletions(-)


base-commit: 67f3b04b277373438f17300e056306adbd9edf7b
--
2.54.0