Provided by: opa-basic-tools_10.10.3.0.11-1ubuntu1_amd64 
NAME
opasaquery
(All) Performs various queries of the subnet manager/subnet agent and provides detailed
fabric information.
opareport and opareports from the Intel(R) Omni-Path Fabric Suite can provide a more
powerful tool. In some cases, opasaquery is preferred, especially when dealing with
virtual fabrics, service records, and multicast.
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|-b addr] [-p port] [--timeout]
[-x gid] [-E] [-T ssl_params] [-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 nodeDescription] [-D dg_name] [-P 'guid guid']
[-G 'gid gid'] [-H mask]
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
Specifies the HFI, numbered 1..n. Using 0 specifies that the -p port port is a
system-wide port number. Default is 0.
-b/--oob address
Specifies Out-of-Band address of node running the FE. Can be either hostname,
IPv4, or IPv6 address. Default is "127.0.0.1".
-p/--port port
Specifies the port.
• In-band: numbered 1..n. Using 0 specifies first active port. Default is
0.
• Out-of-band: Port FE is listening on. Default is 3245.
--timeout
Specifies the timeout (wait time for response) in ms. Default is 1000 ms.
-x/--source-gid src_gid
Specifies the source GID of the local GID (This is required for most Path and
Trace Record Queries when Out-of-Band.)
-E/--feEsm
Specifies the ESM FE.
-T/--ssl-params file
Specifies the SSL/TLS parameters XML file. Default is /etc/opa/opamgt_tls.xml.
-o type
Output type for query. Default is node. See Output Types for details.
-l/--lid lid
Query a specific LID.
-t/--type node_type
Queries by node type. See Node Types for details.
-s/--sysguid system_image_guid
Queries by system image GUID.
-n/--nodeguid node_guid
Queries by node GUID.
-g/--portguid port_guid
Queries by port GUID.
-k/--pkey pkey
Queries a specific PKey.
-i/--vfindex vfIndex
Queries a specific vfindex.
-S/--serviceId serviceId
Queries a specific service ID.
-L/--SL SL
Queries by service level.
-u/--portgid port_gid
Queries by port GID. See GIDs for details.
-m/--mcgid multicast_gid
Queries by multicast GID. See GIDs for details.
-d/--desc node_description
Queries by node name/description.
-D/--dgname dg_name
Queries by device group name/description
-P/--guidpair guid guid
Queries by a pair of port GUIDs.
-G/--gidpair gid gid
Queries by a pair 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 -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.
Node Types
fi
Fabric Interface
sw
Switch
GIDs
Specifies a 64-bit subnet and 64-bit interface ID in the form:
subnet:interface
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
Specifies the classportinfo of the SA.
systemguid
Lists the system image GUIDs.
nodeguid
Lists the node GUIDs.
portguid
Lists the port GUIDs.
lid
Lists the LIDs.
desc
Lists the node descriptions/names.
path
Lists the path records.
node
Lists the node records.
portinfo
Lists the port info records.
sminfo
Lists the SM info records.
swinfo
Lists the switch info records.
link
Lists the link records.
scsc
Lists the SC to SC mapping table records.
slsc
Lists the SL to SC mapping table records.
scsl
Lists the SC to SL mapping table records.
scvlt
Lists the SC to VLt table records.
scvlr
Lists the SC to VLr table records.
scvlnt
Lists the SC to VLnt table records.
vlarb
Lists the VL arbitration table records.
pkey
Lists the PKey table records.
service
Lists the service records.
mcmember
Lists the multicast member records.
inform
Lists the inform info records.
linfdb
Lists the switch linear forwarding database (FDB) records.
mcfdb
Lists the switch multicast FDB records.
trace
Lists the trace records.
vfinfo
Lists the vFabrics.
vfinfocsv
Lists the vFabrics in CSV format.
vfinfocsv2
Lists the vFabrics in CSV format with enums.
fabricinfo
Specifies the summary of fabric devices.
quarantine
Lists the quarantined nodes.
conginfo
Lists the Congestion Info Records.
swcongset
Lists the Switch Congestion Settings.
swportcong
Lists the Switch Port Congestion Settings.
hficongset
Lists the HFI Congestion Settings.
hficongcon
Lists the HFI Congestion Control Settings.
bfrctrl
Lists the buffer control tables.
cableinfo
Lists the Cable Info records.
portgroup
Lists the AR Port Group records.
portgroupfdb
Lists the AR Port Group FWD records.
dglist
Lists the Device Group Names.
dgmember
Lists the Device Group records.
dtree
Lists the Device Tree records.
swcost
Lists the switch cost 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::mcastSl
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
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, dglist, dgmember, dtree
-o output not permitted
trace
-t node_type
-o output permitted
systemguid, nodeguid, portguid, lid, desc, node, dglist, dgmember,
dtree
-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, mcmember, linfdb, mcfdb, dgmember, dtree
-o output not permitted
sminfo, link, inform, service, trace, vfinfo, vfinfocsv, vfinfocsv2,
dglist
-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, dglist, dgmember, dtree
-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, dglist, dgmember, dtree
-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, dglist,
dgmember, dtree
-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, dglist,
dgmember, dtree
-g port_guid
-o output permitted
systemguid, nodeguid, portguid, lid, desc, path, node, trace, dgmember
-o output not permitted
portinfo, sminfo, swinfo, link, vlarb, pkey, linfdb, mcfdb, vfinfo,
vfinfocsv, vfinfocsv2, dglist, dtree, service, mcmember, inform
-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, dglist, dgmember, dtree
-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, dglist, dgmember, dtree
-d node_description
-o output permitted
systemguid, nodeguid, portguid, lid, desc, node, dgmember
-o output not permitted
trace, dglist, dtree
-D dg_name
-o output permitted
dgmember
-o output not permitted
systemguid, nodeguid, portguid, lid, desc, path, node, portinfo,
sminfo, swinfo, link, vlarb, pkey, service, inform, linfdb, mcfdb,
trace, dglist, dtree
-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,
dglist, dgmember, dtree
-S serviceId
-o output permitted
path, vfinfo, vfinfocsv, vfinfocsv2, service
-o output not permitted
systemimageguid, nodeguid, portguid, lid, desc, node, portinfo,
sminfo, swinfo, link, vlarb, pkey, mcmember, inform, linfdb, mcfdb,
dglist, dgmember, dtree
-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, dglist, dgmember, dtree
-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,
dglist, dgmember, dtree
-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, dglist, dgmember, dtree
-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, dglist, dgmember, dtree