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.
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 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]hierfdb(CN5000 only) Specifies switch hierarchical FDB tables.
[-m dest_port] [-m port1,port2] [-f flid] [-t table]hiercont(CN5000 only) Specifies switch hierarchical control tables.
[-m dest_port] [-m port1,port2] [-t table]hieroverride(CN5000 only) Specifies 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 PKey tables.
[-m dest_port] [-b block[,count]]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]sitscvlt(CN5000 only) Specifies 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.
hficongctrlexch(CN5000 only) Specifies SuperNIC congestion control exchange settings.
swcongexch(CN5000 only) Specifies switch congestion exchange settings.
[-m dest_port] [-m port1,port2]swtelemexch(CN5000 only) Specifies 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]bwarb(CN5000 only) Specifies 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
-t(CN5000 only) Displays 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