fscache_relinquish_cookie(9)

📦 version 7.3.1, in nixpkgs unstable

okay so bestie, welcome to the Kernel API Manual — this one's all about giving a cookie back to the cache. like, literally handing it over. it's giving "returning your friend's hoodie but maybe also throwing it in the trash," and honestly? iconic 🎀

✨ NAME ✨

fscache_relinquish_cookie — Return the cookie to the cache, maybe discarding it

no cap, that's the whole vibe: you give the cookie back, and maybe you also yeet the thing it represents. we'll get to that 🦋

🌸 SYNOPSIS 🌸

void fscache_relinquish_cookie (struct fscache_cookie *cookie , bool retire );

look at that signature. void return, so it doesn't hand you anything back — it just does the thing. 💅

🫶 ARGUMENTS 🫶

  • cookie — The cookie being returned

this is the main character right here 👑 it's the cookie you're handing back.

  • retire — True if the cache object the cookie represents is to be discarded

so like, if you set this to true, the associated cache object gets forcibly discarded. dramatic? yes. correct? also yes. 🔥

💜 DESCRIPTION 💜

This function returns a cookie to the cache, forcibly discarding the associated cache object if retire is set to true.

that's it, that's the whole function fr fr — but lowkey important: "forcibly discarding" is not a drill. if you set retire to true, that cache object is gone, periodt. 💀

See Documentation/filesystems/caching/netfs-api.rst for a complete description.

seriously bestie, go read that doc if you want the full lore. this manpage is the sparknotes version and we respect the source material 🙈

🧚 SEE ALSO 🧚

Kernel file ./include/linux/fscache.h and also, like, the whole fscache friend group — they all show up together:

like a whole group chat of functions and you just left it on read 😭 go say hi to the rest of them.

and that's a wrap, bestie! 🌈 this little page lives over in ./include/linux, dated October 2026, and it's filed under fscache_relinquish_cookie(9). go forth and relinquish responsibly 💅✨🍓

📦 where this page comes from