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

NAME

7       opasaquery
8
9
10
11       (All)  Performs  various queries of the subnet manager/subnet agent and
12       provides detailed fabric information.
13
14       opareport and opareports from the Intel(R) Omni-Path Fabric  Suite  can
15       provide  a  more powerful tool. In some cases, opasaquery is preferred,
16       especially when dealing with virtual fabrics, service records, and mul‐
17       ticast.
18
19       By  default, opasaquery uses the first active port on the local system.
20       However, if the node is connected to more than one fabric (for example,
21       a  subnet), the Intel(R) Omni-Path Host Fabric Interface (HFI) and port
22       may be specified to select the fabric whose SA is to be queried.
23

Syntax

25       opasaquery [-v [-v] [-v]] [-I] [-h hfi|-b addr] [-p port] [-x gid] [-E]
26       [-T ssl_params] [-o type] [-l lid] [-t type] [-s guid] [-n guid]
27       [-g guid] [-k pkey] [-i vfIndex] [-S serviceId] [-L sl] [-u gid]
28       [-m gid] [-d name] [-P 'guid guid'] [-G 'gid gid'] [-H mask]
29

Options

31       --help    Produces full help text.
32
33
34       -v/--verbose
35                 Returns verbose output. A second invocation activates  openib
36                 debugging, a third invocation activates libibumad debugging.
37
38
39       -I/--IB   Issues query in legacy InfiniBand* format.
40
41
42       -h/--hfi hfi
43                 Specifies  the HFI, numbered 1..n. Using 0 specifies that the
44                 -p port port is a system-wide port number. (Default is 0.)
45
46
47       -b/--oob address
48                 Specifies Out-of-Band address of node running the FE. Can  be
49                 either   hostname,   IPv4,   or  IPv6  address.  (Default  is
50                 "127.0.0.1")
51
52
53       -p/--port port
54                 Specifies the port.
55
56
57                 ·      In-band: numbered 1..n. Using 0 specifies first active
58                        port. (Default is 0.)
59
60                 ·      Out-of-band:  Port  FE  is  listening  on. (Default is
61                        3245.)
62
63
64
65
66       -x/--source-gid src_gid
67                 Specifies the source GID of the local GID (This  is  required
68                 for most Path and Trace Record Queries when Out-of-Band.)
69
70
71       -E/--feEsm
72                 Specifies the ESM FE.
73
74
75       -T/--ssl-params file
76                 Specifies  the  SSL/TLS  parameters  XML  file.  (Default  is
77                 /etc/opa/opamgt_tls.xml)
78
79
80       -o type   Output type for query (default is node). See Output Types for
81                 details.
82
83
84       -l/--lid lid
85                 Query a specific LID.
86
87
88       -t/--type node_type
89                 Queries by node type. See Node Types for details.
90
91
92       -s/--sysguid system_image_guid
93                 Queries by system image GUID.
94
95
96       -n/--nodeguid node_guid
97                 Queries by node GUID.
98
99
100       -g/--portguid port_guid
101                 Queries by port GUID.
102
103
104       -k/--pkey pkey
105                 Queries a specific PKey.
106
107
108       -i/--vfindex vfIndex
109                 Queries a specific vfindex.
110
111
112       -S/--serviceId serviceId
113                 Queries a specific service ID.
114
115
116       -L/--SL SL
117                 Queries by service level.
118
119
120       -u/--portgid port_gid
121                 Queries by port GID. See GIDs for details.
122
123
124       -m/--mcgid multicast_gid
125                 Queries by multicast GID. See GIDs for details.
126
127
128       -d/--desc node_description
129                 Queries by node name/description.
130
131
132       -P/--guidpair guid guid
133                 Queries by a pair of port GUIDs.
134
135
136       -G/--gidpair gid gid
137                 Queries by a pair of GIDs. See GIDs for details.
138
139
140

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

