[PATCH RFC 10/19] mm: add definitions for allocating unmapped pages

From: Brendan Jackman

Date: Wed Feb 25 2026 - 11:42:52 EST


Create __GFP_UNMAPPED, which requests pages that are not present in the
direct map. Since this feature has a cost (e.g. more freelists), it's
behind a kconfig. Unlike other conditionally-defined GFP flags, it
doesn't fall back to being 0. This prevents building code that uses
__GFP_UNMAPPED but doesn't depend on the necessary kconfig, since that
would lead to invisible security issues.

Create a freetype flag to record that pages on the freelists with this
flag are unmapped. This is currently only needed for MIGRATE_UNMOVABLE
pages, so the freetype encoding remains trivial.

Also create the corresponding pageblock flag to record the same thing.

To keep patches from being too overwhelming, the actual implementation
is added separately, this is just types, Kconfig boilerplate, etc.

Signed-off-by: Brendan Jackman <jackmanb@xxxxxxxxxx>
---
include/linux/freetype.h | 41 +++++++++++++++++++++++++++++++++--------
include/linux/gfp_types.h | 26 ++++++++++++++++++++++++++
include/trace/events/mmflags.h | 9 ++++++++-
mm/Kconfig | 4 ++++
4 files changed, 71 insertions(+), 9 deletions(-)

diff --git a/include/linux/freetype.h b/include/linux/freetype.h
index 11bd6d2b94349..3b0d41b8c857f 100644
--- a/include/linux/freetype.h
+++ b/include/linux/freetype.h
@@ -2,6 +2,7 @@
#ifndef _LINUX_FREETYPE_H
#define _LINUX_FREETYPE_H

+#include <linux/log2.h>
#include <linux/types.h>
#include <linux/mmdebug.h>

@@ -64,30 +65,56 @@ static inline bool migratetype_is_mergeable(int mt)
return mt < MIGRATE_PCPTYPES;
}

+enum {
+ /* Defined unconditionally as a hack to avoid a zero-width bitfield. */
+ FREETYPE_UNMAPPED_BIT,
+ NUM_FREETYPE_FLAGS,
+};
+
/*
* A freetype is the index used to identify free lists. This consists of a
* migratetype, and other bits which encode orthogonal properties of memory.
*/
typedef struct {
- int migratetype;
+ unsigned int migratetype : order_base_2(MIGRATE_TYPES);
+ unsigned int flags : NUM_FREETYPE_FLAGS;
} freetype_t;

+#ifdef CONFIG_PAGE_ALLOC_UNMAPPED
+#define FREETYPE_UNMAPPED BIT(FREETYPE_UNMAPPED_BIT)
+#define NUM_UNMAPPED_FREETYPES 1
+#else
+#define FREETYPE_UNMAPPED 0
+#define NUM_UNMAPPED_FREETYPES 0
+#endif
+
/*
* Return a dense linear index for freetypes that have lists in the free area.
* Return -1 for other freetypes.
*/
static inline int freetype_idx(freetype_t freetype)
{
+ /* For FREETYPE_UNMAPPED, only MIGRATE_UNMOVABLE has an index. */
+ if (freetype.flags & FREETYPE_UNMAPPED) {
+ VM_WARN_ON_ONCE(freetype.flags & ~FREETYPE_UNMAPPED);
+ if (!IS_ENABLED(CONFIG_PAGE_ALLOC_UNMAPPED))
+ return -1;
+ if (freetype.migratetype != MIGRATE_UNMOVABLE)
+ return -1;
+ return MIGRATE_TYPES;
+ }
+ /* No other flags are supported. */
+ VM_WARN_ON_ONCE(freetype.flags);
+
return freetype.migratetype;
}

-/* No freetype flags actually exist yet. */
-#define NR_FREETYPE_IDXS MIGRATE_TYPES
+/* One for each migratetype, plus one for MIGRATE_UNMOVABLE-FREETYPE_UNMAPPED */
+#define NR_FREETYPE_IDXS (MIGRATE_TYPES + NUM_UNMAPPED_FREETYPES)

static inline unsigned int freetype_flags(freetype_t freetype)
{
- /* No flags supported yet. */
- return 0;
+ return freetype.flags;
}

