opasaquery (1) - Linux Manuals

NAME

opasaquery

(All) Performs various queries of the subnet manager/subnet agent and provides detailed fabric information.

opareport and opareports can provide a more powerful tool, however, in some cases opasaquery is preferred, especially when dealing with virtual fabrics, service records, and multicast.

The command opasaquery is installed on all hosts as part of the Intel(R) Omni-Path Fabric Host Software, but it is also included in Intel(R) Omni-Path Fabric Suite FastFabric Toolset.

By default, opasaquery uses the first active port on the local system. However, if the node is connected to more than one fabric (for example, a subnet), the Intel(R) Omni-Path Host Fabric Interface (HFI) and port may be specified to select the fabric whose SA is to be queried.

Syntax

opasaquery [-v [-v] [-v]] [-I] [-h hfi] [-p port] [-o type] [-l lid]
[-t type] [-s guid] [-n guid] [-g guid] [-k pkey] [-i vfIndex]
[-S serviceId] [-L sl] [-u gid] [-m gid] [-d name] [-P 'guid guid']
[-G 'gid gid'] [-a 'sguid...; dguid...'] [-A#8217#160;'sgid...; dgid...']

Options

--help
Produces full help text.

-v/--verbose
Returns verbose output. A second invocation activates openib debugging, a third invocation activates libibumad debugging.

-I/--IB
Issues query in legacy InfiniBand* format.

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

-p/--port port
Port, numbered 1..n. If 0, then port is a first active. Default is first active.

-o/--output type
Output type for query (default is node). See Output Types for details.

-l/--lid lid
Query a specific LID.

-t/--type node_type
Query by node type. See Node Types for details.

-s/--sysguid system_image_guid
Query by system image GUID.

-n/--nodeguid node_guid
Query by node GUID.

-g/--portguid port_guid
Query by port GUID.

-k/--pkey pkey
Query a specific PKey.

-i/--vfindex vfIndex
Query a specific vfindex.

-S/--serviceId serviceId
Query a specific service ID.

-L/--SL SL
Query by service level.

-u/--portgid port_gid
Query by port GID. See GIDs for details.

-m/--mcgid multicast_gid
Query by multicast GID. See GIDs for details.

-d/--desc node_description
Query by node name/description.

-P/--guidpair guid guid
Query by a pair of port GUIDs.

-G/--gidpair gid gid
Query by a pair of GIDs. See GIDs for details.

-a/--guidlist sguid ...;dguid ...
Query by a list of port GUIDs.

-A/--gidlist sgid ...;dgid ...
Query by a list of GIDs. See GIDs for details.

-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#8217#160;-p 0
First active port on HFI x.

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

-h x#8217#160;-p y
HFI x, port y.

Node Types

fi
Fabric Interface

sw
Switch

GIDs

Specify a 64-bit subnet and 64-bit interface ID in the form:


 subnetinterface 

NOTE: In the following example, the GID corresponds to a PortGID. In this case, the interface ID coincides with the lower 64-bits of the GUID of the card. The interface ID will be different if the GID is a MGID (that is, multicast GID). See opafm.xml for MGID examples.


0xfe80000000000000:0x00117500a0000380


Output Types

Default is node.

classportinfo
classportinfo of the SA.

systemguid
List of system image GUIDs.

nodeguid
List of node GUIDs.

portguid
List of port GUIDs.

lid
List of LIDs.

desc
List of node descriptions/names.

path
List of path records.

node
List of node records.

portinfo
List of port info records.

sminfo
List of SM info records.

swinfo
List of switch info records.

link
List of link records.

scsc
List of SC to SC mapping table records.

slsc
List of SL to SC mapping table records.

scsl
List of SC to SL mapping table records.

scvlt
List of SC to VLt table records.

scvlnt
List of SC to VLnt table records.

vlarb
List of VL arbitration table records.

pkey
List of PKey table records.

service
List of service records.

mcmember
List of multicast member records.

inform
List of inform info records.

linfdb
List of switch linear forwarding database (FDB) records.

mcfdb
List of switch multicast FDB records.

trace
List of trace records.

vfinfo
List of vFabrics.

vfinfocsv
List of vFabrics in CSV format.

vfinfocsv2
List of vFabrics in CSV format with enums.

fabricinfo
Summary of fabric devices.

quarantine
List of quarantined nodes.

conginfo
List of Congestion Info Records.

swcongset
List of Switch Congestion Settings.

swportcong
List of Switch Port Congestion Settings.
hficongset
List of HFI Congestion Settings.

hficongcon
List of HFI Congestion Control Settings.

bfrctrl
List of buffer control tables.

cableinfo
List of Cable Info records.

portgroup
List of AR Port Group records.

portgroupfdb
List of AR Port Group FWD records.

The vfinfocsv and vfinfocsv2 output formats are designed to make it easier to script vfinfo queries. One line is output per vFabric of the form:



name:index:pkey:sl:mtu:rate:optionflag


The only difference between these two formats is how the MTU and rate are output. vfinfocsv outputs MTU and rate in human/text readable format. vfinfocsv2 outputs MTU and rate as enumerations defined for the SMA protocol. The opagetvf command is based on this capability of opasaquery. For more information, see opagetvf

Example

opasaquery -o desc -t fi
opasaquery -o portinfo -l 2
opasaquery -o sminfo
opasaquery -o pkey

Input Options vs. Output Permitted

The following list shows the input (assorted query by options) and outputs (-o) that are permitted.

None

-o output permitted systemguid, nodeguid, portguid, lid, desc, path, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb, vfinfo, vfinfocsv, vfinfocsv2, scsc, slsc, scvlt, scnlmt, linfdb, classportinfo, fabricinfo, quarantine, conginfo, swcongset, swportcong, hficongset, hficongcon, bfrctl, cableinfo, portgroup, portgroupfdb

-o output not permitted trace

-t node_type

-o output permitted systemguid, nodeguid, portguid, lid, desc, node

-o output not permitted portinfo, sminfo, swinfo, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb, trace, vfinfo, vfinfocsv, vfinfocsv2

-l lid

-o output permitted systemguid, nodeguid, portguid, lid, desc, path, node, portinfo, swinfo, slvl, vlarb, pkey, service, mcmember, linfdb, mcfdb

-o output not permitted sminfo, link, inform, trace, vfinfo, vfinfocsv, vfinfocsv2

-k pkey

-o output permitted mcmember, path, vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted systemimageguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb

-i
vfindex

-o output permitted vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted systemimageguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb

-s system_image_guid

-o output permitted systemguid, nodeguid, portguid, lid, desc, node

-o output not permitted portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb, trace, vfinfo, vfinfocsv, vfinfocsv2

-n node_guid

-o output permitted systemguid, nodeguid, portguid, lid, desc, node

-o output not permitted portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb, trace, vfinfo, vfinfocsv, vfinfocsv2

-g port_guid

-o output permitted systemguid, nodeguid, portguid, lid, desc, path, node, service, mcmember, inform, trace

-o output not permitted portinfo, sminfo, swinfo, link, vlarb, pkey, linfdb, mcfdb, vfinfo, vfinfocsv, vfinfocsv2

-u port_gid

-o output permitted path, service, mcmember, inform, trace

-o output not permitted systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, vlarb, pkey, linfdb, mcfdb, vfinfo, vfinfocsv, vfinfocsv2

-m multicast_gid

-o output permitted mcmember, vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted systemguid, nodeguid, portguid, lid, desc, path, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, inform, linfdb, mcfdb, trace

-d name

-o output permitted systemguid, nodeguid, portguid, lid, desc, node

-o output not permitted trace

-P port_guid_pair

-o output permitted path, trace

-o output not permitted systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb

-S serviceId

-o output permitted path, vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted systemimageguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb

-L SL

-o output permitted path, vfinfo, vfinfocsv, vfinfocsv2

-o output not permitted systemimageguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb

-G gid_pair

-o output permitted path, trace

-o output not permitted systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb

-a port_guid_list

-o output permitted path

-o output not permitted systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb, trace

-A gid_list

-o output permitted path

-o output not permitted systemguid, nodeguid, portguid, lid, desc, node, portinfo, sminfo, swinfo, link, vlarb, pkey, service, mcmember, inform, linfdb, mcfdb, trace