memory_failure_queue(9)

💖 memory_failure_queue(9) 💖

okay bestie, welcome to the Kernel API Manual — yeah the title is a whole mouthful but stick with me, this one's actually kinda iconic. we're looking at memory_failure_queue(9) and fr fr it's the function that handles your RAM having a bad day. 🫶

---

✨ NAME ✨

memory_failure_queue — schedule handling memory failure of a page. that's the whole vibe: a page goes bad, and this queues up the cleanup. 🎀

---

🌸 SYNOPSIS 🌸

void memory_failure_queue (unsigned long pfn , int flags );

look at her. returns void, takes two args, no notes. 💅

---

🦋 ARGUMENTS 🦋

• pfn — the Page Number of the corrupted page. yes, the corrupted one. the problem child. 😭
• flags — flags for memory failure handling, i.e. the little knobs that tell it how to do the thing.

---

🔥 DESCRIPTION 🔥

okay so here's the tea: this function gets called by the low level hardware error handler when it detects hardware memory corruption of a page. like, the hardware literally snitched on itself and this is who picks up the phone. 💀

what it does is schedules the recovering of error page — and that recovering package includes dropping pages, killing processes, etc. yeah. etc. she contains multitudes. 👑

the function is primarily of use for corruptions that happen outside the current execution context (e.g. when detected by a background scrubber), so it's the girl who handles the drama when you're not even in the room. ✨

and the best part? Can run in IRQ context. no cap, she's built different. 🌈

---

👑 SEE ALSO 👑

• Kernel file ./mm/memory-failure.c
• MF_ATTR_RO(9)
• get_hwpoison_page(9)
• mf_dax_kill_procs(9)
• memory_failure_pfn(9)
• memory_failure(9)
• unpoison_memory(9)
• soft_offline_page(9)

all her besties, go read them too, iykyk 📚💜

---

and that's the page!! brought to you by the fine folks over at ./mm — source/version realness — dated October 2026, and yes she's still titled memory_failure_queue(9) because consistency is a slay. mwah, go fix that memory bestie 💋🌸🧚