i915_capture_error_state(9)

💅 i915_capture_error_state(9) 💅

okay so bestie, welcome to the Kernel API Manual page for i915_capture_error_state(9) — yes, that name is a mouthful, but she's iconic and we're gonna get through it together 🫶

---

🌸 NAME 🌸

i915_capture_error_state — capture an error record for later analysis. periodt. 💖

---

✨ SYNOPSIS ✨

void i915_capture_error_state (struct intel_gt *gt , intel_engine_mask_t
       engine_mask , u32 dump_flags );

---

🎀 ARGUMENTS 🎀

• gt — the intel_gt which originated the hang. she's the main character of this little disaster 💀
• engine_mask — hung engines. plural energy, it's a mask, bestie ✨
• dump_flags — dump flags. literally just the flags for the dump 💅

---

🦋 DESCRIPTION 🦋

Should be called when an error is detected — either a hang or an error interrupt — to capture error state from the time of the error. no cap, that's the whole vibe: grab the state while it's still fresh 😭

It fills out a structure which becomes available in debugfs for user level tools to pick up. so yes, the tools get their little treat, and everyone can analyze it later 🔥

---

💜 SEE ALSO 💜

Kernel file ./drivers/gpu/drm/i915/i915_gpu_error.c — go read her, iykyk 🌈

---

mwah 💖 this page's source/version is ./drivers/gpu/drm/i915, and it's dated October 2026 — slay, bye bestie 🎀