1SMPQUERY(8) Open IB Diagnostics SMPQUERY(8)
2
6 SMPQUERY -
7
9 SYNOPSIS
10 smpquery [options] <op> <dest dr_path|lid|guid> [op params]
11 DESCRIPTION
13 smpquery allows a basic subset of standard SMP queries including the
14 following: node info, node description, switch info, port info. Fields
15 are displayed in human readable format.
16 OPTIONS
18 Current supported operations and their parameters:
19 :: nodeinfo <addr> nodedesc <addr> portinfo <addr> [<portnum>]
21 # default port is zero switchinfo <addr> pkeys <addr> [<port‐
22 num>] sl2vl <addr> [<portnum>] vlarb <addr> [<portnum>] guids
23 <addr> mlnxextportinfo <addr> [<portnum>] # default port is
24 zero
25 -c, --combined
27 Use Combined route address argument <lid> <DR_Path>
28 -x, --extended
30 Set SMSupportsExtendedSpeeds bit 31 in AttributeModifier (only
31 impacts PortInfo queries).
32 -K, --show_keys
34 show security keys (mkey, smkey, etc.) associated with the
35 request.
36 Addressing Flags
38 -D, --Direct The address specified is a directed route
39 Examples:
41 [options] -D [options] "0" # self port
42 [options] -D [options] "0,1,2,1,4" # out via port 1, then 2, ...
43 (Note the second number in the path specified must match the port being
45 used. This can be specified using the port selection flag '-P' or the
46 port found through the automatic selection process.)
47 -G, --Guid The address specified is a Port GUID
49 -L, --Lid The address specified is a LID
51 -s, --sm_port <smlid> use 'smlid' as the target lid for SA queries.
53 Port Selection flags
55 -C, --Ca <ca_name> use the specified ca_name.
56 -P, --Port <ca_port> use the specified ca_port.
58 Local port Selection
60 Multiple port/Multiple CA support: when no IB device or port is speci‐
61 fied (see the "local umad parameters" below), the libibumad library
62 selects the port to use by the following criteria:
63 1. the first port that is ACTIVE.
65 2. if not found, the first port that is UP (physical link up).
67 If a port and/or CA name is specified, the libibumad library
69 attempts to fulfill the user request, and will fail if it is not
70 possible.
71 For example:
73 ibaddr # use the first port (criteria #1 above)
75 ibaddr -C mthca1 # pick the best port from "mthca1" only.
76 ibaddr -P 2 # use the second (active/up) port from the first available IB device.
77 ibaddr -C mthca0 -P 2 # use the specified port only.
78 Debugging flags
80 -d raise the IB debugging level. May be used several times (-ddd
81 or -d -d -d).
82 -e show send and receive errors (timeouts and others)
84 -h, --help show the usage message
86 -v, --verbose
88 increase the application verbosity level. May be used several
89 times (-vv or -v -v -v)
90 -V, --version show the version info.
92 Configuration flags
94 -t, --timeout <timeout_ms> override the default timeout for the
95 solicited mads.
96 --node-name-map <node-name-map> Specify a node name map.
98 This file maps GUIDs to more user friendly names. See FILES sec‐
99 tion.
100 -y, --m_key <key>
102 use the specified M_key for requests. If non-numeric value (like
103 'x') is specified then a value will be prompted for.
104 --config, -z <config_file> Specify alternate config file.
106 Default: /etc/infiniband-diags/ibdiag.conf
107 FILES
109 CONFIG FILE
110 /etc/infiniband-diags/ibdiag.conf
111 A global config file is provided to set some of the common options for
113 all tools. See supplied config file for details.
114 NODE NAME MAP FILE FORMAT
116 The node name map is used to specify user friendly names for nodes in
117 the output. GUIDs are used to perform the lookup.
118 This functionality is provided by the opensm-libs package. See
120 opensm(8) for the file location for your installation.
121 Generically:
123 # comment
125 <guid> "<name>"
126 Example:
128 # IB1
130 # Line cards
131 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D"
132 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D"
133 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D"
134 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D"
135 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB-24D"
136 # Spines
138 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D"
139 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D"
140 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D"
141 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D"
142 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D"
143 # GUID Node Name
145 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D"
146 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D"
147 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D"
148 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D"
149 EXAMPLES
151 :: smpquery portinfo 3 1 # portinfo by lid,
152 with port modifier smpquery -G switchinfo 0x2C9000100D051 1 #
153 switchinfo by guid smpquery -D nodeinfo 0 #
154 nodeinfo by direct route smpquery -c nodeinfo 6 0,12
155 # nodeinfo by combined route
156 SEE ALSO
158 smpdump (8)
159 AUTHOR
161 Hal Rosenstock
162 < hal@mellanox.com >
163 SMPQUERY(8)