Name
opasmaquery — Performs Omni-Path Architecture-defined SMA queries and displays the resulting response. Each query is issued directly to the SMA and does not involve SM interaction. This command is one of the Fabric Debug commands.
Syntax
opasmaquery [-v] [-d detail] [-g] [-l lid] [-h hfi] [-p port] [-o otype [-m port|port1,port2 [-f flid] [-b block[,count]] [hop hop...]
Options
--helpProduces full help text.
-vReturns verbose output. Can be specified more than once for additional
openibandlibibumaddebugging.-ddetailSpecifies the output detail level for
cableinfoonly. Range is 0 - n. Default is 2. An upper limit for detail level is not enforced. After a maximum amount of output is reached, a larger detail value has no effect.-gDisplays line-by-line format. Default is summary format.
-llidSpecifies the destination LID. Default is local port.
-h/--hfihfiSpecifies the SuperNIC, numbered 1..n. Using 0 specifies that the
-pport is a system-wide port number. Default is 0.port-p/--portportSpecifies the port, numbered 1..n. Using 0 specifies the first active port. Default is 0.
-ootypeSpecifies the output type. Default is
nodeinfo. Refer to otype Options Vary by Report for supported options.Valid output types are:
bfrctrlSpecifies buffer control tables.
[-m dest_port] [-m port1,port2]cableinfoSpecifies cable information.
[-d detail] [-m dest_port] [-b block[,count]]conginfoSpecifies congestion information.
descornodedescSpecifies node descriptions/names.
hficongconSpecifies SuperNIC congestion control settings.
[-b block[,count]] [-f flid]hficonglogSpecifies SuperNIC congestion logs.
[-b block[,count]]hficongsetSpecifies SuperNIC congestion settings.
linfdbSpecifies switch linear forwarding database (FDB) tables.
[-b block[,count]] [-f flid]hierfdbSpecifies switch hierarchical FDB tables.
[-m dest_port] [-m port1,port2] [-f flid] [-t table]hiercontSpecifies switch hierarchical control tables.
[-m dest_port] [-m port1,port2] [-t table]hieroverrideSpecifies switch hierarchical override entries.
[-m dest_port] [-m port1,port2] [-t table]mcfdbSpecifies switch multicast FDB tables.
[-m dest_port] [-b block[,count]] [-f flid]portgroupSpecifies Adaptive Routing port groups.
[-b block[,count]]portgroupfdbSpecifies Adaptive Routing port group FWD tables.
[-b block[,count]] [-f flid]nodeaggrSpecifies node information and node descriptions.
nodeornodeinfoSpecifies switch node information.
[-m dest_port]portinfoSpecifies switch port information.
[-m dest_port]pstateinfoSpecifies switch port state information.
[-m dest_port] [-m port1,port2]pkeySpecifies the full hardware PKey table capacity independent of Fabric Manager configuration.
[-m dest_port] [-b block[,count]]NOTE: To inspect the PKey blocks corresponding to Virtual Fabrics configured with a unique PKey in the Fabric Manager
opafm.xml, useopasaquery -o pkey.slscscslSpecifies SC to SL mapping tables.
scscSpecifies SC to SC mapping tables.
[-m dest_port] [-m port1,port2]scvltSpecifies SC to VLt tables.
[-m dest_port] [-m port1,port2]scvlntSpecifies SC to VLnt tables.
[-m dest_port] [-m port1,port2]scvlrSpecifies SC to VLr tables
[-m dest_port] [-m port1,port2]NOTE: This output type is not supported for SuperNICs.
sitscvltSpecifies Sit to SC to VLt tables
[-m dest_port] [-m port1,port2]sminfoSpecifies SM information.
swaggrSpecifies node information and switch information.
swconglogSpecifies switch congestion logs.
[-b block[,count]]swcongsetSpecifies switch congestion settings.
hficongctrlexchSpecifies SuperNIC congestion control exchange settings.
swcongexchSpecifies switch congestion exchange settings.
[-m dest_port] [-m port1,port2]swtelemexchSpecifies switch telemetry exchange settings.
[-m dest_port] [-m port1,port2]swinfoSpecifies switch information.
swportcongSpecifies switch congestion settings.
[-b block[,count]]vlarbSpecifies VL arbitration tables.
[-m dest_port]bwarbSpecifies BW arbitration tables.
[-m dest_port]ibnodeinfoSpecifies InfiniBand node information.
ledinfoSpecifies LED information.
[-m dest_port]
-h and -p options permit a variety of selections:
-h 0First active port in the system (Default).
-h 0 -p 0First active port in the system.
-hxFirst active port on SuperNIC
x.-hx-p 0First active port on SuperNIC
x.-h 0 -pyPort
ywithin the system (no matter which ports are active).-hx-pySuperNIC
x, porty.
otype Options Vary by Report
-mportSpecifies the switch port in the destination device to query.
-mport1,port2For some reports, specifies a range of switch ports between
port1port2-flidSpecifies the LID to look up in forwarding table to select which LFT or MFT block to display. Default is to show entire table.
-bblock[,count]Specifies the block number of either GUIDs or PKey, and the number of blocks to display. Default is to show entire table.
For example:
-bblockDisplays all of block
block-bblock,countDisplays
countblock-b ,countDisplays
count
-tDisplays specific HFT table.
Examples
opasmaquery -o desc -l 6 # get nodedesc via lid routed opasmaquery -o nodedesc 1 3 # get nodedesc via directed route (2 dr hops) opasmaquery -o nodeinfo -l 2 3 # get nodeinfo via a combination of lid routed and # directed route (1 dr hop) opasmaquery -o portinfo # get local port info opasmaquery -o portinfo -l 6 -m 1 # get port info of port 1 of lid 6 opasmaquery -o pkey -l 2 3 # get pkey table entries starting (lid routed to lid 2, # then 1 dr hop to port 3) opasmaquery -o vlarb -l 6 # get vlarb table entries from lid 6 opasmaquery -o swinfo -l 2 # get switch info opasmaquery -o sminfo -l 1 # get SM info opasmaquery -o slsc -l 3 # get sl2sc table entries from lid 3 opasmaquery -o scsl -l 3 # get sc2sl table entries from lid 3