Commit 83631c7b authored by Dave Airlie's avatar Dave Airlie
Browse files

Merge tag 'drm-xe-next-2025-08-29' of https://gitlab.freedesktop.org/drm/xe/kernel into drm-next 



UAPI Changes:
 - Add madvise interface (Himal Prasad Ghimiray)
 - Add DRM_IOCTL_XE_VM_QUERY_MEMORY_RANGE_ATTRS to query VMA count and
   memory attributes (Himal Prasad Ghimiray)
 - Handle Firmware reported Hardware Errors notifying userspace with
   device wedged uevent (Riana Tauro)

Cross-subsystem Changes:

 - Add a vendor-specific recovery method to drm device wedged uevent
   (Riana Tauro)

Driver Changes:
 - Use same directory structure in debugfs as in sysfs (Michal Wajdeczko)
 - Cleanup and future-proof VRAM region initialization (Piotr Piórkowski)
 - Add G-states and PCIe link states to debugfs (Soham Purkait)
 - Cleanup eustall debug messages (Harish Chegondi)
 - Add SR-IOV support to restore Compression Control Surface (CCS) to
   Xe2 and later (Satyanarayana K V P)
 - Enable SR-IOV PF mode by default on supported platforms without
   needing CONFIG_DRM_XE_DEBUG and mark some platforms behind
   force_probe as supported (Michal Wajdeczko)
 - More targeted log messages (Michal Wajdeczko)
 - Cleanup STEER_SEMAPHORE/MCFG_MCR_SELECTOR usage (Nitin Gote)
 - Use common code to emit flush (Tvrtko Ursulin)
 - Add/extend more HW workarounds and tunings for Xe2 and Xe3
   (Sk Anirban, Tangudu Tilak Tirumalesh, Nitin Gote, Chaitanya Kumar Borah)
 - Add a generic dependency scheduler to help with TLB invalidations
   and future scenarios (Matthew Brost)
 - Use DRM scheduler for delayed GT TLB invalidations (Matthew Brost)
 - Error out on incorrect device use in configfs
   (Michal Wajdeczko, Lucas De Marchi)
 - Refactor configfs attributes (Michal Wajdeczko / Lucas De Marchi)
 - Allow configuring future VF devices via configfs (Michal Wajdeczko)
 - Implement some missing XeLP workarounds (Tvrtko Ursulin)
 - Generalize WA BB setup/emission and add support for
   mid context restore BB, aka indirect context (Tvrtko Ursulin)
 - Prepare the driver to expose mmio regions to userspace
   in future (Ilia Levi)
 - Add more GuC load error status codes (John Harrison)
 - Document DRM_XE_GEM_CREATE_FLAG_DEFER_BACKING (Priyanka Dandamudi)
 - Disable CSC and RPM on VFs (Lukasz Laguna, Satyanarayana K V P)
 - Fix oops in xe_gem_fault with PREEMPT_RT (Maarten Lankhorst)
 - Skip LMTT update if no LMEM was provisioned (Michal Wajdeczko)
 - Add support to VF migration (Tomasz Lis)
 - Use a helper for guc_waklv_enable functions (Jonathan Cavitt)
 - Prepare GPU SVM for migration of THP (Francois Dugast)
 - Program LMTT directory pointer on all GTs within a tile
   (Piotr Piórkowski)
 - Rename XE_WA to XE_GT_WA to better convey its scope vs the device WAs
   (Matt Atwood)
 - Allow to match devices on PCI devid/vendorid only (Lucas De Marchi)
 - Improve PDE PAT index selection (Matthew Brost)
 - Consolidate ASID allocation in xe_vm_create() vs
   xe_vm_create_ioctl() (Piotr Piórkowski)
 - Resize VF BARS to max possible size according to number of VFs
   (Michał Winiarski)
 - Untangle vm_bind_ioctl cleanup order (Christoph Manszewski)
 - Start fixing usage of XE_PAGE_SIZE vs PAGE_SIZE to improve
   compatibility with non-x86 arch (Simon Richter)
 - Improve tile vs gt initialization order and accounting
   (Gustavo Sousa)
 - Extend WA kunit test to PTL
 - Ensure data is initialized before transferring to pcode
   (Stuart Summers)
 - Add PSMI support for HW validation (Lucas De Marchi,
   Vinay Belgaumkar, Badal Nilawar)
 - Improve xe_dma_buf test (Thomas Hellström, Marcin Bernatowicz)
 - Fix basename() usage in generator with !glibc (Carlos Llamas)
 - Ensure GT is in C0 during resumes (Xin Wang)
 - Add TLB invalidation abstraction (Matt Brost, Stuart Summers)
 - Make MI_TLB_INVALIDATE conditional on migrate (Matthew Auld)
 - Prepare xe_nvm to be initialized early for future use cases
   (Riana Tauro)

