QLogic OFED+ Host Software User Guide, Rev. B

I–Useful Programs and Files
Summary and Descriptions of Useful Programs
iba_opp_query
This command retrieves path records from the Distributed SA and is somewhat
similar to iba_saquery. It is intended for testing the Distributed SA
(qlogic_sa) and for verifying connectivity between nodes in the fabric. For
information on configuring and using the Distributed SA, refer to “QLogic
Distributed Subnet Administration” on page 3-13.
iba_opp_query does not access the SM when doing queries, it only accesses
the local Distributed SA database. For that reason, the kinds of queries that can
be done are much more limited than with iba_saquery. In particular, it can only
find paths that start on the machine where the command is run. (In other words,
the source LID or source GID must be on the local node.) In addition, queries
must supply either a source and destination LID, or a source and destination GID.
They cannot be mixed. In addition, you will usually need to provide either a SID
that was specified in Distributed SA configuration file, or a pkey that matches such
a SID.
Usage
iba_opp_query [-v level] [-hca hca] [-p port] [-s LID] [-d
LID] [-S GID] [-D GID] [-k pkey] [-i sid] [-H]
Options
-v/--verbose level — Debug level. Should be a number between 1
and 7. Default is 5.
-s/--slid LID — Source LID. Can be in decimal, hex (0x##) or octal
(0##)
-d/--dlid LID — Destination LID. Can be in decimal, hex (0x##) or octal
(0##)
-S/--sgid GID — Source GID. (Can be in GID
("0x########:0x########") or inet6 format ("##:##:##:##:##:##:##:##"))
-D/--dgid GID — Destination GID. (Can be in GID
("0x########:0x########") or inet6 format ("##:##:##:##:##:##:##:##"))
-k/--pkey pkey — Partition Key
-i/--sid sid — Service ID
-h/--hca hca — The Host Channel Adapter to use. (Defaults to the first
Host Channel Adapter.) The Host Channel Adapter can be identified by
name ("mthca0", “qib1”, et cetera) or by number (1, 2, 3, et cetera).
-p/--port port — The port to use. (Defaults to the first port)
-H/--help — Provides this help text.
All arguments are optional, but ill-formed queries can be expected to fail. You
must provide at least a pair of LIDs, or a pair of GIDs.
I-4 D000046-005 B