Skip to content

Commit cd37124

Browse files
committed
drm/doc: Add a section about "Task information" for the wedge API
Add a section about "Task information" for the wedge API. Reviewed-by: Krzysztof Karas <krzysztof.karas@intel.com> Reviewed-by: Raag Jadav <raag.jadav@intel.com> Reviewed-by: Christian König <christian.koenig@amd.com> Link: https://lore.kernel.org/r/20250617124949.2151549-5-andrealmeid@igalia.com Signed-off-by: André Almeida <andrealmeid@igalia.com>
1 parent 183bcca commit cd37124

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

Documentation/gpu/drm-uapi.rst

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -446,6 +446,23 @@ telemetry information (devcoredump, syslog). This is useful because the first
446446
hang is usually the most critical one which can result in consequential hangs or
447447
complete wedging.
448448

449+
Task information
450+
---------------
451+
452+
The information about which application (if any) was involved in the device
453+
wedging is useful for userspace if they want to notify the user about what
454+
happened (e.g. the compositor display a message to the user "The <task name>
455+
caused a graphical error and the system recovered") or to implement policies
456+
(e.g. the daemon may "ban" an task that keeps resetting the device). If the task
457+
information is available, the uevent will display as ``PID=<pid>`` and
458+
``TASK=<task name>``. Otherwise, ``PID`` and ``TASK`` will not appear in the
459+
event string.
460+
461+
The reliability of this information is driver and hardware specific, and should
462+
be taken with a caution regarding it's precision. To have a big picture of what
463+
really happened, the devcoredump file provides should have much more detailed
464+
information about the device state and about the event.
465+
449466
Consumer prerequisites
450467
----------------------
451468

0 commit comments

Comments
 (0)