Signed-off-by: default avatarDave Airlie <airlied@redhat.com>

From: Lucas De Marchi <lucas.demarchi@intel.com>
Link: https://lore.kernel.org/r/nuejxdhnalyok7tzwkrj67dwjgdafwp4mhdejpyyqnrh4f2epq@nlldovuflnbx
parents 14579a6f 1047bd82

Documentation/gpu/drm-uapi.rst

+40 −7
Original line number Diff line number Diff line
@@ -418,13 +418,12 @@ needed. 
Recovery

--------



Current implementation defines three recovery methods, out of which, drivers

Current implementation defines four recovery methods, out of which, drivers

can use any one, multiple or none. Method(s) of choice will be sent in the

uevent environment as ``WEDGED=<method1>[,..,<methodN>]`` in order of less to

more side-effects. If driver is unsure about recovery or method is unknown

(like soft/hard system reboot, firmware flashing, physical device replacement

or any other procedure which can't be attempted on the fly), ``WEDGED=unknown``

will be sent instead.

more side-effects. See the section `Vendor Specific Recovery`_

for ``WEDGED=vendor-specific``. If driver is unsure about recovery or

method is unknown, ``WEDGED=unknown`` will be sent instead.



Userspace consumers can parse this event and attempt recovery as per the

following expectations.
@@ -435,6 +434,7 @@ following expectations. 
    none            optional telemetry collection

    rebind          unbind + bind driver

    bus-reset       unbind + bus reset/re-enumeration + bind

    vendor-specific vendor specific recovery method

    unknown         consumer policy

    =============== ========================================
@@ -446,6 +446,35 @@ telemetry information (devcoredump, syslog). This is useful because the first 
hang is usually the most critical one which can result in consequential hangs or

complete wedging.





Vendor Specific Recovery

------------------------



When ``WEDGED=vendor-specific`` is sent, it indicates that the device requires

a recovery procedure specific to the hardware vendor and is not one of the

standardized approaches.



``WEDGED=vendor-specific`` may be used to indicate different cases within a

single vendor driver, each requiring a distinct recovery procedure.

In such scenarios, the vendor driver must provide comprehensive documentation

that describes each case, include additional hints to identify specific case and

outline the corresponding recovery procedure. The documentation includes:



Case - A list of all cases that sends the ``WEDGED=vendor-specific`` recovery method.



Hints - Additional Information to assist the userspace consumer in identifying and

differentiating between different cases. This can be exposed through sysfs, debugfs,

traces, dmesg etc.



Recovery Procedure - Clear instructions and guidance for recovering each case.

This may include userspace scripts, tools needed for the recovery procedure.



It is the responsibility of the admin/userspace consumer to identify the case and

verify additional identification hints before attempting a recovery procedure.



Example: If the device uses the Xe driver, then userspace consumer should refer to

:ref:`Xe Device Wedging <xe-device-wedging>` for the detailed documentation.



Task information

----------------
@@ -472,8 +501,12 @@ erroring out, all device memory should be unmapped and file descriptors should 
be closed to prevent leaks or undefined behaviour. The idea here is to clear the

device of all user context beforehand and set the stage for a clean recovery.



Example

-------

For ``WEDGED=vendor-specific`` recovery method, it is the responsibility of the

consumer to check the driver documentation and the usecase before attempting

a recovery.



Example - rebind

----------------



Udev rule::

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

Documentation/gpu/xe/xe_pcode.rst

+4 −2
Original line number Diff line number Diff line
@@ -13,9 +13,11 @@ Internal API 
.. kernel-doc:: drivers/gpu/drm/xe/xe_pcode.c

   :internal:



.. _xe-survivability-mode:



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

Boot Survivability

Survivability Mode

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



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

   :doc: Xe Boot Survivability
 
   :doc: Survivability Mode

drivers/gpu/drm/drm_drv.c

+2 −0
Original line number Diff line number Diff line
@@ -532,6 +532,8 @@ static const char *drm_get_wedge_recovery(unsigned int opt) 
		return "rebind";

	case DRM_WEDGE_RECOVERY_BUS_RESET:

		return "bus-reset";

	case DRM_WEDGE_RECOVERY_VENDOR:

		return "vendor-specific";

	default:

		return NULL;

	}