linux/Documentation/gpu
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
..
amdgpu drm/amdgpu/display: Add amdgpu_display.c documentation 2026-07-15 09:15:41 -04:00
bridge
dp-mst
imagination drm/imagination: Numerous documentation fixes. 2023-11-28 18:56:03 +01:00
intel-display drm/i915/doc: Document DP link capabilities 2026-07-09 10:22:29 +03:00
nova gpu: nova-core: vbios: move constants and functions to be associated 2026-05-25 20:18:08 +02:00
rfc Documentation/gpu/rfc: fix toctree 2026-05-13 11:07:12 +03:00
xe drm/xe/log: Add structured SIGID error logging infrastructure 2026-08-14 14:55:35 -04:00
afbc.rst
automated_testing.rst drm/doc: update tree setup instructions 2026-06-17 15:51:10 +05:30
backlight.rst
driver-uapi.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drivers.rst Documentation/gpu: add dedicated documentation for Intel display 2026-05-11 10:30:13 +03:00
drm-client.rst drm/client: Move client event handlers to drm_client_event.c 2024-10-18 09:23:03 +02:00
drm-compute.rst kernel/cgroup: Add "dmem" memory accounting cgroup 2025-01-06 17:24:38 +01:00
drm-internals.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drm-kms-helpers.rst drm/bridge: Document bridge chain format selection 2026-06-09 21:03:51 +01:00
drm-kms.rst drm: Add new general DRM property "color format" 2026-06-09 21:03:50 +01:00
drm-mm.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drm-ras.rst drm/drm_ras: Add drm_ras netlink error event 2026-08-12 16:03:05 -04:00
drm-uapi.rst drm/doc: Document DRM_WEDGE_RECOVERY_COLD_RESET recovery method 2026-08-13 09:42:08 -04:00
drm-usage-stats.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
drm-vm-bind-async.rst Documentation/gpu: Add a VM_BIND async document 2023-10-17 10:38:07 +02:00
drm-vm-bind-locking.rst Documentation/gpu: VM_BIND locking document 2023-11-29 20:54:43 +01:00
i915.rst Documentation/gpu: add dedicated documentation for Intel display 2026-05-11 10:30:13 +03:00
implementation_guidelines.rst Documentation/gpu: VM_BIND locking document 2023-11-29 20:54:43 +01:00
index.rst Documentation/gpu: limit main toctree depth to 2 2026-05-13 11:07:12 +03:00
introduction.rst Documentation/gpu: add some tables of contents to large documents 2026-05-13 11:07:12 +03:00
kms-properties.csv drm/connector: hdmi: Add Broadcast RGB property 2024-05-28 10:24:37 +02:00
komeda-kms.rst drm: Rename struct drm_atomic_state to drm_atomic_commit 2026-05-04 14:05:04 +10:00
mcde.rst
meson.rst
msm-crash-dump.rst
msm-preemption.rst Documentation: document adreno preemption 2024-10-04 08:47:29 -07:00
nouveau.rst Documentation: nouveau: Update GSP message queue kernel-doc reference 2025-06-13 16:46:35 +02:00
panfrost.rst drm/panfrost: Replace fdinfo's profiling debugfs knob with sysfs 2024-03-11 13:27:10 +01:00
panthor.rst Documentation/gpu: Add fdinfo meanings of panthor-*-memory tags 2025-02-07 15:23:39 +01:00
pl111.rst
tegra.rst
todo.rst drm/todo: clarify drm_syncobj error TODOs 2026-06-22 15:20:15 +02:00
tve200.rst
v3d.rst
vc4.rst
vga-switcheroo.rst
vgaarbiter.rst Documentation: vgaarbiter: Fix grammar 2025-03-19 15:11:49 +01:00
vkms.rst drm/vkms: Update testing with IGT IGT_DEVICE 2025-11-04 11:51:15 +01:00
xen-front.rst
zynqmp.rst drm: xlnx: zynqmp_dpsub: Fix kernel doc 2025-01-16 12:45:16 +01:00