[merged mm-stable] mm-zsmalloc-document-free_zspage-helper-variants.patch removed from -mm tree

Andrew Morton <[email protected]> Tue, 28 Jul 2026 21:14:57 -0700
Newsgroups org.kernel.vger.mm-commits
Message-ID <[email protected]>
The quilt patch titled
     Subject: mm/zsmalloc: document free_zspage helper variants
has been removed from the -mm tree.  Its filename was
     mm-zsmalloc-document-free_zspage-helper-variants.patch

This patch was dropped because it was merged into the mm-stable branch
of git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm

------------------------------------------------------
From: Wenchao Hao <[email protected]>
Subject: mm/zsmalloc: document free_zspage helper variants
Date: Fri, 26 Jun 2026 09:50:03 +0800

After splitting __free_zspage() into a lockless core and a wrapper that
does the class-stat bookkeeping, three similarly-named helpers coexist:
free_zspage / __free_zspage / __free_zspage_lockless.

Add a comment block above them describing what each does and where it is
used, so the names are not easy to confuse.

No functional change.

Link: https://lore.kernel.org/[email protected]
Signed-off-by: Wenchao Hao <[email protected]>
Suggested-by: Nhat Pham <[email protected]>
Reviewed-by: Nhat Pham <[email protected]>
Reviewed-by: Barry Song <[email protected]>
Cc: Joshua Hahn <[email protected]>
Cc: Minchan Kim <[email protected]>
Cc: Sergey Senozhatsky <[email protected]>
Cc: Xueyuan Chen <[email protected]>
Signed-off-by: Andrew Morton <[email protected]>
---

 mm/zsmalloc.c |   16 ++++++++++++++++
 1 file changed, 16 insertions(+)

--- a/mm/zsmalloc.c~mm-zsmalloc-document-free_zspage-helper-variants
+++ a/mm/zsmalloc.c
@@ -877,6 +877,22 @@ unlock:
 	return 0;
 }
 
+/*
+ * Three free helpers, kept apart here:
+ *
+ * __free_zspage_lockless(): bare core; walks zpdescs and returns pages
+ *   to the buddy allocator.  Caller owns all zpdesc locks and has
+ *   removed the zspage from its class list.  Used by zs_free() outside
+ *   class->lock so the buddy-side work does not stall the class.
+ *
+ * __free_zspage(): __free_zspage_lockless() + per-class accounting,
+ *   under class->lock.  Used by async_free_zspage(), the worker for
+ *   zspages whose trylock_zspage() failed.
+ *
+ * free_zspage(): full wrapper - trylock zpdescs, remove from class
+ *   list, call __free_zspage(); kicks deferred free on contention.
+ *   Used by compaction.
+ */
 static inline void __free_zspage_lockless(struct zspage *zspage)
 {
 	struct zpdesc *zpdesc, *next;
_

Patches currently in -mm which might be from [email protected] are