ibswitches(8)

1IBSWITCHES(8)                 OpenIB Diagnostics                 IBSWITCHES(8)
2
3
4

NAME

6       IBSWITCHES - show InfiniBand switch nodes in topology
7

SYNOPSIS

9       ibswitches [options] [<topology-file>]
10

DESCRIPTION

12       ibswitches  is  a  script  which either walks the IB subnet topology or
13       uses an already saved topology file and extracts the switch nodes.
14

OPTIONS

16       -C, --Ca <ca_name>    use the specified ca_name.
17
18       -P, --Port <ca_port>    use the specified ca_port.
19
20       -t,  --timeout  <timeout_ms>  override  the  default  timeout  for  the
21       solicited mads.
22
23       -y, --m_key <key>
24              use the specified M_key for requests. If non-numeric value (like
25              'x') is specified then a value will be prompted for.
26
27       -h, --help      show the usage message
28
29       --config, -z  <config_file> Specify alternate config file.
30          Default: /etc/infiniband-diags/ibdiag.conf
31
32   Local port Selection
33       Multiple port/Multiple CA support: when no IB device or port is  speci‐
34       fied  (see  the  "local  umad parameters" below), the libibumad library
35       selects the port to use by the following criteria:
36
37          1. the first port that is ACTIVE.
38
39          2. if not found, the first port that is UP (physical link up).
40
41          If a port  and/or  CA  name  is  specified,  the  libibumad  library
42          attempts  to  fulfill  the  user request, and will fail if it is not
43          possible.
44
45          For example:
46
47              ibaddr                 # use the first port (criteria #1 above)
48              ibaddr -C mthca1       # pick the best port from "mthca1" only.
49              ibaddr -P 2            # use the second (active/up) port from the first available IB device.
50              ibaddr -C mthca0 -P 2  # use the specified port only.
51

FILES

53   CONFIG FILE
54       /etc/infiniband-diags/ibdiag.conf
55
56       A global config file is provided to set some of the common options  for
57       all tools.  See supplied config file for details.
58
59   NODE NAME MAP FILE FORMAT
60       The  node  name map is used to specify user friendly names for nodes in
61       the output.  GUIDs are used to perform the lookup.
62
63       This  functionality  is  provided  by  the  opensm-libs  package.   See
64       opensm(8) for the file location for your installation.
65
66       Generically:
67
68          # comment
69          <guid> "<name>"
70
71       Example:
72
73          # IB1
74          # Line cards
75          0x0008f104003f125c "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
76          0x0008f104003f125d "IB1 (Rack 11 slot 1   ) ISR9288/ISR9096 Voltaire sLB-24D"
77          0x0008f104003f10d2 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
78          0x0008f104003f10d3 "IB1 (Rack 11 slot 2   ) ISR9288/ISR9096 Voltaire sLB-24D"
79          0x0008f104003f10bf "IB1 (Rack 11 slot 12  ) ISR9288/ISR9096 Voltaire sLB-24D"
80
81          # Spines
82          0x0008f10400400e2d "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
83          0x0008f10400400e2e "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
84          0x0008f10400400e2f "IB1 (Rack 11 spine 1   ) ISR9288 Voltaire sFB-12D"
85          0x0008f10400400e31 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
86          0x0008f10400400e32 "IB1 (Rack 11 spine 2   ) ISR9288 Voltaire sFB-12D"
87
88          # GUID   Node Name
89          0x0008f10400411a08 "SW1  (Rack  3) ISR9024 Voltaire 9024D"
90          0x0008f10400411a28 "SW2  (Rack  3) ISR9024 Voltaire 9024D"
91          0x0008f10400411a34 "SW3  (Rack  3) ISR9024 Voltaire 9024D"
92          0x0008f104004119d0 "SW4  (Rack  3) ISR9024 Voltaire 9024D"
93

DEPENDENCIES

98       ibnetdiscover, ibnetdiscover format
99

AUTHOR

101       Hal Rosenstock
102              < halr@voltaire.com >
103
104
105
106
107                                                                 IBSWITCHES(8)