177522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/version 2c2ce6bbcSDave JiangDate: Apr 15, 2020 3c2ce6bbcSDave JiangKernelVersion: 5.8.0 4c2ce6bbcSDave JiangContact: dmaengine@vger.kernel.org 5c2ce6bbcSDave JiangDescription: The hardware version number. 6c2ce6bbcSDave Jiang 777522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/cdev_major 8b131ad59SJing LinDate: Oct 25, 2019 9b131ad59SJing LinKernelVersion: 5.6.0 10b131ad59SJing LinContact: dmaengine@vger.kernel.org 11b131ad59SJing LinDescription: The major number that the character device driver assigned to 12b131ad59SJing Lin this device. 13b131ad59SJing Lin 1477522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/errors 15b131ad59SJing LinDate: Oct 25, 2019 16b131ad59SJing LinKernelVersion: 5.6.0 17b131ad59SJing LinContact: dmaengine@vger.kernel.org 18b131ad59SJing LinDescription: The error information for this device. 19b131ad59SJing Lin 2077522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_batch_size 21b131ad59SJing LinDate: Oct 25, 2019 22b131ad59SJing LinKernelVersion: 5.6.0 23b131ad59SJing LinContact: dmaengine@vger.kernel.org 24b131ad59SJing LinDescription: The largest number of work descriptors in a batch. 25b131ad59SJing Lin 2677522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_work_queues_size 27b131ad59SJing LinDate: Oct 25, 2019 28b131ad59SJing LinKernelVersion: 5.6.0 29b131ad59SJing LinContact: dmaengine@vger.kernel.org 30b131ad59SJing LinDescription: The maximum work queue size supported by this device. 31b131ad59SJing Lin 3277522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_engines 33b131ad59SJing LinDate: Oct 25, 2019 34b131ad59SJing LinKernelVersion: 5.6.0 35b131ad59SJing LinContact: dmaengine@vger.kernel.org 36b131ad59SJing LinDescription: The maximum number of engines supported by this device. 37b131ad59SJing Lin 3877522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_groups 39b131ad59SJing LinDate: Oct 25, 2019 40b131ad59SJing LinKernelVersion: 5.6.0 41b131ad59SJing LinContact: dmaengine@vger.kernel.org 42b131ad59SJing LinDescription: The maximum number of groups can be created under this device. 43b131ad59SJing Lin 44fde212e4SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_read_buffers 45fde212e4SDave JiangDate: Dec 10, 2021 46fde212e4SDave JiangKernelVersion: 5.17.0 47b131ad59SJing LinContact: dmaengine@vger.kernel.org 48fde212e4SDave JiangDescription: The total number of read buffers supported by this device. 49fde212e4SDave Jiang The read buffers represent resources within the DSA 50b131ad59SJing Lin implementation, and these resources are allocated by engines to 51fde212e4SDave Jiang support operations. See DSA spec v1.2 9.2.4 Total Read Buffers. 52b131ad59SJing Lin 5377522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_transfer_size 54b131ad59SJing LinDate: Oct 25, 2019 55b131ad59SJing LinKernelVersion: 5.6.0 56b131ad59SJing LinContact: dmaengine@vger.kernel.org 57b131ad59SJing LinDescription: The number of bytes to be read from the source address to 58b131ad59SJing Lin perform the operation. The maximum transfer size is dependent on 59b131ad59SJing Lin the workqueue the descriptor was submitted to. 60b131ad59SJing Lin 6177522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/max_work_queues 62b131ad59SJing LinDate: Oct 25, 2019 63b131ad59SJing LinKernelVersion: 5.6.0 64b131ad59SJing LinContact: dmaengine@vger.kernel.org 65b131ad59SJing LinDescription: The maximum work queue number that this device supports. 66b131ad59SJing Lin 6777522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/numa_node 68b131ad59SJing LinDate: Oct 25, 2019 69b131ad59SJing LinKernelVersion: 5.6.0 70b131ad59SJing LinContact: dmaengine@vger.kernel.org 71b131ad59SJing LinDescription: The numa node number for this device. 72b131ad59SJing Lin 7377522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/op_cap 74b131ad59SJing LinDate: Oct 25, 2019 75b131ad59SJing LinKernelVersion: 5.6.0 76b131ad59SJing LinContact: dmaengine@vger.kernel.org 77b131ad59SJing LinDescription: The operation capability bit mask specify the operation types 78b131ad59SJing Lin supported by the this device. 79b131ad59SJing Lin 804749f51dSDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/pasid_enabled 814749f51dSDave JiangDate: Oct 27, 2020 824749f51dSDave JiangKernelVersion: 5.11.0 834749f51dSDave JiangContact: dmaengine@vger.kernel.org 844749f51dSDave JiangDescription: To indicate if PASID (process address space identifier) is 854749f51dSDave Jiang enabled or not for this device. 864749f51dSDave Jiang 8777522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/state 88b131ad59SJing LinDate: Oct 25, 2019 89b131ad59SJing LinKernelVersion: 5.6.0 90b131ad59SJing LinContact: dmaengine@vger.kernel.org 91b131ad59SJing LinDescription: The state information of this device. It can be either enabled 92b131ad59SJing Lin or disabled. 93b131ad59SJing Lin 9477522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/group<m>.<n> 95b131ad59SJing LinDate: Oct 25, 2019 96b131ad59SJing LinKernelVersion: 5.6.0 97b131ad59SJing LinContact: dmaengine@vger.kernel.org 98b131ad59SJing LinDescription: The assigned group under this device. 99b131ad59SJing Lin 10077522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/engine<m>.<n> 101b131ad59SJing LinDate: Oct 25, 2019 102b131ad59SJing LinKernelVersion: 5.6.0 103b131ad59SJing LinContact: dmaengine@vger.kernel.org 104b131ad59SJing LinDescription: The assigned engine under this device. 105b131ad59SJing Lin 10677522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/wq<m>.<n> 107b131ad59SJing LinDate: Oct 25, 2019 108b131ad59SJing LinKernelVersion: 5.6.0 109b131ad59SJing LinContact: dmaengine@vger.kernel.org 110b131ad59SJing LinDescription: The assigned work queue under this device. 111b131ad59SJing Lin 11277522b21SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/configurable 113b131ad59SJing LinDate: Oct 25, 2019 114b131ad59SJing LinKernelVersion: 5.6.0 115b131ad59SJing LinContact: dmaengine@vger.kernel.org 116b131ad59SJing LinDescription: To indicate if this device is configurable or not. 117b131ad59SJing Lin 118fde212e4SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/read_buffer_limit 119fde212e4SDave JiangDate: Dec 10, 2021 120fde212e4SDave JiangKernelVersion: 5.17.0 121b131ad59SJing LinContact: dmaengine@vger.kernel.org 122fde212e4SDave JiangDescription: The maximum number of read buffers that may be in use at 123b131ad59SJing Lin one time by operations that access low bandwidth memory in the 124fde212e4SDave Jiang device. See DSA spec v1.2 9.2.8 GENCFG on Global Read Buffer Limit. 125b131ad59SJing Lin 126ff18de55SDave JiangWhat: /sys/bus/dsa/devices/dsa<m>/cmd_status 127ff18de55SDave JiangDate: Aug 28, 2020 128ff18de55SDave JiangKernelVersion: 5.10.0 129ff18de55SDave JiangContact: dmaengine@vger.kernel.org 130ff18de55SDave JiangDescription: The last executed device administrative command's status/error. 131125d1037SDave Jiang Also last configuration error overloaded. 132125d1037SDave Jiang Writing to it will clear the status. 133ff18de55SDave Jiang 1344749f51dSDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/block_on_fault 1354749f51dSDave JiangDate: Oct 27, 2020 1364749f51dSDave JiangKernelVersion: 5.11.0 1374749f51dSDave JiangContact: dmaengine@vger.kernel.org 1384749f51dSDave JiangDescription: To indicate block on fault is allowed or not for the work queue 1394749f51dSDave Jiang to support on demand paging. 1404749f51dSDave Jiang 14177522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/group_id 142b131ad59SJing LinDate: Oct 25, 2019 143b131ad59SJing LinKernelVersion: 5.6.0 144b131ad59SJing LinContact: dmaengine@vger.kernel.org 145b131ad59SJing LinDescription: The group id that this work queue belongs to. 146b131ad59SJing Lin 14777522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/size 148b131ad59SJing LinDate: Oct 25, 2019 149b131ad59SJing LinKernelVersion: 5.6.0 150b131ad59SJing LinContact: dmaengine@vger.kernel.org 151b131ad59SJing LinDescription: The work queue size for this work queue. 152b131ad59SJing Lin 15377522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/type 154b131ad59SJing LinDate: Oct 25, 2019 155b131ad59SJing LinKernelVersion: 5.6.0 156b131ad59SJing LinContact: dmaengine@vger.kernel.org 157b131ad59SJing LinDescription: The type of this work queue, it can be "kernel" type for work 158b131ad59SJing Lin queue usages in the kernel space or "user" type for work queue 159b131ad59SJing Lin usages by applications in user space. 160b131ad59SJing Lin 16177522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor 162b131ad59SJing LinDate: Oct 25, 2019 163b131ad59SJing LinKernelVersion: 5.6.0 164b131ad59SJing LinContact: dmaengine@vger.kernel.org 165b131ad59SJing LinDescription: The minor number assigned to this work queue by the character 166b131ad59SJing Lin device driver. 167b131ad59SJing Lin 16877522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/mode 169b131ad59SJing LinDate: Oct 25, 2019 170b131ad59SJing LinKernelVersion: 5.6.0 171b131ad59SJing LinContact: dmaengine@vger.kernel.org 172b131ad59SJing LinDescription: The work queue mode type for this work queue. 173b131ad59SJing Lin 17477522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/priority 175b131ad59SJing LinDate: Oct 25, 2019 176b131ad59SJing LinKernelVersion: 5.6.0 177b131ad59SJing LinContact: dmaengine@vger.kernel.org 1783e42d1deSCarlos BilbaoDescription: The priority value of this work queue, it is a value relative to 179b131ad59SJing Lin other work queue in the same group to control quality of service 180b131ad59SJing Lin for dispatching work from multiple workqueues in the same group. 181b131ad59SJing Lin 18277522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/state 183b131ad59SJing LinDate: Oct 25, 2019 184b131ad59SJing LinKernelVersion: 5.6.0 185b131ad59SJing LinContact: dmaengine@vger.kernel.org 186b131ad59SJing LinDescription: The current state of the work queue. 187b131ad59SJing Lin 18877522b21SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/threshold 189b131ad59SJing LinDate: Oct 25, 2019 190b131ad59SJing LinKernelVersion: 5.6.0 191b131ad59SJing LinContact: dmaengine@vger.kernel.org 192b131ad59SJing LinDescription: The number of entries in this work queue that may be filled 193b131ad59SJing Lin via a limited portal. 194b131ad59SJing Lin 195d7aad555SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size 196d7aad555SDave JiangDate: Aug 28, 2020 197d7aad555SDave JiangKernelVersion: 5.10.0 198d7aad555SDave JiangContact: dmaengine@vger.kernel.org 199d7aad555SDave JiangDescription: The max transfer sized for this workqueue. Cannot exceed device 200d7aad555SDave Jiang max transfer size. Configurable parameter. 201d7aad555SDave Jiang 202e7184b15SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size 203e7184b15SDave JiangDate: Aug 28, 2020 204e7184b15SDave JiangKernelVersion: 5.10.0 205e7184b15SDave JiangContact: dmaengine@vger.kernel.org 206e7184b15SDave JiangDescription: The max batch size for this workqueue. Cannot exceed device 207e7184b15SDave Jiang max batch size. Configurable parameter. 208e7184b15SDave Jiang 20992de5fa2SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/ats_disable 21092de5fa2SDave JiangDate: Nov 13, 2020 21192de5fa2SDave JiangKernelVersion: 5.11.0 21292de5fa2SDave JiangContact: dmaengine@vger.kernel.org 21392de5fa2SDave JiangDescription: Indicate whether ATS disable is turned on for the workqueue. 21492de5fa2SDave Jiang 0 indicates ATS is on, and 1 indicates ATS is off for the workqueue. 21592de5fa2SDave Jiang 216e753a64bSDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/occupancy 217e753a64bSDave JiangDate May 25, 2021 218e753a64bSDave JiangKernelVersion: 5.14.0 219e753a64bSDave JiangContact: dmaengine@vger.kernel.org 220e753a64bSDave JiangDescription: Show the current number of entries in this WQ if WQ Occupancy 221e753a64bSDave Jiang Support bit WQ capabilities is 1. 222e753a64bSDave Jiang 2237930d855SDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/enqcmds_retries 2247930d855SDave JiangDate Oct 29, 2021 2257930d855SDave JiangKernelVersion: 5.17.0 2267930d855SDave JiangContact: dmaengine@vger.kernel.org 2277930d855SDave JiangDescription: Indicate the number of retires for an enqcmds submission on a sharedwq. 2287930d855SDave Jiang A max value to set attribute is capped at 64. 2297930d855SDave Jiang 230b0325aefSDave JiangWhat: /sys/bus/dsa/devices/wq<m>.<n>/op_config 231b0325aefSDave JiangDate: Sept 14, 2022 232b0325aefSDave JiangKernelVersion: 6.0.0 233b0325aefSDave JiangContact: dmaengine@vger.kernel.org 234b0325aefSDave JiangDescription: Shows the operation capability bits displayed in bitmap format 235b0325aefSDave Jiang presented by %*pb printk() output format specifier. 236b0325aefSDave Jiang The attribute can be configured when the WQ is disabled in 237b0325aefSDave Jiang order to configure the WQ to accept specific bits that 238b0325aefSDave Jiang correlates to the operations allowed. It's visible only 239b0325aefSDave Jiang on platforms that support the capability. 240b0325aefSDave Jiang 24177522b21SDave JiangWhat: /sys/bus/dsa/devices/engine<m>.<n>/group_id 242b131ad59SJing LinDate: Oct 25, 2019 243b131ad59SJing LinKernelVersion: 5.6.0 244b131ad59SJing LinContact: dmaengine@vger.kernel.org 245b131ad59SJing LinDescription: The group that this engine belongs to. 246fde212e4SDave Jiang 247fde212e4SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/use_read_buffer_limit 248fde212e4SDave JiangDate: Dec 10, 2021 249fde212e4SDave JiangKernelVersion: 5.17.0 250fde212e4SDave JiangContact: dmaengine@vger.kernel.org 251fde212e4SDave JiangDescription: Enable the use of global read buffer limit for the group. See DSA 252fde212e4SDave Jiang spec v1.2 9.2.18 GRPCFG Use Global Read Buffer Limit. 253fde212e4SDave Jiang 254fde212e4SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_allowed 255fde212e4SDave JiangDate: Dec 10, 2021 256fde212e4SDave JiangKernelVersion: 5.17.0 257fde212e4SDave JiangContact: dmaengine@vger.kernel.org 258fde212e4SDave JiangDescription: Indicates max number of read buffers that may be in use at one time 259fde212e4SDave Jiang by all engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read 260fde212e4SDave Jiang Buffers Allowed. 261fde212e4SDave Jiang 262fde212e4SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/read_buffers_reserved 263fde212e4SDave JiangDate: Dec 10, 2021 264fde212e4SDave JiangKernelVersion: 5.17.0 265fde212e4SDave JiangContact: dmaengine@vger.kernel.org 266fde212e4SDave JiangDescription: Indicates the number of Read Buffers reserved for the use of 267fde212e4SDave Jiang engines in the group. See DSA spec v1.2 9.2.18 GRPCFG Read Buffers 268fde212e4SDave Jiang Reserved. 269*1f273752SDave Jiang 270*1f273752SDave JiangWhat: /sys/bus/dsa/devices/group<m>.<n>/desc_progress_limit 271*1f273752SDave JiangDate: Sept 14, 2022 272*1f273752SDave JiangKernelVersion: 6.0.0 273*1f273752SDave JiangContact: dmaengine@vger.kernel.org 274*1f273752SDave JiangDescription: Allows control of the number of work descriptors that can be 275*1f273752SDave Jiang concurrently processed by an engine in the group as a fraction 276*1f273752SDave Jiang of the Maximum Work Descriptors in Progress value specified in 277*1f273752SDave Jiang the ENGCAP register. The acceptable values are 0 (default), 278*1f273752SDave Jiang 1 (1/2 of max value), 2 (1/4 of the max value), and 3 (1/8 of 279*1f273752SDave Jiang the max value). It's visible only on platforms that support 280*1f273752SDave Jiang the capability. 281