1 What: /sys/bus/dsa/devices/dsa<m>/ve 1 What: /sys/bus/dsa/devices/dsa<m>/version
2 Date: Apr 15, 2020 2 Date: Apr 15, 2020
3 KernelVersion: 5.8.0 3 KernelVersion: 5.8.0
4 Contact: dmaengine@vger.kernel.org 4 Contact: dmaengine@vger.kernel.org
5 Description: The hardware version number. 5 Description: The hardware version number.
6 6
7 What: /sys/bus/dsa/devices/dsa<m>/cd 7 What: /sys/bus/dsa/devices/dsa<m>/cdev_major
8 Date: Oct 25, 2019 8 Date: Oct 25, 2019
9 KernelVersion: 5.6.0 9 KernelVersion: 5.6.0
10 Contact: dmaengine@vger.kernel.org 10 Contact: dmaengine@vger.kernel.org
11 Description: The major number that the char 11 Description: The major number that the character device driver assigned to
12 this device. 12 this device.
13 13
14 What: /sys/bus/dsa/devices/dsa<m>/er 14 What: /sys/bus/dsa/devices/dsa<m>/errors
15 Date: Oct 25, 2019 15 Date: Oct 25, 2019
16 KernelVersion: 5.6.0 16 KernelVersion: 5.6.0
17 Contact: dmaengine@vger.kernel.org 17 Contact: dmaengine@vger.kernel.org
18 Description: The error information for this 18 Description: The error information for this device.
19 19
20 What: /sys/bus/dsa/devices/dsa<m>/ma 20 What: /sys/bus/dsa/devices/dsa<m>/max_batch_size
21 Date: Oct 25, 2019 21 Date: Oct 25, 2019
22 KernelVersion: 5.6.0 22 KernelVersion: 5.6.0
23 Contact: dmaengine@vger.kernel.org 23 Contact: dmaengine@vger.kernel.org
24 Description: The largest number of work des 24 Description: The largest number of work descriptors in a batch.
25 It's not visible when the devi <<
26 25
27 What: /sys/bus/dsa/devices/dsa<m>/ma 26 What: /sys/bus/dsa/devices/dsa<m>/max_work_queues_size
28 Date: Oct 25, 2019 27 Date: Oct 25, 2019
29 KernelVersion: 5.6.0 28 KernelVersion: 5.6.0
30 Contact: dmaengine@vger.kernel.org 29 Contact: dmaengine@vger.kernel.org
31 Description: The maximum work queue size su 30 Description: The maximum work queue size supported by this device.
32 31
33 What: /sys/bus/dsa/devices/dsa<m>/ma 32 What: /sys/bus/dsa/devices/dsa<m>/max_engines
34 Date: Oct 25, 2019 33 Date: Oct 25, 2019
35 KernelVersion: 5.6.0 34 KernelVersion: 5.6.0
36 Contact: dmaengine@vger.kernel.org 35 Contact: dmaengine@vger.kernel.org
37 Description: The maximum number of engines 36 Description: The maximum number of engines supported by this device.
38 37
39 What: /sys/bus/dsa/devices/dsa<m>/ma 38 What: /sys/bus/dsa/devices/dsa<m>/max_groups
40 Date: Oct 25, 2019 39 Date: Oct 25, 2019
41 KernelVersion: 5.6.0 40 KernelVersion: 5.6.0
42 Contact: dmaengine@vger.kernel.org 41 Contact: dmaengine@vger.kernel.org
43 Description: The maximum number of groups c 42 Description: The maximum number of groups can be created under this device.
44 43
45 What: /sys/bus/dsa/devices/dsa<m>/ma !! 44 What: /sys/bus/dsa/devices/dsa<m>/max_tokens
46 Date: Dec 10, 2021 !! 45 Date: Oct 25, 2019
47 KernelVersion: 5.17.0 !! 46 KernelVersion: 5.6.0
48 Contact: dmaengine@vger.kernel.org 47 Contact: dmaengine@vger.kernel.org
49 Description: The total number of read buffe !! 48 Description: The total number of bandwidth tokens supported by this device.
50 The read buffers represent res !! 49 The bandwidth tokens represent resources within the DSA
51 implementation, and these reso 50 implementation, and these resources are allocated by engines to
52 support operations. See DSA sp !! 51 support operations.
53 It's not visible when the devi <<
54 allocation control. <<
55 52
56 What: /sys/bus/dsa/devices/dsa<m>/ma 53 What: /sys/bus/dsa/devices/dsa<m>/max_transfer_size
57 Date: Oct 25, 2019 54 Date: Oct 25, 2019
58 KernelVersion: 5.6.0 55 KernelVersion: 5.6.0
59 Contact: dmaengine@vger.kernel.org 56 Contact: dmaengine@vger.kernel.org
60 Description: The number of bytes to be read 57 Description: The number of bytes to be read from the source address to
61 perform the operation. The max 58 perform the operation. The maximum transfer size is dependent on
62 the workqueue the descriptor w 59 the workqueue the descriptor was submitted to.
63 60
64 What: /sys/bus/dsa/devices/dsa<m>/ma 61 What: /sys/bus/dsa/devices/dsa<m>/max_work_queues
65 Date: Oct 25, 2019 62 Date: Oct 25, 2019
66 KernelVersion: 5.6.0 63 KernelVersion: 5.6.0
67 Contact: dmaengine@vger.kernel.org 64 Contact: dmaengine@vger.kernel.org
68 Description: The maximum work queue number 65 Description: The maximum work queue number that this device supports.
69 66
70 What: /sys/bus/dsa/devices/dsa<m>/nu 67 What: /sys/bus/dsa/devices/dsa<m>/numa_node
71 Date: Oct 25, 2019 68 Date: Oct 25, 2019
72 KernelVersion: 5.6.0 69 KernelVersion: 5.6.0
73 Contact: dmaengine@vger.kernel.org 70 Contact: dmaengine@vger.kernel.org
74 Description: The numa node number for this 71 Description: The numa node number for this device.
75 72
76 What: /sys/bus/dsa/devices/dsa<m>/op 73 What: /sys/bus/dsa/devices/dsa<m>/op_cap
77 Date: Oct 25, 2019 74 Date: Oct 25, 2019
78 KernelVersion: 5.6.0 75 KernelVersion: 5.6.0
79 Contact: dmaengine@vger.kernel.org 76 Contact: dmaengine@vger.kernel.org
80 Description: The operation capability bit m 77 Description: The operation capability bit mask specify the operation types
81 supported by the this device. 78 supported by the this device.
82 79
83 What: /sys/bus/dsa/devices/dsa<m>/pa <<
84 Date: Oct 27, 2020 <<
85 KernelVersion: 5.11.0 <<
86 Contact: dmaengine@vger.kernel.org <<
87 Description: To indicate if user PASID (pro <<
88 enabled or not for this device <<
89 <<
90 What: /sys/bus/dsa/devices/dsa<m>/st 80 What: /sys/bus/dsa/devices/dsa<m>/state
91 Date: Oct 25, 2019 81 Date: Oct 25, 2019
92 KernelVersion: 5.6.0 82 KernelVersion: 5.6.0
93 Contact: dmaengine@vger.kernel.org 83 Contact: dmaengine@vger.kernel.org
94 Description: The state information of this 84 Description: The state information of this device. It can be either enabled
95 or disabled. 85 or disabled.
96 86
97 What: /sys/bus/dsa/devices/dsa<m>/gr 87 What: /sys/bus/dsa/devices/dsa<m>/group<m>.<n>
98 Date: Oct 25, 2019 88 Date: Oct 25, 2019
99 KernelVersion: 5.6.0 89 KernelVersion: 5.6.0
100 Contact: dmaengine@vger.kernel.org 90 Contact: dmaengine@vger.kernel.org
101 Description: The assigned group under this 91 Description: The assigned group under this device.
102 92
103 What: /sys/bus/dsa/devices/dsa<m>/en 93 What: /sys/bus/dsa/devices/dsa<m>/engine<m>.<n>
104 Date: Oct 25, 2019 94 Date: Oct 25, 2019
105 KernelVersion: 5.6.0 95 KernelVersion: 5.6.0
106 Contact: dmaengine@vger.kernel.org 96 Contact: dmaengine@vger.kernel.org
107 Description: The assigned engine under this 97 Description: The assigned engine under this device.
108 98
109 What: /sys/bus/dsa/devices/dsa<m>/wq 99 What: /sys/bus/dsa/devices/dsa<m>/wq<m>.<n>
110 Date: Oct 25, 2019 100 Date: Oct 25, 2019
111 KernelVersion: 5.6.0 101 KernelVersion: 5.6.0
112 Contact: dmaengine@vger.kernel.org 102 Contact: dmaengine@vger.kernel.org
113 Description: The assigned work queue under 103 Description: The assigned work queue under this device.
114 104
115 What: /sys/bus/dsa/devices/dsa<m>/co 105 What: /sys/bus/dsa/devices/dsa<m>/configurable
116 Date: Oct 25, 2019 106 Date: Oct 25, 2019
117 KernelVersion: 5.6.0 107 KernelVersion: 5.6.0
118 Contact: dmaengine@vger.kernel.org 108 Contact: dmaengine@vger.kernel.org
119 Description: To indicate if this device is 109 Description: To indicate if this device is configurable or not.
120 110
121 What: /sys/bus/dsa/devices/dsa<m>/re !! 111 What: /sys/bus/dsa/devices/dsa<m>/token_limit
122 Date: Dec 10, 2021 !! 112 Date: Oct 25, 2019
123 KernelVersion: 5.17.0 !! 113 KernelVersion: 5.6.0
124 Contact: dmaengine@vger.kernel.org 114 Contact: dmaengine@vger.kernel.org
125 Description: The maximum number of read buf !! 115 Description: The maximum number of bandwidth tokens that may be in use at
126 one time by operations that ac 116 one time by operations that access low bandwidth memory in the
127 device. See DSA spec v1.2 9.2. !! 117 device.
128 It's not visible when the devi <<
129 allocation control. <<
130 118
131 What: /sys/bus/dsa/devices/dsa<m>/cm 119 What: /sys/bus/dsa/devices/dsa<m>/cmd_status
132 Date: Aug 28, 2020 120 Date: Aug 28, 2020
133 KernelVersion: 5.10.0 121 KernelVersion: 5.10.0
134 Contact: dmaengine@vger.kernel.org 122 Contact: dmaengine@vger.kernel.org
135 Description: The last executed device admin 123 Description: The last executed device administrative command's status/error.
136 Also last configuration error <<
137 Writing to it will clear the s <<
138 <<
139 What: /sys/bus/dsa/devices/dsa<m>/ia <<
140 Date: Sept 14, 2022 <<
141 KernelVersion: 6.0.0 <<
142 Contact: dmaengine@vger.kernel.org <<
143 Description: IAA (IAX) capability mask. Exp <<
144 consumption. This attribute sh <<
145 that are version 2 or later. <<
146 <<
147 What: /sys/bus/dsa/devices/dsa<m>/ev <<
148 Date: Sept 14, 2022 <<
149 KernelVersion: 6.4.0 <<
150 Contact: dmaengine@vger.kernel.org <<
151 Description: The event log size to be confi <<
152 occupies 4k size if the evl en <<
153 only on platforms that support <<
154 <<
155 What: /sys/bus/dsa/devices/wq<m>.<n> <<
156 Date: Oct 27, 2020 <<
157 KernelVersion: 5.11.0 <<
158 Contact: dmaengine@vger.kernel.org <<
159 Description: To indicate block on fault is <<
160 to support on demand paging. <<
161 124
162 What: /sys/bus/dsa/devices/wq<m>.<n> 125 What: /sys/bus/dsa/devices/wq<m>.<n>/group_id
163 Date: Oct 25, 2019 126 Date: Oct 25, 2019
164 KernelVersion: 5.6.0 127 KernelVersion: 5.6.0
165 Contact: dmaengine@vger.kernel.org 128 Contact: dmaengine@vger.kernel.org
166 Description: The group id that this work qu 129 Description: The group id that this work queue belongs to.
167 130
168 What: /sys/bus/dsa/devices/wq<m>.<n> 131 What: /sys/bus/dsa/devices/wq<m>.<n>/size
169 Date: Oct 25, 2019 132 Date: Oct 25, 2019
170 KernelVersion: 5.6.0 133 KernelVersion: 5.6.0
171 Contact: dmaengine@vger.kernel.org 134 Contact: dmaengine@vger.kernel.org
172 Description: The work queue size for this w 135 Description: The work queue size for this work queue.
173 136
174 What: /sys/bus/dsa/devices/wq<m>.<n> 137 What: /sys/bus/dsa/devices/wq<m>.<n>/type
175 Date: Oct 25, 2019 138 Date: Oct 25, 2019
176 KernelVersion: 5.6.0 139 KernelVersion: 5.6.0
177 Contact: dmaengine@vger.kernel.org 140 Contact: dmaengine@vger.kernel.org
178 Description: The type of this work queue, i 141 Description: The type of this work queue, it can be "kernel" type for work
179 queue usages in the kernel spa 142 queue usages in the kernel space or "user" type for work queue
180 usages by applications in user 143 usages by applications in user space.
181 144
182 What: /sys/bus/dsa/devices/wq<m>.<n> 145 What: /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor
183 Date: Oct 25, 2019 146 Date: Oct 25, 2019
184 KernelVersion: 5.6.0 147 KernelVersion: 5.6.0
185 Contact: dmaengine@vger.kernel.org 148 Contact: dmaengine@vger.kernel.org
186 Description: The minor number assigned to t 149 Description: The minor number assigned to this work queue by the character
187 device driver. 150 device driver.
188 151
189 What: /sys/bus/dsa/devices/wq<m>.<n> 152 What: /sys/bus/dsa/devices/wq<m>.<n>/mode
190 Date: Oct 25, 2019 153 Date: Oct 25, 2019
191 KernelVersion: 5.6.0 154 KernelVersion: 5.6.0
192 Contact: dmaengine@vger.kernel.org 155 Contact: dmaengine@vger.kernel.org
193 Description: The work queue mode type for t 156 Description: The work queue mode type for this work queue.
194 157
195 What: /sys/bus/dsa/devices/wq<m>.<n> 158 What: /sys/bus/dsa/devices/wq<m>.<n>/priority
196 Date: Oct 25, 2019 159 Date: Oct 25, 2019
197 KernelVersion: 5.6.0 160 KernelVersion: 5.6.0
198 Contact: dmaengine@vger.kernel.org 161 Contact: dmaengine@vger.kernel.org
199 Description: The priority value of this wor !! 162 Description: The priority value of this work queue, it is a vlue relative to
200 other work queue in the same g 163 other work queue in the same group to control quality of service
201 for dispatching work from mult 164 for dispatching work from multiple workqueues in the same group.
202 165
203 What: /sys/bus/dsa/devices/wq<m>.<n> 166 What: /sys/bus/dsa/devices/wq<m>.<n>/state
204 Date: Oct 25, 2019 167 Date: Oct 25, 2019
205 KernelVersion: 5.6.0 168 KernelVersion: 5.6.0
206 Contact: dmaengine@vger.kernel.org 169 Contact: dmaengine@vger.kernel.org
207 Description: The current state of the work 170 Description: The current state of the work queue.
208 171
209 What: /sys/bus/dsa/devices/wq<m>.<n> 172 What: /sys/bus/dsa/devices/wq<m>.<n>/threshold
210 Date: Oct 25, 2019 173 Date: Oct 25, 2019
211 KernelVersion: 5.6.0 174 KernelVersion: 5.6.0
212 Contact: dmaengine@vger.kernel.org 175 Contact: dmaengine@vger.kernel.org
213 Description: The number of entries in this 176 Description: The number of entries in this work queue that may be filled
214 via a limited portal. 177 via a limited portal.
215 178
216 What: /sys/bus/dsa/devices/wq<m>.<n> 179 What: /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size
217 Date: Aug 28, 2020 180 Date: Aug 28, 2020
218 KernelVersion: 5.10.0 181 KernelVersion: 5.10.0
219 Contact: dmaengine@vger.kernel.org 182 Contact: dmaengine@vger.kernel.org
220 Description: The max transfer sized for thi 183 Description: The max transfer sized for this workqueue. Cannot exceed device
221 max transfer size. Configurabl 184 max transfer size. Configurable parameter.
222 185
223 What: /sys/bus/dsa/devices/wq<m>.<n> 186 What: /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size
224 Date: Aug 28, 2020 187 Date: Aug 28, 2020
225 KernelVersion: 5.10.0 188 KernelVersion: 5.10.0
226 Contact: dmaengine@vger.kernel.org 189 Contact: dmaengine@vger.kernel.org
227 Description: The max batch size for this wo 190 Description: The max batch size for this workqueue. Cannot exceed device
228 max batch size. Configurable p 191 max batch size. Configurable parameter.
229 It's not visible when the devi <<
230 <<
231 What: /sys/bus/dsa/devices/wq<m>.<n> <<
232 Date: Nov 13, 2020 <<
233 KernelVersion: 5.11.0 <<
234 Contact: dmaengine@vger.kernel.org <<
235 Description: Indicate whether ATS disable i <<
236 0 indicates ATS is on, and 1 i <<
237 <<
238 What: /sys/bus/dsa/devices/wq<m>.<n> <<
239 Date: Sept 14, 2022 <<
240 KernelVersion: 6.4.0 <<
241 Contact: dmaengine@vger.kernel.org <<
242 Description: Controls whether PRS disable i <<
243 0 indicates PRS is on, and 1 i <<
244 workqueue. This option overrid <<
245 if set. It's visible only on p <<
246 capability. <<
247 <<
248 What: /sys/bus/dsa/devices/wq<m>.<n> <<
249 Date May 25, 2021 <<
250 KernelVersion: 5.14.0 <<
251 Contact: dmaengine@vger.kernel.org <<
252 Description: Show the current number of ent <<
253 Support bit WQ capabilities is <<
254 <<
255 What: /sys/bus/dsa/devices/wq<m>.<n> <<
256 Date Oct 29, 2021 <<
257 KernelVersion: 5.17.0 <<
258 Contact: dmaengine@vger.kernel.org <<
259 Description: Indicate the number of retires <<
260 A max value to set attribute i <<
261 <<
262 What: /sys/bus/dsa/devices/wq<m>.<n> <<
263 Date: Sept 14, 2022 <<
264 KernelVersion: 6.0.0 <<
265 Contact: dmaengine@vger.kernel.org <<
266 Description: Shows the operation capability <<
267 presented by %*pb printk() out <<
268 The attribute can be configure <<
269 order to configure the WQ to a <<
270 correlates to the operations a <<
271 on platforms that support the <<
272 <<
273 What: /sys/bus/dsa/devices/wq<m>.<n> <<
274 Date: Sept 8, 2023 <<
275 KernelVersion: 6.7.0 <<
276 Contact: dmaengine@vger.kernel.org <<
277 Description: Name of driver to be bounded t <<
278 192
279 What: /sys/bus/dsa/devices/engine<m> 193 What: /sys/bus/dsa/devices/engine<m>.<n>/group_id
280 Date: Oct 25, 2019 194 Date: Oct 25, 2019
281 KernelVersion: 5.6.0 195 KernelVersion: 5.6.0
282 Contact: dmaengine@vger.kernel.org 196 Contact: dmaengine@vger.kernel.org
283 Description: The group that this engine bel 197 Description: The group that this engine belongs to.
284 <<
285 What: /sys/bus/dsa/devices/group<m>. <<
286 Date: Dec 10, 2021 <<
287 KernelVersion: 5.17.0 <<
288 Contact: dmaengine@vger.kernel.org <<
289 Description: Enable the use of global read <<
290 spec v1.2 9.2.18 GRPCFG Use Gl <<
291 It's not visible when the devi <<
292 allocation control. <<
293 <<
294 What: /sys/bus/dsa/devices/group<m>. <<
295 Date: Dec 10, 2021 <<
296 KernelVersion: 5.17.0 <<
297 Contact: dmaengine@vger.kernel.org <<
298 Description: Indicates max number of read b <<
299 by all engines in the group. S <<
300 Buffers Allowed. <<
301 It's not visible when the devi <<
302 allocation control. <<
303 <<
304 What: /sys/bus/dsa/devices/group<m>. <<
305 Date: Dec 10, 2021 <<
306 KernelVersion: 5.17.0 <<
307 Contact: dmaengine@vger.kernel.org <<
308 Description: Indicates the number of Read B <<
309 engines in the group. See DSA <<
310 Reserved. <<
311 It's not visible when the devi <<
312 allocation control. <<
313 <<
314 What: /sys/bus/dsa/devices/group<m>. <<
315 Date: Sept 14, 2022 <<
316 KernelVersion: 6.0.0 <<
317 Contact: dmaengine@vger.kernel.org <<
318 Description: Allows control of the number o <<
319 concurrently processed by an e <<
320 of the Maximum Work Descriptor <<
321 the ENGCAP register. The accep <<
322 1 (1/2 of max value), 2 (1/4 o <<
323 the max value). It's visible o <<
324 the capability. <<
325 <<
326 What: /sys/bus/dsa/devices/group<m>. <<
327 Date: Sept 14, 2022 <<
328 KernelVersion: 6.0.0 <<
329 Contact: dmaengine@vger.kernel.org <<
330 Description: Allows control of the number o <<
331 concurrently processed by an e <<
332 of the Maximum Batch Descripto <<
333 the ENGCAP register. The accep <<
334 1 (1/2 of max value), 2 (1/4 o <<
335 the max value). It's visible o <<
336 the capability. <<
337 <<
338 What: /sys/bus/dsa/devices/wq<m>.<n> <<
339 Date: Sept 14, 2022 <<
340 KernelVersion: 6.4.0 <<
341 Contact: dmaengine@vger.kernel.org <<
342 Description: Show the number of Completion <<
343 has caused. <<
344 <<
345 What: /sys/bus/dsa/devices/wq<m>.<n> <<
346 Date: Sept 14, 2022 <<
347 KernelVersion: 6.4.0 <<
348 Contact: dmaengine@vger.kernel.org <<
349 Description: Show the number of Completion <<
350 application has caused. The fa <<
351 driver cannot fault in the add <<
352 by a bad address programmed in <<
353 submitter is using bad CR addr <<
354 <<
355 What: /sys/bus/dsa/devices/wq<m>.<n> <<
356 Date: Sept 14, 2022 <<
357 KernelVersion: 6.4.0 <<
358 Contact: dmaengine@vger.kernel.org <<
359 Description: Show the process id of the app <<
360 helpful information for a moni <<
361 application that opened the fi <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.