142       -h 0      First active port in system (default).
143
144
145       -h 0 -p 0 First active port in system.
146
147
148       -h x      First active port on HFI x.
149
150
151       -h x -p 0 First active port on HFI x.
152
153
154       -h 0 -p y Port y within system (no matter which ports are active).
155
156
157       -h x -p y HFI x, port y.
158
159

Node Types

161       fi        Fabric Interface
162
163
164       sw        Switch
165
166

GIDs

168       Specifies a 64-bit subnet and 64-bit interface ID in the form:
169
170       subnet:interface
171
172       NOTE:  In  the  following example, the GID corresponds to a PortGID. In
173       this case, the interface ID coincides with the  lower  64-bits  of  the
174       GUID  of  the  card. The interface ID will be different if the GID is a
175       MGID (that is, multicast GID). See opafm.xml for MGID examples.
176
177
178       0xfe80000000000000:0x00117500a0000380
179
180
181

Output Types

183       Default is node.
184
185       classportinfo
186                 Specifies the classportinfo of the SA.
187
188
189       systemguid
190                 Lists the system image GUIDs.
191
192
193       nodeguid  Lists the node GUIDs.
194
195
196       portguid  Lists the port GUIDs.
197
198
199       lid       Lists the LIDs.
200
201
202       desc      Lists the node descriptions/names.
203
204
205       path      Lists the path records.
206
207
208       node      Lists the node records.
209
210
211       portinfo  Lists the port info records.
212
213
214       sminfo    Lists the SM info records.
215
216
217       swinfo    Lists the switch info records.
218
219
220       link      Lists the link records.
221
222
223       scsc      Lists the SC to SC mapping table records.
224
225
226       slsc      Lists the SL to SC mapping table records.
227
228
229       scsl      Lists the SC to SL mapping table records.
230
231
232       scvlt     Lists the SC to VLt table records.
233
234
235       scvlnt    Lists the SC to VLnt table records.
236
237
238       vlarb     Lists the VL arbitration table records.
239
240
241       pkey      Lists the PKey table records.
242
243
244       service   Lists the service records.
245
246
247       mcmember  Lists the multicast member records.
248
249
250       inform    Lists the inform info records.
251
252
253       linfdb    Lists the switch linear forwarding database (FDB) records.
254
255
256       mcfdb     Lists the switch multicast FDB records.
257
258
259       trace     Lists the trace records.
260
261
262       vfinfo    Lists the vFabrics.
263
264
265       vfinfocsv Lists the vFabrics in CSV format.
266
267
268       vfinfocsv2
269                 Lists the vFabrics in CSV format with enums.
270
271
272       fabricinfo
273                 Specifies the summary of fabric devices.
274
275
276       quarantine
277                 Lists the quarantined nodes.
278
279
280       conginfo  Lists the Congestion Info Records.
281
282
283       swcongset Lists the Switch Congestion Settings.
284
285
286       swportcong
287                 Lists the Switch Port Congestion Settings.
288
289
290       hficongset
291                 Lists the HFI Congestion Settings.
292
293
294       hficongcon
295                 Lists the HFI Congestion Control Settings.
296
297
298       bfrctrl   Lists the buffer control tables.
299
300
301       cableinfo Lists the Cable Info records.
302
303
304       portgroup Lists the AR Port Group records.
305
306
307       portgroupfdb
308                 Lists the AR Port Group FWD records.
309
310
311       swcost    Lists the switch cost records.
312
313
314       The vfinfocsv and vfinfocsv2 output formats are  designed  to  make  it
315       easier  to script vfinfo queries. One line is output per vFabric of the
316       form:
317
318       name:index:pkey:sl:mtu:rate:optionflag::mcastSl
319
320
321
322       The only difference between these two formats is how the MTU  and  rate
323       are  output. vfinfocsv outputs MTU and rate in human/text readable for‐
324       mat. vfinfocsv2 outputs MTU and rate as enumerations  defined  for  the
325       SMA  protocol.  The  opagetvf  command  is  based on this capability of
326       opasaquery. For more information, see opagetvf
327

