| 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" |