[PATCH 03/22] mm: introduce the common-memory node state

From: Gregory Price (Meta)

Date: Sat Nov 14 2026 - 02:10:43 EST


N_MEMORY is overloaded with two meanings:
1) a node has memory.
2) a node's memory is reachable via ordinary allocation or
an arbitrary MM service may use that memory.

Allow N_MEMORY to mean #1, and introduce N_MEMORY_COMMON to mean #2.

N_MEMORY_COMMON nodes contain "common memory" capable of being managed
arbitrarily by the kernel MM based solely on zone membership. Following
commits convert relevant N_MEMORY users to N_MEMORY_COMMON.

Add folio_is_common_memory() and page_is_common_memory() for MM services
that walk folios. Following commits convert folio_is_zone_device() and
page_is_zone_device() callers accordingly.

Expose the state via `has_common_memory` so userspace can identify
the memory available to ordinary allocations and common MM services.

Add has_memory to the docs while we're here.

Every node with memory is common, so N_MEMORY_COMMON equals N_MEMORY
and there is no behavioral change.

Signed-off-by: Gregory Price (Meta) <gourry@xxxxxxxxxx>
---
Documentation/ABI/stable/sysfs-devices-node | 16 ++++++++++++++++
Documentation/mm/physical_memory.rst | 8 +++++++-
drivers/base/node.c | 2 ++
include/linux/nodemask.h | 9 ++++++++-
mm/internal.h | 15 +++++++++++++++
mm/page_alloc.c | 3 +++
6 files changed, 51 insertions(+), 2 deletions(-)

diff --git a/Documentation/ABI/stable/sysfs-devices-node b/Documentation/ABI/stable/sysfs-devices-node
index 2d0e023f22a71..a93de328f8fe8 100644
--- a/Documentation/ABI/stable/sysfs-devices-node
+++ b/Documentation/ABI/stable/sysfs-devices-node
@@ -10,6 +10,15 @@ Contact: Linux Memory Management list <linux-mm@xxxxxxxxx>
Description:
Nodes that are online.

+What: /sys/devices/system/node/has_memory
+Date: December 2012
+Contact: Linux Memory Management list <linux-mm@xxxxxxxxx>
+Description:
+ Nodes that have memory.
+
+ This memory may or may not be reachable via standard
+ allocations, see has_common_memory for details.
+
What: /sys/devices/system/node/has_normal_memory
Date: October 2002
Contact: Linux Memory Management list <linux-mm@xxxxxxxxx>
@@ -29,6 +38,13 @@ Description:
Nodes that have regular or high memory.
Depends on CONFIG_HIGHMEM.

+What: /sys/devices/system/node/has_common_memory
+Date: November 2026
+Contact: Linux Memory Management list <linux-mm@xxxxxxxxx>
+Description:
+ Nodes whose memory ordinary allocations may use without
+ requesting the node explicitly.
+
What: /sys/devices/system/node/nodeX
Date: October 2002
Contact: Linux Memory Management list <linux-mm@xxxxxxxxx>
diff --git a/Documentation/mm/physical_memory.rst b/Documentation/mm/physical_memory.rst
index 2e67e8b23a994..fd5c5d136180f 100644
--- a/Documentation/mm/physical_memory.rst
+++ b/Documentation/mm/physical_memory.rst
@@ -168,7 +168,12 @@ nodes with particular properties as defined by ``enum node_states``:
The node has regular or high memory. When ``CONFIG_HIGHMEM`` is disabled
aliased to ``N_NORMAL_MEMORY``.
``N_MEMORY``
- The node has memory(regular, high, movable)
+ The node has online memory (regular, high, movable). This is a topology and
+ accounting state. Presence in this mask does not mean ordinary allocations
+ can use the node's memory; see ``N_MEMORY_COMMON``.
+``N_MEMORY_COMMON``
+ The node is on the page allocator's fallback zonelists, so an allocation
+ that named no node can be satisfied from it.
``N_CPU``
The node has one or more CPUs
``N_GENERIC_INITIATOR``
@@ -184,6 +189,7 @@ For example, for node 2 with normal memory and CPUs, bit 2 will be set in ::
node_states[N_NORMAL_MEMORY]
node_states[N_HIGH_MEMORY]
node_states[N_MEMORY]
+ node_states[N_MEMORY_COMMON]
node_states[N_CPU]

