linux/Documentation/gpu/xe
Mallesh Koujalagi 1d2292f8f1
drm/xe/log: Add structured SIGID error logging infrastructure
Today the driver reports faults with ad-hoc drm_err()/xe_gt_err()
strings that have no stable shape. That is readable for a human, but it
gives fleet tooling nothing durable to match on: the wording changes
between releases, lines can be rate-limited or dropped under an error
storm, and there is no consistent way to ask "which recognised fault
just happened?".

Introduce a signature identifier (SIGID): a small, stable integer that
names one recognised Xe fault site and serves as the primary handle for
triage. A SIGID maps, through published end-user documentation, to a
description and a recommended action; the driver only has to emit the
right SIGID next to the usual human-readable text.

Signed-off-by: Mallesh Koujalagi <mallesh.koujalagi@intel.com>
Assisted-by: Copilot:Opus-4.8
Co-developed-by: Michal Wajdeczko <michal.wajdeczko@intel.com>
Signed-off-by: Michal Wajdeczko <michal.wajdeczko@intel.com>
Cc: Riana Tauro <riana.tauro@intel.com>
Cc: Stuart Summers <stuart.summers@intel.com>
cc: Badal Nilawar <badal.nilawar@intel.com>
Reviewed-by: Badal Nilawar <badal.nilawar@intel.com>
Link: https://patch.msgid.link/20260814171801.13347-3-michal.wajdeczko@intel.com
Signed-off-by: Rodrigo Vivi <rodrigo.vivi@intel.com>
2026-08-14 14:55:35 -04:00
..
index.rst drm/xe/log: Add structured SIGID error logging infrastructure 2026-08-14 14:55:35 -04:00
xe_configfs.rst drm/xe/configfs: Add internal API to documentation 2025-06-02 11:00:46 -07:00
xe_cs.rst
xe_debugging.rst drm/xe/doc: Include documentation about xe_assert() 2023-12-21 11:45:08 -05:00
xe_devcoredump.rst drm/xe: Wire up devcoredump in documentation 2024-11-04 23:29:57 -08:00
xe_device.rst drm/xe/xe_ras: Add RAS GPU health indicator 2026-07-17 10:18:12 +05:30
xe_exec_queue.rst drm/xe/doc: Add documentation for Multi Queue Group GuC interface 2025-12-11 19:22:18 -08:00
xe_firmware.rst drm/xe: Move xe_uc_fw_abi.h to abi/ 2026-05-27 21:28:01 +02:00
xe_gt_freq.rst drm/xe: Improve freq and throttle documentation 2025-10-30 23:20:25 -07:00
xe_gt_mcr.rst
xe_gt_stats.rst drm/xe: Document GT statistics 2026-03-30 11:00:45 +02:00
xe_map.rst
xe_migrate.rst
xe_mm.rst drm/xe: Introduce GGTT documentation 2024-08-22 14:00:44 -04:00
xe_pcode.rst drm/xe/doc: Document device wedged and runtime survivability 2025-08-26 10:11:34 -04:00
xe_pm.rst
xe_rtp.rst
xe_sigid.rst drm/xe/log: Add structured SIGID error logging infrastructure 2026-08-14 14:55:35 -04:00
xe_tile.rst
xe_wa.rst
xe-drm-usage-stats.rst drm/xe/client: Print runtime to fdinfo 2024-05-21 06:33:40 -07:00