1
2opasmaquery(1)         Master map: IFSFFCLIRG (Man Page)        opasmaquery(1)
3
4
5

NAME

7       opasmaquery
8
9
10
11       (All)  Performs Intel(R) Omni-Path Architecture-defined SMA queries and
12       displays the resulting response. Each query is issued directly  to  the
13       SMA and does not involve SM interaction.
14

Syntax

16       opasmaquery [-v] [-d detail][-g] [-l lid] [-h hfi] [-p port] [-K mkey]
17       [-o otype] [-m port| port1,port2] [-f flid] [-b block[,count]]
18       [hop hop ...]
19

Options

21       --help    Produces full help text.
22
23
24       -v        Returns  verbose  output. Can be specified more than once for
25                 additional openib and libibumad debugging.
26
27
28       -d detail Specifies the output detail level for cableinfo only. Range =
29                 0  -  n.  Default = 2. An upper limit for detail level is not
30                 enforced. After a maximum amount  of  output  is  reached,  a
31                 larger detail value has no effect.
32
33
34       -g        Displays line-by-line format. Default is summary format.
35
36
37       -l lid    Specifies the destination LID. Default is local port.
38
39
40       -h/--hfi hfi
41                 Specifies  the HFI, numbered 1..n. Using 0 specifies that the
42                 -p port port is a system-wide port number. (Default is 0.)
43
44
45       -p/--port port
46                 Specifies the port, numbered  1..n.  Using  0  specifies  the
47                 first active port. (Default is 0.)
48
49
50       -K mkey   Specifies the SM management key to access remote ports.
51
52
53       -o otype  Specifies  the  output  type.  Default  is nodeinfo. Refer to
54                 otype Options Vary by Report for supported options.
55
56
57                 Valid output types are:
58
59
60
61                 bfrctrl   Specifies buffer control tables.
62
63
64                           [-m dest_port] [-m port1,port2]
65
66
67
68
69                 cableinfo Specifies cable information.
70
71
72                           [-d detail] [-m dest_port] [-b block[,count]]
73
74
75
76
77                 conginfo  Specifies congestion information.
78
79
80
81
82
83                 desc or nodedesc
84                           Specifies node descriptions/names.
85
86
87
88
89
90                 hficongcon
91                           Specifies HFI congestion control settings.
92
93
94                           [-b block[,count]] [-f flid]
95
96
97
98
99                 hficonglog
100                           Specifies HFI congestion logs.
101
102
103                           [-b block[,count]]
104
105
106
107
108                 hficongset
109                           Specifies HFI congestion settings.
110
111
112
113
114
115                 linfdb    Specifies switch linear forwarding  database  (FDB)
116                           tables.
117
118
119                           [-b block[,count]] [-f flid]
120
121
122
123
124                 mcfdb     Specifies switch multicast FDB tables.
125
126
127                           [-m dest_port] [-b block[,count]] [-f flid]
128
129
130
131
132                 portgroup
133                           Specifies Adaptive Routing port groups.
134
135
136                           [-b block[,count]]
137
138
139
140
141                 portgroupfdb
142                           Specifies Adaptive Routing port group FWD tables.
143
144
145                           [-b block[,count]] [-f flid]
146
147
148
149
150                 nodeaggr  Specifies node information and node descriptions.
151
152
153
154
155
156                 node or nodeinfo
157                           Specifies node information.
158
159
160                           [-m dest_port]
161
162
163
164
165                 portinfo  Specifies port information.
166
167
168                           [-m dest_port]
169
170
171
172
173                 pstateinfo
174                           Specifies switch port state information.
175
176
177                           [-m dest_port] [-m port1,port2]
178
179
180
181
182                 pkey      Specifies P-Key tables.
183
184
185                           [-m dest_port] [-b block[,count]]
186
187
188
189
190                 slsc      Specifies SL to SC mapping tables.
191
192
193
194
195
196                 scsl      Specifies SC to SL mapping tables.
197
198
199
200
201
202                 scsc      Specifies SC to SC mapping tables.
203
204
205                           [-m dest_port] [-m port1,port2]
206
207
208
209
210                 scvlt     Specifies SC to VLt tables.
211
212
213                           [-m dest_port] [-m port1,port2]
214
215
216
217
218                 scvlnt    Specifies SC to VLnt tables.
219
220
221                           [-m dest_port] [-m port1,port2]
222
223
224
225
226                 sminfo    Specifies SM information.
227
228
229
230
231
232                 swaggr    Specifies node information and switch information.
233
234
235
236
237
238                 swconglog Specifies switch congestion logs.
239
240
241                           [-b block[,count]]
242
243
244
245
246                 swcongset Specifies switch congestion settings.
247
248
249
250
251
252                 swinfo    Specifies switch information.
253
254
255
256
257
258                 swportcong
259                           Specifies switch congestion settings.
260
261
262                           [-b block[,count]]
263
264
265
266
267                 vlarb     Specifies VL arbitration tables.
268
269
270                           [-m dest_port]
271
272
273
274
275                 ibnodeinfo
276                           Specifies IB node information.
277
278
279
280
281
282                 ledinfo   Specifies LED information.
283
284
285                           [-m dest_port]
286
287
288

-h and -p options permit a variety of selections:

290       -h 0      First active port in system (default).
291
292
293       -h 0 -p 0 First active port in system.
294
295
296       -h x      First active port on HFI x.
297
298
299       -h x -p 0 First active port on HFI x.
300
301
302       -h 0 -p y Port y within system (no matter which ports are active).
303
304
305       -h x -p y HFI x, port y.
306
307
308

otype Options Vary by Report

310       -m port   Specifies the port in destination device to query.
311
312
313       -m port1,port2
314                 For  some  reports,  specifies a range of ports between port1
315                 and port2. For others, this describes an inport/outport pair.
316
317
318       -f flid   Specifies the LID to look up in forwarding  table  to  select
319                 which  LFT or MFT block to display. Default is to show entire
320                 table.
321
322
323       -b block[,count]
324                 Specifies the block number of either GUIDs or pkey,  and  the
325                 number of blocks to display. Default is to show entire table.
326
327
328                 For example:
329
330                 -b block  Displays all of block block of a larger table.
331
332
333
334
335
336                 -b block,count
337                           Displays  count  blocks of data starting with block
338                           block.
339
340
341
342
343
344                 -b, count Displays count blocks of data starting  with  block
345                           0.
346
347
348

Examples

350       opasmaquery -o desc -l 6
351       # get nodedesc via lid routed
352
353       opasmaquery -o nodedesc 1 3
354       # get nodedesc via directed route (2 dr hops)
355
356       opasmaquery -o nodeinfo -l 2 3
357       #  get nodeinfo via a combination of lid routed and # directed route (1
358       dr hop)
359
360       opasmaquery -o portinfo
361       # get local port info
362
363       opasmaquery -o portinfo -l 6 -m 1
364       # get port info of port 1 of lid 6
365
366       opasmaquery -o pkey -l 2 3
367       # get pkey table entries starting (lid routed to lid 2,
368       # then 1 dr hop to port 3)
369
370       opasmaquery -o vlarb -l 6
371       # get vlarb table entries from lid 6
372
373       opasmaquery -o swinfo -l 2
374       # get switch info
375
376       opasmaquery -o sminfo -l 1
377       # get SM info
378
379       opasmaquery -o slsc -l 3
380       # get sl2sc table entries from lid 3
381
382       opasmaquery -o scsl -l 3
383       # get sc2sl table entries from lid 3
384
385
386
387Copyright(C) 2015-2018         Intel Corporation                opasmaquery(1)