linux-yocto/Documentation/ABI/testing/sysfs-driver-qat_ras
Shashank Gupta 532d7f6bc4 crypto: qat - add error counters
Introduce ras counters interface for counting QAT specific device
errors and expose them through the newly created qat_ras sysfs
group attribute.

This adds the following attributes:

- errors_correctable: number of correctable errors
- errors_nonfatal: number of uncorrectable non fatal errors
- errors_fatal: number of uncorrectable fatal errors
- reset_error_counters: resets all counters

These counters are initialized during device bring up and cleared
during device shutdown and are applicable only to QAT GEN4 devices.

Signed-off-by: Shashank Gupta <shashank.gupta@intel.com>
Reviewed-by: Giovanni Cabiddu <giovanni.cabiddu@intel.com>
Reviewed-by: Tero Kristo <tero.kristo@linux.intel.com>
Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>
2023-10-27 18:04:27 +08:00

1.3 KiB

What: /sys/bus/pci/devices//qat_ras/errors_correctable Date: January 2024 KernelVersion: 6.7 Contact: qat-linux@intel.com Description: (RO) Reports the number of correctable errors detected by the device.

	This attribute is only available for qat_4xxx devices.

What: /sys/bus/pci/devices//qat_ras/errors_nonfatal Date: January 2024 KernelVersion: 6.7 Contact: qat-linux@intel.com Description: (RO) Reports the number of non fatal errors detected by the device.

	This attribute is only available for qat_4xxx devices.

What: /sys/bus/pci/devices//qat_ras/errors_fatal Date: January 2024 KernelVersion: 6.7 Contact: qat-linux@intel.com Description: (RO) Reports the number of fatal errors detected by the device.

	This attribute is only available for qat_4xxx devices.

What: /sys/bus/pci/devices//qat_ras/reset_error_counters Date: January 2024 KernelVersion: 6.7 Contact: qat-linux@intel.com Description: (WO) Write to resets all error counters of a device.

	The following example reports how to reset the counters::

		# echo 1 > /sys/bus/pci/devices/<BDF>/qat_ras/reset_error_counters
		# cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_correctable
		0
		# cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_nonfatal
		0
		# cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_fatal
		0

	This attribute is only available for qat_4xxx devices.