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