xe_device_declare_wedged(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_device_declare_wedged(9) — the Kernel API Manual glow-up ✨

hiii bestie, welcome to xe_device_declare_wedged(9), coming at you live from the Kernel API Manual 🎀 this one's short but it's important, so like, pay attention okay?

🌸 NAME 🌸

xe_device_declare_wedged — declare device wedged 💀 (yes that's the whole vibe, we're declaring the device wedged, no cap)

✨ SYNOPSIS ✨

void xe_device_declare_wedged (struct xe_device *xe );

like, that's it. that's the whole call. one argument, zero return values, maximum drama 🫶

🦋 ARGUMENTS 🦋

  • xe — the xe device instance 💖 you know, the device. the one we're about to declare wedged. main character energy fr fr.

👑 DESCRIPTION 👑

okay so this is a final state 🌈 and here's the tea: it can only be cleared with the recovery method specified in the drm wedged uevent. no takebacks, no "wait actually—", none of that. once you're wedged, the method is the only way out.

that method? you can set it using xe_device_set_wedged_method before you declare the device as wedged. timing matters bestie ⏰. and if no method is set? don't stress — reprobe (that's unbind/re-bind) will be sent by default. slay, defaults are iconic ✨

🚨 heads up: in this state every IOCTL will be blocked so the GT cannot be used. like literally every single one. GT is out of office 💀

in general it'll be called upon any critical error — think gt reset failure or guc loading failure, the messy stuff 😭. and userspace gets notified of this state through the device wedged uevent, so nobody's left on read 💌

now here's the fun part 🍓: if the xe.wedged module parameter is set to 2, this function gets called on every single execution timeout (a.k.a. GPU hang, you know the one) right after devcoredump snapshot capture 📸. in this mode, GT reset won't be attempted — so the state of the issue is preserved for further debugging 🔥. yes, that's on purpose. it's giving forensic scientist, it's giving preserve the crime scene. iconic behavior, no notes.

💜 SEE ALSO 💜

buckle up, this list is long and it ate 👑

Kernel file ./drivers/gpu/drm/xe/xe_device.c

🧚 and that's the whole page bestie, go forth and wedge responsibly 💅

kisses from ./drivers/gpu/drm/xe 💖 page dated October 2026 🌸 see you in the next manpage, mwah 🫶✨

📦 where this page comes from