1What: /sys/bus/dsa/devices/dsa<m>/version 2Date: Apr 15, 2020 3KernelVersion: 5.8.0 4Contact: dmaengine@vger.kernel.org 5Description: The hardware version number. 6 7What: /sys/bus/dsa/devices/dsa<m>/cdev_major 8Date: Oct 25, 2019 9KernelVersion: 5.6.0 10Contact: dmaengine@vger.kernel.org 11Description: The major number that the character device driver assigned to 12 this device. 13 14What: /sys/bus/dsa/devices/dsa<m>/errors 15Date: Oct 25, 2019 16KernelVersion: 5.6.0 17Contact: dmaengine@vger.kernel.org 18Description: The error information for this device. 19 20What: /sys/bus/dsa/devices/dsa<m>/max_batch_size 21Date: Oct 25, 2019 22KernelVersion: 5.6.0 23Contact: dmaengine@vger.kernel.org 24Description: The largest number of work descriptors in a batch. 25 26What: /sys/bus/dsa/devices/dsa<m>/max_work_queues_size 27Date: Oct 25, 2019 28KernelVersion: 5.6.0 29Contact: dmaengine@vger.kernel.org 30Description: The maximum work queue size supported by this device. 31 32What: /sys/bus/dsa/devices/dsa<m>/max_engines 33Date: Oct 25, 2019 34KernelVersion: 5.6.0 35Contact: dmaengine@vger.kernel.org 36Description: The maximum number of engines supported by this device. 37 38What: /sys/bus/dsa/devices/dsa<m>/max_groups 39Date: Oct 25, 2019 40KernelVersion: 5.6.0 41Contact: dmaengine@vger.kernel.org 42Description: The maximum number of groups can be created under this device. 43 44What: /sys/bus/dsa/devices/dsa<m>/max_read_buffers 45Date: Dec 10, 2021 46KernelVersion: 5.17.0 47Contact: dmaengine@vger.kernel.org 48Description: The total number of read buffers supported by this device. 49 The read buffers represent resources within the DSA 50 implementation, and these resources are allocated by engines to 51 support operations. See DSA spec v1.2 9.2.4 Total Read Buffers. 52 53What: /sys/bus/dsa/devices/dsa<m>/max_transfer_size 54Date: Oct 25, 2019 55KernelVersion: 5.6.0 56Contact: dmaengine@vger.kernel.org 57Description: The number of bytes to be read from the source address to 58 perform the operation. The maximum transfer size is dependent on 59 the workqueue the descriptor was submitted to. 60 61What: /sys/bus/dsa/devices/dsa<m>/max_work_queues 62Date: Oct 25, 2019 63KernelVersion: 5.6.0 64Contact: dmaengine@vger.kernel.org 65Description: The maximum work queue number that this device supports. 66 67What: /sys/bus/dsa/devices/dsa<m>/numa_node 68Date: Oct 25, 2019 69KernelVersion: 5.6.0 70Contact: dmaengine@vger.kernel.org 71Description: The numa node number for this device. 72 73What: /sys/bus/dsa/devices/dsa<m>/op_cap 74Date: Oct 25, 2019 75KernelVersion: 5.6.0 76Contact: dmaengine@vger.kernel.org 77Description: The operation capability bit mask specify the operation types 78 supported by the this device. 79 80What: /sys/bus/dsa/devices/dsa<m>/pasid_enabled 81Date: Oct 27, 2020 82KernelVersion: 5.11.0 83Contact: dmaengine@vger.kernel.org 84Description: To indicate if PASID (process address space identifier) is 85 enabled or not for this device. 86 87What: /sys/bus/dsa/devices/dsa<m>/state 88Date: Oct 25, 2019 89KernelVersion: 5.6.0 90Contact: dmaengine@vger.kernel.org 91Description: The state information of this device. It can be either enabled 92 or disabled. 93 94What: /sys/bus/dsa/devices/dsa<m>/group<m>.<n> 95Date: Oct 25, 2019 96KernelVersion: 5.6.0 97Contact: dmaengine@vger.kernel.org 98Description: The assigned group under this device. 99 100What: /sys/bus/dsa/devices/dsa<m>/engine<m>.<n> 101Date: Oct 25, 2019 102KernelVersion: 5.6.0 103Contact: dmaengine@vger.kernel.org 104Description: The assigned engine under this device. 105 106What: /sys/bus/dsa/devices/dsa<m>/wq<m>.<n> 107Date: Oct 25, 2019 108KernelVersion: 5.6.0 109Contact: dmaengine@vger.kernel.org 110Description: The assigned work queue under this device. 111 112What: /sys/bus/dsa/devices/dsa<m>/configurable 113Date: Oct 25, 2019 114KernelVersion: 5.6.0 115Contact: dmaengine@vger.kernel.org 116Description: To indicate if this device is configurable or not. 117 118What: /sys/bus/dsa/devices/dsa<m>/read_buffer_limit 119Date: Dec 10, 2021 120KernelVersion: 5.17.0 121Contact: dmaengine@vger.kernel.org 122Description: The maximum number of read buffers that may be in use at 123 one time by operations that access low bandwidth memory in the 124 device. See DSA spec v1.2 9.2.8 GENCFG on Global Read Buffer Limit. 125 126What: /sys/bus/dsa/devices/dsa<m>/cmd_status 127Date: Aug 28, 2020 128KernelVersion: 5.10.0 129Contact: dmaengine@vger.kernel.org 130Description: The last executed device administrative command's status/error. 131 Also last configuration error overloaded. 132 Writing to it will clear the status. 133 134What: /sys/bus/dsa/devices/wq<m>.<n>/block_on_fault 135Date: Oct 27, 2020 136KernelVersion: 5.11.0 137Contact: dmaengine@vger.kernel.org 138Description: To indicate block on fault is allowed or not for the work queue 139 to support on demand paging. 140 141What: /sys/bus/dsa/devices/wq<m>.<n>/group_id 142Date: Oct 25, 2019 143KernelVersion: 5.6.0 144Contact: dmaengine@vger.kernel.org 145Description: The group id that this work queue belongs to. 146 147What: /sys/bus/dsa/devices/wq<m>.<n>/size 148Date: Oct 25, 2019 149KernelVersion: 5.6.0 150Contact: dmaengine@vger.kernel.org 151Description: The work queue size for this work queue. 152 153What: /sys/bus/dsa/devices/wq<m>.<n>/type 154Date: Oct 25, 2019 155KernelVersion: 5.6.0 156Contact: dmaengine@vger.kernel.org 157Description: The type of this work queue, it can be "kernel" type for work 158 queue usages in the kernel space or "user" type for work queue 159 usages by applications in user space. 160 161What: /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor 162Date: Oct 25, 2019 163KernelVersion: 5.6.0 164Contact: dmaengine@vger.kernel.org 165Description: The minor number assigned to this work queue by the character 166 device driver. 167 168What: /sys/bus/dsa/devices/wq<m>.<n>/mode 169Date: Oct 25, 2019 170KernelVersion: 5.6.0 171Contact: dmaengine@vger.kernel.org 172Description: The work queue mode type for this work queue. 173 174What: /sys/bus/dsa/devices/wq<m>.<n>/priority 175Date: Oct 25, 2019 176KernelVersion: 5.6.0 177Contact: dmaengine@vger.kernel.org 178Description: The priority value of this work queue, it is a value relative to 179 other work queue in the same group to control quality of service 180 for dispatching work from multiple workqueues in the same group. 181 182What: /sys/bus/dsa/devices/wq<m>.<n>/state 183Date: Oct 25, 2019 184KernelVersion: 5.6.0 185Contact: dmaengine@vger.kernel.org 186Description: The current state of the work queue. 187 188What: /sys/bus/dsa/devices/wq<m>.<n>/threshold 189Date: Oct 25, 2019 190KernelVersion: 5.6.0 191Contact: dmaengine@vger.kernel.org 192Description: The number of entries in this work queue that may be filled 193 via a limited portal. 194 195What: /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size 196Date: Aug 28, 2020 197KernelVersion: 5.10.0 198Contact: dmaengine@vger.kernel.org 199Description: The max transfer sized for this workqueue. Cannot exceed device 200 max transfer size. Configurable parameter. 201 202What: /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size 203Date: Aug 28, 2020 204KernelVersion: 5.10.0 205Contact: dmaengine@vger.kernel.org 206Description: The max batch size for this workqueue. Cannot exceed device 207 max batch size. Configurable parameter. 208 209What: /sys/bus/dsa/devices/wq<m>.<n>/ats_disable 210Date: Nov 13, 2020 211KernelVersion: 5.11.0 212Contact: dmaengine@vger.kernel.org 213Description: Indicate whether ATS disable is turned on for the workqueue. 214 0 indicates ATS is on, and 1 indicates ATS is off for the workqueue. 215 216What: /sys/bus/dsa/devices/wq<m>.<n>/occupancy 217Date May 25, 2021 218KernelVersion: 5.14.0 219Contact: dmaengine@vger.kernel.org 220Description: Show the current number of entries in this WQ if WQ Occupancy 221 Support bit WQ capabilities is 1. 222 223What: /sys/bus/dsa/devices/wq<m>.<n>/enqcmds_retries 224Date Oct 29, 2021 225KernelVersion: 5.17.0 226Contact: dmaengine@vger.kernel.org 227Description: Indicate the number of retires for an enqcmds submission on a sharedwq. 228 A max value to set attribute is capped at 64. 229 230What: /sys/bus/dsa/devices/engine<m>.<n>/group_id 231Date: Oct 25, 2019 232KernelVersion: 5.6.0 233Contact: dmaengine@vger.kernel.org 234Description: The group that this engine belongs to. 235 236What: /sys/bus/dsa/devices/group<m>.<n>/use_read_buffer_limit 237Date: Dec 10, 2021 238KernelVersion: 5.17.0 239Contact: dmaengine@vger.kernel.org 240Description: Enable the use of global read buffer limit for the group. See DSA 241 spec v1.2 9.2.18 GRPCFG Use Global Read Buffer Limit. 242 243What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_allowed 244Date: Dec 10, 2021 245KernelVersion: 5.17.0 246Contact: dmaengine@vger.kernel.org 247Description: Indicates max number of read buffers that may be in use at one time 248 by all engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read 249 Buffers Allowed. 250 251What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_reserved 252Date: Dec 10, 2021 253KernelVersion: 5.17.0 254Contact: dmaengine@vger.kernel.org 255Description: Indicates the number of Read Buffers reserved for the use of 256 engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read Buffers 257 Reserved. 258