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 80 What: /sys/bus/dsa/devices/dsa<m>/pasid_enabled
84 Date: Oct 27, 2020 81 Date: Oct 27, 2020
85 KernelVersion: 5.11.0 82 KernelVersion: 5.11.0
86 Contact: dmaengine@vger.kernel.org 83 Contact: dmaengine@vger.kernel.org
87 Description: To indicate if user PASID (pro !! 84 Description: To indicate if PASID (process address space identifier) is
88 enabled or not for this device 85 enabled or not for this device.
89 86
90 What: /sys/bus/dsa/devices/dsa<m>/st 87 What: /sys/bus/dsa/devices/dsa<m>/state
91 Date: Oct 25, 2019 88 Date: Oct 25, 2019
92 KernelVersion: 5.6.0 89 KernelVersion: 5.6.0
93 Contact: dmaengine@vger.kernel.org 90 Contact: dmaengine@vger.kernel.org
94 Description: The state information of this 91 Description: The state information of this device. It can be either enabled
95 or disabled. 92 or disabled.
96 93
97 What: /sys/bus/dsa/devices/dsa<m>/gr 94 What: /sys/bus/dsa/devices/dsa<m>/group<m>.<n>
98 Date: Oct 25, 2019 95 Date: Oct 25, 2019
99 KernelVersion: 5.6.0 96 KernelVersion: 5.6.0
100 Contact: dmaengine@vger.kernel.org 97 Contact: dmaengine@vger.kernel.org
101 Description: The assigned group under this 98 Description: The assigned group under this device.
102 99
103 What: /sys/bus/dsa/devices/dsa<m>/en 100 What: /sys/bus/dsa/devices/dsa<m>/engine<m>.<n>
104 Date: Oct 25, 2019 101 Date: Oct 25, 2019
105 KernelVersion: 5.6.0 102 KernelVersion: 5.6.0
106 Contact: dmaengine@vger.kernel.org 103 Contact: dmaengine@vger.kernel.org
107 Description: The assigned engine under this 104 Description: The assigned engine under this device.
108 105
109 What: /sys/bus/dsa/devices/dsa<m>/wq 106 What: /sys/bus/dsa/devices/dsa<m>/wq<m>.<n>
110 Date: Oct 25, 2019 107 Date: Oct 25, 2019
111 KernelVersion: 5.6.0 108 KernelVersion: 5.6.0
112 Contact: dmaengine@vger.kernel.org 109 Contact: dmaengine@vger.kernel.org
113 Description: The assigned work queue under 110 Description: The assigned work queue under this device.
114 111
115 What: /sys/bus/dsa/devices/dsa<m>/co 112 What: /sys/bus/dsa/devices/dsa<m>/configurable
116 Date: Oct 25, 2019 113 Date: Oct 25, 2019
117 KernelVersion: 5.6.0 114 KernelVersion: 5.6.0
118 Contact: dmaengine@vger.kernel.org 115 Contact: dmaengine@vger.kernel.org
119 Description: To indicate if this device is 116 Description: To indicate if this device is configurable or not.
120 117
121 What: /sys/bus/dsa/devices/dsa<m>/re !! 118 What: /sys/bus/dsa/devices/dsa<m>/token_limit
122 Date: Dec 10, 2021 !! 119 Date: Oct 25, 2019
123 KernelVersion: 5.17.0 !! 120 KernelVersion: 5.6.0
124 Contact: dmaengine@vger.kernel.org 121 Contact: dmaengine@vger.kernel.org
125 Description: The maximum number of read buf !! 122 Description: The maximum number of bandwidth tokens that may be in use at
126 one time by operations that ac 123 one time by operations that access low bandwidth memory in the
127 device. See DSA spec v1.2 9.2. !! 124 device.
128 It's not visible when the devi <<
129 allocation control. <<
130 125
131 What: /sys/bus/dsa/devices/dsa<m>/cm 126 What: /sys/bus/dsa/devices/dsa<m>/cmd_status
132 Date: Aug 28, 2020 127 Date: Aug 28, 2020
133 KernelVersion: 5.10.0 128 KernelVersion: 5.10.0
134 Contact: dmaengine@vger.kernel.org 129 Contact: dmaengine@vger.kernel.org
135 Description: The last executed device admin 130 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 131
155 What: /sys/bus/dsa/devices/wq<m>.<n> 132 What: /sys/bus/dsa/devices/wq<m>.<n>/block_on_fault
156 Date: Oct 27, 2020 133 Date: Oct 27, 2020
157 KernelVersion: 5.11.0 134 KernelVersion: 5.11.0
158 Contact: dmaengine@vger.kernel.org 135 Contact: dmaengine@vger.kernel.org
159 Description: To indicate block on fault is 136 Description: To indicate block on fault is allowed or not for the work queue
160 to support on demand paging. 137 to support on demand paging.
161 138
162 What: /sys/bus/dsa/devices/wq<m>.<n> 139 What: /sys/bus/dsa/devices/wq<m>.<n>/group_id
163 Date: Oct 25, 2019 140 Date: Oct 25, 2019
164 KernelVersion: 5.6.0 141 KernelVersion: 5.6.0
165 Contact: dmaengine@vger.kernel.org 142 Contact: dmaengine@vger.kernel.org
166 Description: The group id that this work qu 143 Description: The group id that this work queue belongs to.
167 144
168 What: /sys/bus/dsa/devices/wq<m>.<n> 145 What: /sys/bus/dsa/devices/wq<m>.<n>/size
169 Date: Oct 25, 2019 146 Date: Oct 25, 2019
170 KernelVersion: 5.6.0 147 KernelVersion: 5.6.0
171 Contact: dmaengine@vger.kernel.org 148 Contact: dmaengine@vger.kernel.org
172 Description: The work queue size for this w 149 Description: The work queue size for this work queue.
173 150
174 What: /sys/bus/dsa/devices/wq<m>.<n> 151 What: /sys/bus/dsa/devices/wq<m>.<n>/type
175 Date: Oct 25, 2019 152 Date: Oct 25, 2019
176 KernelVersion: 5.6.0 153 KernelVersion: 5.6.0
177 Contact: dmaengine@vger.kernel.org 154 Contact: dmaengine@vger.kernel.org
178 Description: The type of this work queue, i 155 Description: The type of this work queue, it can be "kernel" type for work
179 queue usages in the kernel spa 156 queue usages in the kernel space or "user" type for work queue
180 usages by applications in user 157 usages by applications in user space.
181 158
182 What: /sys/bus/dsa/devices/wq<m>.<n> 159 What: /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor
183 Date: Oct 25, 2019 160 Date: Oct 25, 2019
184 KernelVersion: 5.6.0 161 KernelVersion: 5.6.0
185 Contact: dmaengine@vger.kernel.org 162 Contact: dmaengine@vger.kernel.org
186 Description: The minor number assigned to t 163 Description: The minor number assigned to this work queue by the character
187 device driver. 164 device driver.
188 165
189 What: /sys/bus/dsa/devices/wq<m>.<n> 166 What: /sys/bus/dsa/devices/wq<m>.<n>/mode
190 Date: Oct 25, 2019 167 Date: Oct 25, 2019
191 KernelVersion: 5.6.0 168 KernelVersion: 5.6.0
192 Contact: dmaengine@vger.kernel.org 169 Contact: dmaengine@vger.kernel.org
193 Description: The work queue mode type for t 170 Description: The work queue mode type for this work queue.
194 171
195 What: /sys/bus/dsa/devices/wq<m>.<n> 172 What: /sys/bus/dsa/devices/wq<m>.<n>/priority
196 Date: Oct 25, 2019 173 Date: Oct 25, 2019
197 KernelVersion: 5.6.0 174 KernelVersion: 5.6.0
198 Contact: dmaengine@vger.kernel.org 175 Contact: dmaengine@vger.kernel.org
199 Description: The priority value of this wor !! 176 Description: The priority value of this work queue, it is a vlue relative to
200 other work queue in the same g 177 other work queue in the same group to control quality of service
201 for dispatching work from mult 178 for dispatching work from multiple workqueues in the same group.
202 179
203 What: /sys/bus/dsa/devices/wq<m>.<n> 180 What: /sys/bus/dsa/devices/wq<m>.<n>/state
204 Date: Oct 25, 2019 181 Date: Oct 25, 2019
205 KernelVersion: 5.6.0 182 KernelVersion: 5.6.0
206 Contact: dmaengine@vger.kernel.org 183 Contact: dmaengine@vger.kernel.org
207 Description: The current state of the work 184 Description: The current state of the work queue.
208 185
209 What: /sys/bus/dsa/devices/wq<m>.<n> 186 What: /sys/bus/dsa/devices/wq<m>.<n>/threshold
210 Date: Oct 25, 2019 187 Date: Oct 25, 2019
211 KernelVersion: 5.6.0 188 KernelVersion: 5.6.0
212 Contact: dmaengine@vger.kernel.org 189 Contact: dmaengine@vger.kernel.org
213 Description: The number of entries in this 190 Description: The number of entries in this work queue that may be filled
214 via a limited portal. 191 via a limited portal.
215 192
216 What: /sys/bus/dsa/devices/wq<m>.<n> 193 What: /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size
217 Date: Aug 28, 2020 194 Date: Aug 28, 2020
218 KernelVersion: 5.10.0 195 KernelVersion: 5.10.0
219 Contact: dmaengine@vger.kernel.org 196 Contact: dmaengine@vger.kernel.org
220 Description: The max transfer sized for thi 197 Description: The max transfer sized for this workqueue. Cannot exceed device
221 max transfer size. Configurabl 198 max transfer size. Configurable parameter.
222 199
223 What: /sys/bus/dsa/devices/wq<m>.<n> 200 What: /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size
224 Date: Aug 28, 2020 201 Date: Aug 28, 2020
225 KernelVersion: 5.10.0 202 KernelVersion: 5.10.0
226 Contact: dmaengine@vger.kernel.org 203 Contact: dmaengine@vger.kernel.org
227 Description: The max batch size for this wo 204 Description: The max batch size for this workqueue. Cannot exceed device
228 max batch size. Configurable p 205 max batch size. Configurable parameter.
229 It's not visible when the devi <<
230 206
231 What: /sys/bus/dsa/devices/wq<m>.<n> 207 What: /sys/bus/dsa/devices/wq<m>.<n>/ats_disable
232 Date: Nov 13, 2020 208 Date: Nov 13, 2020
233 KernelVersion: 5.11.0 209 KernelVersion: 5.11.0
234 Contact: dmaengine@vger.kernel.org 210 Contact: dmaengine@vger.kernel.org
235 Description: Indicate whether ATS disable i 211 Description: Indicate whether ATS disable is turned on for the workqueue.
236 0 indicates ATS is on, and 1 i 212 0 indicates ATS is on, and 1 indicates ATS is off for the workqueue.
237 213
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 <<
279 What: /sys/bus/dsa/devices/engine<m> 214 What: /sys/bus/dsa/devices/engine<m>.<n>/group_id
280 Date: Oct 25, 2019 215 Date: Oct 25, 2019
281 KernelVersion: 5.6.0 216 KernelVersion: 5.6.0
282 Contact: dmaengine@vger.kernel.org 217 Contact: dmaengine@vger.kernel.org
283 Description: The group that this engine bel 218 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.