genwqe_recover_card(9)

🩹 genwqe_recover_card — kernel API manual, but make it make sense

okay so bestie, we're in the kernel API manual for genwqe_recover_card(9) — yes that's the function, yes it lives in the genwqe corner of the kernel, and yes I'm gonna walk you through it like we're on FaceTime. 🫶

---

✨ NAME ✨

genwqe_recover_card — literally just "try to recover the card if it is possible". that's the whole pitch. it's giving CPR for hardware 💅

---

✨ SYNOPSIS ✨

int genwqe_recover_card (struct genwqe_dev *cd , int fatal_err );

like, that's it. two args, one int back. no cap.

---

✨ ARGUMENTS ✨

• cd — the GenWQE device information. your main character struct fr fr 🌸
• fatal_err — tells us whether we should attempt a soft reset. yep, this one little flag decides the whole vibe of the recovery attempt ✨

---

✨ DESCRIPTION ✨

okay so here's the tea 🍓 — if fatal_err is set, that means no register access is possible anymore. like, at all. ngl, it's likely that genwqe_start fails in that situation, so you're gonna need proper error handling in this case. no skipping it, bestie, it's required 😭

and then — genwqe_bus_reset will cause the pci code to call genwqe_remove and later genwqe_probe for all virtual functions. that's the whole chain, every VF, no exceptions 👑

lowkey important: read that again before you go poking at a card that's already cooked 💀

---

✨ SEE ALSO ✨

Kernel file ./drivers/misc/genwqe/card_base.c, plus the whole friend group of genwqe functions — go say hi 🦋

• genwqe_devnode(9)
• genwqe_dev_alloc(9)
• genwqe_bus_reset(9)
• genwqe_recovery_on_fatal_gfir_required(9)
• genwqe_T_psec(9)
• genwqe_setup_pf_jtimer(9)
• genwqe_setup_vf_jtimer(9)
• genwqe_stop(9)
• genwqe_fir_checking(9)
• genwqe_pci_fundamental_reset(9)
• genwqe_reload_bistream(9)
• genwqe_health_thread(9)
• genwqe_pci_setup(9)
• genwqe_pci_remove(9)
• genwqe_probe(9)
• genwqe_remove(9)
• genwqe_err_error_detected(9)
• genwqe_init_module(9)
• genwqe_exit_module(9)

---

aaaand that's the page!! source is ./drivers/misc/genwqe, dated October 2026, and the header/footer both say genwqe_recover_card(9) if you needed to cite it for your homework 📚💖 slay, go fix that card, you got this 🎀💜