Documentation/ABI/stable/sysfs-driver-dma-idxd

   1 What:           /sys/bus/dsa/devices/dsa<m>/version
   2 Date:           Apr 15, 2020
   3 KernelVersion:  5.8.0
   4 Contact:        dmaengine@vger.kernel.org
   5 Description:    The hardware version number.
   6
   7 What:           /sys/bus/dsa/devices/dsa<m>/cdev_major
   8 Date:           Oct 25, 2019
   9 KernelVersion:  5.6.0
  10 Contact:        dmaengine@vger.kernel.org
  11 Description:    The major number that the character device driver assigned to
  12                 this device.
  13
  14 What:           /sys/bus/dsa/devices/dsa<m>/errors
  15 Date:           Oct 25, 2019
  16 KernelVersion:  5.6.0
  17 Contact:        dmaengine@vger.kernel.org
  18 Description:    The error information for this device.
  19
  20 What:           /sys/bus/dsa/devices/dsa<m>/max_batch_size
  21 Date:           Oct 25, 2019
  22 KernelVersion:  5.6.0
  23 Contact:        dmaengine@vger.kernel.org
  24 Description:    The largest number of work descriptors in a batch.
  25
  26 What:           /sys/bus/dsa/devices/dsa<m>/max_work_queues_size
  27 Date:           Oct 25, 2019
  28 KernelVersion:  5.6.0
  29 Contact:        dmaengine@vger.kernel.org
  30 Description:    The maximum work queue size supported by this device.
  31
  32 What:           /sys/bus/dsa/devices/dsa<m>/max_engines
  33 Date:           Oct 25, 2019
  34 KernelVersion:  5.6.0
  35 Contact:        dmaengine@vger.kernel.org
  36 Description:    The maximum number of engines supported by this device.
  37
  38 What:           /sys/bus/dsa/devices/dsa<m>/max_groups
  39 Date:           Oct 25, 2019
  40 KernelVersion:  5.6.0
  41 Contact:        dmaengine@vger.kernel.org
  42 Description:    The maximum number of groups can be created under this device.
  43
  44 What:           /sys/bus/dsa/devices/dsa<m>/max_tokens
  45 Date:           Oct 25, 2019
  46 KernelVersion:  5.6.0
  47 Contact:        dmaengine@vger.kernel.org
  48 Description:    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
  53 What:           /sys/bus/dsa/devices/dsa<m>/max_transfer_size
  54 Date:           Oct 25, 2019
  55 KernelVersion:  5.6.0
  56 Contact:        dmaengine@vger.kernel.org
  57 Description:    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
  61 What:           /sys/bus/dsa/devices/dsa<m>/max_work_queues
  62 Date:           Oct 25, 2019
  63 KernelVersion:  5.6.0
  64 Contact:        dmaengine@vger.kernel.org
  65 Description:    The maximum work queue number that this device supports.
  66
  67 What:           /sys/bus/dsa/devices/dsa<m>/numa_node
  68 Date:           Oct 25, 2019
  69 KernelVersion:  5.6.0
  70 Contact:        dmaengine@vger.kernel.org
  71 Description:    The numa node number for this device.
  72
  73 What:           /sys/bus/dsa/devices/dsa<m>/op_cap
  74 Date:           Oct 25, 2019
  75 KernelVersion:  5.6.0
  76 Contact:        dmaengine@vger.kernel.org
  77 Description:    The operation capability bit mask specify the operation types
  78                 supported by the this device.
  79
  80 What:           /sys/bus/dsa/devices/dsa<m>/pasid_enabled
  81 Date:           Oct 27, 2020
  82 KernelVersion:  5.11.0
  83 Contact:        dmaengine@vger.kernel.org
  84 Description:    To indicate if PASID (process address space identifier) is
  85                 enabled or not for this device.
  86
  87 What:           /sys/bus/dsa/devices/dsa<m>/state
  88 Date:           Oct 25, 2019
  89 KernelVersion:  5.6.0
  90 Contact:        dmaengine@vger.kernel.org
  91 Description:    The state information of this device. It can be either enabled
  92                 or disabled.
  93
  94 What:           /sys/bus/dsa/devices/dsa<m>/group<m>.<n>
  95 Date:           Oct 25, 2019
  96 KernelVersion:  5.6.0
  97 Contact:        dmaengine@vger.kernel.org
  98 Description:    The assigned group under this device.
  99
 100 What:           /sys/bus/dsa/devices/dsa<m>/engine<m>.<n>
 101 Date:           Oct 25, 2019
 102 KernelVersion:  5.6.0
 103 Contact:        dmaengine@vger.kernel.org
 104 Description:    The assigned engine under this device.
 105
 106 What:           /sys/bus/dsa/devices/dsa<m>/wq<m>.<n>
 107 Date:           Oct 25, 2019
 108 KernelVersion:  5.6.0
 109 Contact:        dmaengine@vger.kernel.org
 110 Description:    The assigned work queue under this device.
 111
 112 What:           /sys/bus/dsa/devices/dsa<m>/configurable
 113 Date:           Oct 25, 2019
 114 KernelVersion:  5.6.0
 115 Contact:        dmaengine@vger.kernel.org
 116 Description:    To indicate if this device is configurable or not.
 117
 118 What:           /sys/bus/dsa/devices/dsa<m>/token_limit
 119 Date:           Oct 25, 2019
 120 KernelVersion:  5.6.0
 121 Contact:        dmaengine@vger.kernel.org
 122 Description:    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
 126 What:           /sys/bus/dsa/devices/dsa<m>/cmd_status
 127 Date:           Aug 28, 2020
 128 KernelVersion:  5.10.0
 129 Contact:        dmaengine@vger.kernel.org
 130 Description:    The last executed device administrative command's status/error.
 131                 Also last configuration error overloaded.
 132                 Writing to it will clear the status.
 133
 134 What:           /sys/bus/dsa/devices/wq<m>.<n>/block_on_fault
 135 Date:           Oct 27, 2020
 136 KernelVersion:  5.11.0
 137 Contact:        dmaengine@vger.kernel.org
 138 Description:    To indicate block on fault is allowed or not for the work queue
 139                 to support on demand paging.
 140
 141 What:           /sys/bus/dsa/devices/wq<m>.<n>/group_id
 142 Date:           Oct 25, 2019
 143 KernelVersion:  5.6.0
 144 Contact:        dmaengine@vger.kernel.org
 145 Description:    The group id that this work queue belongs to.
 146
 147 What:           /sys/bus/dsa/devices/wq<m>.<n>/size
 148 Date:           Oct 25, 2019
 149 KernelVersion:  5.6.0
 150 Contact:        dmaengine@vger.kernel.org
 151 Description:    The work queue size for this work queue.
 152
 153 What:           /sys/bus/dsa/devices/wq<m>.<n>/type
 154 Date:           Oct 25, 2019
 155 KernelVersion:  5.6.0
 156 Contact:        dmaengine@vger.kernel.org
 157 Description:    The type of this work queue, it can be "kernel" type for work
 158                 queue usages in the kernel space or "user" type for work queue
 159                 usages by applications in user space.
 160
 161 What:           /sys/bus/dsa/devices/wq<m>.<n>/cdev_minor
 162 Date:           Oct 25, 2019
 163 KernelVersion:  5.6.0
 164 Contact:        dmaengine@vger.kernel.org
 165 Description:    The minor number assigned to this work queue by the character
 166                 device driver.
 167
 168 What:           /sys/bus/dsa/devices/wq<m>.<n>/mode
 169 Date:           Oct 25, 2019
 170 KernelVersion:  5.6.0
 171 Contact:        dmaengine@vger.kernel.org
 172 Description:    The work queue mode type for this work queue.
 173
 174 What:           /sys/bus/dsa/devices/wq<m>.<n>/priority
 175 Date:           Oct 25, 2019
 176 KernelVersion:  5.6.0
 177 Contact:        dmaengine@vger.kernel.org
 178 Description:    The priority value of this work queue, it is a value relative to
 179                 other work queue in the same group to control quality of service
 180                 for dispatching work from multiple workqueues in the same group.
 181
 182 What:           /sys/bus/dsa/devices/wq<m>.<n>/state
 183 Date:           Oct 25, 2019
 184 KernelVersion:  5.6.0
 185 Contact:        dmaengine@vger.kernel.org
 186 Description:    The current state of the work queue.
 187
 188 What:           /sys/bus/dsa/devices/wq<m>.<n>/threshold
 189 Date:           Oct 25, 2019
 190 KernelVersion:  5.6.0
 191 Contact:        dmaengine@vger.kernel.org
 192 Description:    The number of entries in this work queue that may be filled
 193                 via a limited portal.
 194
 195 What:           /sys/bus/dsa/devices/wq<m>.<n>/max_transfer_size
 196 Date:           Aug 28, 2020
 197 KernelVersion:  5.10.0
 198 Contact:        dmaengine@vger.kernel.org
 199 Description:    The max transfer sized for this workqueue. Cannot exceed device
 200                 max transfer size. Configurable parameter.
 201
 202 What:           /sys/bus/dsa/devices/wq<m>.<n>/max_batch_size
 203 Date:           Aug 28, 2020
 204 KernelVersion:  5.10.0
 205 Contact:        dmaengine@vger.kernel.org
 206 Description:    The max batch size for this workqueue. Cannot exceed device
 207                 max batch size. Configurable parameter.
 208
 209 What:           /sys/bus/dsa/devices/wq<m>.<n>/ats_disable
 210 Date:           Nov 13, 2020
 211 KernelVersion:  5.11.0
 212 Contact:        dmaengine@vger.kernel.org
 213 Description:    Indicate whether ATS disable is turned on for the workqueue.
 214                 0 indicates ATS is on, and 1 indicates ATS is off for the workqueue.
 215
 216 What:           /sys/bus/dsa/devices/wq<m>.<n>/occupancy
 217 Date            May 25, 2021
 218 KernelVersion:  5.14.0
 219 Contact:        dmaengine@vger.kernel.org
 220 Description:    Show the current number of entries in this WQ if WQ Occupancy
 221                 Support bit WQ capabilities is 1.
 222
 223 What:           /sys/bus/dsa/devices/engine<m>.<n>/group_id
 224 Date:           Oct 25, 2019
 225 KernelVersion:  5.6.0
 226 Contact:        dmaengine@vger.kernel.org
 227 Description:    The group that this engine belongs to.