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/wq<m>.<n>/op_config 231Date: Sept 14, 2022 232KernelVersion: 6.0.0 233Contact: dmaengine@vger.kernel.org 234Description: Shows the operation capability bits displayed in bitmap format 235 presented by %*pb printk() output format specifier. 236 The attribute can be configured when the WQ is disabled in 237 order to configure the WQ to accept specific bits that 238 correlates to the operations allowed. It's visible only 239 on platforms that support the capability. 240 241What: /sys/bus/dsa/devices/engine<m>.<n>/group_id 242Date: Oct 25, 2019 243KernelVersion: 5.6.0 244Contact: dmaengine@vger.kernel.org 245Description: The group that this engine belongs to. 246 247What: /sys/bus/dsa/devices/group<m>.<n>/use_read_buffer_limit 248Date: Dec 10, 2021 249KernelVersion: 5.17.0 250Contact: dmaengine@vger.kernel.org 251Description: Enable the use of global read buffer limit for the group. See DSA 252 spec v1.2 9.2.18 GRPCFG Use Global Read Buffer Limit. 253 254What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_allowed 255Date: Dec 10, 2021 256KernelVersion: 5.17.0 257Contact: dmaengine@vger.kernel.org 258Description: Indicates max number of read buffers that may be in use at one time 259 by all engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read 260 Buffers Allowed. 261 262What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_reserved 263Date: Dec 10, 2021 264KernelVersion: 5.17.0 265Contact: dmaengine@vger.kernel.org 266Description: Indicates the number of Read Buffers reserved for the use of 267 engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read Buffers 268 Reserved. 269 270What: /sys/bus/dsa/devices/group<m>.<n>/desc_progress_limit 271Date: Sept 14, 2022 272KernelVersion: 6.0.0 273Contact: dmaengine@vger.kernel.org 274Description: Allows control of the number of work descriptors that can be 275 concurrently processed by an engine in the group as a fraction 276 of the Maximum Work Descriptors in Progress value specified in 277 the ENGCAP register. The acceptable values are 0 (default), 278 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of 279 the max value). It's visible only on platforms that support 280 the capability. 281 282What: /sys/bus/dsa/devices/group<m>.<n>/batch_progress_limit 283Date: Sept 14, 2022 284KernelVersion: 6.0.0 285Contact: dmaengine@vger.kernel.org 286Description: Allows control of the number of batch descriptors that can be 287 concurrently processed by an engine in the group as a fraction 288 of the Maximum Batch Descriptors in Progress value specified in 289 the ENGCAP register. The acceptable values are 0 (default), 290 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of 291 the max value). It's visible only on platforms that support 292 the capability. 293