For various operations possible with nodemasks please refer to
diff --git a/drivers/base/node.c b/drivers/base/node.c
index dcdc8626627a8..cc6696d1390f3 100644
--- a/drivers/base/node.c
+++ b/drivers/base/node.c
@@ -965,6 +965,7 @@ static struct node_attr node_state_attr[] = {
[N_HIGH_MEMORY] = _NODE_ATTR(has_high_memory, N_HIGH_MEMORY),
#endif
[N_MEMORY] = _NODE_ATTR(has_memory, N_MEMORY),
+ [N_MEMORY_COMMON] = _NODE_ATTR(has_common_memory, N_MEMORY_COMMON),
[N_CPU] = _NODE_ATTR(has_cpu, N_CPU),
[N_GENERIC_INITIATOR] = _NODE_ATTR(has_generic_initiator,
N_GENERIC_INITIATOR),
@@ -978,6 +979,7 @@ static struct attribute *node_state_attrs[] = {
&node_state_attr[N_HIGH_MEMORY].attr.attr,
#endif
&node_state_attr[N_MEMORY].attr.attr,
+ &node_state_attr[N_MEMORY_COMMON].attr.attr,
&node_state_attr[N_CPU].attr.attr,
&node_state_attr[N_GENERIC_INITIATOR].attr.attr,
NULL
diff --git a/include/linux/nodemask.h b/include/linux/nodemask.h
index 28a456c3f5964..7ace610bdd654 100644
--- a/include/linux/nodemask.h
+++ b/include/linux/nodemask.h
@@ -402,7 +402,14 @@ enum node_states {
#else
N_HIGH_MEMORY = N_NORMAL_MEMORY,
#endif
- N_MEMORY, /* The node has memory(regular, high, movable) */
+ /*
+ * N_MEMORY indicates online memory exists on the node - it is used
+ * to manage per-node meta-data and topology decisions.
+ * N_MEMORY_COMMON indicates whether the node can satisfy arbitrary
+ * allocations and whether a service should manage that node's folios.
+ */
+ N_MEMORY, /* the node has memory */
+ N_MEMORY_COMMON, /* common pool (fallback zonelist) */
N_CPU, /* The node has one or more cpus */
N_GENERIC_INITIATOR, /* The node has one or more Generic Initiators */
NR_NODE_STATES
diff --git a/mm/internal.h b/mm/internal.h
index 608a83c34c224..af6fc27a9fc98 100644
--- a/mm/internal.h
+++ b/mm/internal.h
@@ -65,6 +65,21 @@ void folio_mark_lazyfree(struct folio *folio);
void node_set_memory_state(int nid, bool high, bool normal);
void node_clear_memory_state(int nid);

+/*
+ * Common memory is available to generic MM services. ZONE_DEVICE folios do
+ * not qualify even when their NUMA node is common.
+ */
+static inline bool folio_is_common_memory(struct folio *folio)
+{
+ return !folio_is_zone_device(folio) &&
+ node_state(folio_nid(folio), N_MEMORY_COMMON);
+}
+
+static inline bool page_is_common_memory(struct page *page)
+{
+ return folio_is_common_memory(page_folio(page));
+}
+
/* mm/vmscan.c */
unsigned long zone_reclaimable_pages(struct zone *zone);
unsigned long try_to_free_pages(struct zonelist *zonelist, int order,
diff --git a/mm/page_alloc.c b/mm/page_alloc.c
index 834d199ff8429..6ffa972811462 100644
--- a/mm/page_alloc.c
+++ b/mm/page_alloc.c
@@ -203,6 +203,7 @@ nodemask_t node_states[NR_NODE_STATES] __read_mostly = {
[N_HIGH_MEMORY] = { { [0] = 1UL } },
#endif
[N_MEMORY] = { { [0] = 1UL } },
+ [N_MEMORY_COMMON] = { { [0] = 1UL } },
[N_CPU] = { { [0] = 1UL } },
#endif /* NUMA */
};
@@ -215,10 +216,12 @@ void __meminit node_set_memory_state(int nid, bool high, bool normal)
node_set_state(nid, N_HIGH_MEMORY);
if (normal)
node_set_state(nid, N_NORMAL_MEMORY);
+ node_set_state(nid, N_MEMORY_COMMON);
}

void __meminit node_clear_memory_state(int nid)
{
+ node_clear_state(nid, N_MEMORY_COMMON);
node_clear_state(nid, N_NORMAL_MEMORY);
node_clear_state(nid, N_MEMORY);
}
--
2.53.1-Meta