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 Chelsio T3 RDMA Driver (cxgb3)
 318 --------------------------------------------------
 319
 320 What:           /sys/class/infiniband/cxgb3_X/hw_rev
 321 What:           /sys/class/infiniband/cxgb3_X/hca_type
 322 What:           /sys/class/infiniband/cxgb3_X/board_id
 323 Date:           Feb, 2007
 324 KernelVersion:  v2.6.21
 325 Contact:        linux-rdma@vger.kernel.org
 326 Description:
 327                 hw_rev:         (RO) Hardware revision number
 328
 329                 hca_type:       (RO) HCA type. Here it is a driver short name.
 330                                 It should normally match the name in its bus
 331                                 driver structure (e.g.  pci_driver::name).
 332
 333                 board_id:       (RO) Manufacturing board id
 334
 335
 336 sysfs interface for Mellanox ConnectX HCA IB driver (mlx4)
 337 ----------------------------------------------------------
 338
 339 What:           /sys/class/infiniband/mlx4_X/hw_rev
 340 What:           /sys/class/infiniband/mlx4_X/hca_type
 341 What:           /sys/class/infiniband/mlx4_X/board_id
 342 Date:           Sep, 2007
 343 KernelVersion:  v2.6.24
 344 Contact:        linux-rdma@vger.kernel.org
 345 Description:
 346                 hw_rev:         (RO) Hardware revision number
 347
 348                 hca_type:       (RO) Host channel adapter type
 349
 350                 board_id:       (RO) Manufacturing board ID
 351
 352
 353 What:           /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/gids/<n>
 354 What:           /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/admin_guids/<n>
 355 What:           /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/pkeys/<n>
 356 What:           /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/mcgs/
 357 What:           /sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/gid_idx/0
 358 What:           /sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/pkey_idx/<n>
 359 Date:           Aug, 2012
 360 KernelVersion:  v3.6.15
 361 Contact:        linux-rdma@vger.kernel.org
 362 Description:
 363                 The sysfs iov directory is used to manage and examine the port
 364                 P_Key and guid paravirtualization. This directory is added only
 365                 for the master -- slaves do not have it.
 366
 367                 Under iov/ports, the administrator may examine the gid and P_Key
 368                 tables as they are present in the device (and as are seen in the
 369                 "network view" presented to the SM).
 370
 371                 The "pkeys" and "gids" subdirectories contain one file for each
 372                 entry in the port's P_Key or GID table respectively. For
 373                 example, ports/1/pkeys/10 contains the value at index 10 in port
 374                 1's P_Key table.
 375
 376                 gids/<n>:               (RO) The physical port gids n = 0..127
 377
 378                 admin_guids/<n>:        (RW) Allows examining or changing the
 379                                         administrative state of a given GUID
 380                                         n = 0..127
 381
 382                 pkeys/<n>:              (RO) Displays the contents of the physical
 383                                         key table n = 0..126
 384
 385                 mcgs/:                  (RO) Muticast group table
 386
 387                 <m>/gid_idx/0:          (RO) Display the GID mapping m = 1..2
 388
 389                 <m>/pkey_idx/<n>:       (RW) Writable except for RoCE pkeys.
 390                                         m = 1..2, n = 0..126
 391
 392                                         Under the iov/<pci slot number>
 393                                         directories, the admin may map the index
 394                                         numbers in the physical tables (as under
 395                                         iov/ports) to the paravirtualized index
 396                                         numbers that guests see.
 397
 398                                         For example, if the administrator, for
 399                                         port 1 on guest 2 maps physical pkey
 400                                         index 10 to virtual index 1, then that
 401                                         guest, whenever it uses its pkey index
 402                                         1, will actually be using the real pkey
 403                                         index 10.
 404
 405
 406 What:           /sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/smi_enabled
 407 What:           /sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/enable_smi_admin
 408 Date:           May, 2014
 409 KernelVersion:  v3.15.7
 410 Contact:        linux-rdma@vger.kernel.org
 411 Description:
 412                 Enabling QP0 on VFs for selected VF/port. By default, no VFs are
 413                 enabled for QP0 operation.
 414
 415                 smi_enabled:    (RO) Indicates whether smi is currently enabled
 416                                 for the indicated VF/port
 417
 418                 enable_smi_admin:(RW) Used by the admin to request that smi
 419                                 capability be enabled or disabled for the
 420                                 indicated VF/port. 0 = disable, 1 = enable.
 421
 422                 The requested enablement will occur at the next reset of the VF
 423                 (e.g. driver restart on the VM which owns the VF).
 424
 425
 426 sysfs interface for Chelsio T4/T5 RDMA driver (cxgb4)
 427 -----------------------------------------------------
 428
 429 What:           /sys/class/infiniband/cxgb4_X/hw_rev
 430 What:           /sys/class/infiniband/cxgb4_X/hca_type
 431 What:           /sys/class/infiniband/cxgb4_X/board_id
 432 Date:           Apr, 2010
 433 KernelVersion:  v2.6.35
 434 Contact:        linux-rdma@vger.kernel.org
 435 Description:
 436
 437                 hw_rev:         (RO) Hardware revision number
 438
 439                 hca_type:       (RO) Driver short name. Should normally match
 440                                 the name in its bus driver structure (e.g.
 441                                 pci_driver::name)
 442
 443                 board_id:       (RO) Manufacturing board id. (Vendor + device
 444                                 information)
 445
 446
 447 sysfs interface for Intel IB driver qib
 448 ---------------------------------------
 449
 450 What:           /sys/class/infiniband/qibX/version
 451 What:           /sys/class/infiniband/qibX/hw_rev
 452 What:           /sys/class/infiniband/qibX/hca_type
 453 What:           /sys/class/infiniband/qibX/board_id
 454 What:           /sys/class/infiniband/qibX/boardversion
 455 What:           /sys/class/infiniband/qibX/nctxts
 456 What:           /sys/class/infiniband/qibX/localbus_info
 457 What:           /sys/class/infiniband/qibX/tempsense
 458 What:           /sys/class/infiniband/qibX/serial
 459 What:           /sys/class/infiniband/qibX/nfreectxts
 460 What:           /sys/class/infiniband/qibX/chip_reset
 461 Date:           May, 2010
 462 KernelVersion:  v2.6.35
 463 Contact:        linux-rdma@vger.kernel.org
 464 Description:
 465                 version:        (RO) Display version information of installed software
 466                                 and drivers.
 467
 468                 hw_rev:         (RO) Hardware revision number
 469
 470                 hca_type:       (RO) Host channel adapter type
 471
 472                 board_id:       (RO) Manufacturing board id
 473
 474                 boardversion:   (RO) Current version of the chip architecture
 475
 476                 nctxts:         (RO) Return the number of user ports (contexts)
 477                                 available
 478
 479                 localbus_info:  (RO) Human readable localbus info
 480
 481                 tempsense:      (RO) Display temp sense registers in decimal
 482
 483                 serial:         (RO) Serial number of the HCA
 484
 485                 nfreectxts:     (RO) The number of free user ports (contexts)
 486                                 available.
 487
 488                 chip_reset:     (WO) Reset the chip if possible by writing
 489                                 "reset" to this file. Only allowed if no user
 490                                 contexts are open that use chip resources.
 491
 492
 493 What:           /sys/class/infiniband/qibX/ports/N/sl2vl/[0-15]
 494 Date:           May, 2010
 495 KernelVersion:  v2.6.35
 496 Contact:        linux-rdma@vger.kernel.org
 497 Description:
 498                 (RO) The directory contains 16 files numbered 0-15 that specify
 499                 the Service Level (SL). Listing the SL files returns the Virtual
 500                 Lane (VL) as programmed by the SL.
 501
 502 What:           /sys/class/infiniband/qibX/ports/N/CCMgtA/cc_settings_bin
 503 What:           /sys/class/infiniband/qibX/ports/N/CCMgtA/cc_table_bin
 504 Date:           May, 2010
 505 KernelVersion:  v2.6.35
 506 Contact:        linux-rdma@vger.kernel.org
 507 Description:
 508                 Per-port congestion control. Both are binary attributes.
 509
 510                 cc_table_bin:   (RO) Congestion control table size followed by
 511                                 table entries.
 512
 513                 cc_settings_bin:(RO) Congestion settings: port control, control
 514                                 map and an array of 16 entries for the
 515                                 congestion entries - increase, timer, event log
 516                                 trigger threshold and the minimum injection rate
 517                                 delay.
 518
 519 What:           /sys/class/infiniband/qibX/ports/N/linkstate/loopback
 520 What:           /sys/class/infiniband/qibX/ports/N/linkstate/led_override
 521 What:           /sys/class/infiniband/qibX/ports/N/linkstate/hrtbt_enable
 522 What:           /sys/class/infiniband/qibX/ports/N/linkstate/status
 523 What:           /sys/class/infiniband/qibX/ports/N/linkstate/status_str
 524 Date:           May, 2010
 525 KernelVersion:  v2.6.35
 526 Contact:        linux-rdma@vger.kernel.org
 527 Description:
 528                 [to be documented]
 529
 530                 loopback:       (WO)
 531                 led_override:   (WO)
 532                 hrtbt_enable:   (RW)
 533                 status:         (RO)
 534
 535                 status_str:     (RO) Displays information about the link state,
 536                                 possible cable/switch problems, and hardware
 537                                 errors. Possible states are- "Initted",
 538                                 "Present", "IB_link_up", "IB_configured" or
 539                                 "Fatal_Hardware_Error".
 540
 541 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/rc_resends
 542 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/seq_naks
 543 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/rdma_seq
 544 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/rnr_naks
 545 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/other_naks
 546 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/rc_timeouts
 547 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/look_pkts
 548 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/pkt_drops
 549 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/dma_wait
 550 What:           /sys/class/infiniband/qibX/ports/N/diag_counters/unaligned
 551 Date:           May, 2010
 552 KernelVersion:  v2.6.35
 553 Contact:        linux-rdma@vger.kernel.org
 554 Description:
 555                 [to be documented]
 556
 557
 558 sysfs interface for Mellanox Connect-IB HCA driver mlx5
 559 -------------------------------------------------------
 560
 561 What:           /sys/class/infiniband/mlx5_X/hw_rev
 562 What:           /sys/class/infiniband/mlx5_X/hca_type
 563 What:           /sys/class/infiniband/mlx5_X/reg_pages
 564 What:           /sys/class/infiniband/mlx5_X/fw_pages
 565 Date:           Jul, 2013
 566 KernelVersion:  v3.11
 567 Contact:        linux-rdma@vger.kernel.org
 568 Description:
 569                 [to be documented]
 570
 571
 572 sysfs interface for Cisco VIC (usNIC) Verbs Driver
 573 --------------------------------------------------
 574
 575 What:           /sys/class/infiniband/usnic_X/board_id
 576 What:           /sys/class/infiniband/usnic_X/config
 577 What:           /sys/class/infiniband/usnic_X/qp_per_vf
 578 What:           /sys/class/infiniband/usnic_X/max_vf
 579 What:           /sys/class/infiniband/usnic_X/cq_per_vf
 580 What:           /sys/class/infiniband/usnic_X/iface
 581 Date:           Sep, 2013
 582 KernelVersion:  v3.14
 583 Contact:        Christian Benvenuti <benve@cisco.com>,
 584                 Dave Goodell <dgoodell@cisco.com>,
 585                 linux-rdma@vger.kernel.org
 586 Description:
 587
 588                 board_id:       (RO) Manufacturing board id
 589
 590                 config:         (RO) Report the configuration for this PF
 591
 592                 qp_per_vf:      (RO) Queue pairs per virtual function.
 593
 594                 max_vf:         (RO) Max virtual functions
 595
 596                 cq_per_vf:      (RO) Completion queue per virtual function
 597
 598                 iface:          (RO) Shows which network interface this usNIC
 599                                 entry is associated to (visible with ifconfig).
 600
 601 What:           /sys/class/infiniband/usnic_X/qpn/summary
 602 What:           /sys/class/infiniband/usnic_X/qpn/context
 603 Date:           Sep, 2013
 604 KernelVersion:  v3.14
 605 Contact:        Christian Benvenuti <benve@cisco.com>,
 606                 Dave Goodell <dgoodell@cisco.com>,
 607                 linux-rdma@vger.kernel.org
 608 Description:
 609                 [to be documented]
 610
 611
 612 sysfs interface for Emulex RoCE HCA Driver
 613 ------------------------------------------
 614
 615 What:           /sys/class/infiniband/ocrdmaX/hw_rev
 616 Date:           Feb, 2014
 617 KernelVersion:  v3.14
 618 Description:
 619                 hw_rev:         (RO) Hardware revision number
 620
 621 What:           /sys/class/infiniband/ocrdmaX/hca_type
 622 Date:           Jun, 2014
 623 KernelVersion:  v3.16
 624 Contact:        linux-rdma@vger.kernel.org
 625 Description:
 626                 hca_type:       (RO) Display FW version
 627
 628
 629 sysfs interface for Intel Omni-Path driver (HFI1)
 630 -------------------------------------------------
 631
 632 What:           /sys/class/infiniband/hfi1_X/hw_rev
 633 What:           /sys/class/infiniband/hfi1_X/board_id
 634 What:           /sys/class/infiniband/hfi1_X/nctxts
 635 What:           /sys/class/infiniband/hfi1_X/serial
 636 What:           /sys/class/infiniband/hfi1_X/chip_reset
 637 What:           /sys/class/infiniband/hfi1_X/boardversion
 638 What:           /sys/class/infiniband/hfi1_X/nfreectxts
 639 What:           /sys/class/infiniband/hfi1_X/tempsense
 640 Date:           May, 2016
 641 KernelVersion:  v4.6
 642 Contact:        linux-rdma@vger.kernel.org
 643 Description:
 644                 hw_rev:         (RO) Hardware revision number
 645
 646                 board_id:       (RO) Manufacturing board id
 647
 648                 nctxts:         (RO) Total contexts available.
 649
 650                 serial:         (RO) Board serial number
 651
 652                 chip_reset:     (WO) Write "reset" to this file to reset the
 653                                 chip if possible. Only allowed if no user
 654                                 contexts are open that use chip resources.
 655
 656                 boardversion:   (RO) Human readable board info
 657
 658                 nfreectxts:     (RO) The number of free user ports (contexts)
 659                                 available.
 660
 661                 tempsense:      (RO) Thermal sense information
 662
 663
 664 What:           /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_settings_bin
 665 What:           /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_table_bin
 666 What:           /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_prescan
 667 Date:           May, 2016
 668 KernelVersion:  v4.6
 669 Contact:        linux-rdma@vger.kernel.org
 670 Description:
 671                 Per-port congestion control.
 672
 673                 cc_table_bin:   (RO) CCA tables used by PSM2 Congestion control
 674                                 table size followed by table entries. Binary
 675                                 attribute.
 676
 677                 cc_settings_bin:(RO) Congestion settings: port control, control
 678                                 map and an array of 16 entries for the
 679                                 congestion entries - increase, timer, event log
 680                                 trigger threshold and the minimum injection rate
 681                                 delay. Binary attribute.
 682
 683                 cc_prescan:     (RW) enable prescanning for faster BECN
 684                                 response. Write "on" to enable and "off" to
 685                                 disable.
 686
 687 What:           /sys/class/infiniband/hfi1_X/ports/N/sc2vl/[0-31]
 688 What:           /sys/class/infiniband/hfi1_X/ports/N/sl2sc/[0-31]
 689 What:           /sys/class/infiniband/hfi1_X/ports/N/vl2mtu/[0-15]
 690 Date:           May, 2016
 691 KernelVersion:  v4.6
 692 Contact:        linux-rdma@vger.kernel.org
 693 Description:
 694                 sc2vl/:         (RO) 32 files (0 - 31) used to translate sl->vl
 695
 696                 sl2sc/:         (RO) 32 files (0 - 31) used to translate sl->sc
 697
 698                 vl2mtu/:        (RO) 16 files (0 - 15) used to determine MTU for vl
 699
 700
 701 What:           /sys/class/infiniband/hfi1_X/sdma_N/cpu_list
 702 What:           /sys/class/infiniband/hfi1_X/sdma_N/vl
 703 Date:           Sept, 2016
 704 KernelVersion:  v4.8
 705 Contact:        linux-rdma@vger.kernel.org
 706 Description:
 707                 sdma<N>/ contains one directory per sdma engine (0 - 15)
 708
 709                 cpu_list:       (RW) List of cpus for user-process to sdma
 710                                 engine assignment.
 711
 712                 vl:             (RO) Displays the virtual lane (vl) the sdma
 713                                 engine maps to.
 714
 715                 This interface gives the user control on the affinity settings
 716                 for the device. As an example, to set an sdma engine irq
 717                 affinity and thread affinity of a user processes to use the
 718                 sdma engine, which is "near" in terms of NUMA configuration, or
 719                 physical cpu location, the user will do:
 720
 721                 echo "3" > /proc/irq/<N>/smp_affinity_list
 722                 echo "4-7" > /sys/devices/.../sdma3/cpu_list
 723                 cat /sys/devices/.../sdma3/vl
 724                 0
 725                 echo "8" > /proc/irq/<M>/smp_affinity_list
 726                 echo "9-12" > /sys/devices/.../sdma4/cpu_list
 727                 cat /sys/devices/.../sdma4/vl
 728                 1
 729
 730                 to make sure that when a process runs on cpus 4,5,6, or 7, and
 731                 uses vl=0, then sdma engine 3 is selected by the driver, and
 732                 also the interrupt of the sdma engine 3 is steered to cpu 3.
 733                 Similarly, when a process runs on cpus 9,10,11, or 12 and sets
 734                 vl=1, then engine 4 will be selected and the irq of the sdma
 735                 engine 4 is steered to cpu 8.  This assumes that in the above N
 736                 is the irq number of "sdma3", and M is irq number of "sdma4" in
 737                 the /proc/interrupts file.
 738
 739
 740 sysfs interface for Intel(R) X722 iWARP i40iw driver
 741 ----------------------------------------------------
 742
 743 What:           /sys/class/infiniband/i40iwX/hw_rev
 744 What:           /sys/class/infiniband/i40iwX/hca_type
 745 What:           /sys/class/infiniband/i40iwX/board_id
 746 Date:           Jan, 2016
 747 KernelVersion:  v4.10
 748 Contact:        linux-rdma@vger.kernel.org
 749 Description:
 750                 hw_rev:         (RO) Hardware revision number
 751
 752                 hca_type:       (RO) Show HCA type (I40IW)
 753
 754                 board_id:       (RO) I40IW board ID
 755
 756
 757 sysfs interface for QLogic qedr NIC Driver
 758 ------------------------------------------
 759
 760 What:           /sys/class/infiniband/qedrX/hw_rev
 761 What:           /sys/class/infiniband/qedrX/hca_type
 762 Date:           Oct, 2016
 763 KernelVersion:  v4.10
 764 Contact:        linux-rdma@vger.kernel.org
 765 Description:
 766
 767                 hw_rev:         (RO) Hardware revision number
 768
 769                 hca_type:       (RO) Display HCA type
 770
 771
 772 sysfs interface for VMware Paravirtual RDMA driver
 773 --------------------------------------------------
 774
 775 What:           /sys/class/infiniband/vmw_pvrdmaX/hw_rev
 776 What:           /sys/class/infiniband/vmw_pvrdmaX/hca_type
 777 What:           /sys/class/infiniband/vmw_pvrdmaX/board_id
 778 Date:           Oct, 2016
 779 KernelVersion:  v4.10
 780 Contact:        linux-rdma@vger.kernel.org
 781 Description:
 782
 783                 hw_rev:         (RO) Hardware revision number
 784
 785                 hca_type:       (RO) Host channel adapter type
 786
 787                 board_id:       (RO) Display PVRDMA manufacturing board ID
 788
 789
 790 sysfs interface for Broadcom NetXtreme-E RoCE driver
 791 ----------------------------------------------------
 792
 793 What:           /sys/class/infiniband/bnxt_reX/hw_rev
 794 What:           /sys/class/infiniband/bnxt_reX/hca_type
 795 Date:           Feb, 2017
 796 KernelVersion:  v4.11
 797 Contact:        linux-rdma@vger.kernel.org
 798 Description:
 799                 hw_rev:         (RO) Hardware revision number
 800
 801                 hca_type:       (RO) Host channel adapter type