list_lru_add_obj(9)

📦 version 7.3.1, in nixpkgs unstable

💖 list_lru_add_obj(9) 💖

okay bestie, welcome to the Kernel API Manual ✨ — yes this is a section 9 page, yes it's about the kernel, and yes you're gonna get it. this one's list_lru_add_obj, and it's lowkey one of the cutest little helpers in the LRU-verse 🦋

🌸 NAME 🌸

list_lru_add_obj — add an element to the lru list's tail 👑

like, it literally does what it says on the tin. element goes in, at the tail, no drama 💅

✨ SYNOPSIS ✨

bool list_lru_add_obj (struct list_lru *lru , struct list_head *item );

that's it. that's the whole vibe check 🔥 returns a bool, takes two pointers, slays.

🎀 ARGUMENTS 🎀

  • lru — the lru pointer 🫶 this is your list, your main character. hand it over and it'll do the thing.
  • item — the item to be added. yes, the actual thing going on the list. icon behavior 💖

🌈 DESCRIPTION 🌈

so here's the tea ☕ — this function is similar to list_lru_add, but with a little twist: the NUMA node and the memcg of the sublist are determined by the item's list_head, not by you passing them in. it just knows. iykyk 🧚

and this assumption is valid for slab objects LRU such as dentries, inodes, etc. — so if that's your situation, you're so good, no cap 💜

ngl, key word here is assumption — it holds for slab objects LRU like the ones listed above. that's the contract, bestie, don't come for it 🙈

⭐ RETURN ⭐

  • true — the list was updated 🎉 slay, it worked
  • false — otherwise 😭 the list was not updated

🦋 SEE ALSO 🦋

Kernel file ./include/linux/list_lru.h — go read it, it's giving lore 👑

and these icons, all in their natural habitat:

and that's the page, bestie 🫶 this little gem comes straight from the ./include/linux corner of the kernel tree, dated October 2026 — go add some objects to some tails, you've got this 💅✨🎀

📦 where this page comes from