opasaquery(1)

📦 version 10.14.4.0.20, in centos-stream 9, debian bookworm, debian trixie, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🎀 opasaquery(1) 🎀

IFSFFCLIRG (Man Page) — yeah bestie, that's the family this one lives in 💖

✨ NAME ✨

opasaquery — (All) does a whole bunch of different queries against the subnet manager / subnet agent and hands you back detailed fabric info. It's giving fabric detective energy 🕵️‍♀️✨

So like, opareport and opareports from the Intel(R) Omni-Path Fabric Suite are honestly a more powerful tool overall. But sometimes opasaquery is just the girl for the job — especially when you're messing with virtual fabrics, service records, and multicast. iykyk 💅

By default, opasaquery uses the first active port on the local system. But lowkey, if your node is connected to more than one fabric (like, a subnet), you can specify the Intel(R) Omni-Path Host Fabric Interface (HFI) and port to pick exactly which fabric's SA you're querying. main character selection energy 👑

🌸 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 — spills the full help text, no cap 🫶
-v, --verbose — gives you verbose output. Hit it a second time and it turns on openib debugging; a third time turns on libibumad debugging. Three layers deep, obsessed 😭
-I, --IB — issues the query in legacy InfiniBand* format. vintage, but make it fashion ✨
-h, --hfi hfi — specifies the HFI, numbered 1..n. Using 0 means the -p port port is a system-wide port number. Default is 0.
-b, --oob address — specifies the Out-of-Band address of the node running the FE. Can be a hostname, an IPv4, or an IPv6 address. Default is "127.0.0.1".
-p, --port port — specifies the port. Details:
- In-band: numbered 1..n. Using 0 specifies the first active port. Default is 0.
- Out-of-band: the port the FE is listening on. Default is 3245.
--timeout — specifies the timeout (aka the wait time for a response) in ms. Default is 1000 ms. she's patient but not that patient 🕐
-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.) ⚠️ don't forget it
-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 the query. Default is node. See Output Types for the deets.
-l, --lid lid — query a specific LID.
-t, --type node_type — queries by node type. See Node Types for the deets.
-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 the deets.
-m, --mcgid multicast_gid — queries by multicast GID. See GIDs for the deets.
-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 the deets.

🦋 `-h` and `-p` options permit a variety of selections 🦋

like, mix and match, bestie:

-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

short and sweet, periodt 💅

⭐ GIDs ⭐

Specifies a 64-bit subnet and a 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. Here's the whole roster, no skips:

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 get 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 🦋

okay bestie, this next bit is so important and it's literally the whole vibe check of opasaquery: not every input option lets you ask for every output. like, some combos just are not it. here's the full rundown of what input (the assorted query you make with options) plays nice with which outputs (-o) 💖

✨ None ✨

no input option at all? you still get options, bestie 👑

✅ -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

yes, linfdb really is in there twice. that's the manpage's business, not mine. 🫶

`-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

iykyk — yes, mcmember is in both lists for -k. that's exactly what the page says. don't come for me 💅

`-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

so yeah — that's the whole compatibility grid, bestie. if you try an input/output pair that's in the "not permitted" column, don't be shocked when it doesn't vibe. 🌸

💀 also peep that a couple of these lists use systemimageguid while the None list uses systemguid. that's literally what's written, so that's literally what you get. no cap.

and that's a wrap on opasaquery(1)! 🎀 big Copyright(C) 2015-2019 Intel Corporation energy up in here — that's the source and version info this page belongs to, bestie, and honestly? iconic. go query some fabrics, main character. ✨🦋💖

📦 where this page comes from

centos-stream 9: opa-basic-tools 1:10.12.1.0.6-1.el9 · BSD or GPLv2
debian bookworm: opa-basic-tools 10.10.3.0.11-1+b1 · BSD-3-clause-top
debian trixie: opa-basic-tools 10.10.3.0.11-1+b2 · BSD-3-clause-top
opensuse-leap 16.0: opa-basic-tools 10.14.4.0.20-160000.3.2 · BSD-3-Clause OR GPL-2.0-only
ubuntu jammy: opa-basic-tools 10.10.3.0.11-1ubuntu1 · BSD-3-clause-top
ubuntu noble: opa-basic-tools 10.10.3.0.11-1ubuntu3 · BSD-3-clause-top
ubuntu questing: opa-basic-tools 10.10.3.0.11-1ubuntu3
ubuntu resolute: opa-basic-tools 10.10.3.0.11-1ubuntu4 · BSD-3-clause-top
ubuntu stonking: opa-basic-tools 10.10.3.0.11-1ubuntu5 · BSD-3-clause-top
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-13: a language model's rewrite of the original, under its terms

opasaquery(1)

🎀 opasaquery(1) 🎀

✨ NAME ✨

🌸 Syntax 🌸

💅 Options 💅

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

🌈 Node Types 🌈

⭐ GIDs ⭐

💖 Output Types 💖

🧚 Example 🧚

🦋 Input Options vs. Output Permitted 🦋

✨ None ✨

-t node_type

-l lid

-k pkey

-i vfindex

-s system_image_guid

-n node_guid

-g port_guid

-u port_gid

-m multicast_gid

-d node_description

-D dg_name

-P port_guid_pair

-S serviceId

-L SL

-G gid_pair

-a port_guid_list

-A gid_list