110 lines · plain
1What: /sys/kernel/debug/qat_<device>_<BDF>/fw_counters2Date: November 20233KernelVersion: 6.64Contact: qat-linux@intel.com5Description: (RO) Read returns the number of requests sent to the FW and the number of responses6 received from the FW for each Acceleration Engine7 Reported firmware counters::8 9 <N>: Number of requests sent from Acceleration Engine N to FW and responses10 Acceleration Engine N received from FW11 12What: /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/config13Date: November 202314KernelVersion: 6.615Contact: qat-linux@intel.com16Description: (RW) Read returns value of the Heartbeat update period.17 Write to the file changes this period value.18 19 This period should reflect planned polling interval of device20 health status. High frequency Heartbeat monitoring wastes CPU cycles21 but minimizes the customer’s system downtime. Also, if there are22 large service requests that take some time to complete, high frequency23 Heartbeat monitoring could result in false reports of unresponsiveness24 and in those cases, period needs to be increased.25 26 This parameter is effective only for c3xxx, c62x, dh895xcc devices.27 4xxx has this value internally fixed to 200ms.28 29 Default value is set to 500. Minimal allowed value is 200.30 All values are expressed in milliseconds.31 32What: /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/queries_failed33Date: November 202334KernelVersion: 6.635Contact: qat-linux@intel.com36Description: (RO) Read returns the number of times the device became unresponsive.37 38 Attribute returns value of the counter which is incremented when39 status query results negative.40 41What: /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/queries_sent42Date: November 202343KernelVersion: 6.644Contact: qat-linux@intel.com45Description: (RO) Read returns the number of times the control process checked46 if the device is responsive.47 48 Attribute returns value of the counter which is incremented on49 every status query.50 51What: /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/status52Date: November 202353KernelVersion: 6.654Contact: qat-linux@intel.com55Description: (RO) Read returns the device health status.56 57 Returns 0 when device is healthy or -1 when is unresponsive58 or the query failed to send.59 60 The driver does not monitor for Heartbeat. It is left for a user61 to poll the status periodically.62 63What: /sys/kernel/debug/qat_<device>_<BDF>/pm_status64Date: January 202465KernelVersion: 6.766Contact: qat-linux@intel.com67Description: (RO) Read returns power management information specific to the68 QAT device.69 70 This attribute is only available for qat_4xxx devices.71 72What: /sys/kernel/debug/qat_<device>_<BDF>/cnv_errors73Date: January 202474KernelVersion: 6.775Contact: qat-linux@intel.com76Description: (RO) Read returns, for each Acceleration Engine (AE), the number77 of errors and the type of the last error detected by the device78 when performing verified compression.79 Reported counters::80 81 <N>: Number of Compress and Verify (CnV) errors and type82 of the last CnV error detected by Acceleration83 Engine N.84 85What: /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/inject_error86Date: March 202487KernelVersion: 6.888Contact: qat-linux@intel.com89Description: (WO) Write to inject an error that simulates an heartbeat90 failure. This is to be used for testing purposes.91 92 After writing this file, the driver stops arbitration on a93 random engine and disables the fetching of heartbeat counters.94 If a workload is running on the device, a job submitted to the95 accelerator might not get a response and a read of the96 `heartbeat/status` attribute might report -1, i.e. device97 unresponsive.98 The error is unrecoverable thus the device must be restarted to99 restore its functionality.100 101 This attribute is available only when the kernel is built with102 CONFIG_CRYPTO_DEV_QAT_ERROR_INJECTION=y.103 104 A write of 1 enables error injection.105 106 The following example shows how to enable error injection::107 108 # cd /sys/kernel/debug/qat_<device>_<BDF>109 # echo 1 > heartbeat/inject_error110