list_lru_walk_one(9)

📦 version 7.3.1, in nixpkgs unstable

💅 list_lru_walk_one (9) — Kernel API Manual 💅

okay bestie, welcome to the <pink>kernel API manual</pink> ✨ you're literally about to read the page for list_lru_walk_one, and honestly? it's giving "walk the LRU, isolate the freeable stuff, dispose of it" energy 🎀 let's get into it.

🌸 NAME 🌸

list_lru_walk_one — walk a @lru, isolating and disposing freeable items. periodt 💅

✨ SYNOPSIS ✨

unsigned long list_lru_walk_one (struct list_lru *lru , int nid , struct
mem_cgroup *memcg , list_lru_walk_cb isolate , void *cb_arg , unsigned
long *nr_to_walk );

like, that's the whole signature, no cap 🫶

🦋 ARGUMENTS 🦋

  • lru — the lru pointer. the main character of this whole function ngl 👑
  • nid — the node id you're scanning from. where we start, bestie 📍
  • memcg — the cgroup you're scanning from. yes, that one 💜
  • isolate — callback function that is responsible for deciding what to do with the item currently being scanned. the vibe check, essentially 🧚
  • cb_arg — opaque type that will be passed to isolate. it's a mystery to everyone except you, iykyk 🙈
  • nr_to_walk — how many items to scan. how many to scan, mind you, more on that in a sec 👀

💖 DESCRIPTION 💖

so this function will scan <purple>all elements in a particular lru</purple>, calling the isolate callback for each of those items, along with the current list spinlock and a caller-provided opaque. yes, every single one of them ✨

the isolate callback can choose to drop the lock internally — but it *must* return with the lock held. like, that's the rule, that's the whole deal, no exceptions 🔥

the callback will return an enum lru_status telling the lru infrastructure what to do with the object being scanned. it's literally the callback telling everybody else what's up 📣

⚠️ bestie, please note: nr_to_walk does not mean how many objects will be freed. it means how many objects will be scanned. those are two different things and mixing them up is a whole tragedy 😭

⭐ RETURN ⭐

the number of objects effectively removed from the LRU. that's it, that's the number 💅

🌈 SEE ALSO 🌈

kernel file ./include/linux/list_lru.h 👑 plus these icons:

and that's the whole page, bestie, you ate that 🫶 this one lives over in ./include/linux, and it's dated <mint>October 2026</mint> — so yeah, mark your calendar, mwah 💋🎀🦋

📦 where this page comes from