Re: [PATCH i-g-t v6] tests/intel/xe_ras: Add test for GPU health indicator

["Tauro, Riana" <riana.tauro@intel.com>]

On 05-10-2026 23:17, Soham Purkait wrote:
> Add a new Xe RAS test exercising the gpu_health sysfs attribute
> exposed by the Xe driver on platforms that provide the system
> controller. The attribute reports and allows updating the GPU
> health state.
>
> The gpu-health subtest validates each valid state by writing it
> and reading the value back, and checks that invalid writes are
> rejected with -EINVAL, guarding against regressions.
>
> v1:
>   - Add platform-conditional skip and exit handler. (Anirban)
> v2:
>   - Add dynamic subtests for each case. (Riana)
> v3:
>   - Add health state description.
>   - Store original health state as an index instead of a char pointer. (Riana)
>
> Signed-off-by: Soham Purkait <soham.purkait@intel.com>
> Reviewed-by: Sk Anirban <sk.anirban@intel.com>

LGTM

Reviewed-by: Riana Tauro <riana.tauro@intel.com>


> ---
>   tests/intel/xe_ras.c | 158 +++++++++++++++++++++++++++++++++++++++++++
>   tests/meson.build    |   1 +
>   2 files changed, 159 insertions(+)
>   create mode 100644 tests/intel/xe_ras.c
>
> diff --git a/tests/intel/xe_ras.c b/tests/intel/xe_ras.c
> new file mode 100644
> index 000000000..c98a10f00
> --- /dev/null
> +++ b/tests/intel/xe_ras.c
> @@ -0,0 +1,158 @@
> +// SPDX-License-Identifier: MIT
> +/*
> + * Copyright © 2026 Intel Corporation
> + */
> +
> +#include <errno.h>
> +#include <string.h>
> +#include <unistd.h>
> +
> +#include "igt.h"
> +#include "igt_sysfs.h"
> +
> +/**
> + * TEST: Test Xe RAS (Reliability, Availability, Serviceability) functionality
> + * Category: Core
> + * Mega feature: RAS
> + * Sub-category: RAS tests
> + * Functionality: ras
> + * Test category: Functional tests
> + *
> + * SUBTEST: gpu-health
> + * Description: Verify the gpu_health sysfs attribute accepts each valid state
> + *		and rejects invalid writes with -EINVAL.
> + *		The valid states 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.
> + */
> +
> +IGT_TEST_DESCRIPTION("Tests for Xe RAS");
> +
> +#define GPU_HEALTH_ATTR	"device/gpu_health"
> +
> +static const char * const gpu_health_states[] = {
> +	"ok",
> +	"warning",
> +	"critical",
> +	"invalid-input",
> +};
> +
> +#define GPU_HEALTH_VALID_STATE_COUNT (ARRAY_SIZE(gpu_health_states) - 1)
> +
> +static struct {
> +	int sys_fd;
> +	int orig_health;
> +} gpu_health_ctx = { .sys_fd = -1, .orig_health = -1 };
> +
> +static void restore_gpu_health(int sig)
> +{
> +	if (gpu_health_ctx.sys_fd < 0)
> +		return;
> +
> +	if (gpu_health_ctx.orig_health >= 0) {
> +		igt_sysfs_set(gpu_health_ctx.sys_fd, GPU_HEALTH_ATTR,
> +			      gpu_health_states[gpu_health_ctx.orig_health]);
> +		igt_info("Restored initial gpu_health to '%s'\n",
> +			 gpu_health_states[gpu_health_ctx.orig_health]);
> +		gpu_health_ctx.orig_health = -1;
> +	}
> +	close(gpu_health_ctx.sys_fd);
> +	gpu_health_ctx.sys_fd = -1;
> +}
> +
> +static bool valid_gpu_health(const char *s)
> +{
> +	int i;
> +
> +	if (!s)
> +		return false;
> +
> +	for (i = 0; i < GPU_HEALTH_VALID_STATE_COUNT; i++)
> +		if (!strcmp(s, gpu_health_states[i]))
> +			return true;
> +
> +	return false;
> +}
> +
> +static void setup_gpu_health(int xe)
> +{
> +	char *health;
> +	int i;
> +
> +	gpu_health_ctx.sys_fd = igt_sysfs_open(xe);
> +	igt_assert(gpu_health_ctx.sys_fd >= 0);
> +
> +	igt_skip_on_f(!igt_sysfs_has_attr(gpu_health_ctx.sys_fd, GPU_HEALTH_ATTR),
> +		      "gpu_health sysfs attribute not exposed by driver\n");
> +
> +	health = igt_sysfs_get(gpu_health_ctx.sys_fd, GPU_HEALTH_ATTR);
> +	igt_assert_f(valid_gpu_health(health),
> +		     "Unexpected initial gpu_health value: '%s'\n", health);
> +
> +	for (i = 0; i < GPU_HEALTH_VALID_STATE_COUNT; i++)
> +		if (!strcmp(health, gpu_health_states[i]))
> +			gpu_health_ctx.orig_health = i;
> +
> +	igt_info("Initial gpu_health: %s\n", health);
> +	free(health);
> +}
> +
> +static void test_gpu_health_state(const char *state)
> +{
> +	char *health;
> +	int ret;
> +
> +	if (!valid_gpu_health(state)) {
> +		ret = igt_sysfs_write(gpu_health_ctx.sys_fd, GPU_HEALTH_ATTR,
> +				      state, strlen(state));
> +		igt_assert_f(ret == -EINVAL,
> +			     "Writing invalid value to %s returned %d, expected -EINVAL\n",
> +			     GPU_HEALTH_ATTR, ret);
> +		return;
> +	}
> +
> +	igt_info("Setting gpu_health to '%s'\n", state);
> +
> +	igt_assert_f(igt_sysfs_set(gpu_health_ctx.sys_fd, GPU_HEALTH_ATTR, state),
> +		     "Failed to write '%s' to %s\n",
> +		     state, GPU_HEALTH_ATTR);
> +
> +	health = igt_sysfs_get(gpu_health_ctx.sys_fd, GPU_HEALTH_ATTR);
> +	igt_assert(health);
> +	igt_assert_f(!strcmp(health, state),
> +		     "gpu_health readback mismatch: wrote '%s', read '%s'\n",
> +		     state, health);
> +	igt_info("Verified gpu_health state readback for '%s' successfully\n",
> +		 state);
> +	free(health);
> +}
> +
> +int igt_main()
> +{
> +	int xe;
> +	int state;
> +
> +	igt_fixture() {
> +		xe = drm_open_driver(DRIVER_XE);
> +	}
> +
> +	igt_subtest_with_dynamic("gpu-health") {
> +		igt_install_exit_handler(restore_gpu_health);
> +		setup_gpu_health(xe);
> +
> +		for (state = 0; state < ARRAY_SIZE(gpu_health_states); state++) {
> +			igt_dynamic_f("%s", gpu_health_states[state]) {
> +				test_gpu_health_state(gpu_health_states[state]);
> +			}
> +		}
> +
> +		restore_gpu_health(0);
> +	}
> +
> +	igt_fixture()
> +		drm_close_driver(xe);
> +}
> diff --git a/tests/meson.build b/tests/meson.build
> index 1ac89bab7..3c2d4fdda 100644
> --- a/tests/meson.build
> +++ b/tests/meson.build
> @@ -333,6 +333,7 @@ intel_xe_progs = [
>   	'xe_prime_self_import',
>   	'xe_pxp',
>   	'xe_query',
> +	'xe_ras',
>   	'xe_render_copy',
>   	'xe_vm',
>   	'xe_userptr_pressure',