Example

329       opasaquery -o desc -t fi
330

Input Options vs. Output Permitted

332       The following list shows the input (assorted query by options) and out‐
333       puts (-o) that are permitted.
334
335       None
336
337
338
339
340                 -o output permitted
341                           systemguid,  nodeguid,  portguid,  lid, desc, path,
342                           node, portinfo, sminfo, swinfo, link, vlarb,  pkey,
343                           service,  mcmember,  inform, linfdb, mcfdb, vfinfo,
344                           vfinfocsv, vfinfocsv2, scsc, slsc,  scvlt,  scnlmt,
345                           linfdb, classportinfo, fabricinfo, quarantine, con‐
346                           ginfo, swcongset, swportcong, hficongset,  hficong‐
347                           con, bfrctl, cableinfo, portgroup, portgroupfdb
348
349
350
351
352
353                 -o output not permitted
354                           trace
355
356
357
358
359       -t node_type
360
361
362
363
364                 -o output permitted
365                           systemguid, nodeguid, portguid, lid, desc, node
366
367
368
369
370
371                 -o output not permitted
372                           portinfo,  sminfo,  swinfo,  vlarb,  pkey, service,
373                           mcmember, inform,  linfdb,  mcfdb,  trace,  vfinfo,
374                           vfinfocsv, vfinfocsv2
375
376
377
378
379       -l lid
380
381
382
383
384                 -o output permitted
385                           systemguid,  nodeguid,  portguid,  lid, desc, path,
386                           node, portinfo, swinfo, slvl, vlarb,  pkey,  mcmem‐
387                           ber, linfdb, mcfdb
388
389
390
391
392
393                 -o output not permitted
394                           sminfo, link, inform, service, trace, vfinfo, vfin‐
395                           focsv, vfinfocsv2
396
397
398
399
400       -k pkey
401
402
403
404
405                 -o output permitted
406                           mcmember, path, vfinfo, vfinfocsv, vfinfocsv2
407
408
409
410
411
412                 -o output not permitted
413                           systemimageguid,  nodeguid,  portguid,  lid,  desc,
414                           node,  portinfo, sminfo, swinfo, link, vlarb, pkey,
415                           service, mcmember, inform, linfdb, mcfdb
416
417
418
419
420       -i        vfindex
421
422
423
424
425
426
427                 -o output permitted
428                           vfinfo, vfinfocsv, vfinfocsv2
429
430
431
432
433
434                 -o output not permitted
435                           systemimageguid,  nodeguid,  portguid,  lid,  desc,
436                           node,  portinfo, sminfo, swinfo, link, vlarb, pkey,
437                           service, mcmember, inform, linfdb, mcfdb
438
439
440
441
442       -s system_image_guid
443
444
445
446
447                 -o output permitted
448                           systemguid, nodeguid, portguid, lid, desc, node
449
450
451
452
453
454                 -o output not permitted
455                           portinfo, sminfo, swinfo, link, vlarb,  pkey,  ser‐
456                           vice,   mcmember,  inform,  linfdb,  mcfdb,  trace,
457                           vfinfo, vfinfocsv, vfinfocsv2
458
459
460
461
462       -n node_guid
463
464
465
466
467                 -o output permitted
468                           systemguid, nodeguid, portguid, lid, desc, node
469
470
471
472
473
474                 -o output not permitted
475                           portinfo, sminfo, swinfo, link, vlarb,  pkey,  ser‐
476                           vice,   mcmember,  inform,  linfdb,  mcfdb,  trace,
477                           vfinfo, vfinfocsv, vfinfocsv2
478
479
480
481
482       -g port_guid
483
484
485
486
487                 -o output permitted
488                           systemguid, nodeguid, portguid,  lid,  desc,  path,
489                           node, service, mcmember, inform, trace
490
491
492
493
494
495                 -o output not permitted
496                           portinfo,   sminfo,   swinfo,  link,  vlarb,  pkey,
497                           linfdb, mcfdb, vfinfo, vfinfocsv, vfinfocsv2
498
499
500
501
502       -u port_gid
503
504
505
506
507                 -o output permitted
508                           path, service, mcmember, inform, trace
509
510
511
512
513
514                 -o output not permitted
515                           systemguid, nodeguid, portguid,  lid,  desc,  node,
516                           portinfo,   sminfo,   swinfo,  link,  vlarb,  pkey,
517                           linfdb, mcfdb, vfinfo, vfinfocsv, vfinfocsv2
518
519
520
521
522       -m multicast_gid
523
524
525
526
527                 -o output permitted
528                           mcmember, vfinfo, vfinfocsv, vfinfocsv2
529
530
531
532
533
534                 -o output not permitted
535                           systemguid, nodeguid, portguid,  lid,  desc,  path,
536                           node,  portinfo, sminfo, swinfo, link, vlarb, pkey,
537                           service, inform, linfdb, mcfdb, trace
538
539
540
541
542       -d name
543
544
545
546
547                 -o output permitted
548                           systemguid, nodeguid, portguid, lid, desc, node
549
550
551
552
553
554                 -o output not permitted
555                           trace
556
557
558
559
560       -P port_guid_pair
561
562
563
564
565                 -o output permitted
566                           path, trace
567
568
569
570
571
572                 -o output not permitted
573                           systemguid, nodeguid, portguid,  lid,  desc,  node,
574                           portinfo,  sminfo,  swinfo, link, vlarb, pkey, ser‐
575                           vice, mcmember, inform, linfdb, mcfdb
576
577
578
579
580       -S serviceId
581
582
583
584
585                 -o output permitted
586                           path, vfinfo, vfinfocsv, vfinfocsv2
587
588
589
590
591
592                 -o output not permitted
593                           systemimageguid,  nodeguid,  portguid,  lid,  desc,
594                           node,  portinfo, sminfo, swinfo, link, vlarb, pkey,
595                           service, mcmember, inform, linfdb, mcfdb
596
597
598
599
600       -L SL
601
602
603
604
605                 -o output permitted
606                           path, vfinfo, vfinfocsv, vfinfocsv2
607
608
609
610
611
612                 -o output not permitted
613                           systemimageguid,  nodeguid,  portguid,  lid,  desc,
614                           node,  portinfo, sminfo, swinfo, link, vlarb, pkey,
615                           service, mcmember, inform, linfdb, mcfdb
616
617
618
619
620       -G gid_pair
621
622
623
624
625                 -o output permitted
626                           path, trace
627
628
629
630
631
632                 -o output not permitted
633                           systemguid, nodeguid, portguid,  lid,  desc,  node,
634                           portinfo,  sminfo,  swinfo, link, vlarb, pkey, ser‐
635                           vice, mcmember, inform, linfdb, mcfdb
636
637
638
639
640       -a port_guid_list
641
642
643
644
645                 -o output permitted
646                           path
647
648
649
650
651
652                 -o output not permitted
653                           systemguid, nodeguid, portguid,  lid,  desc,  node,
654                           portinfo,  sminfo,  swinfo, link, vlarb, pkey, ser‐
655                           vice, mcmember, inform, linfdb, mcfdb, trace
656
657
658
659
660       -A gid_list
661
662
663
664
665                 -o output permitted
666                           path
667
668
669
670
671
672                 -o output not permitted
673                           systemguid, nodeguid, portguid,  lid,  desc,  node,
674                           portinfo,  sminfo,  swinfo, link, vlarb, pkey, ser‐
675                           vice, mcmember, inform, linfdb, mcfdb, trace
676
677
678
679
680
681Copyright(C) 2015-2018         Intel Corporation                 opasaquery(1)