Quelle  debugfs-driver-qat   Sprache: Text

What:  /sys/kernel/debug/qat_<device>_<BDF>/fw_counters
Date:  November 2023
KernelVersion: 6.6
Contact: qat-linux@intel.com
Description: (RO) Read returns the number of requests sent to the FW and the number of responses
  received from the FW for each Acceleration Engine
  Reported firmware counters::

   <N>: Number of requests sent from Acceleration Engine N to FW and responses
        Acceleration Engine N received from FW

What:  /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/config
Date:  November 2023
KernelVersion: 6.6
Contact: qat-linux@intel.com
Description: (RW) Read returns value of the Heartbeat update period.
  Write to the file changes this period value.

  This period should reflect planned polling interval of device
  health status. High frequency Heartbeat monitoring wastes CPU cycles
  but minimizes the customer’s system downtime. Also, if there are
  large service requests that take some time to complete, high frequency
  Heartbeat monitoring could result in false reports of unresponsiveness
  and in those cases, period needs to be increased.

  This parameter is effective only for c3xxx, c62x, dh895xcc devices.
  4xxx has this value internally fixed to 200ms.

  Default value is set to 500. Minimal allowed value is 200.
  All values are expressed in milliseconds.

What:  /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/queries_failed
Date:  November 2023
KernelVersion: 6.6
Contact: qat-linux@intel.com
Description: (RO) Read returns the number of times the device became unresponsive.

  Attribute returns value of the counter which is incremented when
  status query results negative.

What:  /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/queries_sent
Date:  November 2023
KernelVersion: 6.6
Contact: qat-linux@intel.com
Description: (RO) Read returns the number of times the control process checked
  if the device is responsive.

  Attribute returns value of the counter which is incremented on
  every status query.

What:  /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/status
Date:  November 2023
KernelVersion: 6.6
Contact: qat-linux@intel.com
Description: (RO) Read returns the device health status.

  Returns 0 when device is healthy or -1 when is unresponsive
  or the query failed to send.

  The driver does not monitor for Heartbeat. It is left for a user
  to poll the status periodically.

What:  /sys/kernel/debug/qat_<device>_<BDF>/pm_status
Date:  January 2024
KernelVersion: 6.7
Contact: qat-linux@intel.com
Description: (RO) Read returns power management information specific to the
  QAT device.

  This attribute is only available for qat_4xxx and qat_6xxx devices.

What:  /sys/kernel/debug/qat_<device>_<BDF>/cnv_errors
Date:  January 2024
KernelVersion: 6.7
Contact: qat-linux@intel.com
Description: (RO) Read returns, for each Acceleration Engine (AE), the number
  of errors and the type of the last error detected by the device
  when performing verified compression.
  Reported counters::

   <N>: Number of Compress and Verify (CnV) errors and type
        of the last CnV error detected by Acceleration
        Engine N.

What:  /sys/kernel/debug/qat_<device>_<BDF>/heartbeat/inject_error
Date:  March 2024
KernelVersion: 6.8
Contact: qat-linux@intel.com
Description: (WO) Write to inject an error that simulates an heartbeat
  failure. This is to be used for testing purposes.

  After writing this file, the driver stops arbitration on a
  random engine and disables the fetching of heartbeat counters.
  If a workload is running on the device, a job submitted to the
  accelerator might not get a response and a read of the
  `heartbeat/status` attribute might report -1, i.e. device
  unresponsive.
  The error is unrecoverable thus the device must be restarted to
  restore its functionality.

  This attribute is available only when the kernel is built with
  CONFIG_CRYPTO_DEV_QAT_ERROR_INJECTION=y.

  A write of 1 enables error injection.

  The following example shows how to enable error injection::

   # cd /sys/kernel/debug/qat_<device>_<BDF>
   # echo 1 > heartbeat/inject_error