164 lines · plain
1What: /sys/bus/pci/devices/<BDF>/qat/state2Date: June 20223KernelVersion: 6.04Contact: qat-linux@intel.com5Description: (RW) Reports the current state of the QAT device. Write to6 the file to start or stop the device.7 8 The values are:9 10 * up: the device is up and running11 * down: the device is down12 13 14 It is possible to transition the device from up to down only15 if the device is up and vice versa.16 17 This attribute is only available for qat_4xxx devices.18 19What: /sys/bus/pci/devices/<BDF>/qat/cfg_services20Date: June 202221KernelVersion: 6.022Contact: qat-linux@intel.com23Description: (RW) Reports the current configuration of the QAT device.24 Write to the file to change the configured services.25 26 The values are:27 28 * sym;asym: the device is configured for running crypto29 services30 * asym;sym: identical to sym;asym31 * dc: the device is configured for running compression services32 * dcc: identical to dc but enables the dc chaining feature,33 hash then compression. If this is not required chose dc34 * sym: the device is configured for running symmetric crypto35 services36 * asym: the device is configured for running asymmetric crypto37 services38 * asym;dc: the device is configured for running asymmetric39 crypto services and compression services40 * dc;asym: identical to asym;dc41 * sym;dc: the device is configured for running symmetric crypto42 services and compression services43 * dc;sym: identical to sym;dc44 45 It is possible to set the configuration only if the device46 is in the `down` state (see /sys/bus/pci/devices/<BDF>/qat/state)47 48 The following example shows how to change the configuration of49 a device configured for running crypto services in order to50 run data compression::51 52 # cat /sys/bus/pci/devices/<BDF>/qat/state53 up54 # cat /sys/bus/pci/devices/<BDF>/qat/cfg_services55 sym;asym56 # echo down > /sys/bus/pci/devices/<BDF>/qat/state57 # echo dc > /sys/bus/pci/devices/<BDF>/qat/cfg_services58 # echo up > /sys/bus/pci/devices/<BDF>/qat/state59 # cat /sys/bus/pci/devices/<BDF>/qat/cfg_services60 dc61 62 This attribute is only available for qat_4xxx devices.63 64What: /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled65Date: June 202366KernelVersion: 6.567Contact: qat-linux@intel.com68Description: (RW) This configuration option provides a way to force the device into remaining in69 the MAX power state.70 If idle support is enabled the device will transition to the `MIN` power state when71 idle, otherwise will stay in the MAX power state.72 Write to the file to enable or disable idle support.73 74 The values are:75 76 * 0: idle support is disabled77 * 1: idle support is enabled78 79 Default value is 1.80 81 It is possible to set the pm_idle_enabled value only if the device82 is in the `down` state (see /sys/bus/pci/devices/<BDF>/qat/state)83 84 The following example shows how to change the pm_idle_enabled of85 a device::86 87 # cat /sys/bus/pci/devices/<BDF>/qat/state88 up89 # cat /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled90 191 # echo down > /sys/bus/pci/devices/<BDF>/qat/state92 # echo 0 > /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled93 # echo up > /sys/bus/pci/devices/<BDF>/qat/state94 # cat /sys/bus/pci/devices/<BDF>/qat/pm_idle_enabled95 096 97 This attribute is only available for qat_4xxx devices.98 99What: /sys/bus/pci/devices/<BDF>/qat/rp2srv100Date: January 2024101KernelVersion: 6.7102Contact: qat-linux@intel.com103Description:104 (RW) This attribute provides a way for a user to query a105 specific ring pair for the type of service that it is currently106 configured for.107 108 When written to, the value is cached and used to perform the109 read operation. Allowed values are in the range 0 to N-1, where110 N is the max number of ring pairs supported by a device. This111 can be queried using the attribute qat/num_rps.112 113 A read returns the service associated to the ring pair queried.114 115 The values are:116 117 * dc: the ring pair is configured for running compression services118 * sym: the ring pair is configured for running symmetric crypto119 services120 * asym: the ring pair is configured for running asymmetric crypto121 services122 123 Example usage::124 125 # echo 1 > /sys/bus/pci/devices/<BDF>/qat/rp2srv126 # cat /sys/bus/pci/devices/<BDF>/qat/rp2srv127 sym128 129 This attribute is only available for qat_4xxx devices.130 131What: /sys/bus/pci/devices/<BDF>/qat/num_rps132Date: January 2024133KernelVersion: 6.7134Contact: qat-linux@intel.com135Description:136 (RO) Returns the number of ring pairs that a single device has.137 138 Example usage::139 140 # cat /sys/bus/pci/devices/<BDF>/qat/num_rps141 64142 143 This attribute is only available for qat_4xxx devices.144 145What: /sys/bus/pci/devices/<BDF>/qat/auto_reset146Date: May 2024147KernelVersion: 6.9148Contact: qat-linux@intel.com149Description: (RW) Reports the current state of the autoreset feature150 for a QAT device151 152 Write to the attribute to enable or disable device auto reset.153 154 Device auto reset is disabled by default.155 156 The values are:157 158 * 1/Yy/on: auto reset enabled. If the device encounters an159 unrecoverable error, it will be reset automatically.160 * 0/Nn/off: auto reset disabled. If the device encounters an161 unrecoverable error, it will not be reset.162 163 This attribute is only available for qat_4xxx devices.164