0001 What: /sys/bus/dsa/devices/dsa<m>/version
0002 Date: Apr 15, 2020
0003 KernelVersion: 5.8.0
0004 Contact: dmaengine@vger.kernel.org
0005 Description: The hardware version number.
0006
0007 What: /sys/bus/dsa/devices/dsa<m>/cdev_major
0008 Date: Oct 25, 2019
0009 KernelVersion: 5.6.0
0010 Contact: dmaengine@vger.kernel.org
0011 Description: The major number that the character device driver assigned to
0012 this device.
0013
0014 What: /sys/bus/dsa/devices/dsa<m>/errors
0015 Date: Oct 25, 2019
0016 KernelVersion: 5.6.0
0017 Contact: dmaengine@vger.kernel.org
0018 Description: The error information for this device.
0019
0020 What: /sys/bus/dsa/devices/dsa<m>/max_batch_size
0021 Date: Oct 25, 2019
0022 KernelVersion: 5.6.0
0023 Contact: dmaengine@vger.kernel.org
0024 Description: The largest number of work descriptors in a batch.
0025
0026 What: /sys/bus/dsa/devices/dsa<m>/max_work_queues_size
0027 Date: Oct 25, 2019
0028 KernelVersion: 5.6.0
0029 Contact: dmaengine@vger.kernel.org
0030 Description: The maximum work queue size supported by this device.
0031
0032 What: /sys/bus/dsa/devices/dsa<m>/max_engines
0033 Date: Oct 25, 2019
0034 KernelVersion: 5.6.0
0035 Contact: dmaengine@vger.kernel.org
0036 Description: The maximum number of engines supported by this device.
0037
0038 What: /sys/bus/dsa/devices/dsa<m>/max_groups
0039 Date: Oct 25, 2019
0040 KernelVersion: 5.6.0
0041 Contact: dmaengine@vger.kernel.org
0042 Description: The maximum number of groups can be created under this device.
0043
0044 What: /sys/bus/dsa/devices/dsa<m>/max_read_buffers
0045 Date: Dec 10, 2021
0046 KernelVersion: 5.17.0
0047 Contact: dmaengine@vger.kernel.org
0048 Description: The total number of read buffers supported by this device.
0049 The read buffers represent resources within the DSA
0050 implementation, and these resources are allocated by engines to
0051 support operations. See DSA spec v1.2 9.2.4 Total Read Buffers.
0052
0053 What: /sys/bus/dsa/devices/dsa<m>/max_transfer_size
0054 Date: Oct 25, 2019
0055 KernelVersion: 5.6.0
0056 Contact: dmaengine@vger.kernel.org
0057 Description: The number of bytes to be read from the source address to
0058 perform the operation. The maximum transfer size is dependent on
0059 the workqueue the descriptor was submitted to.
0060
0061 What: /sys/bus/dsa/devices/dsa<m>/max_work_queues
0062 Date: Oct 25, 2019
0063 KernelVersion: 5.6.0
0064 Contact: dmaengine@vger.kernel.org
0065 Description: The maximum work queue number that this device supports.
0066
0067 What: /sys/bus/dsa/devices/dsa<m>/numa_node
0068 Date: Oct 25, 2019
0069 KernelVersion: 5.6.0
0070 Contact: dmaengine@vger.kernel.org
0071 Description: The numa node number for this device.
0072
0073 What: /sys/bus/dsa/devices/dsa<m>/op_cap
0074 Date: Oct 25, 2019
0075 KernelVersion: 5.6.0
0076 Contact: dmaengine@vger.kernel.org
0077 Description: The operation capability bit mask specify the operation types
0078 supported by the this device.
0079
0080 What: /sys/bus/dsa/devices/dsa<m>/pasid_enabled
0081 Date: Oct 27, 2020
0082 KernelVersion: 5.11.0
0083 Contact: dmaengine@vger.kernel.org
0084 Description: To indicate if PASID (process address space identifier) is
0085 enabled or not for this device.
0086
0087 What: /sys/bus/dsa/devices/dsa<m>/state
0088 Date: Oct 25, 2019
0089 KernelVersion: 5.6.0
0090 Contact: dmaengine@vger.kernel.org
0091 Description: The state information of this device. It can be either enabled
0092 or disabled.
0093
0094 What: /sys/bus/dsa/devices/dsa<m>/group<m>.<n>
0095 Date: Oct 25, 2019
0096 KernelVersion: 5.6.0
0097 Contact: dmaengine@vger.kernel.org
0098 Description: The assigned group under this device.
0099
0100 What: /sys/bus/dsa/devices/dsa<m>/engine<m>.<n>
0101 Date: Oct 25, 2019
0102 KernelVersion: 5.6.0
0103 Contact: dmaengine@vger.kernel.org
0104 Description: The assigned engine under this device.
0105
0106 What: /sys/bus/dsa/devices/dsa<m>/wq<m>.<n>
0107 Date: Oct 25, 2019
0108 KernelVersion: 5.6.0
0109 Contact: dmaengine@vger.kernel.org
0110 Description: The assigned work queue under this device.
0111
0112 What: /sys/bus/dsa/devices/dsa<m>/configurable
0113 Date: Oct 25, 2019
0114 KernelVersion: 5.6.0
0115 Contact: dmaengine@vger.kernel.org
0116 Description: To indicate if this device is configurable or not.
0117
0118 What: /sys/bus/dsa/devices/dsa<m>/read_buffer_limit
0119 Date: Dec 10, 2021
0120 KernelVersion: 5.17.0
0121 Contact: dmaengine@vger.kernel.org
0122 Description: The maximum number of read buffers that may be in use at
0123 one time by operations that access low bandwidth memory in the
0124 device. See DSA spec v1.2 9.2.8 GENCFG on Global Read Buffer Limit.
0125
0126 What: /sys/bus/dsa/devices/dsa<m>/cmd_status
0127 Date: Aug 28, 2020
0128 KernelVersion: 5.10.0
0129 Contact: dmaengine@vger.kernel.org
0130 Description: The last executed device administrative command's status/error.
0131 Also last configuration error overloaded.
0132 Writing to it will clear the status.
0133
0134 What: /sys/bus/dsa/devices/wq<m>.<n>/block_on_fault
0135 Date: Oct 27, 2020
0136 KernelVersion: 5.11.0
0137 Contact: dmaengine@vger.kernel.org
0138 Description: To indicate block on fault is allowed or not for the work queue
0139 to support on demand paging.
0140
0141 What: /sys/bus/dsa/devices/wq<m>.<n>/group_id
0142 Date: Oct 25, 2019
0143 KernelVersion: 5.6.0
0144 Contact: dmaengine@vger.kernel.org
0145 Description: The group id that this work queue belongs to.
0146
0147 What: /sys/bus/dsa/devices/wq<m>.<n>/size
0148 Date: Oct 25, 2019
0149 KernelVersion: 5.6.0
0150 Contact: dmaengine@vger.kernel.org
0151 Description: The work queue size for this work queue.
0152
0153 What: /sys/bus/dsa/devices/wq<m>.<n>/type
0154 Date: Oct 25, 2019
0155 KernelVersion: 5.6.0
0156 Contact: dmaengine@vger.kernel.org
0157 Description: The type of this work queue, it can be "kernel" type for work
0158 queue usages in the kernel space or "user" type for work queue
0159 usages by applications in user space.
0160
0161 What: /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor
0162 Date: Oct 25, 2019
0163 KernelVersion: 5.6.0
0164 Contact: dmaengine@vger.kernel.org
0165 Description: The minor number assigned to this work queue by the character
0166 device driver.
0167
0168 What: /sys/bus/dsa/devices/wq<m>.<n>/mode
0169 Date: Oct 25, 2019
0170 KernelVersion: 5.6.0
0171 Contact: dmaengine@vger.kernel.org
0172 Description: The work queue mode type for this work queue.
0173
0174 What: /sys/bus/dsa/devices/wq<m>.<n>/priority
0175 Date: Oct 25, 2019
0176 KernelVersion: 5.6.0
0177 Contact: dmaengine@vger.kernel.org
0178 Description: The priority value of this work queue, it is a value relative to
0179 other work queue in the same group to control quality of service
0180 for dispatching work from multiple workqueues in the same group.
0181
0182 What: /sys/bus/dsa/devices/wq<m>.<n>/state
0183 Date: Oct 25, 2019
0184 KernelVersion: 5.6.0
0185 Contact: dmaengine@vger.kernel.org
0186 Description: The current state of the work queue.
0187
0188 What: /sys/bus/dsa/devices/wq<m>.<n>/threshold
0189 Date: Oct 25, 2019
0190 KernelVersion: 5.6.0
0191 Contact: dmaengine@vger.kernel.org
0192 Description: The number of entries in this work queue that may be filled
0193 via a limited portal.
0194
0195 What: /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size
0196 Date: Aug 28, 2020
0197 KernelVersion: 5.10.0
0198 Contact: dmaengine@vger.kernel.org
0199 Description: The max transfer sized for this workqueue. Cannot exceed device
0200 max transfer size. Configurable parameter.
0201
0202 What: /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size
0203 Date: Aug 28, 2020
0204 KernelVersion: 5.10.0
0205 Contact: dmaengine@vger.kernel.org
0206 Description: The max batch size for this workqueue. Cannot exceed device
0207 max batch size. Configurable parameter.
0208
0209 What: /sys/bus/dsa/devices/wq<m>.<n>/ats_disable
0210 Date: Nov 13, 2020
0211 KernelVersion: 5.11.0
0212 Contact: dmaengine@vger.kernel.org
0213 Description: Indicate whether ATS disable is turned on for the workqueue.
0214 0 indicates ATS is on, and 1 indicates ATS is off for the workqueue.
0215
0216 What: /sys/bus/dsa/devices/wq<m>.<n>/occupancy
0217 Date May 25, 2021
0218 KernelVersion: 5.14.0
0219 Contact: dmaengine@vger.kernel.org
0220 Description: Show the current number of entries in this WQ if WQ Occupancy
0221 Support bit WQ capabilities is 1.
0222
0223 What: /sys/bus/dsa/devices/wq<m>.<n>/enqcmds_retries
0224 Date Oct 29, 2021
0225 KernelVersion: 5.17.0
0226 Contact: dmaengine@vger.kernel.org
0227 Description: Indicate the number of retires for an enqcmds submission on a sharedwq.
0228 A max value to set attribute is capped at 64.
0229
0230 What: /sys/bus/dsa/devices/engine<m>.<n>/group_id
0231 Date: Oct 25, 2019
0232 KernelVersion: 5.6.0
0233 Contact: dmaengine@vger.kernel.org
0234 Description: The group that this engine belongs to.
0235
0236 What: /sys/bus/dsa/devices/group<m>.<n>/use_read_buffer_limit
0237 Date: Dec 10, 2021
0238 KernelVersion: 5.17.0
0239 Contact: dmaengine@vger.kernel.org
0240 Description: Enable the use of global read buffer limit for the group. See DSA
0241 spec v1.2 9.2.18 GRPCFG Use Global Read Buffer Limit.
0242
0243 What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_allowed
0244 Date: Dec 10, 2021
0245 KernelVersion: 5.17.0
0246 Contact: dmaengine@vger.kernel.org
0247 Description: Indicates max number of read buffers that may be in use at one time
0248 by all engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read
0249 Buffers Allowed.
0250
0251 What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_reserved
0252 Date: Dec 10, 2021
0253 KernelVersion: 5.17.0
0254 Contact: dmaengine@vger.kernel.org
0255 Description: Indicates the number of Read Buffers reserved for the use of
0256 engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read Buffers
0257 Reserved.
