public-mirrors/linux
1
0
Fork 0
mirror of git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git synced 2025-08-05 16:54:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Documentation: qat: update sysfs-driver-qat for GEN6 devices

Browse source 
Reorganize and expand documentation for service configurations. This
reworks the `cfg_services` section by removing explicit service
combinations (e.g., asym;sym, sym;asym) and clarifying that multiple
services can be configured in any order.

Update the documentation to reflect that the attribute previously limited
to qat_4xxx devices is also applicable to qat_6xxx devices.

Signed-off-by: Suman Kumar Chakraborty <suman.kumar.chakraborty@intel.com>
Reviewed-by: Giovanni Cabiddu <giovanni.cabiddu@intel.com>
Reviewed-by: Fiona Trahe <fiona.trahe@intel.com>
Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>
This commit is contained in:
Suman Kumar Chakraborty 2025-06-05 12:25:27 +01:00 • committed by Herbert Xu
parent 8f2e1a3cd7
commit 1029436218
1 changed files with 27 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

50
Documentation/ABI/testing/sysfs-driver-qat
View file

@ -14,7 +14,7 @@ Description: (RW) Reports the current state of the QAT device. Write to
It is possible to transition the device from up to down only It is possible to transition the device from up to down only
if the device is up and vice versa. if the device is up and vice versa.
This attribute is only available for qat_4xxx devices. This attribute is available for qat_4xxx and qat_6xxx devices.
What: /sys/bus/pci/devices/<BDF>/qat/cfg_services What: /sys/bus/pci/devices/<BDF>/qat/cfg_services
Date: June 2022 Date: June 2022
@ -23,24 +23,28 @@ Contact: qat-linux@intel.com
Description: (RW) Reports the current configuration of the QAT device. Description: (RW) Reports the current configuration of the QAT device.
Write to the file to change the configured services. Write to the file to change the configured services.
The values are: One or more services can be enabled per device.
Certain configurations are restricted to specific device types;
where applicable this is explicitly indicated, for example
(qat_6xxx) denotes applicability exclusively to that device series.
* sym;asym: the device is configured for running crypto The available services include:
services
* asym;sym: identical to sym;asym * sym: Configures the device for symmetric cryptographic operations.
* dc: the device is configured for running compression services * asym: Configures the device for asymmetric cryptographic operations.
* dcc: identical to dc but enables the dc chaining feature, * dc: Configures the device for compression and decompression
hash then compression. If this is not required chose dc operations.
* sym: the device is configured for running symmetric crypto * dcc: Similar to dc, but with the additional dc chaining feature
services enabled, cipher then compress (qat_6xxx), hash then compression.
* asym: the device is configured for running asymmetric crypto If this is not required choose dc.
services * decomp: Configures the device for decompression operations (qat_6xxx).
* asym;dc: the device is configured for running asymmetric
crypto services and compression services Service combinations are permitted for all services except dcc.
* dc;asym: identical to asym;dc On QAT GEN4 devices (qat_4xxx driver) a maximum of two services can be
* sym;dc: the device is configured for running symmetric crypto combined and on QAT GEN6 devices (qat_6xxx driver ) a maximum of three
services and compression services services can be combined.
* dc;sym: identical to sym;dc The order of services is not significant. For instance, sym;asym is
functionally equivalent to asym;sym.
It is possible to set the configuration only if the device It is possible to set the configuration only if the device
is in the `down` state (see /sys/bus/pci/devices/<BDF>/qat/state) is in the `down` state (see /sys/bus/pci/devices/<BDF>/qat/state)
@ -59,7 +63,7 @@ Description: (RW) Reports the current configuration of the QAT device.
# cat /sys/bus/pci/devices/<BDF>/qat/cfg_services # cat /sys/bus/pci/devices/<BDF>/qat/cfg_services
dc dc
This attribute is only available for qat_4xxx devices. This attribute is available for qat_4xxx and qat_6xxx devices.
What: /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled What: /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled
Date: June 2023 Date: June 2023
@ -94,7 +98,7 @@ Description: (RW) This configuration option provides a way to force the device i
# cat /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled # cat /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled
0 0
This attribute is only available for qat_4xxx devices. This attribute is available for qat_4xxx and qat_6xxx devices.
What: /sys/bus/pci/devices/<BDF>/qat/rp2srv What: /sys/bus/pci/devices/<BDF>/qat/rp2srv
Date: January 2024 Date: January 2024
@ -126,7 +130,7 @@ Description:
# cat /sys/bus/pci/devices/<BDF>/qat/rp2srv # cat /sys/bus/pci/devices/<BDF>/qat/rp2srv
sym sym
This attribute is only available for qat_4xxx devices. This attribute is available for qat_4xxx and qat_6xxx devices.
What: /sys/bus/pci/devices/<BDF>/qat/num_rps What: /sys/bus/pci/devices/<BDF>/qat/num_rps
Date: January 2024 Date: January 2024
@ -140,7 +144,7 @@ Description:
# cat /sys/bus/pci/devices/<BDF>/qat/num_rps # cat /sys/bus/pci/devices/<BDF>/qat/num_rps
64 64
This attribute is only available for qat_4xxx devices. This attribute is available for qat_4xxx and qat_6xxx devices.
What: /sys/bus/pci/devices/<BDF>/qat/auto_reset What: /sys/bus/pci/devices/<BDF>/qat/auto_reset
Date: May 2024 Date: May 2024
@ -160,4 +164,4 @@ Description: (RW) Reports the current state of the autoreset feature
* 0/Nn/off: auto reset disabled. If the device encounters an * 0/Nn/off: auto reset disabled. If the device encounters an
unrecoverable error, it will not be reset. unrecoverable error, it will not be reset.
This attribute is only available for qat_4xxx devices. This attribute is available for qat_4xxx and qat_6xxx devices.