[PATCH v4 0/3] mm: zswap: free cold writeback folios promptly
From: Alexandre Ghiti
Date: Tue Aug 25 2026 - 10:08:34 EST
When zswap writes an entry back, it allocates an order-0 swap cache folio,
decompresses into it, and issues the write. The folio is cold by
construction, yet today it is left on the LRU for page reclaim to find and
free later. That wastes a reclaim scan and keeps cold memory resident
longer than necessary.
Rather than implement this in zswap, extend the existing dropbehind
mechanism to swap cache folios and have zswap opt into it (Yosry). A
PG_dropbehind folio is already dropped from its cache once writeback
completes instead of being left for reclaim; for a swap cache folio that
"drop" is removing it from the swap cache.
Patch 1 - move LRU insertion out of the swap cache allocator into its
callers, so zswap writeback can allocate off the LRU.
Patch 2 - drop dropbehind swap cache folios on writeback completion.
Patch 3 - zswap allocates its writeback folio off the LRU and marks it
dropbehind, opting into the mechanism above.
Note: patch 1 also appears as patch 1 of the zswap writeback refault
series [1]. It is the same patch. Both series need it and both are meant
to apply on their own, so it is posted in each; whichever lands first, the
other should drop it.
This version is based on Linus' tree rather than mm-unstable, because it
builds on Tal Zussman's BIO_COMPLETE_IN_TASK work merged in the 7.3 block
pull, which has not reached the mm tree yet. Thanks to Matthew and Barry for
pointing out this series!
v1: https://lore.kernel.org/linux-mm/20260718093723.153324-1-alex@xxxxxxxx/
v2: https://lore.kernel.org/linux-mm/20260727143618.1582318-1-alex@xxxxxxxx/
v3: https://lore.kernel.org/linux-mm/20260818163221.589352-1-alex@xxxxxxxx/
[1] https://lore.kernel.org/linux-mm/20260821093606.2231216-1-alex@xxxxxxxx/
Changes in v4:
- Rebase on BIO_COMPLETE_IN_TASK: set it on dropbehind swap writeback like
the file dropbehind paths do, and drop the folio directly from
folio_end_writeback(). This removes the per-CPU llist, the workqueue and
the reuse of folio->lru as the list node.
- zswap now drops its folio reference before starting writeback, so the
swap cache holds the only one and remove_mapping() sees the refcount it
expects. This fixes the drop on synchronous-IO devices and the race
Sashiko reported, where the drop could run before zswap released its
reference and fall back to the LRU. Verified on zram (the only
SWP_SYNCHRONOUS_IO backend I have): over ~6.7M writebacks per run, 99.999%
of the folios are dropped, and the refcount fallback fires 37-50 times.
- Use remove_mapping_reclaim() rather than adding a boolean argument to
remove_mapping(), which keeps the calling code readable (David). This also
leaves the existing remove_mapping() callers untouched.
- Patch 1: correct the changelog. The folio has to stay off the LRU because
folio_add_lru() leaves a reference in the per-CPU LRU batch, not because
of the free-time page-flag checks. Measured on zram, adding the folio to
the LRU instead drops the freed rate from 99.999% to 2.7%.
Changes in v3:
- Drop the synchronous-IO special case in zswap writeback (Yosry, Nhat).
- Use mem_cgroup_tryget()/mem_cgroup_put(): struct mem_cgroup is only
defined under CONFIG_MEMCG, so css_tryget()/css_put() failed to build
with CONFIG_MEMCG=n.
Changes in v2:
- Make swap dropbehind a generic core-mm mechanism that zswap opts into,
rather than a zswap-specific implementation (Yosry).
- Allocate off the LRU by moving folio_add_lru() out of the swap cache
allocator into its callers; rename it to __swap_cache_alloc_folio()
(Kairui).
- Skip the folio in the free path if it is still under writeback (Nhat).
Results
-------
Paired baseline vs series on async swap (NVMe). Each
workload runs confined to a memory cgroup (memory.max) small enough to force
zswap shrinker writeback.
Kernel build (defconfig, make -j4; memory.max = 600M):
metric baseline series delta
pgrotated 441028 2521 -99.4%
pgsteal_direct 3524343 2869004 -18.6%
pgscan_direct 8393791 7765008 -7.5%
zswpwb 705129 699019 -0.9%
build time (s) 1155 1114 -3.6%
Of the 699019 folios written back, 698990 (99.996%) were freed promptly on
writeback completion; only 28 fell back to reclaim.
MySQL/OLTP (sysbench, 10 tables x 1M rows, 512M buffer pool, 8 threads, 300s;
memory.max = 256M):
metric baseline series delta
transactions/s 153.87 163.30 +6.1%
p95 latency (ms) 157.42 145.82 -7.4%
avg latency (ms) 52.09 49.05 -5.9%
pgrotated 743738 22460 -97.0%
pgsteal_direct 6886490 5445278 -20.9%
pgscan_direct 13462510 10820730 -19.6%
Future work
-----------
Barry suggested extending this to MADV_PAGEOUT and general reclaim. I
prototyped dropbehind for all reclaimed swap folios and it regressed
sysbench OLTP throughput by ~15% on NVMe swap: dropping the swap cache
immediately turns cheap in-cache refaults into disk reads and collapses
swap readahead clustering. Neither blk-wbt, mq-deadline nor a PG_workingset
gate recovered it. MADV_PAGEOUT alone may still be worth it, since there
userspace has explicitly declared the range cold, but I have not measured
that case in isolation yet.
Alexandre Ghiti (3):
mm: swap: move LRU insertion out of the swap cache allocator
mm: swap: drop dropbehind swap cache folios on writeback completion
mm: zswap: drop cold writeback folios via swap dropbehind
include/linux/swap.h | 5 ++++
mm/filemap.c | 19 ++++++++++++++
mm/page_io.c | 7 +++++
mm/swap.h | 6 ++---
mm/swap_state.c | 61 ++++++++++++++++++++++++++++++++++++++------
mm/vmscan.c | 48 ++++++++++++++++++++++++++--------
mm/zswap.c | 22 +++++++++++++---
7 files changed, 143 insertions(+), 25 deletions(-)
base-commit: 55ab7e14222e5f0b0fd9f7711ca391d2924b35e3
--
2.53.0-Meta