fix an example of scatterlists handling in DMA-API.txt
[linux-2.6] / 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"