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>/state
81Date:           Oct 25, 2019
82KernelVersion:  5.6.0
83Contact:        dmaengine@vger.kernel.org
84Description:    The state information of this device. It can be either enabled
85		or disabled.
86
87What:           /sys/bus/dsa/devices/dsa<m>/group<m>.<n>
88Date:           Oct 25, 2019
89KernelVersion:  5.6.0
90Contact:        dmaengine@vger.kernel.org
91Description:    The assigned group under this device.
92
93What:           /sys/bus/dsa/devices/dsa<m>/engine<m>.<n>
94Date:           Oct 25, 2019
95KernelVersion:  5.6.0
96Contact:        dmaengine@vger.kernel.org
97Description:    The assigned engine under this device.
98
99What:           /sys/bus/dsa/devices/dsa<m>/wq<m>.<n>
100Date:           Oct 25, 2019
101KernelVersion:  5.6.0
102Contact:        dmaengine@vger.kernel.org
103Description:    The assigned work queue under this device.
104
105What:           /sys/bus/dsa/devices/dsa<m>/configurable
106Date:           Oct 25, 2019
107KernelVersion:  5.6.0
108Contact:        dmaengine@vger.kernel.org
109Description:    To indicate if this device is configurable or not.
110
111What:           /sys/bus/dsa/devices/dsa<m>/token_limit
112Date:           Oct 25, 2019
113KernelVersion:  5.6.0
114Contact:        dmaengine@vger.kernel.org
115Description:    The maximum number of bandwidth tokens that may be in use at
116		one time by operations that access low bandwidth memory in the
117		device.
118
119What:           /sys/bus/dsa/devices/wq<m>.<n>/group_id
120Date:           Oct 25, 2019
121KernelVersion:  5.6.0
122Contact:        dmaengine@vger.kernel.org
123Description:    The group id that this work queue belongs to.
124
125What:           /sys/bus/dsa/devices/wq<m>.<n>/size
126Date:           Oct 25, 2019
127KernelVersion:  5.6.0
128Contact:        dmaengine@vger.kernel.org
129Description:    The work queue size for this work queue.
130
131What:           /sys/bus/dsa/devices/wq<m>.<n>/type
132Date:           Oct 25, 2019
133KernelVersion:  5.6.0
134Contact:        dmaengine@vger.kernel.org
135Description:    The type of this work queue, it can be "kernel" type for work
136		queue usages in the kernel space or "user" type for work queue
137		usages by applications in user space.
138
139What:           /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor
140Date:           Oct 25, 2019
141KernelVersion:  5.6.0
142Contact:        dmaengine@vger.kernel.org
143Description:    The minor number assigned to this work queue by the character
144		device driver.
145
146What:           /sys/bus/dsa/devices/wq<m>.<n>/mode
147Date:           Oct 25, 2019
148KernelVersion:  5.6.0
149Contact:        dmaengine@vger.kernel.org
150Description:    The work queue mode type for this work queue.
151
152What:           /sys/bus/dsa/devices/wq<m>.<n>/priority
153Date:           Oct 25, 2019
154KernelVersion:  5.6.0
155Contact:        dmaengine@vger.kernel.org
156Description:    The priority value of this work queue, it is a vlue relative to
157		other work queue in the same group to control quality of service
158		for dispatching work from multiple workqueues in the same group.
159
160What:           /sys/bus/dsa/devices/wq<m>.<n>/state
161Date:           Oct 25, 2019
162KernelVersion:  5.6.0
163Contact:        dmaengine@vger.kernel.org
164Description:    The current state of the work queue.
165
166What:           /sys/bus/dsa/devices/wq<m>.<n>/threshold
167Date:           Oct 25, 2019
168KernelVersion:  5.6.0
169Contact:        dmaengine@vger.kernel.org
170Description:    The number of entries in this work queue that may be filled
171		via a limited portal.
172
173What:		/sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size
174Date:		Aug 28, 2020
175KernelVersion:	5.10.0
176Contact:	dmaengine@vger.kernel.org
177Description:	The max transfer sized for this workqueue. Cannot exceed device
178		max transfer size. Configurable parameter.
179
180What:		/sys/bus/dsa/devices/wq<m>.<n>/max_batch_size
181Date:		Aug 28, 2020
182KernelVersion:	5.10.0
183Contact:	dmaengine@vger.kernel.org
184Description:	The max batch size for this workqueue. Cannot exceed device
185		max batch size. Configurable parameter.
186
187What:           /sys/bus/dsa/devices/engine<m>.<n>/group_id
188Date:           Oct 25, 2019
189KernelVersion:  5.6.0
190Contact:        dmaengine@vger.kernel.org
191Description:    The group that this engine belongs to.
192