1 .\" Man page generated from reStructuredText.
3 .TH SMPQUERY 8 "" "" "Open IB Diagnostics"
7 .nr rst2man-indent-level 0
11 level \\n[rst2man-indent-level]
12 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
19 .\" .rstReportMargin pre:
21 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22 . nr rst2man-indent-level +1
23 .\" .rstReportMargin post:
27 .\" indent \\n[an-margin]
28 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .nr rst2man-indent-level -1
30 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
33 .SH QUERY INFINIBAND SUBNET MANAGEMENT ATTRIBUTES
36 smpquery [options] <op> <dest dr_path|lid|guid> [op params]
39 smpquery allows a basic subset of standard SMP queries including the following:
40 node info, node description, switch info, port info. Fields are displayed in
41 human readable format.
44 Current supported operations (case insensitive) and their parameters:
54 Portinfo (PI) <addr> [<portnum>] # default port is zero
56 PortInfoExtended (PIE) <addr> [<portnum>]
58 Switchinfo (SI) <addr>
60 PKeyTable (PKeys) <addr> [<portnum>]
62 SL2VLTable (SL2VL) <addr> [<portnum>]
64 VLArbitration (VLArb) <addr> [<portnum>]
68 MlnxExtPortInfo (MEPI) <addr> [<portnum>] # default port is zero
75 .B \fB\-c, \-\-combined\fP
76 Use Combined route address argument \fB<lid> <DR_Path>\fP
78 .B \fB\-x, \-\-extended\fP
79 Set SMSupportsExtendedSpeeds bit 31 in AttributeModifier
80 (only impacts PortInfo queries).
82 .\" Define the common option -K
86 .B \fB\-K, \-\-show_keys\fP
87 show security keys (mkey, smkey, etc.) associated with the request.
90 .\" Define the common option -D for Directed routes
93 \fB\-D, \-\-Direct\fP The address specified is a directed route
100 [options] \-D [options] "0" # self port
101 [options] \-D [options] "0,1,2,1,4" # out via port 1, then 2, ...
103 (Note the second number in the path specified must match the port being
104 used. This can be specified using the port selection flag \(aq\-P\(aq or the
105 port found through the automatic selection process.)
110 .\" Define the common option -G
113 \fB\-G, \-\-Guid\fP The address specified is a Port GUID
114 .\" Define the common option -L
117 \fB\-L, \-\-Lid\fP The address specified is a LID
118 .\" Define the common option -s
121 \fB\-s, \-\-sm_port <smlid>\fP use \(aqsmlid\(aq as the target lid for SA queries.
122 .SS Port Selection flags
123 .\" Define the common option -C
126 \fB\-C, \-\-Ca <ca_name>\fP use the specified ca_name.
127 .\" Define the common option -P
130 \fB\-P, \-\-Port <ca_port>\fP use the specified ca_port.
131 .\" Explanation of local port selection
133 .SS Local port Selection
135 Multiple port/Multiple CA support: when no IB device or port is specified
136 (see the "local umad parameters" below), the libibumad library
137 selects the port to use by the following criteria:
142 the first port that is ACTIVE.
144 if not found, the first port that is UP (physical link up).
147 If a port and/or CA name is specified, the libibumad library attempts
148 to fulfill the user request, and will fail if it is not possible.
156 ibaddr # use the first port (criteria #1 above)
157 ibaddr \-C mthca1 # pick the best port from "mthca1" only.
158 ibaddr \-P 2 # use the second (active/up) port from the first available IB device.
159 ibaddr \-C mthca0 \-P 2 # use the specified port only.
167 .\" Define the common option -d
172 raise the IB debugging level.
173 May be used several times (\-ddd or \-d \-d \-d).
175 .\" Define the common option -e
180 show send and receive errors (timeouts and others)
182 .\" Define the common option -h
185 \fB\-h, \-\-help\fP show the usage message
186 .\" Define the common option -v
190 .B \fB\-v, \-\-verbose\fP
191 increase the application verbosity level.
192 May be used several times (\-vv or \-v \-v \-v)
194 .\" Define the common option -V
197 \fB\-V, \-\-version\fP show the version info.
198 .SS Configuration flags
199 .\" Define the common option -t
202 \fB\-t, \-\-timeout <timeout_ms>\fP override the default timeout for the solicited mads.
203 .\" Define the common option --node-name-map
206 \fB\-\-node\-name\-map <node\-name\-map>\fP Specify a node name map.
209 This file maps GUIDs to more user friendly names. See FILES section.
212 .\" Define the common option -y
216 .B \fB\-y, \-\-m_key <key>\fP
217 use the specified M_key for requests. If non\-numeric value (like \(aqx\(aq)
218 is specified then a value will be prompted for.
220 .\" Define the common option -z
223 \fB\-\-config, \-z <config_file>\fP Specify alternate config file.
226 Default: /etc/infiniband-diags/ibdiag.conf
230 .\" Common text for the config file
234 /etc/infiniband-diags/ibdiag.conf
236 A global config file is provided to set some of the common options for all
237 tools. See supplied config file for details.
238 .\" Common text to describe the node name map file.
240 .SS NODE NAME MAP FILE FORMAT
242 The node name map is used to specify user friendly names for nodes in the
243 output. GUIDs are used to perform the lookup.
245 This functionality is provided by the opensm\-libs package. See \fBopensm(8)\fP
246 for the file location for your installation.
269 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D"
270 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D"
271 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D"
272 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D"
273 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D"
276 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D"
277 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D"
278 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D"
279 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D"
280 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D"
283 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D"
284 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D"
285 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D"
286 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D"
295 smpquery portinfo 3 1 # portinfo by lid, with port modifier
296 smpquery \-G switchinfo 0x2C9000100D051 1 # switchinfo by guid
297 smpquery \-D nodeinfo 0 # nodeinfo by direct route
298 smpquery \-c nodeinfo 6 0,12 # nodeinfo by combined route
307 < \fI\%hal@mellanox.com\fP >
309 .\" Generated by docutils manpage writer.