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