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