1 What: /sys/bus/dsa/devices/dsa<m>/version
4 Contact: dmaengine@vger.kernel.org
5 Description: The hardware version number.
7 What: /sys/bus/dsa/devices/dsa<m>/cdev_major
10 Contact: dmaengine@vger.kernel.org
11 Description: The major number that the character device driver assigned to
14 What: /sys/bus/dsa/devices/dsa<m>/errors
17 Contact: dmaengine@vger.kernel.org
18 Description: The error information for this device.
20 What: /sys/bus/dsa/devices/dsa<m>/max_batch_size
23 Contact: dmaengine@vger.kernel.org
24 Description: The largest number of work descriptors in a batch.
25 It's not visible when the device does not support batch.
27 What: /sys/bus/dsa/devices/dsa<m>/max_work_queues_size
30 Contact: dmaengine@vger.kernel.org
31 Description: The maximum work queue size supported by this device.
33 What: /sys/bus/dsa/devices/dsa<m>/max_engines
36 Contact: dmaengine@vger.kernel.org
37 Description: The maximum number of engines supported by this device.
39 What: /sys/bus/dsa/devices/dsa<m>/max_groups
42 Contact: dmaengine@vger.kernel.org
43 Description: The maximum number of groups can be created under this device.
45 What: /sys/bus/dsa/devices/dsa<m>/max_read_buffers
48 Contact: dmaengine@vger.kernel.org
49 Description: The total number of read buffers supported by this device.
50 The read buffers represent resources within the DSA
51 implementation, and these resources are allocated by engines to
52 support operations. See DSA spec v1.2 9.2.4 Total Read Buffers.
53 It's not visible when the device does not support Read Buffer
56 What: /sys/bus/dsa/devices/dsa<m>/max_transfer_size
59 Contact: dmaengine@vger.kernel.org
60 Description: The number of bytes to be read from the source address to
61 perform the operation. The maximum transfer size is dependent on
62 the workqueue the descriptor was submitted to.
64 What: /sys/bus/dsa/devices/dsa<m>/max_work_queues
67 Contact: dmaengine@vger.kernel.org
68 Description: The maximum work queue number that this device supports.
70 What: /sys/bus/dsa/devices/dsa<m>/numa_node
73 Contact: dmaengine@vger.kernel.org
74 Description: The numa node number for this device.
76 What: /sys/bus/dsa/devices/dsa<m>/op_cap
79 Contact: dmaengine@vger.kernel.org
80 Description: The operation capability bit mask specify the operation types
81 supported by the this device.
83 What: /sys/bus/dsa/devices/dsa<m>/pasid_enabled
86 Contact: dmaengine@vger.kernel.org
87 Description: To indicate if PASID (process address space identifier) is
88 enabled or not for this device.
90 What: /sys/bus/dsa/devices/dsa<m>/state
93 Contact: dmaengine@vger.kernel.org
94 Description: The state information of this device. It can be either enabled
97 What: /sys/bus/dsa/devices/dsa<m>/group<m>.<n>
100 Contact: dmaengine@vger.kernel.org
101 Description: The assigned group under this device.
103 What: /sys/bus/dsa/devices/dsa<m>/engine<m>.<n>
106 Contact: dmaengine@vger.kernel.org
107 Description: The assigned engine under this device.
109 What: /sys/bus/dsa/devices/dsa<m>/wq<m>.<n>
112 Contact: dmaengine@vger.kernel.org
113 Description: The assigned work queue under this device.
115 What: /sys/bus/dsa/devices/dsa<m>/configurable
118 Contact: dmaengine@vger.kernel.org
119 Description: To indicate if this device is configurable or not.
121 What: /sys/bus/dsa/devices/dsa<m>/read_buffer_limit
123 KernelVersion: 5.17.0
124 Contact: dmaengine@vger.kernel.org
125 Description: The maximum number of read buffers that may be in use at
126 one time by operations that access low bandwidth memory in the
127 device. See DSA spec v1.2 9.2.8 GENCFG on Global Read Buffer Limit.
128 It's not visible when the device does not support Read Buffer
131 What: /sys/bus/dsa/devices/dsa<m>/cmd_status
133 KernelVersion: 5.10.0
134 Contact: dmaengine@vger.kernel.org
135 Description: The last executed device administrative command's status/error.
136 Also last configuration error overloaded.
137 Writing to it will clear the status.
139 What: /sys/bus/dsa/devices/wq<m>.<n>/block_on_fault
141 KernelVersion: 5.11.0
142 Contact: dmaengine@vger.kernel.org
143 Description: To indicate block on fault is allowed or not for the work queue
144 to support on demand paging.
146 What: /sys/bus/dsa/devices/wq<m>.<n>/group_id
149 Contact: dmaengine@vger.kernel.org
150 Description: The group id that this work queue belongs to.
152 What: /sys/bus/dsa/devices/wq<m>.<n>/size
155 Contact: dmaengine@vger.kernel.org
156 Description: The work queue size for this work queue.
158 What: /sys/bus/dsa/devices/wq<m>.<n>/type
161 Contact: dmaengine@vger.kernel.org
162 Description: The type of this work queue, it can be "kernel" type for work
163 queue usages in the kernel space or "user" type for work queue
164 usages by applications in user space.
166 What: /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor
169 Contact: dmaengine@vger.kernel.org
170 Description: The minor number assigned to this work queue by the character
173 What: /sys/bus/dsa/devices/wq<m>.<n>/mode
176 Contact: dmaengine@vger.kernel.org
177 Description: The work queue mode type for this work queue.
179 What: /sys/bus/dsa/devices/wq<m>.<n>/priority
182 Contact: dmaengine@vger.kernel.org
183 Description: The priority value of this work queue, it is a value relative to
184 other work queue in the same group to control quality of service
185 for dispatching work from multiple workqueues in the same group.
187 What: /sys/bus/dsa/devices/wq<m>.<n>/state
190 Contact: dmaengine@vger.kernel.org
191 Description: The current state of the work queue.
193 What: /sys/bus/dsa/devices/wq<m>.<n>/threshold
196 Contact: dmaengine@vger.kernel.org
197 Description: The number of entries in this work queue that may be filled
198 via a limited portal.
200 What: /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size
202 KernelVersion: 5.10.0
203 Contact: dmaengine@vger.kernel.org
204 Description: The max transfer sized for this workqueue. Cannot exceed device
205 max transfer size. Configurable parameter.
207 What: /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size
209 KernelVersion: 5.10.0
210 Contact: dmaengine@vger.kernel.org
211 Description: The max batch size for this workqueue. Cannot exceed device
212 max batch size. Configurable parameter.
213 It's not visible when the device does not support batch.
215 What: /sys/bus/dsa/devices/wq<m>.<n>/ats_disable
217 KernelVersion: 5.11.0
218 Contact: dmaengine@vger.kernel.org
219 Description: Indicate whether ATS disable is turned on for the workqueue.
220 0 indicates ATS is on, and 1 indicates ATS is off for the workqueue.
222 What: /sys/bus/dsa/devices/wq<m>.<n>/occupancy
224 KernelVersion: 5.14.0
225 Contact: dmaengine@vger.kernel.org
226 Description: Show the current number of entries in this WQ if WQ Occupancy
227 Support bit WQ capabilities is 1.
229 What: /sys/bus/dsa/devices/wq<m>.<n>/enqcmds_retries
231 KernelVersion: 5.17.0
232 Contact: dmaengine@vger.kernel.org
233 Description: Indicate the number of retires for an enqcmds submission on a sharedwq.
234 A max value to set attribute is capped at 64.
236 What: /sys/bus/dsa/devices/wq<m>.<n>/op_config
239 Contact: dmaengine@vger.kernel.org
240 Description: Shows the operation capability bits displayed in bitmap format
241 presented by %*pb printk() output format specifier.
242 The attribute can be configured when the WQ is disabled in
243 order to configure the WQ to accept specific bits that
244 correlates to the operations allowed. It's visible only
245 on platforms that support the capability.
247 What: /sys/bus/dsa/devices/engine<m>.<n>/group_id
250 Contact: dmaengine@vger.kernel.org
251 Description: The group that this engine belongs to.
253 What: /sys/bus/dsa/devices/group<m>.<n>/use_read_buffer_limit
255 KernelVersion: 5.17.0
256 Contact: dmaengine@vger.kernel.org
257 Description: Enable the use of global read buffer limit for the group. See DSA
258 spec v1.2 9.2.18 GRPCFG Use Global Read Buffer Limit.
259 It's not visible when the device does not support Read Buffer
262 What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_allowed
264 KernelVersion: 5.17.0
265 Contact: dmaengine@vger.kernel.org
266 Description: Indicates max number of read buffers that may be in use at one time
267 by all engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read
269 It's not visible when the device does not support Read Buffer
272 What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_reserved
274 KernelVersion: 5.17.0
275 Contact: dmaengine@vger.kernel.org
276 Description: Indicates the number of Read Buffers reserved for the use of
277 engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read Buffers
279 It's not visible when the device does not support Read Buffer
282 What: /sys/bus/dsa/devices/group<m>.<n>/desc_progress_limit
285 Contact: dmaengine@vger.kernel.org
286 Description: Allows control of the number of work descriptors that can be
287 concurrently processed by an engine in the group as a fraction
288 of the Maximum Work 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
294 What: /sys/bus/dsa/devices/group<m>.<n>/batch_progress_limit
297 Contact: dmaengine@vger.kernel.org
298 Description: Allows control of the number of batch descriptors that can be
299 concurrently processed by an engine in the group as a fraction
300 of the Maximum Batch Descriptors in Progress value specified in
301 the ENGCAP register. The acceptable values are 0 (default),
302 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of
303 the max value). It's visible only on platforms that support