static inline bool freetypes_equal(freetype_t a, freetype_t b)
@@ -100,10 +127,8 @@ static inline freetype_t migrate_to_freetype(enum migratetype mt,
{
freetype_t freetype;

- /* No flags supported yet. */
- VM_WARN_ON_ONCE(flags);
-
freetype.migratetype = mt;
+ freetype.flags = flags;
return freetype;
}

diff --git a/include/linux/gfp_types.h b/include/linux/gfp_types.h
index 814bb2892f99b..1f4f49bacb5b4 100644
--- a/include/linux/gfp_types.h
+++ b/include/linux/gfp_types.h
@@ -56,6 +56,9 @@ enum {
___GFP_NOLOCKDEP_BIT,
#endif
___GFP_NO_OBJ_EXT_BIT,
+#ifdef CONFIG_PAGE_ALLOC_UNMAPPED
+ ___GFP_UNMAPPED_BIT,
+#endif
___GFP_LAST_BIT
};

@@ -97,6 +100,10 @@ enum {
#define ___GFP_NOLOCKDEP 0
#endif
#define ___GFP_NO_OBJ_EXT BIT(___GFP_NO_OBJ_EXT_BIT)
+#ifdef CONFIG_PAGE_ALLOC_UNMAPPED
+#define ___GFP_UNMAPPED BIT(___GFP_UNMAPPED_BIT)
+/* No #else - __GFP_UNMAPPED should never be a nop. Break the build if it isn't supported. */
+#endif

/*
* Physical address zone modifiers (see linux/mmzone.h - low four bits)
@@ -293,6 +300,25 @@ enum {
/* Disable lockdep for GFP context tracking */
#define __GFP_NOLOCKDEP ((__force gfp_t)___GFP_NOLOCKDEP)

+/*
+ * Allocate pages that aren't present in the direct map. If the caller changes
+ * direct map presence, it must be restored to the previous state before freeing
+ * the page. (This is true regardless of __GFP_UNMAPPED).
+ *
+ * This uses the mermap (when __GFP_ZERO), so it's only valid to allocate with
+ * this flag where that's valid, namely from process context after the mermap
+ * has been initialised for that process. This also means that the allocator
+ * leaves behind stale TLB entries in the mermap region. The caller is
+ * responsible for ensuring they are flushed as needed.
+ *
+ * This is currently incompatible with __GFP_MOVABLE and __GFP_RECLAIMABLE, but
+ * only because of allocator implementation details, if a usecase arises this
+ * restriction could be dropped.
+ */
+#ifdef CONFIG_PAGE_ALLOC_UNMAPPED
+#define __GFP_UNMAPPED ((__force gfp_t)___GFP_UNMAPPED)
+#endif
+
/* Room for N __GFP_FOO bits */
#define __GFP_BITS_SHIFT ___GFP_LAST_BIT
#define __GFP_BITS_MASK ((__force gfp_t)((1 << __GFP_BITS_SHIFT) - 1))
diff --git a/include/trace/events/mmflags.h b/include/trace/events/mmflags.h
index a6e5a44c9b429..bb365da355b3a 100644
--- a/include/trace/events/mmflags.h
+++ b/include/trace/events/mmflags.h
@@ -61,11 +61,18 @@
# define TRACE_GFP_FLAGS_SLAB
#endif

+#ifdef CONFIG_PAGE_ALLOC_UNMAPPED
+# define TRACE_GFP_FLAGS_UNMAPPED TRACE_GFP_EM(UNMAPPED)
+#else
+# define TRACE_GFP_FLAGS_UNMAPPED
+#endif
+
#define TRACE_GFP_FLAGS \
TRACE_GFP_FLAGS_GENERAL \
TRACE_GFP_FLAGS_KASAN \
TRACE_GFP_FLAGS_LOCKDEP \
- TRACE_GFP_FLAGS_SLAB
+ TRACE_GFP_FLAGS_SLAB \
+ TRACE_GFP_FLAGS_UNMAPPED

#undef TRACE_GFP_EM
#define TRACE_GFP_EM(a) TRACE_DEFINE_ENUM(___GFP_##a##_BIT);
diff --git a/mm/Kconfig b/mm/Kconfig
index bd49eb9ef2165..ccf1cda90cf4a 100644
--- a/mm/Kconfig
+++ b/mm/Kconfig
@@ -1503,3 +1503,7 @@ config MERMAP_KUNIT_TEST
If unsure, say N.

endmenu
+
+config PAGE_ALLOC_UNMAPPED
+ bool "Support allocating pages that aren't in the direct map" if COMPILE_TEST
+ default COMPILE_TEST

--
2.51.2