fscache_io_error(9)

💅 fscache_io_error — a lil kernel API manual moment

okay so bestie, welcome to the Kernel API Manual ✨ this one is called fscache_io_error(9) and it's literally the "hey girl your cache is cooked" function 🫶

---

🌸 NAME 🌸

fscache_io_error — note a cache I/O error 💀

like, you're officially putting it on the record. the cache did a bad thing. we're writing it down. periodt.

---

✨ SYNOPSIS ✨

void fscache_io_error (struct fscache_cache *cache );

no return value bestie, it just happens and you move on 💅

---

🎀 ARGUMENTS 🎀

• cache — the record describing the cache. yeah, the whole lil struct that says "this is the cache, here's what's up with it" 🦋

---

🔥 DESCRIPTION 🔥

so here's the vibe check: you call this bad boy to note that an I/O error occurred in a cache, and that it should no longer be used for anything. like at all. it's retired. it's on permanent vacation. do not pass go, do not fetch a single block 🙈

it also reports the error into the kernel log, so the kernel knows too. no secrets, no cap 💀

if you want the complete description, it's literally all spelled out in Documentation/filesystems/caching/backend-api.rst — go read it, it's giving documentation 💖

---

👑 SEE ALSO 👑

kernel file ./fs/netfs/fscache_cache.c — and the whole friend group:

• fscache_acquire_cache(9)
• fscache_put_cache(9)
• fscache_relinquish_cache(9)
• fscache_add_cache(9)
• fscache_begin_cache_access(9)
• fscache_end_cache_access(9)
• fscache_withdraw_cache(9)

the way that these all fit together... main character energy fr fr 🌈

---

and that's a wrap!! 🧚 this page came to you from ./fs/netfs, dated October 2026, and honestly? iconic. slay. bye bestie 💜🎀