eeh_check_failure(9)

✨ eeh_check_failure ✨

ok so bestie, welcome to eeh_check_failure — the kernel API manual girlies are gonna eat this one up 💅 it's literally the "is this all-0xff energy a real problem or just vibes" check, and honestly? iconic.

---

🌸 SYNOPSIS 🌸

int eeh_check_failure (const volatile void __iomem *token );

like, that's the whole signature. short. sweet. main character energy fr fr 🎀

---

🦋 ARGUMENTS 🦋

• token — the I/O address. that's it, that's the whole parameter. it's an I/O address, bestie, treat it with respect ✨

---

💖 DESCRIPTION 💖

okay so picture this: you did a read, and the result came back all 0xff's. kind of sus, right? 😭 so you call this routine and it will check for an EEH failure at the given I/O address — basically it's you going "hey, is this all-0xff situation because of an EEH slot freeze event, or are we fine?"

and the way it finds out? it queries firmware for the EEH status. no cap, that's the whole move. it goes and asks. 🔥

💀 important note bestie: this routine is safe to call in an interrupt context. like, yes queen, you can absolutely call it from an interrupt. that's a real gift and we should be grateful 🫶

---

👑 SEE ALSO 👑

the kernel file lives at ./arch/powerpc/kernel/eeh.c — go look, it's giving source code realness 📂✨ and while you're there, the whole eeh friend group is here:

• eeh_slot_error_detail(9)
• eeh_token_to_phys(9)
• eeh_dev_check_failure(9)
• eeh_pci_enable(9)
• pcibios_set_pcie_reset_state(9)
• eeh_set_dev_freset(9)
• eeh_pe_reset_full(9)
• eeh_save_bars(9)
• eeh_init(9)
• eeh_probe_device(9)
• eeh_remove_device(9)
• eeh_dev_open(9)
• eeh_dev_release(9)
• eeh_iommu_group_to_pe(9)
• eeh_pe_set_option(9)
• eeh_pe_get_state(9)
• eeh_pe_reset(9)
• eeh_pe_configure(9)
• eeh_pe_inject_err(9)

like, that's a whole squad. a whole roster. iykyk 🌈⭐

---

ok that's the page!! mwah 💋 this little gem comes to you from ./arch/powerpc/kernel, dated October 2026, and it's filed under eeh_check_failure(9) — go forth and check those failures, bestie 🧚‍♀️💜