linux/Documentation/ABI/testing/sysfs-driver-intel-xe-ras
Soham Purkait 53a7115f98 drm/xe/xe_ras: Add RAS GPU health indicator
Add a sysfs interface that reports the current GPU health state and
lets admin users and management tools update it but is readable by all
users. Requests are routed through the sysctrl mailbox. The interface
is present only on platforms that support the GPU health indicator.

The interface is a single read/write file at the device level:

  $ cat /sys/.../device/gpu_health
  ok

  $ echo critical > /sys/.../device/gpu_health

  $ cat /sys/.../device/gpu_health
  critical

Signed-off-by: Soham Purkait <soham.purkait@intel.com>
Acked-by: Rodrigo Vivi <rodrigo.vivi@intel.com>
Acked-by: Raag Jadav <raag.jadav@intel.com>
Reviewed-by: Andi Shyti <andi.shyti@linux.intel.com>
Reviewed-by: Badal Nilawar <badal.nilawar@intel.com>
Link: https://patch.msgid.link/20260716073600.674089-4-soham.purkait@intel.com
Signed-off-by: Riana Tauro <riana.tauro@intel.com>
2026-07-17 10:18:12 +05:30

31 lines
948 B
Plaintext

What: /sys/bus/pci/drivers/xe/.../gpu_health
Date: July 2026
KernelVersion: 7.3
Contact: intel-xe@lists.freedesktop.org
Description:
This file exposes the current gpu health state and allows the gpu
health state to be updated.
This sysfs file is present only on Intel Xe platforms that support
the gpu health indicator interface for RAS. Reading the current
health state is available to all users, while updating the health
state is restricted to administrative users only.
Read returns a single line containing one of the valid values for
the current gpu health state. Writing one of the valid values
updates the current gpu health state.
The valid values for the gpu health state are:
ok
The gpu is healthy and operating within normal
parameters.
warning
The gpu is experiencing minor issues but remains
operational.
critical
The gpu is in a critical state and may not be
operational.