mm: workingset: fix the shadow node budget under MGLRU
Subsystems (6)
v5 cover mm: workingset: fix the shadow node budget under MGLRU
From: Hui Zhu <[email protected]>
Commit 7404bd37cfbe ("mm: workingset: use lruvec_lru_size() to get the number of lru pages") broke the workingset shadow node budget under
MGLRU: lruvec_lru_size() reads mz->lru_zone_size, which MGLRU never maintains, so count_shadow_nodes() sees the evictable LRU lists as empty and the shadow shrinker reclaims eviction tokens almost as fast as they are created, losing thrashing protection.
Patch 1 extends the dying-mcg stat redirection (previously cgroup v1 only) to all hierarchies, addressing the reparenting race that motivated 7404bd37cfbe.
Patch 2 then switches count_shadow_nodes() back to lruvec_page_state_local(), which both classic LRU and MGLRU maintain.
Patch 3 recovers the performance. Patch 1 added an unconditional rcu_read_lock() to the stat update fast path; patch 3 checks memcg_is_dying() first and takes the RCU lock only on the rare dying path.
Patch 4 closes an accounting gap that patch 2 makes visible: on cgroup v2, reparent_state_local() never moves the dying memcg's non-hierarchical lruvec stats to the parent, so the parent receives the uncharges without the matching charges and its state_local underflows. Patch 4 reparents those stats, mirroring cgroup v1.
Performance testing
===================
The test script and the raw results are available at [1].
Environment: 10-vCPU QEMU guest, 8 GiB RAM, cgroup v2; 7 runs per configuration, medians reported. Workloads:
w1-anon-churn: single-threaded anon fault/charge loop in a memcg
(MADV_DONTNEED + re-fault, no reclaim). Every touch is a real fault with charge and memcg stat updates, so it stresses exactly the fast path patch 1 changes. This is the meaningful signal: it is not reclaim-bound, so the small fast-path overhead is not drowned out.
w2-file-churn: file read loop under memory.high pressure
(reclaim-bound; the differences below are within run-to-run noise and are shown for completeness only).
w3-reparent: reparent accounting sanity check.
w1-anon-churn (pages/s):
classic LRU MGLRU base 4393028 4377122 patches 1-2 4385996 (-0.2%) 4352887 (-0.6%) patches 1-3 4381832 (-0.3%) 4377053 (+0.0%)
w2-file-churn (MB/s):
classic LRU MGLRU base 8277 8226 patches 1-2 8226 (-0.6%) 8123 (-1.3%) patches 1-3 8157 (-1.4%) 8294 (+0.8%)
w3-reparent passed on all kernels.
The small overhead visible with patches 1-2 comes from the redirection added by patch 1; patch 3 brings w1 back to the base level in both LRU configurations. The w2-file-churn differences are within run-to-run
noise: that workload is reclaim-bound and too noisy to expose the small fast-path overhead, so w1-anon-churn is the meaningful signal. Patch 4 only touches the memcg offline path and is not exercised by these workloads.
[1] https://gist.github.com/teawater/32f373ec41d185d840455eb167321a5a
Changelog:
v5:
According to the comments of Andrew, clarify the performance testing
section: the w2-file-churn differences are within run-to-run noise; w1-anon-churn is the meaningful signal.
v4:
According to the comments of Andrew, Fix "follow-up patch" to "preceding patch" in the commit message to match the reordered series. According to the comments of Sashiko, add patch 4 to reparent the non-hierarchical lruvec stats on cgroup v2 to fixing the state_local underflow.
v3:
According to the comments of Shakeel, reorder the series per review, add Fixes/Cc stable and the user-visible impact to patch 1.
Hui Zhu (4):
mm: memcg: redirect stats updates of dying memcgs for all hierarchies
mm: workingset: use lruvec_page_state_local() to count lru pages
mm: memcg: skip the RCU lock when the memcg is not dying
mm: memcg: reparent non-hierarchical lruvec stats on cgroup v2
mm/memcontrol-v1.h | 5 ++-- mm/memcontrol.c | 72 +++++++++++++++++++++++++--------------------- mm/workingset.c | 5 ++-- 3 files changed, 45 insertions(+), 37 deletions(-)
Signature · 1 line
2.43.0
PATCH v5 1/4 mm: memcg: redirect stats updates of dying memcgs for all hierarchies
From: Hui Zhu <[email protected]>
get_non_dying_memcg_start() redirects the stat updates of a dying memcg to its closest non-dying ancestor, but only on cgroup v1; on cgroup v2 the stats keep being accounted to the dying memcg itself.
A later patch in this series restores lruvec_page_state_local() in count_shadow_nodes() to fix the broken workingset shadow node budget under MGLRU. count_shadow_nodes() is the only reader of those non-hierarchical state_locals on cgroup v2: when a memcg is offlined, its pages are reparented to the ancestor but their stat updates keep being accounted to the dying memcg, so count_shadow_nodes() computes a wrong shadow node budget and workingset thrashing protection is lost. This is user visible as premature reclaim of hot page cache and degraded performance under memory pressure. Apply the redirection to all hierarchies to fix this.
Offlining is rare, so the added cost on the stat update fast path is limited to an rcu_read_lock() and a css_is_dying() check; the upward walk happens only while a memcg is dying.
--- mm/memcontrol.c | 30 +++++------------------------- 1 file changed, 5 insertions(+), 25 deletions(-)
mm/memcontrol.c +5 -25
@@ -845,20 +845,14 @@ static long memcg_state_val_in_pages(int idx, long val)return val <0 ? -res : res; } -#ifdef CONFIG_MEMCG_V1 /* -* Used in mod_memcg_state() and mod_memcg_lruvec_state() to avoid race with -* reparenting of non-hierarchical state_locals. +* Used in mod_memcg_state() and mod_memcg_lruvec_state() to avoid race +* with reparenting of non-hierarchical state_locals. Offlining a +* memcg is rare, so do the redirection for all cgroup hierarchies. */ -static inline struct mem_cgroup *get_non_dying_memcg_start (struct mem_cgroup *memcg, -bool *rcu_locked) +static inline struct mem_cgroup * +get_non_dying_memcg_start (struct mem_cgroup *memcg,bool *rcu_locked) { -/* Rebinding can cause this value to be changed at runtime */ -if (cgroup_subsys_on_dfl (memory_cgrp_subsys)) { - *rcu_locked = false; -return memcg; - } -rcu_read_lock (); *rcu_locked = true;
@@ -870,22 +864,8 @@ static inline struct mem_cgroup *get_non_dying_memcg_start(struct mem_cgroup *mestatic inline void get_non_dying_memcg_end (bool rcu_locked) { -if (!rcu_locked) -return ; -rcu_read_unlock (); } -#else -static inline struct mem_cgroup *get_non_dying_memcg_start (struct mem_cgroup *memcg, -bool *rcu_locked) -{ -return memcg; -} - -static inline void get_non_dying_memcg_end (bool rcu_locked) -{ -} -#endif static void __mod_memcg_state (struct mem_cgroup *memcg,enum memcg_stat_item idx,long val)
Signature · 1 line
2.43.0
PATCH v5 2/4 mm: workingset: use lruvec_page_state_local() to count lru pages
In reply to Hui ZhuFrom: Hui Zhu <[email protected]>
Commit 7404bd37cfbe ("mm: workingset: use lruvec_lru_size() to get the number of lru pages") switched count_shadow_nodes() to lruvec_lru_size(). With CONFIG_MEMCG enabled, lruvec_lru_size() reads mz->lru_zone_size, which only the classic LRU paths maintain. MGLRU accounts its pages through __update_lru_size(), which skips that array, so with MGLRU on the four evictable LRU lists are always seen as empty. The shadow node budget (pages >> 3) then collapses to slab plus unevictable pages, and the workingset shadow shrinker reclaims eviction tokens almost as fast as they are created, losing thrashing protection.
lruvec_page_state_local() reads lruvec_stats->state_local instead, which both classic LRU and MGLRU maintain. Switch back to it. The reparenting race this re-exposes on cgroup v2 is closed by the preceding patch that redirects dying-memcg stat updates for all hierarchies.
--- mm/workingset.c | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-)
mm/workingset.c +2 -3
@@ -688,10 +688,9 @@ static unsigned long count_shadow_nodes(struct shrinker *shrinker,mem_cgroup_flush_stats_ratelimited (sc->memcg); lruvec =mem_cgroup_lruvec (sc->memcg,NODE_DATA (sc->nid)); -for (pages =0 , i =0 ; i <NR_LRU_LISTS ; i++) - pages +=lruvec_lru_size (lruvec, i,MAX_NR_ZONES -1 ); - + pages +=lruvec_page_state_local (lruvec, +NR_LRU_BASE + i); pages +=lruvec_page_state_local ( lruvec,NR_SLAB_RECLAIMABLE_B ) >>PAGE_SHIFT ; pages += lruvec_page_state_local(
Signature · 1 line
2.43.0
Re: [PATCH v5 2/4] mm: workingset: use lruvec_page_state_local() to count lru pages
Quoted 13 lines · Hui Zhu
From: Hui Zhu <[email protected]>
Commit
7404bd37cfbe("mm: workingset: uselruvec_lru_size()to get the number of lru pages") switchedcount_shadow_nodes()tolruvec_lru_size(). WithCONFIG_MEMCGenabled,lruvec_lru_size()readsmz->lru_zone_size, which only the classic LRU paths maintain. MGLRU accounts its pages through__update_lru_size(), which skips that array, so with MGLRU on the four evictable LRU lists are always seen as empty. The shadow node budget (pages >> 3) then collapses to slab plus unevictable pages, and the workingset shadow shrinker reclaims eviction tokens almost as fast as they are created, losing thrashing protection.
Quoted 4 lines
lruvec_page_state_local()readslruvec_stats->state_localinstead, which both classic LRU and MGLRU maintain. Switch back to it. The reparenting race this re-exposes on cgroup v2 is closed by the preceding patch that redirects dying-memcg stat updates for all hierarchies.
Looks nice! thanks.
Quoted 14 lines
Fixes 7404bd37cfbe ("mm: workingset: use lruvec_lru_size() to get the number of lru pages")Signed-off-by Hui Zhu <[email protected]>Acked-by Shakeel Butt <[email protected]>--- mm/workingset.c | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-)mm/workingset.c +0
-0
mm/workingset.c static unsigned long count_shadow_nodes(struct shrinker *shrinker, · line 691
Quoted 4 lines
mm/workingset.c +0
-1@@ -688,10 +688,9 @@ static unsigned long count_shadow_nodes(struct shrinker *shrinker,mem_cgroup_flush_stats_ratelimited (sc->memcg); lruvec =mem_cgroup_lruvec (sc->memcg,NODE_DATA (sc->nid)); -
Blank line change is not necessary and I think it make the code a bit more ugly...
mm/workingset.c static unsigned long count_shadow_nodes(struct shrinker *shrinker, · line 696
Quoted 8 lines
mm/workingset.c +2
-2for (pages =0 , i =0 ; i <NR_LRU_LISTS ; i++) - pages +=lruvec_lru_size (lruvec, i,MAX_NR_ZONES -1 ); - + pages +=lruvec_page_state_local (lruvec, +NR_LRU_BASE + i); pages +=lruvec_page_state_local ( lruvec,NR_SLAB_RECLAIMABLE_B ) >>PAGE_SHIFT ; pages += lruvec_page_state_local(
Just a nit pick.
Re: [PATCH v5 2/4] mm: workingset: use lruvec_page_state_local() to count lru pages
In reply to Hui ZhuQuoted 18 lines · Hui Zhu
From: Hui Zhu <[email protected]>
Commit
7404bd37cfbe("mm: workingset: uselruvec_lru_size()to get the number of lru pages") switchedcount_shadow_nodes()tolruvec_lru_size(). WithCONFIG_MEMCGenabled,lruvec_lru_size()readsmz->lru_zone_size, which only the classic LRU paths maintain. MGLRU accounts its pages through__update_lru_size(), which skips that array, so with MGLRU on the four evictable LRU lists are always seen as empty. The shadow node budget (pages >> 3) then collapses to slab plus unevictable pages, and the workingset shadow shrinker reclaims eviction tokens almost as fast as they are created, losing thrashing protection.
lruvec_page_state_local()readslruvec_stats->state_localinstead, which both classic LRU and MGLRU maintain. Switch back to it. The reparenting race this re-exposes on cgroup v2 is closed by the preceding patch that redirects dying-memcg stat updates for all hierarchies.
Quoted 5 lines
Fixes 7404bd37cfbe ("mm: workingset: use lruvec_lru_size() to get the number of lru pages")Signed-off-by Hui Zhu <[email protected]>Acked-by Shakeel Butt <[email protected]>---
PATCH v5 3/4 mm: memcg: skip the RCU lock when the memcg is not dying
In reply to Hui ZhuFrom: Hui Zhu <[email protected]>
get_non_dying_memcg_start() takes rcu_read_lock() on every stat update, but the lock only protects the upward walk to a non-dying ancestor, which happens solely while a memcg is being offlined. The dying check itself reads the CSS_DYING flag of a memcg the caller already holds a reference to, so it is safe without the lock.
Check memcg_is_dying() first and return immediately when the memcg is alive, taking the RCU lock only on the rare dying path. On an anon fault/charge churn workload in a memcg this recovers the ~0.6% overhead added by the previous patch (4368077 vs 4343159 pages/s before, back to ~4377000 pages/s after).
--- mm/memcontrol.c | 14 ++++++++++++++ 1 file changed, 14 insertions(+)
mm/memcontrol.c +14 -0
@@ -853,6 +853,17 @@ static long memcg_state_val_in_pages(int idx, long val)static inline struct mem_cgroup *get_non_dying_memcg_start (struct mem_cgroup *memcg,bool *rcu_locked) { +/* +* Fast path: the caller holds a reference to @memcg, so reading +* its CSS_DYING flag without the RCU lock is safe. The RCU lock +* is only needed to walk up to a non-dying ancestor, which +* happens only while a memcg is actually being offlined. +*/ +if (!memcg_is_dying (memcg)) { + *rcu_locked = false; +return memcg; + } +rcu_read_lock (); *rcu_locked = true;
@@ -864,6 +875,9 @@ get_non_dying_memcg_start(struct mem_cgroup *memcg, bool *rcu_locked)static inline void get_non_dying_memcg_end (bool rcu_locked) { +if (!rcu_locked) +return ; +rcu_read_unlock (); }
Signature · 1 line
2.43.0
PATCH v5 4/4 mm: memcg: reparent non-hierarchical lruvec stats on cgroup v2
In reply to Hui ZhuFrom: Hui Zhu <[email protected]>
On cgroup v2, reparent_state_local() returns early and never moves the dying memcg's non-hierarchical state_local base counts to its parent. Meanwhile memcg_reparent_objcgs() rewrites objcg->memcg to the parent, so when the reparented folios are freed later, the negative deltas land on the parent's lruvec. The parent therefore receives the uncharges without ever having received the matching charges, and its state_local (NR_LRU_BASE + lru, MEMCG_SOCK, NR_SLAB_RECLAIMABLE_B, NR_SLAB_UNRECLAIMABLE_B) permanently underflows. Since lruvec_page_state_local() clamps negative values to zero, the underflow masks the parent's own legitimate pages.
count_shadow_nodes() is the only reader of these non-hierarchical state_locals on cgroup v2, so the underflow directly distorts the workingset shadow node budget.
Fix this by reparenting the lruvec state_locals on cgroup v2 as well, mirroring what cgroup v1 already does. Only the lruvec stats consumed by count_shadow_nodes() are moved; the memcg-level stats are left alone because on v2 they are exposed through the rstat hierarchical tree and are not read from state_local.
--- mm/memcontrol-v1.h | 5 +++-- mm/memcontrol.c | 42 ++++++++++++++++++++++++++++-------------- 2 files changed, 31 insertions(+), 16 deletions(-)
mm/memcontrol-v1.h +3 -2
@@ -25,6 +25,9 @@ int memory_stat_show(struct seq_file *m, void *v);struct mem_cgroup *mem_cgroup_private_id_get_online (struct mem_cgroup *memcg,unsigned int n); +void reparent_memcg_lruvec_state_local (struct mem_cgroup *memcg, +struct mem_cgroup *parent,int idx); +/* Cgroup v1-specific declarations */ #ifdef CONFIG_MEMCG_V1
@@ -73,8 +76,6 @@ void reparent_memcg1_lruvec_state_local(struct mem_cgroup *memcg, struct mem_cgrvoid reparent_memcg_state_local (struct mem_cgroup *memcg,struct mem_cgroup *parent,int idx); -void reparent_memcg_lruvec_state_local (struct mem_cgroup *memcg, -struct mem_cgroup *parent,int idx);void memcg1_account_kmem (struct mem_cgroup *memcg,int nr_pages);static inline bool memcg1_tcpmem_active (struct mem_cgroup *memcg)
mm/memcontrol.c +28 -14
73 lines not on this page · raw message
Signature · 1 line
2.43.0
Andrew Morton
maintainerQuoted 8 lines · On Fri, 11 Sep 2026 16:00:47 +0800 Hui Zhu <[email protected]> wrote:
From: Hui Zhu <[email protected]>
Commit
7404bd37cfbe("mm: workingset: uselruvec_lru_size()to get the number of lru pages") broke the workingset shadow node budget under
MGLRU:lruvec_lru_size()readsmz->lru_zone_size, which MGLRU never maintains, socount_shadow_nodes()sees the evictable LRU lists as empty and the shadow shrinker reclaims eviction tokens almost as fast as they are created, losing thrashing protection.
Thanks, I've updated mm.git to this version.
Quoted 11 lines
Changelog:
v5:
According to the comments of Andrew, clarify the performance testing
section: the w2-file-churn differences are within run-to-run noise; w1-anon-churn is the meaningful signal.
v4:
According to the comments of Andrew, Fix "follow-up patch" to "preceding patch" in the commit message to match the reordered series. According to the comments of Sashiko, add patch 4 to reparent the non-hierarchical lruvec stats on cgroup v2 to fixing thestate_localunderflow.
Here's how v5 (and v4) altered mm.git:
mm/memcontrol-v1.h | 5 +++-- mm/memcontrol.c | 42 ++++++++++++++++++++++++++++-------------- 2 files changed, 31 insertions(+), 16 deletions(-)
mm/memcontrol.c renamed from mm/memcontrol.c~b +28 -14
@@ -233,14 +233,29 @@ static inline struct obj_cgroup *__memcgreturn objcg; } -#ifdef CONFIG_MEMCG_V1 static void __mem_cgroup_flush_stats (struct mem_cgroup *memcg,bool force); -static inline void reparent_state_local (struct mem_cgroup *memcg,struct mem_cgroup *parent) +/* +* Reparent the non-hierarchical lruvec stats that count_shadow_nodes() reads +* to approximate the shadow node budget. They are not exposed to userspace +* on cgroup v2, but they must follow the reparented folios; otherwise the +* ancestor would only receive the negative deltas when the folios are freed +* without ever having received the positive base, and its local stats would +* permanently underflow. +*/ +static void reparent_v2_lruvec_state_local (struct mem_cgroup *memcg,struct mem_cgroup *parent) { -if (cgroup_subsys_on_dfl (memory_cgrp_subsys)) -return ; +int i; +for (i =0 ; i <NR_LRU_LISTS ; i++) +reparent_memcg_lruvec_state_local (memcg, parent,NR_LRU_BASE + i); + +reparent_memcg_lruvec_state_local (memcg, parent,NR_SLAB_RECLAIMABLE_B ); +reparent_memcg_lruvec_state_local (memcg, parent,NR_SLAB_UNRECLAIMABLE_B ); +} + +static inline void reparent_state_local (struct mem_cgroup *memcg,struct mem_cgroup *parent) +{/* * Reparent stats exposed non-hierarchically. Flush @memcg's stats first * to read its stats accurately , and conservatively flush @parent's
@@ -249,17 +264,18 @@ static inline void reparent_state_local(*/ __mem_cgroup_flush_stats (memcg, true); -/* The following counts are all non-hierarchical and need to be reparented. */ -reparent_memcg1_state_local (memcg, parent); -reparent_memcg1_lruvec_state_local (memcg, parent); +if (cgroup_subsys_on_dfl (memory_cgrp_subsys)) { +reparent_v2_lruvec_state_local (memcg, parent); + }else { +#ifdef CONFIG_MEMCG_V1 +/* The following counts are all non-hierarchical and need to be reparented. */ +reparent_memcg1_state_local (memcg, parent); +reparent_memcg1_lruvec_state_local (memcg, parent); +#endif + }__mem_cgroup_flush_stats (parent, true); } -#else -static inline void reparent_state_local (struct mem_cgroup *memcg,struct mem_cgroup *parent) -{ -} -#endif static inline void reparent_locks (struct mem_cgroup *memcg,struct mem_cgroup *parent,int nid) {
@@ -571,7 +587,6 @@ unsigned long lruvec_page_state_local(streturn x; } -#ifdef CONFIG_MEMCG_V1 static void __mod_memcg_lruvec_state (struct mem_cgroup_per_node *pn,enum node_stat_item idx,long val);
@@ -593,7 +608,6 @@ void reparent_memcg_lruvec_state_local(s__mod_memcg_lruvec_state (parent_pn, idx, value); } } -#endif /* Subset of vm_event_item to report for memcg event stats */ static const unsigned int memcg_vm_event_stat[] = {
mm/memcontrol-v1.h renamed from mm/memcontrol-v1.h~b +3 -2
@@ -25,6 +25,9 @@ int memory_stat_show(struct seq_file *m,struct mem_cgroup *mem_cgroup_private_id_get_online (struct mem_cgroup *memcg,unsigned int n); +void reparent_memcg_lruvec_state_local (struct mem_cgroup *memcg, +struct mem_cgroup *parent,int idx); +/* Cgroup v1-specific declarations */ #ifdef CONFIG_MEMCG_V1
@@ -67,8 +70,6 @@ void reparent_memcg1_lruvec_state_local(void reparent_memcg_state_local (struct mem_cgroup *memcg,struct mem_cgroup *parent,int idx); -void reparent_memcg_lruvec_state_local (struct mem_cgroup *memcg, -struct mem_cgroup *parent,int idx);void memcg1_account_kmem (struct mem_cgroup *memcg,int nr_pages);static inline bool memcg1_tcpmem_active (struct mem_cgroup *memcg)
_