From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 6338BC61DB9 for ; Thu, 27 Aug 2026 06:20:18 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 0D89210E981; Thu, 27 Aug 2026 06:20:18 +0000 (UTC) Authentication-Results: gabe.freedesktop.org; dkim=pass (2048-bit key; unprotected) header.d=intel.com header.i=@intel.com header.b="dfMZO/kq"; dkim-atps=neutral Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.17]) by gabe.freedesktop.org (Postfix) with ESMTPS id 1129F10E3AE for ; Thu, 27 Aug 2026 06:20:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1787811617; x=1819347617; h=date:from:to:cc:subject:message-id:references: mime-version:content-transfer-encoding:in-reply-to; bh=tutAlAbOYUFTgqUo2wYxaZWcMhmFf1GxQkSMvppxsSc=; b=dfMZO/kqgI7Vc9avP/DzjC+uLWcee9+l4hghRVkQaMfsuoi+lehgCyrt FPRRS16CBVzaZgiLliDCBnMlx6zlfiWnPN/Vw3k7V9xuSYjGBQ/cDSXMZ ujsmhgNZ+roeRzdTdiOJnWFi6Q0P+Grpi3uIoJQ07ey5ulA0iKH03jmox 0v2dgXktjNrO4ujE2k+oty6ofwmvKHp+W9D7tYr1EIyfwCxDHBgrbgqoa 3+K3jZEK2KmMwjE2TGvRpn0MRXmoaEN4URQy9OwmI/vUji3+w04RQ6VjL 8vcte3e9CNNP/kWYuKLsG0T3k1T2TMgUSETO4Hiypwa8fjVe5PBbuRYiw g==; X-CSE-ConnectionGUID: xHuXeZEcQOulCXBaIIkZhw== X-CSE-MsgGUID: M9b82gCRTiiFihwlS6JmIQ== X-IronPort-AV: E=McAfee;i="6800,10657,11887"; a="88182689" X-IronPort-AV: E=Sophos;i="6.25,246,1779174000"; d="scan'208";a="88182689" Received: from fmviesa009.fm.intel.com ([10.60.135.149]) by fmvoesa111.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 26 Aug 2026 23:20:16 -0700 X-CSE-ConnectionGUID: T+mxIMhvSoWrpMAnraGiSQ== X-CSE-MsgGUID: nHOVNDMQRmO3KP6L4loiQA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.25,246,1779174000"; d="scan'208";a="261655175" Received: from black.igk.intel.com ([10.91.253.5]) by fmviesa009.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 26 Aug 2026 23:20:13 -0700 Date: Thu, 27 Aug 2026 08:20:10 +0200 From: Raag Jadav To: Rodrigo Vivi Cc: intel-xe@lists.freedesktop.org, riana.tauro@intel.com, michal.wajdeczko@intel.com, lukasz.laguna@intel.com, matthew.d.roper@intel.com, matthew.brost@intel.com Subject: Re: [PATCH v1] drm/xe: Introduce xe_wedge Message-ID: References: <20260825114450.1371821-1-raag.jadav@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: X-BeenThere: intel-xe@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Intel Xe graphics driver List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-xe-bounces@lists.freedesktop.org Sender: "Intel-xe" On Wed, Aug 26, 2026 at 05:10:44PM -0400, Rodrigo Vivi wrote: > On Tue, Aug 25, 2026 at 05:12:43PM +0530, Raag Jadav wrote: > > Consolidates all wedging implementation into a dedicated xe_wedge > > component. While at it, add a worker to schedule the wedge handling to > > be done async making xe_device_declare_wedged() safe for atomic callers. > > > > Signed-off-by: Raag Jadav > > --- > > PS: The original intent was a bug fix, but that's just a matter of opinion. > > I had thought about this spin-off a very long time ago too... > > But please, split into 2 patches, one with the consolidation and one with > the worker. This one is painful to review as is right now. This was meant more as an RFC and needs a bit of discussion, sorry I didn't update the subject prefix. xe_pm_runtime_get_noresume() has checks against 'current' task and I'm wondering if it's reliable in atomic context? > Also, please use 'xe_wedge_' as the new prefix for any non static functions. Sure. Raag > > Documentation/gpu/xe/xe_device.rst | 2 +- > > drivers/gpu/drm/xe/Makefile | 1 + > > drivers/gpu/drm/xe/xe_device.c | 172 +-------------------- > > drivers/gpu/drm/xe/xe_device.h | 11 +- > > drivers/gpu/drm/xe/xe_device_types.h | 19 +-- > > drivers/gpu/drm/xe/xe_wedge.c | 214 +++++++++++++++++++++++++++ > > drivers/gpu/drm/xe/xe_wedge.h | 24 +++ > > drivers/gpu/drm/xe/xe_wedge_types.h | 25 ++++ > > 8 files changed, 271 insertions(+), 197 deletions(-) > > create mode 100644 drivers/gpu/drm/xe/xe_wedge.c > > create mode 100644 drivers/gpu/drm/xe/xe_wedge.h > > create mode 100644 drivers/gpu/drm/xe/xe_wedge_types.h > > > > diff --git a/Documentation/gpu/xe/xe_device.rst b/Documentation/gpu/xe/xe_device.rst > > index d3a022362ade..8baed81580c9 100644 > > --- a/Documentation/gpu/xe/xe_device.rst > > +++ b/Documentation/gpu/xe/xe_device.rst > > @@ -6,7 +6,7 @@ > > Xe Device Wedging > > ================== > > > > -.. kernel-doc:: drivers/gpu/drm/xe/xe_device.c > > +.. kernel-doc:: drivers/gpu/drm/xe/xe_wedge.c > > :doc: Xe Device Wedging > > > > ==================== > > diff --git a/drivers/gpu/drm/xe/Makefile b/drivers/gpu/drm/xe/Makefile > > index adc2de37e768..c739a50b6896 100644 > > --- a/drivers/gpu/drm/xe/Makefile > > +++ b/drivers/gpu/drm/xe/Makefile > > @@ -152,6 +152,7 @@ xe-y += xe_bb.o \ > > xe_vsec.o \ > > xe_wa.o \ > > xe_wait_user_fence.o \ > > + xe_wedge.o \ > > xe_wopcm.o > > > > xe-$(CONFIG_I2C) += xe_i2c.o \ > > diff --git a/drivers/gpu/drm/xe/xe_device.c b/drivers/gpu/drm/xe/xe_device.c > > index 74d566693dfd..d3a7034fac01 100644 > > --- a/drivers/gpu/drm/xe/xe_device.c > > +++ b/drivers/gpu/drm/xe/xe_device.c > > @@ -829,10 +829,7 @@ int xe_device_probe_early(struct xe_device *xe) > > */ > > assert_lmem_ready(xe); > > > > - xe->wedged.mode = xe_device_validate_wedged_mode(xe, xe_modparam.wedged_mode) ? > > - XE_DEFAULT_WEDGED_MODE : xe_modparam.wedged_mode; > > - drm_dbg(&xe->drm, "wedged_mode: setting mode (%u) %s\n", > > - xe->wedged.mode, xe_wedged_mode_to_string(xe->wedged.mode)); > > + xe_device_wedged_init_early(xe); > > > > err = xe_device_vram_alloc(xe); > > if (err) > > @@ -924,14 +921,6 @@ static void detect_preproduction_hw(struct xe_device *xe) > > } > > } > > > > -static void xe_device_wedged_fini(struct drm_device *drm, void *arg) > > -{ > > - struct xe_device *xe = arg; > > - > > - if (atomic_read(&xe->wedged.flag)) > > - xe_pm_runtime_put(xe); > > -} > > - > > #ifdef CONFIG_DRM_XE_DEBUG_PAGE_SIZE > > static int xe_debug_page_size_alloc_ctrl_init(struct xe_device *xe) > > { > > @@ -1148,7 +1137,7 @@ int xe_device_probe(struct xe_device *xe) > > > > detect_preproduction_hw(xe); > > > > - err = drmm_add_action_or_reset(&xe->drm, xe_device_wedged_fini, xe); > > + err = xe_device_wedged_init(xe); > > if (err) > > goto err_unregister_display; > > > > @@ -1394,163 +1383,6 @@ u64 xe_device_uncanonicalize_addr(struct xe_device *xe, u64 address) > > return address & GENMASK_ULL(xe->info.va_bits - 1, 0); > > } > > > > -/** > > - * 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. The conditions under which the driver declares the device wedged > > - * depend on the wedged mode configuration (see &enum xe_wedged_mode). The > > - * default recovery method for a wedged state is rebind/bus-reset. > > - * > > - * Another recovery method is vendor-specific. Below are the cases that send > > - * ``WEDGED=vendor-specific`` recovery method in drm device wedged uevent. > > - * > > - * Case: Firmware Flash > > - * -------------------- > > - * > > - * Identification Hint > > - * +++++++++++++++++++ > > - * > > - * ``WEDGED=vendor-specific`` drm device wedged uevent with > > - * :ref:`Runtime Survivability mode ` is used to notify > > - * admin/userspace consumer about the need for a firmware flash. > > - * > > - * Recovery Procedure > > - * ++++++++++++++++++ > > - * > > - * Once ``WEDGED=vendor-specific`` drm device wedged uevent is received, follow > > - * the below steps > > - * > > - * - Check Runtime Survivability mode sysfs. > > - * If enabled, firmware flash is required to recover the device. > > - * > > - * /sys/bus/pci/devices//survivability_mode > > - * > > - * - Admin/userspace consumer can use firmware flashing tools like fwupd to flash > > - * firmware and restore device to normal operation. > > - */ > > - > > -/** > > - * xe_device_set_wedged_method - Set wedged recovery method > > - * @xe: xe device instance > > - * @method: recovery method to set > > - * > > - * Set wedged recovery method to be sent in drm wedged uevent. > > - */ > > -void xe_device_set_wedged_method(struct xe_device *xe, unsigned long method) > > -{ > > - xe->wedged.method = method; > > -} > > - > > -#define WEDGED_URL "https://docs.kernel.org/gpu/drm-uapi.html#device-wedging" > > -#define XE_BUG_URL "https://gitlab.freedesktop.org/drm/xe/kernel/issues/new" > > - > > -/** > > - * xe_device_declare_wedged - Declare device wedged > > - * @xe: xe device instance > > - * > > - * This is a final state that can only be cleared with the recovery method > > - * specified in the drm wedged uevent. The method can be set using > > - * xe_device_set_wedged_method before declaring the device as wedged. If no method > > - * is set, reprobe (unbind/re-bind) will be sent by default. > > - * > > - * In this state every IOCTL will be blocked so the GT cannot be used. > > - * In general it will be called upon any critical error such as gt reset > > - * failure or guc loading failure. Userspace will be notified of this state > > - * through device wedged uevent. > > - * If xe.wedged module parameter is set to 2, this function will be called > > - * on every single execution timeout (a.k.a. GPU hang) right after devcoredump > > - * snapshot capture. In this mode, GT reset won't be attempted so the state of > > - * the issue is preserved for further debugging. > > - */ > > -void xe_device_declare_wedged(struct xe_device *xe) > > -{ > > - struct xe_gt *gt; > > - u8 id; > > - > > - if (xe->wedged.mode == XE_WEDGED_MODE_NEVER) { > > - drm_dbg(&xe->drm, "Wedged mode is forcibly disabled\n"); > > - return; > > - } > > - > > - if (!atomic_xchg(&xe->wedged.flag, 1)) { > > - xe->needs_flr_on_fini = true; > > - xe_pm_runtime_get_noresume(xe); > > - > > - xe_log_err_fatal(xe, WEDGED, -EIO, "Device declared wedged!\n"); > > - xe_err_once(xe, "IOCTLs and executions are now blocked!\n" > > - "For recovery procedure, refer to %s\n" > > - "Please file a _new_ bug report at %s\n", > > - WEDGED_URL, XE_BUG_URL); > > - } > > - > > - for_each_gt(gt, xe, id) > > - xe_gt_declare_wedged(gt); > > - > > - if (xe_device_wedged(xe)) { > > - /* > > - * XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET is intended for debugging > > - * hangs, so wedge the device with 'none' recovery method and have > > - * it available to the user for debugging. > > - */ > > - if (xe->wedged.mode == XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET) > > - xe_device_set_wedged_method(xe, DRM_WEDGE_RECOVERY_NONE); > > - /* If no wedge recovery method is set, use default */ > > - else if (!xe->wedged.method) > > - xe_device_set_wedged_method(xe, DRM_WEDGE_RECOVERY_REBIND | > > - DRM_WEDGE_RECOVERY_BUS_RESET); > > - > > - /* Notify userspace of wedged device */ > > - drm_dev_wedged_event(&xe->drm, xe->wedged.method, NULL); > > - } > > -} > > - > > -/** > > - * xe_device_validate_wedged_mode - Check if given mode is supported > > - * @xe: the &xe_device > > - * @mode: requested mode to validate > > - * > > - * Check whether the provided wedged mode is supported. > > - * > > - * Return: 0 if mode is supported, error code otherwise. > > - */ > > -int xe_device_validate_wedged_mode(struct xe_device *xe, unsigned int mode) > > -{ > > - if (mode > XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET) { > > - drm_dbg(&xe->drm, "wedged_mode: invalid value (%u)\n", mode); > > - return -EINVAL; > > - } else if (mode == XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET && (IS_SRIOV_VF(xe) || > > - (IS_SRIOV_PF(xe) && !IS_ENABLED(CONFIG_DRM_XE_DEBUG)))) { > > - drm_dbg(&xe->drm, "wedged_mode: (%u) %s mode is not supported for %s\n", > > - mode, xe_wedged_mode_to_string(mode), > > - xe_sriov_mode_to_string(xe_device_sriov_mode(xe))); > > - return -EPERM; > > - } > > - > > - return 0; > > -} > > - > > -/** > > - * xe_wedged_mode_to_string - Convert enum value to string. > > - * @mode: the &xe_wedged_mode to convert > > - * > > - * Returns: wedged mode as a user friendly string. > > - */ > > -const char *xe_wedged_mode_to_string(enum xe_wedged_mode mode) > > -{ > > - switch (mode) { > > - case XE_WEDGED_MODE_NEVER: > > - return "never"; > > - case XE_WEDGED_MODE_UPON_CRITICAL_ERROR: > > - return "upon-critical-error"; > > - case XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET: > > - return "upon-any-hang-no-reset"; > > - default: > > - return ""; > > - } > > -} > > - > > /** > > * xe_device_asid_to_vm() - Find VM from ASID > > * @xe: the &xe_device > > diff --git a/drivers/gpu/drm/xe/xe_device.h b/drivers/gpu/drm/xe/xe_device.h > > index 6c4cfaebc44a..c984972bd0f8 100644 > > --- a/drivers/gpu/drm/xe/xe_device.h > > +++ b/drivers/gpu/drm/xe/xe_device.h > > @@ -11,6 +11,7 @@ > > #include "xe_device_types.h" > > #include "xe_gt_types.h" > > #include "xe_sriov.h" > > +#include "xe_wedge.h" > > > > struct xe_vm; > > > > @@ -207,11 +208,6 @@ bool xe_device_is_l2_flush_optimized(struct xe_device *xe); > > void xe_device_td_flush(struct xe_device *xe); > > void xe_device_l2_flush(struct xe_device *xe); > > > > -static inline bool xe_device_wedged(struct xe_device *xe) > > -{ > > - return atomic_read(&xe->wedged.flag); > > -} > > - > > #ifdef CONFIG_DRM_XE_DEBUG_PAGE_SIZE > > static inline bool xe_debug_page_size_supported(struct xe_device *xe) > > { > > @@ -260,11 +256,6 @@ static inline bool xe_debug_page_size_mode_is_mixed(struct xe_device *xe) > > } > > #endif > > > > -void xe_device_set_wedged_method(struct xe_device *xe, unsigned long method); > > -void xe_device_declare_wedged(struct xe_device *xe); > > -int xe_device_validate_wedged_mode(struct xe_device *xe, unsigned int mode); > > -const char *xe_wedged_mode_to_string(enum xe_wedged_mode mode); > > - > > struct xe_file *xe_file_get(struct xe_file *xef); > > void xe_file_put(struct xe_file *xef); > > > > diff --git a/drivers/gpu/drm/xe/xe_device_types.h b/drivers/gpu/drm/xe/xe_device_types.h > > index 180d450a6deb..f307d7e5e6b6 100644 > > --- a/drivers/gpu/drm/xe/xe_device_types.h > > +++ b/drivers/gpu/drm/xe/xe_device_types.h > > @@ -30,6 +30,7 @@ > > #include "xe_sysctrl_types.h" > > #include "xe_tile_types.h" > > #include "xe_validation.h" > > +#include "xe_wedge_types.h" > > > > #if IS_ENABLED(CONFIG_DRM_XE_DEBUG) > > #define TEST_VM_OPS_ERROR > > @@ -45,22 +46,6 @@ struct xe_pxp; > > struct xe_ttm_stolen_mgr; > > struct xe_vram_region; > > > > -/** > > - * enum xe_wedged_mode - possible wedged modes > > - * @XE_WEDGED_MODE_NEVER: Device will never be declared wedged. > > - * @XE_WEDGED_MODE_UPON_CRITICAL_ERROR: Device will be declared wedged only > > - * when critical error occurs like GT reset failure or firmware failure. > > - * This is the default mode. > > - * @XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET: Device will be declared wedged on > > - * any hang. In this mode, engine resets are disabled to avoid automatic > > - * recovery attempts. This mode is primarily intended for debugging hangs. > > - */ > > -enum xe_wedged_mode { > > - XE_WEDGED_MODE_NEVER = 0, > > - XE_WEDGED_MODE_UPON_CRITICAL_ERROR = 1, > > - XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET = 2, > > -}; > > - > > #ifdef CONFIG_DRM_XE_DEBUG_PAGE_SIZE > > /** > > * enum xe_page_size_alloc_ctrl_mode - User BO page-size allocation control modes > > @@ -534,6 +519,8 @@ struct xe_device { > > unsigned long method; > > /** @wedged.inconsistent_reset: Inconsistent reset policy state between GTs */ > > bool inconsistent_reset; > > + /** @wedged.work: Worker for wedge handling to be done async */ > > + struct work_struct work; > > } wedged; > > > > /** @devres_group: devres group */ > > diff --git a/drivers/gpu/drm/xe/xe_wedge.c b/drivers/gpu/drm/xe/xe_wedge.c > > new file mode 100644 > > index 000000000000..52d4661a2dee > > --- /dev/null > > +++ b/drivers/gpu/drm/xe/xe_wedge.c > > @@ -0,0 +1,214 @@ > > +// SPDX-License-Identifier: MIT > > +/* > > + * Copyright © 2026 Intel Corporation > > + */ > > + > > +#include > > +#include > > + > > +#include "xe_defaults.h" > > +#include "xe_device_types.h" > > +#include "xe_gt.h" > > +#include "xe_log.h" > > +#include "xe_module.h" > > +#include "xe_pm.h" > > +#include "xe_printk.h" > > +#include "xe_wedge.h" > > + > > +/** > > + * 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. The conditions under which the driver declares the device wedged > > + * depend on the wedged mode configuration (see &enum xe_wedged_mode). The > > + * default recovery method for a wedged state is rebind/bus-reset. > > + * > > + * Another recovery method is vendor-specific. Below are the cases that send > > + * ``WEDGED=vendor-specific`` recovery method in drm device wedged uevent. > > + * > > + * Case: Firmware Flash > > + * -------------------- > > + * > > + * Identification Hint > > + * +++++++++++++++++++ > > + * > > + * ``WEDGED=vendor-specific`` drm device wedged uevent with > > + * :ref:`Runtime Survivability mode ` is used to notify > > + * admin/userspace consumer about the need for a firmware flash. > > + * > > + * Recovery Procedure > > + * ++++++++++++++++++ > > + * > > + * Once ``WEDGED=vendor-specific`` drm device wedged uevent is received, follow > > + * the below steps > > + * > > + * - Check Runtime Survivability mode sysfs. > > + * If enabled, firmware flash is required to recover the device. > > + * > > + * /sys/bus/pci/devices//survivability_mode > > + * > > + * - Admin/userspace consumer can use firmware flashing tools like fwupd to flash > > + * firmware and restore device to normal operation. > > + */ > > + > > +/** > > + * xe_device_set_wedged_method() - Set wedged recovery method > > + * @xe: xe device instance > > + * @method: recovery method to set > > + * > > + * Set wedged recovery method to be sent in drm wedged uevent. > > + */ > > +void xe_device_set_wedged_method(struct xe_device *xe, unsigned long method) > > +{ > > + xe->wedged.method = method; > > +} > > + > > +/** > > + * xe_device_wedged() - Check for wedged device > > + * @xe: xe device instance > > + * > > + * Returns: %true if device is wedged, %false otherwise. > > + */ > > +bool xe_device_wedged(struct xe_device *xe) > > +{ > > + return atomic_read(&xe->wedged.flag); > > +} > > + > > +#define WEDGED_URL "https://docs.kernel.org/gpu/drm-uapi.html#device-wedging" > > +#define XE_BUG_URL "https://gitlab.freedesktop.org/drm/xe/kernel/issues/new" > > + > > +static void wedged_work(struct work_struct *work) > > +{ > > + struct xe_device *xe = container_of(work, struct xe_device, wedged.work); > > + struct xe_gt *gt; > > + u8 id; > > + > > + for_each_gt(gt, xe, id) > > + xe_gt_declare_wedged(gt); > > + > > + /* > > + * XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET is intended for debugging > > + * hangs, so wedge the device with 'none' recovery method and have > > + * it available to the user for debugging. > > + */ > > + if (xe->wedged.mode == XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET) > > + xe_device_set_wedged_method(xe, DRM_WEDGE_RECOVERY_NONE); > > + /* If no wedge recovery method is set, use default */ > > + else if (!xe->wedged.method) > > + xe_device_set_wedged_method(xe, DRM_WEDGE_RECOVERY_REBIND | > > + DRM_WEDGE_RECOVERY_BUS_RESET); > > + > > + /* Notify userspace of wedged device */ > > + drm_dev_wedged_event(&xe->drm, xe->wedged.method, NULL); > > +} > > + > > +/** > > + * xe_device_declare_wedged - Declare device wedged > > + * @xe: xe device instance > > + * > > + * This is a final state that can only be cleared with the recovery method > > + * specified in the drm wedged uevent. The method can be set using > > + * xe_device_set_wedged_method before declaring the device as wedged. If no method > > + * is set, reprobe (unbind/re-bind) will be sent by default. > > + * > > + * In this state every IOCTL will be blocked so the GT cannot be used. > > + * In general it will be called upon any critical error such as gt reset > > + * failure or guc loading failure. Userspace will be notified of this state > > + * through device wedged uevent. > > + * If xe.wedged module parameter is set to 2, this function will be called > > + * on every single execution timeout (a.k.a. GPU hang) right after devcoredump > > + * snapshot capture. In this mode, GT reset won't be attempted so the state of > > + * the issue is preserved for further debugging. > > + */ > > +void xe_device_declare_wedged(struct xe_device *xe) > > +{ > > + if (xe->wedged.mode == XE_WEDGED_MODE_NEVER) { > > + drm_dbg(&xe->drm, "Wedged mode is forcibly disabled\n"); > > + return; > > + } > > + > > + if (!atomic_xchg(&xe->wedged.flag, 1)) { > > + xe->needs_flr_on_fini = true; > > + xe_pm_runtime_get_noresume(xe); > > + > > + xe_log_err_fatal(xe, WEDGED, -EIO, "Device declared wedged!\n"); > > + xe_err_once(xe, "IOCTLs and executions are now blocked!\n" > > + "For recovery procedure, refer to %s\n" > > + "Please file a _new_ bug report at %s\n", > > + WEDGED_URL, XE_BUG_URL); > > + > > + schedule_work(&xe->wedged.work); > > + } > > +} > > + > > +/** > > + * xe_device_validate_wedged_mode - Check if given mode is supported > > + * @xe: the &xe_device > > + * @mode: requested mode to validate > > + * > > + * Check whether the provided wedged mode is supported. > > + * > > + * Return: 0 if mode is supported, error code otherwise. > > + */ > > +int xe_device_validate_wedged_mode(struct xe_device *xe, unsigned int mode) > > +{ > > + if (mode > XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET) { > > + drm_dbg(&xe->drm, "wedged_mode: invalid value (%u)\n", mode); > > + return -EINVAL; > > + } else if (mode == XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET && (IS_SRIOV_VF(xe) || > > + (IS_SRIOV_PF(xe) && !IS_ENABLED(CONFIG_DRM_XE_DEBUG)))) { > > + drm_dbg(&xe->drm, "wedged_mode: (%u) %s mode is not supported for %s\n", > > + mode, xe_wedged_mode_to_string(mode), > > + xe_sriov_mode_to_string(xe_device_sriov_mode(xe))); > > + return -EPERM; > > + } > > + > > + return 0; > > +} > > + > > +/** > > + * xe_wedged_mode_to_string - Convert enum value to string. > > + * @mode: the &xe_wedged_mode to convert > > + * > > + * Returns: wedged mode as a user friendly string. > > + */ > > +const char *xe_wedged_mode_to_string(enum xe_wedged_mode mode) > > +{ > > + switch (mode) { > > + case XE_WEDGED_MODE_NEVER: > > + return "never"; > > + case XE_WEDGED_MODE_UPON_CRITICAL_ERROR: > > + return "upon-critical-error"; > > + case XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET: > > + return "upon-any-hang-no-reset"; > > + default: > > + return ""; > > + } > > +} > > + > > +void xe_device_wedged_init_early(struct xe_device *xe) > > +{ > > + xe->wedged.mode = xe_device_validate_wedged_mode(xe, xe_modparam.wedged_mode) ? > > + XE_DEFAULT_WEDGED_MODE : xe_modparam.wedged_mode; > > + drm_dbg(&xe->drm, "wedged_mode: setting mode (%u) %s\n", > > + xe->wedged.mode, xe_wedged_mode_to_string(xe->wedged.mode)); > > +} > > + > > +static void xe_device_wedged_fini(struct drm_device *drm, void *arg) > > +{ > > + struct xe_device *xe = arg; > > + > > + disable_work_sync(&xe->wedged.work); > > + > > + if (atomic_read(&xe->wedged.flag)) > > + xe_pm_runtime_put(xe); > > +} > > + > > +int xe_device_wedged_init(struct xe_device *xe) > > +{ > > + INIT_WORK(&xe->wedged.work, wedged_work); > > + > > + return drmm_add_action_or_reset(&xe->drm, xe_device_wedged_fini, xe); > > +} > > + > > diff --git a/drivers/gpu/drm/xe/xe_wedge.h b/drivers/gpu/drm/xe/xe_wedge.h > > new file mode 100644 > > index 000000000000..fedb30c99398 > > --- /dev/null > > +++ b/drivers/gpu/drm/xe/xe_wedge.h > > @@ -0,0 +1,24 @@ > > +/* SPDX-License-Identifier: MIT */ > > +/* > > + * Copyright © 2026 Intel Corporation > > + */ > > + > > +#ifndef _XE_WEDGE_H_ > > +#define _XE_WEDGE_H_ > > + > > +#include > > +#include > > + > > +#include "xe_wedge_types.h" > > + > > +struct xe_device; > > + > > +void xe_device_wedged_init_early(struct xe_device *xe); > > +int xe_device_wedged_init(struct xe_device *xe); > > +void xe_device_set_wedged_method(struct xe_device *xe, unsigned long method); > > +void xe_device_declare_wedged(struct xe_device *xe); > > +bool xe_device_wedged(struct xe_device *xe); > > +int xe_device_validate_wedged_mode(struct xe_device *xe, unsigned int mode); > > +const char *xe_wedged_mode_to_string(enum xe_wedged_mode mode); > > + > > +#endif > > diff --git a/drivers/gpu/drm/xe/xe_wedge_types.h b/drivers/gpu/drm/xe/xe_wedge_types.h > > new file mode 100644 > > index 000000000000..ffe7f9c64166 > > --- /dev/null > > +++ b/drivers/gpu/drm/xe/xe_wedge_types.h > > @@ -0,0 +1,25 @@ > > +/* SPDX-License-Identifier: MIT */ > > +/* > > + * Copyright © 2026 Intel Corporation > > + */ > > + > > +#ifndef _XE_WEDGE_TYPES_H_ > > +#define _XE_WEDGE_TYPES_H_ > > + > > +/** > > + * enum xe_wedged_mode - possible wedged modes > > + * @XE_WEDGED_MODE_NEVER: Device will never be declared wedged. > > + * @XE_WEDGED_MODE_UPON_CRITICAL_ERROR: Device will be declared wedged only > > + * when critical error occurs like GT reset failure or firmware failure. > > + * This is the default mode. > > + * @XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET: Device will be declared wedged on > > + * any hang. In this mode, engine resets are disabled to avoid automatic > > + * recovery attempts. This mode is primarily intended for debugging hangs. > > + */ > > +enum xe_wedged_mode { > > + XE_WEDGED_MODE_NEVER = 0, > > + XE_WEDGED_MODE_UPON_CRITICAL_ERROR = 1, > > + XE_WEDGED_MODE_UPON_ANY_HANG_NO_RESET = 2, > > +}; > > + > > +#endif > > -- > > 2.43.0 > >