NAME

       opasmaquery

       (All)  Performs  Intel(R) 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

       --help    Produces full help text.

       -v        Returns verbose output. Can be specified more than once for  additional  openib  and  libibumad
                 debugging.

       -d detail Specifies  the  output  detail level for cableinfo only. 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.

       -g        Displays line-by-line format. Default is summary format.

       -l lid    Specifies the destination LID. Default is local port.

       -h/--hfi hfi
                 Specifies the HFI, numbered 1..n. Using 0 specifies that the -p port port is a system-wide port
                 number. Default is 0.

       -p/--port port
                 Specifies the port, numbered 1..n. Using 0 specifies the first active port. Default is 0.

       -o otype  Specifies the output type. Default is nodeinfo. Refer to  otype  Options  Vary  by  Report  for
                 supported options.

                 Valid output types are:

                 bfrctrl   Specifies buffer control tables.

                           [-m dest_port] [-m port1,port2]

                 cableinfo Specifies cable information.

                           [-d detail] [-m dest_port] [-b block[,count]]

                 conginfo  Specifies congestion information.

                 desc or nodedesc
                           Specifies node descriptions/names.

                 hficongcon
                           Specifies HFI congestion control settings.

                           [-b block[,count]] [-f flid]

                 hficonglog
                           Specifies HFI congestion logs.

                           [-b block[,count]]

                 hficongset
                           Specifies HFI congestion settings.

                 linfdb    Specifies switch linear forwarding database (FDB) tables.

                           [-b block[,count]] [-f flid]

                 mcfdb     Specifies switch multicast FDB tables.

                           [-m dest_port] [-b block[,count]] [-f flid]

                 portgroup Specifies Adaptive Routing port groups.

                           [-b block[,count]]

                 portgroupfdb
                           Specifies Adaptive Routing port group FWD tables.

                           [-b block[,count]] [-f flid]

                 nodeaggr  Specifies node information and node descriptions.

                 node or nodeinfo
                           Specifies node information.

                           [-m dest_port]

                 portinfo  Specifies port information.

                           [-m dest_port]

                 pstateinfo
                           Specifies switch port state information.

                           [-m dest_port] [-m port1,port2]

                 pkey      Specifies P-Key tables.

                           [-m dest_port] [-b block[,count]]

                 slsc      Specifies SL to SC mapping tables.

                 scsl      Specifies SC to SL mapping tables.

                 scsc      Specifies SC to SC mapping tables.

                           [-m dest_port] [-m port1,port2]

                 scvlt     Specifies SC to VLt tables.

                           [-m dest_port] [-m port1,port2]

                 scvlnt    Specifies SC to VLnt tables.

                           [-m dest_port] [-m port1,port2]

                 scvlr     Specifies SC to VLr tables

                           [-m dest_port] [-m port1,port2]

                 sminfo    Specifies SM information.

                 swaggr    Specifies node information and switch information.

                 swconglog Specifies switch congestion logs.

                           [-b block[,count]]

                 swcongset Specifies switch congestion settings.

                 swinfo    Specifies switch information.

                 swportcong
                           Specifies switch congestion settings.

                           [-b block[,count]]

                 vlarb     Specifies VL arbitration tables.

                           [-m dest_port]

                 ibnodeinfo
                           Specifies IB node information.

                 ledinfo   Specifies LED information.

                           [-m dest_port]

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

       -h 0      First active port in system (Default).

       -h 0 -p 0 First active port in system.

       -h x      First active port on HFI x.

       -h x -p 0 First active port on HFI x.

       -h 0 -p y Port y within system (no matter which ports are active).

       -h x -p y HFI x, port y.

otype Options Vary by Report

       [-m port|port1,port2] [-f lid] [-b block[,count]]

       -m port   Specifies the port in destination device to query.

       -m port1,port2
                 For  some  reports,  specifies  a  range  of  ports  between  port1 and port2. For others, this
                 describes an inport/outport pair.

       -f lid    Specifies the LID to look up in forwarding table to select which LFT or MFT block  to  display.
                 Default is to show entire table.

       -b block[,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:

                 -b block  Displays all of block block of a larger table.

                 -b block,count
                           Displays count blocks of data starting with block block.

                 -b, count Displays count blocks of data starting with block 0.

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