intel_gt_handle_error(9)

✨ NAME ✨

intel_gt_handle_error — handle a gpu error. Bestie, you’re on the intel_gt_handle_error(9) page from the Kernel API Manual 💖

🎀 SYNOPSIS 🎀

Here’s the whole signature, no cap:

void intel_gt_handle_error (struct intel_gt *gt , intel_engine_mask_t
engine_mask , unsigned long flags , const char *fmt , ... );

🌸 ARGUMENTS 🌸

• gt — the intel_gt 👑
• engine_mask — mask representing engines that are hung 😭
• flags — control flags 🚩
• fmt — Error message format string 📝
• ... — variable arguments 🫶

🦋 DESCRIPTION 🦋

Okay so this function does some basic checking of register state at error time and dumps it to the syslog — very diagnostic, very demure 💅. It also calls i915_capture_error_state to make sure we get a record and make it available in debugfs, because receipts are everything 📸. Then it fires a uevent so userspace knows something bad happened (should trigger collection of a ring dump etc.) 🫶

💅 SEE ALSO 💅

Kernel file ./drivers/gpu/drm/i915/gt/intel_reset.c — go read it, bestie 📚

• intel_gt_reset(9)
• intel_gt_reset_all_engines(9)
• intel_gt_reset_engine(9)
• intel_engine_reset(9)

Source: ./drivers/gpu/drm/i915/gt · version/page: intel_gt_handle_error(9) · date: October 2026 — mwah, bestie, slay your errors 💋✨