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_tokens
45Date:           Oct 25, 2019
46KernelVersion:  5.6.0
47Contact:        dmaengine@vger.kernel.org
48Description:    The total number of bandwidth tokens supported by this device.
49		The bandwidth tokens represent resources within the DSA
50		implementation, and these resources are allocated by engines to
51		support operations.
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>/token_limit
119Date:           Oct 25, 2019
120KernelVersion:  5.6.0
121Contact:        dmaengine@vger.kernel.org
122Description:    The maximum number of bandwidth tokens that may be in use at
123		one time by operations that access low bandwidth memory in the
124		device.
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
132What:		/sys/bus/dsa/devices/wq<m>.<n>/block_on_fault
133Date:		Oct 27, 2020
134KernelVersion:	5.11.0
135Contact:	dmaengine@vger.kernel.org
136Description:	To indicate block on fault is allowed or not for the work queue
137		to support on demand paging.
138
139What:           /sys/bus/dsa/devices/wq<m>.<n>/group_id
140Date:           Oct 25, 2019
141KernelVersion:  5.6.0
142Contact:        dmaengine@vger.kernel.org
143Description:    The group id that this work queue belongs to.
144
145What:           /sys/bus/dsa/devices/wq<m>.<n>/size
146Date:           Oct 25, 2019
147KernelVersion:  5.6.0
148Contact:        dmaengine@vger.kernel.org
149Description:    The work queue size for this work queue.
150
151What:           /sys/bus/dsa/devices/wq<m>.<n>/type
152Date:           Oct 25, 2019
153KernelVersion:  5.6.0
154Contact:        dmaengine@vger.kernel.org
155Description:    The type of this work queue, it can be "kernel" type for work
156		queue usages in the kernel space or "user" type for work queue
157		usages by applications in user space.
158
159What:           /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor
160Date:           Oct 25, 2019
161KernelVersion:  5.6.0
162Contact:        dmaengine@vger.kernel.org
163Description:    The minor number assigned to this work queue by the character
164		device driver.
165
166What:           /sys/bus/dsa/devices/wq<m>.<n>/mode
167Date:           Oct 25, 2019
168KernelVersion:  5.6.0
169Contact:        dmaengine@vger.kernel.org
170Description:    The work queue mode type for this work queue.
171
172What:           /sys/bus/dsa/devices/wq<m>.<n>/priority
173Date:           Oct 25, 2019
174KernelVersion:  5.6.0
175Contact:        dmaengine@vger.kernel.org
176Description:    The priority value of this work queue, it is a value relative to
177		other work queue in the same group to control quality of service
178		for dispatching work from multiple workqueues in the same group.
179
180What:           /sys/bus/dsa/devices/wq<m>.<n>/state
181Date:           Oct 25, 2019
182KernelVersion:  5.6.0
183Contact:        dmaengine@vger.kernel.org
184Description:    The current state of the work queue.
185
186What:           /sys/bus/dsa/devices/wq<m>.<n>/threshold
187Date:           Oct 25, 2019
188KernelVersion:  5.6.0
189Contact:        dmaengine@vger.kernel.org
190Description:    The number of entries in this work queue that may be filled
191		via a limited portal.
192
193What:		/sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size
194Date:		Aug 28, 2020
195KernelVersion:	5.10.0
196Contact:	dmaengine@vger.kernel.org
197Description:	The max transfer sized for this workqueue. Cannot exceed device
198		max transfer size. Configurable parameter.
199
200What:		/sys/bus/dsa/devices/wq<m>.<n>/max_batch_size
201Date:		Aug 28, 2020
202KernelVersion:	5.10.0
203Contact:	dmaengine@vger.kernel.org
204Description:	The max batch size for this workqueue. Cannot exceed device
205		max batch size. Configurable parameter.
206
207What:		/sys/bus/dsa/devices/wq<m>.<n>/ats_disable
208Date:		Nov 13, 2020
209KernelVersion:	5.11.0
210Contact:	dmaengine@vger.kernel.org
211Description:	Indicate whether ATS disable is turned on for the workqueue.
212		0 indicates ATS is on, and 1 indicates ATS is off for the workqueue.
213
214What:		/sys/bus/dsa/devices/wq<m>.<n>/occupancy
215Date		May 25, 2021
216KernelVersion:	5.14.0
217Contact:	dmaengine@vger.kernel.org
218Description:	Show the current number of entries in this WQ if WQ Occupancy
219		Support bit WQ capabilities is 1.
220
221What:           /sys/bus/dsa/devices/engine<m>.<n>/group_id
222Date:           Oct 25, 2019
223KernelVersion:  5.6.0
224Contact:        dmaengine@vger.kernel.org
225Description:    The group that this engine belongs to.
226