Documentation/ABI/stable/sysfs-class-infiniband

   1 sysfs interface common for all infiniband devices
   2 -------------------------------------------------
   3
   4 What:           /sys/class/infiniband/<device>/node_type
   5 What:           /sys/class/infiniband/<device>/node_guid
   6 What:           /sys/class/infiniband/<device>/sys_image_guid
   7 Date:           Apr, 2005
   8 KernelVersion:  v2.6.12
   9 Contact:        linux-rdma@vger.kernel.org
  10 Description:
  11                 node_type:      (RO) Node type (CA, RNIC, usNIC, usNIC UDP,
  12                                 switch or router)
  13
  14                 node_guid:      (RO) Node GUID
  15
  16                 sys_image_guid: (RO) System image GUID
  17
  18
  19 What:           /sys/class/infiniband/<device>/node_desc
  20 Date:           Feb, 2006
  21 KernelVersion:  v2.6.17
  22 Contact:        linux-rdma@vger.kernel.org
  23 Description:
  24                 (RW) Update the node description with information such as the
  25                 node's hostname, so that IB network management software can tie
  26                 its view to the real world.
  27
  28
  29 What:           /sys/class/infiniband/<device>/fw_ver
  30 Date:           Jun, 2016
  31 KernelVersion:  v4.10
  32 Contact:        linux-rdma@vger.kernel.org
  33 Description:
  34                 (RO) Display firmware version
  35
  36
  37 What:           /sys/class/infiniband/<device>/ports/<port-num>/lid
  38 What:           /sys/class/infiniband/<device>/ports/<port-num>/rate
  39 What:           /sys/class/infiniband/<device>/ports/<port-num>/lid_mask_count
  40 What:           /sys/class/infiniband/<device>/ports/<port-num>/sm_sl
  41 What:           /sys/class/infiniband/<device>/ports/<port-num>/sm_lid
  42 What:           /sys/class/infiniband/<device>/ports/<port-num>/state
  43 What:           /sys/class/infiniband/<device>/ports/<port-num>/phys_state
  44 What:           /sys/class/infiniband/<device>/ports/<port-num>/cap_mask
  45 Date:           Apr, 2005
  46 KernelVersion:  v2.6.12
  47 Contact:        linux-rdma@vger.kernel.org
  48 Description:
  49
  50                 lid:            (RO) Port LID
  51
  52                 rate:           (RO) Port data rate (active width * active
  53                                 speed)
  54
  55                 lid_mask_count: (RO) Port LID mask count
  56
  57                 sm_sl:          (RO) Subnet manager SL for port's subnet
  58
  59                 sm_lid:         (RO) Subnet manager LID for port's subnet
  60
  61                 state:          (RO) Port state (DOWN, INIT, ARMED, ACTIVE or
  62                                 ACTIVE_DEFER)
  63
  64                 phys_state:     (RO) Port physical state (Sleep, Polling,
  65                                 LinkUp, etc)
  66
  67                 cap_mask:       (RO) Port capability mask. 2 bits here are
  68                                 settable- IsCommunicationManagementSupported
  69                                 (set when CM module is loaded) and IsSM (set via
  70                                 open of issmN file).
  71
  72
  73 What:           /sys/class/infiniband/<device>/ports/<port-num>/link_layer
  74 Date:           Oct, 2010
  75 KernelVersion:  v2.6.37
  76 Contact:        linux-rdma@vger.kernel.org
  77 Description:
  78                 (RO) Link layer type information (Infiniband or Ethernet type)
  79
  80
  81 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/symbol_error
  82 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_errors
  83 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_remote_physical_errors
  84 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_switch_relay_errors
  85 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/link_error_recovery
  86 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_constraint_errors
  87 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_contraint_errors
  88 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/local_link_integrity_errors
  89 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/excessive_buffer_overrun_errors
  90 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_data
  91 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_data
  92 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_packets
  93 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_packets
  94 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/unicast_rcv_packets
  95 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/unicast_xmit_packets
  96 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/multicast_rcv_packets
  97 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/multicast_xmit_packets
  98 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/link_downed
  99 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_discards
 100 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/VL15_dropped
 101 What:           /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_wait
 102 Date:           Apr, 2005
 103 KernelVersion:  v2.6.12
 104 Contact:        linux-rdma@vger.kernel.org
 105 Description:
 106                 Errors info:
 107                 -----------
 108
 109                 symbol_error: (RO) Total number of minor link errors detected on
 110                 one or more physical lanes.
 111
 112                 port_rcv_errors : (RO) Total number of packets containing an
 113                 error that were received on the port.
 114
 115                 port_rcv_remote_physical_errors : (RO) Total number of packets
 116                 marked with the EBP delimiter received on the port.
 117
 118                 port_rcv_switch_relay_errors : (RO) Total number of packets
 119                 received on the port that were discarded because they could not
 120                 be forwarded by the switch relay.
 121
 122                 link_error_recovery: (RO) Total number of times the Port
 123                 Training state machine has successfully completed the link error
 124                 recovery process.
 125
 126                 port_xmit_constraint_errors: (RO) Total number of packets not
 127                 transmitted from the switch physical port due to outbound raw
 128                 filtering or failing outbound partition or IP version check.
 129
 130                 port_rcv_constraint_errors: (RO) Total number of packets
 131                 received on the switch physical port that are discarded due to
 132                 inbound raw filtering or failing inbound partition or IP version
 133                 check.
 134
 135                 local_link_integrity_errors: (RO) The number of times that the
 136                 count of local physical errors exceeded the threshold specified
 137                 by LocalPhyErrors
 138
 139                 excessive_buffer_overrun_errors: (RO) This counter, indicates an
 140                 input buffer overrun. It indicates possible misconfiguration of
 141                 a port, either by the Subnet Manager (SM) or by user
 142                 intervention. It can also indicate hardware issues or extremely
 143                 poor link signal integrity
 144
 145                 Data info:
 146                 ---------
 147
 148                 port_xmit_data: (RO) Total number of data octets, divided by 4
 149                 (lanes), transmitted on all VLs. This is 64 bit counter
 150
 151                 port_rcv_data: (RO) Total number of data octets, divided by 4
 152                 (lanes), received on all VLs. This is 64 bit counter.
 153
 154                 port_xmit_packets: (RO) Total number of packets transmitted on
 155                 all VLs from this port. This may include packets with errors.
 156                 This is 64 bit counter.
 157
 158                 port_rcv_packets: (RO) Total number of packets (this may include
 159                 packets containing Errors. This is 64 bit counter.
 160
 161                 link_downed: (RO) Total number of times the Port Training state
 162                 machine has failed the link error recovery process and downed
 163                 the link.
 164
 165                 unicast_rcv_packets: (RO) Total number of unicast packets,
 166                 including unicast packets containing errors.
 167
 168                 unicast_xmit_packets: (RO) Total number of unicast packets
 169                 transmitted on all VLs from the port. This may include unicast
 170                 packets with errors.
 171
 172                 multicast_rcv_packets: (RO) Total number of multicast packets,
 173                 including multicast packets containing errors.
 174
 175                 multicast_xmit_packets: (RO) Total number of multicast packets
 176                 transmitted on all VLs from the port. This may include multicast
 177                 packets with errors.
 178
 179                 Misc info:
 180                 ---------
 181
 182                 port_xmit_discards: (RO) Total number of outbound packets
 183                 discarded by the port because the port is down or congested.
 184
 185                 VL15_dropped: (RO) Number of incoming VL15 packets dropped due
 186                 to resource limitations (e.g., lack of buffers) of the port.
 187
 188                 port_xmit_wait: (RO) The number of ticks during which the port
 189                 had data to transmit but no data was sent during the entire tick
 190                 (either because of insufficient credits or because of lack of
 191                 arbitration).
 192
 193                 Each of these files contains the corresponding value from the
 194                 port's Performance Management PortCounters attribute, as
 195                 described in the InfiniBand Architecture Specification.
 196
 197
 198 What:           /sys/class/infiniband/<device-name>/hw_counters/lifespan
 199 What:           /sys/class/infiniband/<device-name>/ports/<port-num>/hw_counters/lifespan
 200 Date:           May, 2016
 201 KernelVersion:  4.6
 202 Contact:        linux-rdma@vger.kernel.org
 203 Description:
 204                 The optional "hw_counters" subdirectory can be under either the
 205                 parent device or the port subdirectories or both. If present,
 206                 there are a list of counters provided by the hardware. They may
 207                 match some of the counters in the counters directory, but they
 208                 often include many other counters. In addition to the various
 209                 counters, there will be a file named "lifespan" that configures
 210                 how frequently the core should update the counters when they are
 211                 being accessed (counters are not updated if they are not being
 212                 accessed). The lifespan is in milliseconds and defaults to 10
 213                 unless set to something else by the driver. Users may echo a
 214                 value between 0-10000 to the lifespan file to set the length
 215                 of time between updates in milliseconds.
 216
 217
 218 What:           /sys/class/infiniband/<hca>/ports/<port-number>/gid_attrs/ndevs/<gid-index>
 219 Date:           November 29, 2015
 220 KernelVersion:  4.4.0
 221 Contact:        linux-rdma@vger.kernel.org
 222 Description:    The net-device's name associated with the GID resides
 223                 at index <gid-index>.
 224
 225 What:           /sys/class/infiniband/<hca>/ports/<port-number>/gid_attrs/types/<gid-index>
 226 Date:           November 29, 2015
 227 KernelVersion:  4.4.0
 228 Contact:        linux-rdma@vger.kernel.org
 229 Description:    The RoCE type of the associated GID resides at index <gid-index>.
 230                 This could either be "IB/RoCE v1" for IB and RoCE v1 based GIDs
 231                 or "RoCE v2" for RoCE v2 based GIDs.
 232
 233
 234 What:           /sys/class/infiniband_mad/umadN/ibdev
 235 What:           /sys/class/infiniband_mad/umadN/port
 236 What:           /sys/class/infiniband_mad/issmN/ibdev
 237 What:           /sys/class/infiniband_mad/issmN/port
 238 Date:           Apr, 2005
 239 KernelVersion:  v2.6.12
 240 Contact:        linux-rdma@vger.kernel.org
 241 Description:
 242                 Each port of each InfiniBand device has a "umad" device and an
 243                 "issm" device attached. For example, a two-port HCA will have
 244                 two umad devices and two issm devices, while a switch will have
 245                 one device of each type (for switch port 0).
 246
 247                 ibdev:  (RO) Show Infiniband (IB) device name
 248
 249                 port:   (RO) Display port number
 250
 251
 252 What:           /sys/class/infiniband_mad/abi_version
 253 Date:           Apr, 2005
 254 KernelVersion:  v2.6.12
 255 Contact:        linux-rdma@vger.kernel.org
 256 Description:
 257                 (RO) Value is incremented if any changes are made that break
 258                 userspace ABI compatibility of umad & issm devices.
 259
 260
 261 What:           /sys/class/infiniband_cm/ucmN/ibdev
 262 Date:           Oct, 2005
 263 KernelVersion:  v2.6.14
 264 Contact:        linux-rdma@vger.kernel.org
 265 Description:
 266                 (RO) Display Infiniband (IB) device name
 267
 268
 269 What:           /sys/class/infiniband_cm/abi_version
 270 Date:           Oct, 2005
 271 KernelVersion:  v2.6.14
 272 Contact:        linux-rdma@vger.kernel.org
 273 Description:
 274                 (RO) Value is incremented if any changes are made that break
 275                 userspace ABI compatibility of ucm devices.
 276
 277
 278 What:           /sys/class/infiniband_verbs/uverbsN/ibdev
 279 What:           /sys/class/infiniband_verbs/uverbsN/abi_version
 280 Date:           Sept, 2005
 281 KernelVersion:  v2.6.14
 282 Contact:        linux-rdma@vger.kernel.org
 283 Description:
 284                 ibdev:          (RO) Display Infiniband (IB) device name
 285
 286                 abi_version:    (RO) Show ABI version of IB device specific
 287                                 interfaces.
 288
 289
 290 What:           /sys/class/infiniband_verbs/abi_version
 291 Date:           Sep, 2005
 292 KernelVersion:  v2.6.14
 293 Contact:        linux-rdma@vger.kernel.org
 294 Description:
 295                 (RO) Value is incremented if any changes are made that break
 296                 userspace ABI compatibility of uverbs devices.
 297
 298
 299 sysfs interface for Mellanox IB HCA low-level driver (mthca)
 300 ------------------------------------------------------------
 301
 302 What:           /sys/class/infiniband/mthcaX/hw_rev
 303 What:           /sys/class/infiniband/mthcaX/hca_type
 304 What:           /sys/class/infiniband/mthcaX/board_id
 305 Date:           Apr, 2005
 306 KernelVersion:  v2.6.12
 307 Contact:        linux-rdma@vger.kernel.org
 308 Description:
 309                 hw_rev:         (RO) Hardware revision number
 310
 311                 hca_type:       (RO) Host Channel Adapter type: MT23108, MT25208
 312                                 (MT23108 compat mode), MT25208 or MT25204
 313
 314                 board_id:       (RO) Manufacturing board ID
 315
 316
 317 sysfs interface for Mellanox ConnectX HCA IB driver (mlx4)
 318 ----------------------------------------------------------
 319
 320 What:           /sys/class/infiniband/mlx4_X/hw_rev
 321 What:           /sys/class/infiniband/mlx4_X/hca_type
 322 What:           /sys/class/infiniband/mlx4_X/board_id
 323 Date:           Sep, 2007
 324 KernelVersion:  v2.6.24
 325 Contact:        linux-rdma@vger.kernel.org
 326 Description:
 327                 hw_rev:         (RO) Hardware revision number
 328
 329                 hca_type:       (RO) Host channel adapter type
 330
 331                 board_id:       (RO) Manufacturing board ID
 332
 333
 334 What:           /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/gids/<n>
 335 What:           /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/admin_guids/<n>
 336 What:           /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/pkeys/<n>
 337 What:           /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/mcgs/
 338 What:           /sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/gid_idx/0
 339 What:           /sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/pkey_idx/<n>
 340 Date:           Aug, 2012
 341 KernelVersion:  v3.6.15
 342 Contact:        linux-rdma@vger.kernel.org
 343 Description:
 344                 The sysfs iov directory is used to manage and examine the port
 345                 P_Key and guid paravirtualization. This directory is added only
 346                 for the master -- slaves do not have it.
 347
 348                 Under iov/ports, the administrator may examine the gid and P_Key
 349                 tables as they are present in the device (and as are seen in the
 350                 "network view" presented to the SM).
 351
 352                 The "pkeys" and "gids" subdirectories contain one file for each
 353                 entry in the port's P_Key or GID table respectively. For
 354                 example, ports/1/pkeys/10 contains the value at index 10 in port
 355                 1's P_Key table.
 356
 357                 gids/<n>:               (RO) The physical port gids n = 0..127
 358
 359                 admin_guids/<n>:        (RW) Allows examining or changing the
 360                                         administrative state of a given GUID
 361                                         n = 0..127
 362
 363                 pkeys/<n>:              (RO) Displays the contents of the physical
 364                                         key table n = 0..126
 365
 366                 mcgs/:                  (RO) Muticast group table
 367
 368                 <m>/gid_idx/0:          (RO) Display the GID mapping m = 1..2
 369
 370                 <m>/pkey_idx/<n>:       (RW) Writable except for RoCE pkeys.
 371                                         m = 1..2, n = 0..126
 372
 373                                         Under the iov/<pci slot number>
 374                                         directories, the admin may map the index
 375                                         numbers in the physical tables (as under
 376                                         iov/ports) to the paravirtualized index
 377                                         numbers that guests see.
 378
 379                                         For example, if the administrator, for
 380                                         port 1 on guest 2 maps physical pkey
 381                                         index 10 to virtual index 1, then that
 382                                         guest, whenever it uses its pkey index
 383                                         1, will actually be using the real pkey
 384                                         index 10.
 385
 386
 387 What:           /sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/smi_enabled
 388 What:           /sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/enable_smi_admin
 389 Date:           May, 2014
 390 KernelVersion:  v3.15.7
 391 Contact:        linux-rdma@vger.kernel.org
 392 Description:
 393                 Enabling QP0 on VFs for selected VF/port. By default, no VFs are
 394                 enabled for QP0 operation.
 395
 396                 smi_enabled:    (RO) Indicates whether smi is currently enabled
 397                                 for the indicated VF/port
 398
 399                 enable_smi_admin:(RW) Used by the admin to request that smi
 400                                 capability be enabled or disabled for the
 401                                 indicated VF/port. 0 = disable, 1 = enable.
 402
 403                 The requested enablement will occur at the next reset of the VF
 404                 (e.g. driver restart on the VM which owns the VF).
 405
 406
 407 sysfs interface for Chelsio T4/T5 RDMA driver (cxgb4)
 408 -----------------------------------------------------
 409
 410 What:           /sys/class/infiniband/cxgb4_X/hw_rev
 411 What:           /sys/class/infiniband/cxgb4_X/hca_type
 412 What:           /sys/class/infiniband/cxgb4_X/board_id
 413 Date:           Apr, 2010
 414 KernelVersion:  v2.6.35
 415 Contact:        linux-rdma@vger.kernel.org
 416 Description:
 417
 418                 hw_rev:         (RO) Hardware revision number
 419
 420                 hca_type:       (RO) Driver short name. Should normally match
 421                                 the name in its bus driver structure (e.g.
 422                                 pci_driver::name)
 423
 424                 board_id:       (RO) Manufacturing board id. (Vendor + device
 425                                 information)
 426
 427
 428 sysfs interface for Intel IB driver qib
 429 ---------------------------------------
 430
 431 What:           /sys/class/infiniband/qibX/version
 432 What:           /sys/class/infiniband/qibX/hw_rev
 433 What:           /sys/class/infiniband/qibX/hca_type
 434 What:           /sys/class/infiniband/qibX/board_id
 435 What:           /sys/class/infiniband/qibX/boardversion
 436 What:           /sys/class/infiniband/qibX/nctxts
 437 What:           /sys/class/infiniband/qibX/localbus_info
 438 What:           /sys/class/infiniband/qibX/tempsense
 439 What:           /sys/class/infiniband/qibX/serial
 440 What:           /sys/class/infiniband/qibX/nfreectxts
 441 What:           /sys/class/infiniband/qibX/chip_reset
 442 Date:           May, 2010
 443 KernelVersion:  v2.6.35
 444 Contact:        linux-rdma@vger.kernel.org
 445 Description:
 446                 version:        (RO) Display version information of installed software
 447                                 and drivers.
 448
 449                 hw_rev:         (RO) Hardware revision number
 450
 451                 hca_type:       (RO) Host channel adapter type
 452
 453                 board_id:       (RO) Manufacturing board id
 454
 455                 boardversion:   (RO) Current version of the chip architecture
 456
 457                 nctxts:         (RO) Return the number of user ports (contexts)
 458                                 available
 459
 460                 localbus_info:  (RO) Human readable localbus info
 461
 462                 tempsense:      (RO) Display temp sense registers in decimal
 463
 464                 serial:         (RO) Serial number of the HCA
 465
 466                 nfreectxts:     (RO) The number of free user ports (contexts)
 467                                 available.
 468
 469                 chip_reset:     (WO) Reset the chip if possible by writing
 470                                 "reset" to this file. Only allowed if no user
 471                                 contexts are open that use chip resources.
 472
 473
 474 What:           /sys/class/infiniband/qibX/ports/N/sl2vl/[0-15]
 475 Date:           May, 2010
 476 KernelVersion:  v2.6.35
 477 Contact:        linux-rdma@vger.kernel.org
 478 Description:
 479                 (RO) The directory contains 16 files numbered 0-15 that specify
 480                 the Service Level (SL). Listing the SL files returns the Virtual
 481                 Lane (VL) as programmed by the SL.
 482
 483 What:           /sys/class/infiniband/qibX/ports/N/CCMgtA/cc_settings_bin
 484 What:           /sys/class/infiniband/qibX/ports/N/CCMgtA/cc_table_bin
 485 Date:           May, 2010
 486 KernelVersion:  v2.6.35
 487 Contact:        linux-rdma@vger.kernel.org
 488 Description:
 489                 Per-port congestion control. Both are binary attributes.
 490
 491                 cc_table_bin:   (RO) Congestion control table size followed by
 492                                 table entries.
 493
 494                 cc_settings_bin:(RO) Congestion settings: port control, control
 495                                 map and an array of 16 entries for the
 496                                 congestion entries - increase, timer, event log
 497                                 trigger threshold and the minimum injection rate
 498                                 delay.
 499
 500 What:           /sys/class/infiniband/qibX/ports/N/linkstate/loopback
 501 What:           /sys/class/infiniband/qibX/ports/N/linkstate/led_override
 502 What:           /sys/class/infiniband/qibX/ports/N/linkstate/hrtbt_enable
 503 What:           /sys/class/infiniband/qibX/ports/N/linkstate/status
 504 What:           /sys/class/infiniband/qibX/ports/N/linkstate/status_str
 505 Date:           May, 2010
 506 KernelVersion:  v2.6.35
 507 Contact:        linux-rdma@vger.kernel.org
 508 Description:
 509                 [to be documented]
 510
 511                 loopback:       (WO)
 512                 led_override:   (WO)
 513                 hrtbt_enable:   (RW)
 514                 status:         (RO)
 515
 516                 status_str:     (RO) Displays information about the link state,
 517                                 possible cable/switch problems, and hardware
 518                                 errors. Possible states are- "Initted",
 519                                 "Present", "IB_link_up", "IB_configured" or
 520                                 "Fatal_Hardware_Error".
 521
 522 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/rc_resends
 523 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/seq_naks
 524 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/rdma_seq
 525 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/rnr_naks
 526 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/other_naks
 527 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/rc_timeouts
 528 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/look_pkts
 529 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/pkt_drops
 530 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/dma_wait
 531 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/unaligned
 532 Date:           May, 2010
 533 KernelVersion:  v2.6.35
 534 Contact:        linux-rdma@vger.kernel.org
 535 Description:
 536                 [to be documented]
 537
 538
 539 sysfs interface for Mellanox Connect-IB HCA driver mlx5
 540 -------------------------------------------------------
 541
 542 What:           /sys/class/infiniband/mlx5_X/hw_rev
 543 What:           /sys/class/infiniband/mlx5_X/hca_type
 544 What:           /sys/class/infiniband/mlx5_X/reg_pages
 545 What:           /sys/class/infiniband/mlx5_X/fw_pages
 546 Date:           Jul, 2013
 547 KernelVersion:  v3.11
 548 Contact:        linux-rdma@vger.kernel.org
 549 Description:
 550                 [to be documented]
 551
 552
 553 sysfs interface for Cisco VIC (usNIC) Verbs Driver
 554 --------------------------------------------------
 555
 556 What:           /sys/class/infiniband/usnic_X/board_id
 557 What:           /sys/class/infiniband/usnic_X/config
 558 What:           /sys/class/infiniband/usnic_X/qp_per_vf
 559 What:           /sys/class/infiniband/usnic_X/max_vf
 560 What:           /sys/class/infiniband/usnic_X/cq_per_vf
 561 What:           /sys/class/infiniband/usnic_X/iface
 562 Date:           Sep, 2013
 563 KernelVersion:  v3.14
 564 Contact:        Christian Benvenuti <benve@cisco.com>,
 565                 Dave Goodell <dgoodell@cisco.com>,
 566                 linux-rdma@vger.kernel.org
 567 Description:
 568
 569                 board_id:       (RO) Manufacturing board id
 570
 571                 config:         (RO) Report the configuration for this PF
 572
 573                 qp_per_vf:      (RO) Queue pairs per virtual function.
 574
 575                 max_vf:         (RO) Max virtual functions
 576
 577                 cq_per_vf:      (RO) Completion queue per virtual function
 578
 579                 iface:          (RO) Shows which network interface this usNIC
 580                                 entry is associated to (visible with ifconfig).
 581
 582 What:           /sys/class/infiniband/usnic_X/qpn/summary
 583 What:           /sys/class/infiniband/usnic_X/qpn/context
 584 Date:           Sep, 2013
 585 KernelVersion:  v3.14
 586 Contact:        Christian Benvenuti <benve@cisco.com>,
 587                 Dave Goodell <dgoodell@cisco.com>,
 588                 linux-rdma@vger.kernel.org
 589 Description:
 590                 [to be documented]
 591
 592
 593 sysfs interface for Emulex RoCE HCA Driver
 594 ------------------------------------------
 595
 596 What:           /sys/class/infiniband/ocrdmaX/hw_rev
 597 Date:           Feb, 2014
 598 KernelVersion:  v3.14
 599 Description:
 600                 hw_rev:         (RO) Hardware revision number
 601
 602 What:           /sys/class/infiniband/ocrdmaX/hca_type
 603 Date:           Jun, 2014
 604 KernelVersion:  v3.16
 605 Contact:        linux-rdma@vger.kernel.org
 606 Description:
 607                 hca_type:       (RO) Display FW version
 608
 609
 610 sysfs interface for Intel Omni-Path driver (HFI1)
 611 -------------------------------------------------
 612
 613 What:           /sys/class/infiniband/hfi1_X/hw_rev
 614 What:           /sys/class/infiniband/hfi1_X/board_id
 615 What:           /sys/class/infiniband/hfi1_X/nctxts
 616 What:           /sys/class/infiniband/hfi1_X/serial
 617 What:           /sys/class/infiniband/hfi1_X/chip_reset
 618 What:           /sys/class/infiniband/hfi1_X/boardversion
 619 What:           /sys/class/infiniband/hfi1_X/nfreectxts
 620 What:           /sys/class/infiniband/hfi1_X/tempsense
 621 Date:           May, 2016
 622 KernelVersion:  v4.6
 623 Contact:        linux-rdma@vger.kernel.org
 624 Description:
 625                 hw_rev:         (RO) Hardware revision number
 626
 627                 board_id:       (RO) Manufacturing board id
 628
 629                 nctxts:         (RO) Total contexts available.
 630
 631                 serial:         (RO) Board serial number
 632
 633                 chip_reset:     (WO) Write "reset" to this file to reset the
 634                                 chip if possible. Only allowed if no user
 635                                 contexts are open that use chip resources.
 636
 637                 boardversion:   (RO) Human readable board info
 638
 639                 nfreectxts:     (RO) The number of free user ports (contexts)
 640                                 available.
 641
 642                 tempsense:      (RO) Thermal sense information
 643
 644
 645 What:           /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_settings_bin
 646 What:           /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_table_bin
 647 What:           /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_prescan
 648 Date:           May, 2016
 649 KernelVersion:  v4.6
 650 Contact:        linux-rdma@vger.kernel.org
 651 Description:
 652                 Per-port congestion control.
 653
 654                 cc_table_bin:   (RO) CCA tables used by PSM2 Congestion control
 655                                 table size followed by table entries. Binary
 656                                 attribute.
 657
 658                 cc_settings_bin:(RO) Congestion settings: port control, control
 659                                 map and an array of 16 entries for the
 660                                 congestion entries - increase, timer, event log
 661                                 trigger threshold and the minimum injection rate
 662                                 delay. Binary attribute.
 663
 664                 cc_prescan:     (RW) enable prescanning for faster BECN
 665                                 response. Write "on" to enable and "off" to
 666                                 disable.
 667
 668 What:           /sys/class/infiniband/hfi1_X/ports/N/sc2vl/[0-31]
 669 What:           /sys/class/infiniband/hfi1_X/ports/N/sl2sc/[0-31]
 670 What:           /sys/class/infiniband/hfi1_X/ports/N/vl2mtu/[0-15]
 671 Date:           May, 2016
 672 KernelVersion:  v4.6
 673 Contact:        linux-rdma@vger.kernel.org
 674 Description:
 675                 sc2vl/:         (RO) 32 files (0 - 31) used to translate sl->vl
 676
 677                 sl2sc/:         (RO) 32 files (0 - 31) used to translate sl->sc
 678
 679                 vl2mtu/:        (RO) 16 files (0 - 15) used to determine MTU for vl
 680
 681
 682 What:           /sys/class/infiniband/hfi1_X/sdma_N/cpu_list
 683 What:           /sys/class/infiniband/hfi1_X/sdma_N/vl
 684 Date:           Sept, 2016
 685 KernelVersion:  v4.8
 686 Contact:        linux-rdma@vger.kernel.org
 687 Description:
 688                 sdma<N>/ contains one directory per sdma engine (0 - 15)
 689
 690                 cpu_list:       (RW) List of cpus for user-process to sdma
 691                                 engine assignment.
 692
 693                 vl:             (RO) Displays the virtual lane (vl) the sdma
 694                                 engine maps to.
 695
 696                 This interface gives the user control on the affinity settings
 697                 for the device. As an example, to set an sdma engine irq
 698                 affinity and thread affinity of a user processes to use the
 699                 sdma engine, which is "near" in terms of NUMA configuration, or
 700                 physical cpu location, the user will do:
 701
 702                 echo "3" > /proc/irq/<N>/smp_affinity_list
 703                 echo "4-7" > /sys/devices/.../sdma3/cpu_list
 704                 cat /sys/devices/.../sdma3/vl
 705                 0
 706                 echo "8" > /proc/irq/<M>/smp_affinity_list
 707                 echo "9-12" > /sys/devices/.../sdma4/cpu_list
 708                 cat /sys/devices/.../sdma4/vl
 709                 1
 710
 711                 to make sure that when a process runs on cpus 4,5,6, or 7, and
 712                 uses vl=0, then sdma engine 3 is selected by the driver, and
 713                 also the interrupt of the sdma engine 3 is steered to cpu 3.
 714                 Similarly, when a process runs on cpus 9,10,11, or 12 and sets
 715                 vl=1, then engine 4 will be selected and the irq of the sdma
 716                 engine 4 is steered to cpu 8.  This assumes that in the above N
 717                 is the irq number of "sdma3", and M is irq number of "sdma4" in
 718                 the /proc/interrupts file.
 719
 720
 721 sysfs interface for Intel(R) X722 iWARP i40iw driver
 722 ----------------------------------------------------
 723
 724 What:           /sys/class/infiniband/i40iwX/hw_rev
 725 What:           /sys/class/infiniband/i40iwX/hca_type
 726 What:           /sys/class/infiniband/i40iwX/board_id
 727 Date:           Jan, 2016
 728 KernelVersion:  v4.10
 729 Contact:        linux-rdma@vger.kernel.org
 730 Description:
 731                 hw_rev:         (RO) Hardware revision number
 732
 733                 hca_type:       (RO) Show HCA type (I40IW)
 734
 735                 board_id:       (RO) I40IW board ID
 736
 737
 738 sysfs interface for QLogic qedr NIC Driver
 739 ------------------------------------------
 740
 741 What:           /sys/class/infiniband/qedrX/hw_rev
 742 What:           /sys/class/infiniband/qedrX/hca_type
 743 Date:           Oct, 2016
 744 KernelVersion:  v4.10
 745 Contact:        linux-rdma@vger.kernel.org
 746 Description:
 747
 748                 hw_rev:         (RO) Hardware revision number
 749
 750                 hca_type:       (RO) Display HCA type
 751
 752
 753 sysfs interface for VMware Paravirtual RDMA driver
 754 --------------------------------------------------
 755
 756 What:           /sys/class/infiniband/vmw_pvrdmaX/hw_rev
 757 What:           /sys/class/infiniband/vmw_pvrdmaX/hca_type
 758 What:           /sys/class/infiniband/vmw_pvrdmaX/board_id
 759 Date:           Oct, 2016
 760 KernelVersion:  v4.10
 761 Contact:        linux-rdma@vger.kernel.org
 762 Description:
 763
 764                 hw_rev:         (RO) Hardware revision number
 765
 766                 hca_type:       (RO) Host channel adapter type
 767
 768                 board_id:       (RO) Display PVRDMA manufacturing board ID
 769
 770
 771 sysfs interface for Broadcom NetXtreme-E RoCE driver
 772 ----------------------------------------------------
 773
 774 What:           /sys/class/infiniband/bnxt_reX/hw_rev
 775 What:           /sys/class/infiniband/bnxt_reX/hca_type
 776 Date:           Feb, 2017
 777 KernelVersion:  v4.11
 778 Contact:        linux-rdma@vger.kernel.org
 779 Description:
 780                 hw_rev:         (RO) Hardware revision number
 781
 782                 hca_type:       (RO) Host channel adapter type