eeh_report_failure(9)

📦 version 7.3.1, in nixpkgs unstable

💖 eeh_report_failure — NAME ✨

okay so bestie, this is eeh_report_failure(9) from the Kernel API Manual, and its whole personality is: tell the device driver that the device is dead. that's it. that's the job. 💀

🌸 SYNOPSIS 🌸

enum pci_ers_result eeh_report_failure (struct eeh_dev *edev , struct
pci_dev *pdev , struct pci_driver *driver );

like yes, it returns an enum pci_ers_result, and yes, the line break in the middle of the parameter list is exactly how the original prints it — we don't editorialize, we preserve. 🎀

🦋 ARGUMENTS 🦋

  • edev — the eeh device 💅 (this one got a real description, unlike its friend below)
  • pdev — so the manpage literally just says -- undescribed -- here 😭 no cap, that's the whole entry. not me reading it three times to check. it is what it is.
  • driver — the device's PCI driver 🫶

⭐ DESCRIPTION ⭐

this is the "it's over" call. eeh_report_failure informs the device driver that the device is permanently dead, and that no further recovery attempts will be made on it. periodt. 🪦

so like, nobody's coming to save it, bestie. the recovery arc is cancelled. this function's entire vibe is showing up to the group chat to say "yeahhh it's not coming back" and then leaving. and honestly? iconic of it. 👑

🌈 SEE ALSO 🌈

first up, the kernel file this lives in:

./arch/powerpc/kernel/eeh_driver.c

and then the whole friend group — go say hi, they're all in the same directory energy:

go read them fr fr, this page is short and the rest of the squad has lore 💖

and that's the whole thing!! mwah 💋 this page ships out of ./arch/powerpc/kernel, dated October 2026, living its best life in the Kernel API Manual as eeh_report_failure(9). slay, stay hydrated, and remember: if your device is dead, at least the documentation told you nicely. 🧚💜

📦 where this page comes from