On Thu, Aug 14, 2025 at 05:44:31PM +0530, Riana Tauro wrote: > Add documentation for Xe Device Wedging so that > file can be referenced in following patches. > > Signed-off-by: Riana Tauro <riana.ta...@intel.com>
Reviewed-by: Rodrigo Vivi <rodrigo.v...@intel.com> > --- > Documentation/gpu/xe/index.rst | 1 + > Documentation/gpu/xe/xe_device.rst | 10 ++++++++++ > drivers/gpu/drm/xe/xe_device.c | 10 ++++++++++ > 3 files changed, 21 insertions(+) > create mode 100644 Documentation/gpu/xe/xe_device.rst > > diff --git a/Documentation/gpu/xe/index.rst b/Documentation/gpu/xe/index.rst > index 42ba6c263cd0..88b22fad880e 100644 > --- a/Documentation/gpu/xe/index.rst > +++ b/Documentation/gpu/xe/index.rst > @@ -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 > diff --git a/Documentation/gpu/xe/xe_device.rst > b/Documentation/gpu/xe/xe_device.rst > new file mode 100644 > index 000000000000..39a937b97cd3 > --- /dev/null > +++ b/Documentation/gpu/xe/xe_device.rst > @@ -0,0 +1,10 @@ > +.. 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 > diff --git a/drivers/gpu/drm/xe/xe_device.c b/drivers/gpu/drm/xe/xe_device.c > index 3e0402dff423..0ab0366c3a9d 100644 > --- a/drivers/gpu/drm/xe/xe_device.c > +++ b/drivers/gpu/drm/xe/xe_device.c > @@ -1157,6 +1157,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 > -- > 2.47.1 >
