xe_guc_declare_wedged(9)

🎀 xe_guc_declare_wedged 🎀

okay so this is a page from the Kernel API Manual, bestie — yes that Kernel API Manual — and it's about a little function called xe_guc_declare_wedged. iykyk 💅

---

✨ NAME ✨

xe_guc_declare_wedged — Declare GuC wedged 🫶

like... it's the official announcement that the GuC is, in fact, wedged. no cap.

---

🌸 SYNOPSIS 🌸

void xe_guc_declare_wedged (struct xe_guc *guc );

that's the whole signature, literally. it returns void — nothing comes back out, it just happens 👑

---

🦋 ARGUMENTS 🦋

• guc — the GuC object. that's it. that's the one (1) thing you gotta hand it. main character energy fr fr 🧚

---

💖 DESCRIPTION 💖

so here's the vibe: it wedges the GuC, which lowkey means three things happen 💀

• it stops all submission — no more work going in, periodt
• it saves desired debug state — so you can actually go look at what went wrong later, iconic
• it cleans up anything which could timeout — sweeping up the stragglers before they can make things worse 🧹✨

basically it's the "we're so done here" button, and it handles the aftermath for you. obsessed.

💜 heads up — this is the wedged-declaring one. it's not a gentle "maybe try again" situation, it's the real deal, so know what you're doing when you call it.

---

🌈 SEE ALSO 🌈

no gatekeeping — here's the whole squad 👯‍♀️

Kernel file ./drivers/gpu/drm/xe/xe_guc.c:

• xe_guc_comm_init_early(9)
• xe_guc_init_post_hwconfig(9)
• xe_guc_min_load_for_hwconfig(9)
• xe_guc_softreset(9)
• xe_guc_runtime_suspend(9)
• xe_guc_runtime_resume(9)
• xe_guc_using_main_gamctrl_queues(9)
• xe_hwe_guc_logical_instance(9)

go read them after this, you'll slay 🔥

---

⭐ that's the whole page!! sign-off time: this one lives in ./drivers/gpu/drm/xe, it's dated October 2026, and you can find it filed under xe_guc_declare_wedged(9). mwah, go forth and debug responsibly 🍓💜