swap_put_entries_cluster(9)

📦 version 7.3.1, in nixpkgs unstable

💅 swap_put_entries_cluster — bestie's guide to dropping swap counts 💅

okay so this is a page from the Kernel API Manual, and we're talking about swap_put_entries_cluster(9) — the little helper that decreases the swap count of slots inside one cluster. she's giving cleanup crew, she's giving "let me handle that for you", and honestly? obsessed. ✨

🌸 NAME 🌸

swap_put_entries_cluster — decrease the swap count of slots within one cluster 🎀

like literally, that's her whole job. one cluster, a bunch of slots, counts go down. periodt.

✨ SYNOPSIS ✨

void swap_put_entries_cluster (struct swap_info_struct *si , pgoff_t
offset , int nr , bool reclaim_cache );

yeah she returns void, no cap — nothing comes back, she just does the thing and dips. 💅

🦋 ARGUMENTS 🦋

  • si — the swap device, aka the main character of this whole operation. this is the struct swap_info_struct * she's working on. 🫶
  • offset — start offset of slots. like where the party begins, pgoff_t style. 📍
  • nr — number of slots. how many we're doing, int. the more the merrier, honestly.
  • reclaim_cache — a bool, and here's the tea: if it's true, she also reclaims the swap cache when slots are freed. so it's not just the counts going down, it's the cache getting tidied too. double duty, iconic. 🔥

💖 DESCRIPTION 💖

so basically — this helper decreases the swap count of a set of slots, and she tries to batch free them. like, not one at a time like some kind of peasant, but batched. efficiency queen. 👑

and also (as if that wasn't enough), she reclaims the swap cache if reclaim_cache is true. so yeah. she does the counts, she does the freeing, and if you asked nicely with that true, she does the cache reclaim too. it's giving full service. 🌈

⭐ CONTEXT ⭐

hiii, important safety moment bestie 🚨 — the specified slots must be pinned by an existing swap count or a swap cache reference. that's the whole vibe. because of that pinning, they won't be released until this helper returns. so like, no funny business, no slots disappearing mid-call. she returns, then things can let go. iykyk. 💀

🧚 SEE ALSO 🧚

the kernel file ./mm/swapfile.c is where she lives, and here's her whole friend group — go say hi:

not a single one skipped, we respect the whole squad. 🫶💜

and that's the page!! 🎀 she's sourced from ./mm, dated October 2026, and yeah — this whole writeup is swap_put_entries_cluster(9) and nothing else. mwah. 💋✨

📦 where this page comes from