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