| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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" |
| Mike Marciniszyn | 7724105 | 2015-07-30 15:17:43 -0400 | [diff] [blame] | 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 |