Unverified Commit 38fc73b8 authored by Riana Tauro's avatar Riana Tauro Committed by Rodrigo Vivi
Browse files

drm/xe: Add documentation for Xe Device Wedging 



Add documentation for Xe Device Wedging so that
file can be referenced in following patches.

Signed-off-by: default avatarRiana Tauro <riana.tauro@intel.com>
Reviewed-by: default avatarRodrigo Vivi <rodrigo.vivi@intel.com>
Link: https://lore.kernel.org/r/20250826063419.3022216-2-riana.tauro@intel.com


Signed-off-by: default avatarRodrigo Vivi <rodrigo.vivi@intel.com>
parent 41880786

Documentation/gpu/xe/index.rst

+1 −0
Original line number Diff line number Diff line
@@ -25,5 +25,6 @@ DG2, etc is provided to prototype the driver. 
   xe_tile

   xe_debugging

   xe_devcoredump

   xe_device

   xe-drm-usage-stats.rst

   xe_configfs

Documentation/gpu/xe/xe_device.rst

0 → 100644
+10 −0
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: (GPL-2.0+ OR MIT)



.. _xe-device-wedging:



==================

Xe Device Wedging

==================



.. kernel-doc:: drivers/gpu/drm/xe/xe_device.c

   :doc: Xe Device Wedging

drivers/gpu/drm/xe/xe_device.c

+10 −0
Original line number Diff line number Diff line
@@ -1166,6 +1166,16 @@ static void xe_device_wedged_fini(struct drm_device *drm, void *arg) 
	xe_pm_runtime_put(xe);

}



/**

 * DOC: Xe Device Wedging

 *

 * Xe driver uses drm device wedged uevent as documented in Documentation/gpu/drm-uapi.rst.

 * When device is in wedged state, every IOCTL will be blocked and GT cannot be

 * used. Certain critical errors like gt reset failure, firmware failures can cause

 * the device to be wedged. The default recovery method for a wedged state

 * is rebind/bus-reset.

 */



/**

 * xe_device_declare_wedged - Declare device wedged

 * @xe: xe device instance