362 lines · plain
1What: /sys/bus/dsa/devices/dsa<m>/version2Date: Apr 15, 20203KernelVersion: 5.8.04Contact: dmaengine@vger.kernel.org5Description: The hardware version number.6 7What: /sys/bus/dsa/devices/dsa<m>/cdev_major8Date: Oct 25, 20199KernelVersion: 5.6.010Contact: dmaengine@vger.kernel.org11Description: The major number that the character device driver assigned to12 this device.13 14What: /sys/bus/dsa/devices/dsa<m>/errors15Date: Oct 25, 201916KernelVersion: 5.6.017Contact: dmaengine@vger.kernel.org18Description: The error information for this device.19 20What: /sys/bus/dsa/devices/dsa<m>/max_batch_size21Date: Oct 25, 201922KernelVersion: 5.6.023Contact: dmaengine@vger.kernel.org24Description: The largest number of work descriptors in a batch.25 It's not visible when the device does not support batch.26 27What: /sys/bus/dsa/devices/dsa<m>/max_work_queues_size28Date: Oct 25, 201929KernelVersion: 5.6.030Contact: dmaengine@vger.kernel.org31Description: The maximum work queue size supported by this device.32 33What: /sys/bus/dsa/devices/dsa<m>/max_engines34Date: Oct 25, 201935KernelVersion: 5.6.036Contact: dmaengine@vger.kernel.org37Description: The maximum number of engines supported by this device.38 39What: /sys/bus/dsa/devices/dsa<m>/max_groups40Date: Oct 25, 201941KernelVersion: 5.6.042Contact: dmaengine@vger.kernel.org43Description: The maximum number of groups can be created under this device.44 45What: /sys/bus/dsa/devices/dsa<m>/max_read_buffers46Date: Dec 10, 202147KernelVersion: 5.17.048Contact: dmaengine@vger.kernel.org49Description: The total number of read buffers supported by this device.50 The read buffers represent resources within the DSA51 implementation, and these resources are allocated by engines to52 support operations. See DSA spec v1.2 9.2.4 Total Read Buffers.53 It's not visible when the device does not support Read Buffer54 allocation control.55 56What: /sys/bus/dsa/devices/dsa<m>/max_transfer_size57Date: Oct 25, 201958KernelVersion: 5.6.059Contact: dmaengine@vger.kernel.org60Description: The number of bytes to be read from the source address to61 perform the operation. The maximum transfer size is dependent on62 the workqueue the descriptor was submitted to.63 64What: /sys/bus/dsa/devices/dsa<m>/max_work_queues65Date: Oct 25, 201966KernelVersion: 5.6.067Contact: dmaengine@vger.kernel.org68Description: The maximum work queue number that this device supports.69 70What: /sys/bus/dsa/devices/dsa<m>/numa_node71Date: Oct 25, 201972KernelVersion: 5.6.073Contact: dmaengine@vger.kernel.org74Description: The numa node number for this device.75 76What: /sys/bus/dsa/devices/dsa<m>/op_cap77Date: Oct 25, 201978KernelVersion: 5.6.079Contact: dmaengine@vger.kernel.org80Description: The operation capability bit mask specify the operation types81 supported by the this device.82 83What: /sys/bus/dsa/devices/dsa<m>/pasid_enabled84Date: Oct 27, 202085KernelVersion: 5.11.086Contact: dmaengine@vger.kernel.org87Description: To indicate if user PASID (process address space identifier) is88 enabled or not for this device.89 90What: /sys/bus/dsa/devices/dsa<m>/state91Date: Oct 25, 201992KernelVersion: 5.6.093Contact: dmaengine@vger.kernel.org94Description: The state information of this device. It can be either enabled95 or disabled.96 97What: /sys/bus/dsa/devices/dsa<m>/group<m>.<n>98Date: Oct 25, 201999KernelVersion: 5.6.0100Contact: dmaengine@vger.kernel.org101Description: The assigned group under this device.102 103What: /sys/bus/dsa/devices/dsa<m>/engine<m>.<n>104Date: Oct 25, 2019105KernelVersion: 5.6.0106Contact: dmaengine@vger.kernel.org107Description: The assigned engine under this device.108 109What: /sys/bus/dsa/devices/dsa<m>/wq<m>.<n>110Date: Oct 25, 2019111KernelVersion: 5.6.0112Contact: dmaengine@vger.kernel.org113Description: The assigned work queue under this device.114 115What: /sys/bus/dsa/devices/dsa<m>/configurable116Date: Oct 25, 2019117KernelVersion: 5.6.0118Contact: dmaengine@vger.kernel.org119Description: To indicate if this device is configurable or not.120 121What: /sys/bus/dsa/devices/dsa<m>/read_buffer_limit122Date: Dec 10, 2021123KernelVersion: 5.17.0124Contact: dmaengine@vger.kernel.org125Description: The maximum number of read buffers that may be in use at126 one time by operations that access low bandwidth memory in the127 device. See DSA spec v1.2 9.2.8 GENCFG on Global Read Buffer Limit.128 It's not visible when the device does not support Read Buffer129 allocation control.130 131What: /sys/bus/dsa/devices/dsa<m>/cmd_status132Date: Aug 28, 2020133KernelVersion: 5.10.0134Contact: dmaengine@vger.kernel.org135Description: The last executed device administrative command's status/error.136 Also last configuration error overloaded.137 Writing to it will clear the status.138 139What: /sys/bus/dsa/devices/dsa<m>/iaa_cap140Date: Sept 14, 2022141KernelVersion: 6.0.0142Contact: dmaengine@vger.kernel.org143Description: IAA (IAX) capability mask. Exported to user space for application144 consumption. This attribute should only be visible on IAA devices145 that are version 2 or later.146 147What: /sys/bus/dsa/devices/dsa<m>/event_log_size148Date: Sept 14, 2022149KernelVersion: 6.4.0150Contact: dmaengine@vger.kernel.org151Description: The event log size to be configured. Default is 64 entries and152 occupies 4k size if the evl entry is 64 bytes. It's visible153 only on platforms that support the capability.154 155What: /sys/bus/dsa/devices/wq<m>.<n>/block_on_fault156Date: Oct 27, 2020157KernelVersion: 5.11.0158Contact: dmaengine@vger.kernel.org159Description: To indicate block on fault is allowed or not for the work queue160 to support on demand paging.161 162What: /sys/bus/dsa/devices/wq<m>.<n>/group_id163Date: Oct 25, 2019164KernelVersion: 5.6.0165Contact: dmaengine@vger.kernel.org166Description: The group id that this work queue belongs to.167 168What: /sys/bus/dsa/devices/wq<m>.<n>/size169Date: Oct 25, 2019170KernelVersion: 5.6.0171Contact: dmaengine@vger.kernel.org172Description: The work queue size for this work queue.173 174What: /sys/bus/dsa/devices/wq<m>.<n>/type175Date: Oct 25, 2019176KernelVersion: 5.6.0177Contact: dmaengine@vger.kernel.org178Description: The type of this work queue, it can be "kernel" type for work179 queue usages in the kernel space or "user" type for work queue180 usages by applications in user space.181 182What: /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor183Date: Oct 25, 2019184KernelVersion: 5.6.0185Contact: dmaengine@vger.kernel.org186Description: The minor number assigned to this work queue by the character187 device driver.188 189What: /sys/bus/dsa/devices/wq<m>.<n>/mode190Date: Oct 25, 2019191KernelVersion: 5.6.0192Contact: dmaengine@vger.kernel.org193Description: The work queue mode type for this work queue.194 195What: /sys/bus/dsa/devices/wq<m>.<n>/priority196Date: Oct 25, 2019197KernelVersion: 5.6.0198Contact: dmaengine@vger.kernel.org199Description: The priority value of this work queue, it is a value relative to200 other work queue in the same group to control quality of service201 for dispatching work from multiple workqueues in the same group.202 203What: /sys/bus/dsa/devices/wq<m>.<n>/state204Date: Oct 25, 2019205KernelVersion: 5.6.0206Contact: dmaengine@vger.kernel.org207Description: The current state of the work queue.208 209What: /sys/bus/dsa/devices/wq<m>.<n>/threshold210Date: Oct 25, 2019211KernelVersion: 5.6.0212Contact: dmaengine@vger.kernel.org213Description: The number of entries in this work queue that may be filled214 via a limited portal.215 216What: /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size217Date: Aug 28, 2020218KernelVersion: 5.10.0219Contact: dmaengine@vger.kernel.org220Description: The max transfer sized for this workqueue. Cannot exceed device221 max transfer size. Configurable parameter.222 223What: /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size224Date: Aug 28, 2020225KernelVersion: 5.10.0226Contact: dmaengine@vger.kernel.org227Description: The max batch size for this workqueue. Cannot exceed device228 max batch size. Configurable parameter.229 It's not visible when the device does not support batch.230 231What: /sys/bus/dsa/devices/wq<m>.<n>/ats_disable232Date: Nov 13, 2020233KernelVersion: 5.11.0234Contact: dmaengine@vger.kernel.org235Description: Indicate whether ATS disable is turned on for the workqueue.236 0 indicates ATS is on, and 1 indicates ATS is off for the workqueue.237 238What: /sys/bus/dsa/devices/wq<m>.<n>/prs_disable239Date: Sept 14, 2022240KernelVersion: 6.4.0241Contact: dmaengine@vger.kernel.org242Description: Controls whether PRS disable is turned on for the workqueue.243 0 indicates PRS is on, and 1 indicates PRS is off for the244 workqueue. This option overrides block_on_fault attribute245 if set. It's visible only on platforms that support the246 capability.247 248What: /sys/bus/dsa/devices/wq<m>.<n>/occupancy249Date May 25, 2021250KernelVersion: 5.14.0251Contact: dmaengine@vger.kernel.org252Description: Show the current number of entries in this WQ if WQ Occupancy253 Support bit WQ capabilities is 1.254 255What: /sys/bus/dsa/devices/wq<m>.<n>/enqcmds_retries256Date Oct 29, 2021257KernelVersion: 5.17.0258Contact: dmaengine@vger.kernel.org259Description: Indicate the number of retires for an enqcmds submission on a sharedwq.260 A max value to set attribute is capped at 64.261 262What: /sys/bus/dsa/devices/wq<m>.<n>/op_config263Date: Sept 14, 2022264KernelVersion: 6.0.0265Contact: dmaengine@vger.kernel.org266Description: Shows the operation capability bits displayed in bitmap format267 presented by %*pb printk() output format specifier.268 The attribute can be configured when the WQ is disabled in269 order to configure the WQ to accept specific bits that270 correlates to the operations allowed. It's visible only271 on platforms that support the capability.272 273What: /sys/bus/dsa/devices/wq<m>.<n>/driver_name274Date: Sept 8, 2023275KernelVersion: 6.7.0276Contact: dmaengine@vger.kernel.org277Description: Name of driver to be bounded to the wq.278 279What: /sys/bus/dsa/devices/engine<m>.<n>/group_id280Date: Oct 25, 2019281KernelVersion: 5.6.0282Contact: dmaengine@vger.kernel.org283Description: The group that this engine belongs to.284 285What: /sys/bus/dsa/devices/group<m>.<n>/use_read_buffer_limit286Date: Dec 10, 2021287KernelVersion: 5.17.0288Contact: dmaengine@vger.kernel.org289Description: Enable the use of global read buffer limit for the group. See DSA290 spec v1.2 9.2.18 GRPCFG Use Global Read Buffer Limit.291 It's not visible when the device does not support Read Buffer292 allocation control.293 294What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_allowed295Date: Dec 10, 2021296KernelVersion: 5.17.0297Contact: dmaengine@vger.kernel.org298Description: Indicates max number of read buffers that may be in use at one time299 by all engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read300 Buffers Allowed.301 It's not visible when the device does not support Read Buffer302 allocation control.303 304What: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_reserved305Date: Dec 10, 2021306KernelVersion: 5.17.0307Contact: dmaengine@vger.kernel.org308Description: Indicates the number of Read Buffers reserved for the use of309 engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read Buffers310 Reserved.311 It's not visible when the device does not support Read Buffer312 allocation control.313 314What: /sys/bus/dsa/devices/group<m>.<n>/desc_progress_limit315Date: Sept 14, 2022316KernelVersion: 6.0.0317Contact: dmaengine@vger.kernel.org318Description: Allows control of the number of work descriptors that can be319 concurrently processed by an engine in the group as a fraction320 of the Maximum Work Descriptors in Progress value specified in321 the ENGCAP register. The acceptable values are 0 (default),322 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of323 the max value). It's visible only on platforms that support324 the capability.325 326What: /sys/bus/dsa/devices/group<m>.<n>/batch_progress_limit327Date: Sept 14, 2022328KernelVersion: 6.0.0329Contact: dmaengine@vger.kernel.org330Description: Allows control of the number of batch descriptors that can be331 concurrently processed by an engine in the group as a fraction332 of the Maximum Batch Descriptors in Progress value specified in333 the ENGCAP register. The acceptable values are 0 (default),334 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of335 the max value). It's visible only on platforms that support336 the capability.337 338What: /sys/bus/dsa/devices/wq<m>.<n>/dsa<x>\!wq<m>.<n>/file<y>/cr_faults339Date: Sept 14, 2022340KernelVersion: 6.4.0341Contact: dmaengine@vger.kernel.org342Description: Show the number of Completion Record (CR) faults this application343 has caused.344 345What: /sys/bus/dsa/devices/wq<m>.<n>/dsa<x>\!wq<m>.<n>/file<y>/cr_fault_failures346Date: Sept 14, 2022347KernelVersion: 6.4.0348Contact: dmaengine@vger.kernel.org349Description: Show the number of Completion Record (CR) faults failures that this350 application has caused. The failure counter is incremented when the351 driver cannot fault in the address for the CR. Typically this is caused352 by a bad address programmed in the submitted descriptor or a malicious353 submitter is using bad CR address on purpose.354 355What: /sys/bus/dsa/devices/wq<m>.<n>/dsa<x>\!wq<m>.<n>/file<y>/pid356Date: Sept 14, 2022357KernelVersion: 6.4.0358Contact: dmaengine@vger.kernel.org359Description: Show the process id of the application that opened the file. This is360 helpful information for a monitor daemon that wants to kill the361 application that opened the file.362