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