Documentation/infiniband/sysfs.txt

   1 SYSFS FILES
   2
   3   For each InfiniBand device, the InfiniBand drivers create the
   4   following files under /sys/class/infiniband/<device name>:
   5
   6     node_type      - Node type (CA, switch or router)
   7     node_guid      - Node GUID
   8     sys_image_guid - System image GUID
   9
  10   In addition, there is a "ports" subdirectory, with one subdirectory
  11   for each port.  For example, if mthca0 is a 2-port HCA, there will
  12   be two directories:
  13
  14     /sys/class/infiniband/mthca0/ports/1
  15     /sys/class/infiniband/mthca0/ports/2
  16
  17   (A switch will only have a single "0" subdirectory for switch port
  18   0; no subdirectory is created for normal switch ports)
  19
  20   In each port subdirectory, the following files are created:
  21
  22     cap_mask       - Port capability mask
  23     lid            - Port LID
  24     lid_mask_count - Port LID mask count
  25     rate           - Port data rate (active width * active speed)
  26     sm_lid         - Subnet manager LID for port's subnet
  27     sm_sl          - Subnet manager SL for port's subnet
  28     state          - Port state (DOWN, INIT, ARMED, ACTIVE or ACTIVE_DEFER)
  29     phys_state     - Port physical state (Sleep, Polling, LinkUp, etc)
  30
  31   There is also a "counters" subdirectory, with files
  32
  33     VL15_dropped
  34     excessive_buffer_overrun_errors
  35     link_downed
  36     link_error_recovery
  37     local_link_integrity_errors
  38     port_rcv_constraint_errors
  39     port_rcv_data
  40     port_rcv_errors
  41     port_rcv_packets
  42     port_rcv_remote_physical_errors
  43     port_rcv_switch_relay_errors
  44     port_xmit_constraint_errors
  45     port_xmit_data
  46     port_xmit_discards
  47     port_xmit_packets
  48     symbol_error
  49
  50   Each of these files contains the corresponding value from the port's
  51   Performance Management PortCounters attribute, as described in
  52   section 16.1.3.5 of the InfiniBand Architecture Specification.
  53
  54   The "pkeys" and "gids" subdirectories contain one file for each
  55   entry in the port's P_Key or GID table respectively.  For example,
  56   ports/1/pkeys/10 contains the value at index 10 in port 1's P_Key
  57   table.
  58
  59 MTHCA
  60
  61   The Mellanox HCA driver also creates the files:
  62
  63     hw_rev   - Hardware revision number
  64     fw_ver   - Firmware version
  65     hca_type - HCA type: "MT23108", "MT25208 (MT23108 compat mode)",
  66                or "MT25208"
  67
  68 HFI1
  69
  70   The hfi1 driver also creates these additional files:
  71
  72    hw_rev - hardware revision
  73    board_id - manufacturing board id
  74    tempsense - thermal sense information
  75    serial - board serial number
  76    nfreectxts - number of free user contexts
  77    nctxts - number of allowed contexts (PSM2)
  78    chip_reset - diagnostic (root only)
  79    boardversion - board version
  80    ports/1/
  81           CMgtA/
  82                cc_settings_bin - CCA tables used by PSM2
  83                cc_table_bin
  84           sc2v/ - 32 files (0 - 31) used to translate sl->vl
  85           sl2sc/ - 32 files (0 - 31) used to translate sl->sc
  86           vl2mtu/ - 16 (0 - 15) files used to determine MTU for vl