Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

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>

+17
+17
Documentation/gpu/drm-uapi.rst
··· 446 446 hang is usually the most critical one which can result in consequential hangs or 447 447 complete wedging. 448 448 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 + 449 466 Consumer prerequisites 450 467 ---------------------- 451 468