saquery Command
Queries InfiniBand fabric administration attributes.
Syntax
saquery [-h][-d][-p][-N][-D][-S][-I][-L][-l][-G][-O][-U][-c][-s] [-g][-m][-x][-C ca_name][-P ca_port][-t timeout][--src-to-dst source:destination][--sgid-to-dgid source-destination][name|lid|guid]
where:
-
ca_name is the channel adapter name.
-
ca_port is the channel adapter port.
-
timeout is the timeout in milliseconds.
-
lid is the local identifier.
-
guid is the global unit identifier.
-
name is the query name described in the following table:
|
|
|
ClassPortInfo |
CPI |
|
NodeRecord |
NR |
|
PortInfoRecord |
PIR |
|
SL2VLTableRecord |
SL2VL |
[[lid]/[in_port]/[out_port]] |
PKeyTableRecord |
PKTR |
[[lid]/[port]/[block]] |
VLArbitrationTableRecord |
VLAR |
[[lid]/[port]/[block]] |
InformInfoRecord |
IIR |
|
LinkRecord |
LR |
[[from_lid]/[from_port]] [[to_lid]/[to_port]] |
ServiceRecord |
SR |
|
PathRecord |
PR |
|
MCMemberRecord |
MCMR |
|
LFTRecord |
LFTR |
[[lid]/[block]] |
MFTRecord |
MFTR |
[[mlid]/[position]/[block]] |
|
Description
This InfiniBand command performs the selected Subnet Administrator query. Node records are queried
by default.
Options
The following table describes the options to the saquery command and their purposes:
|
|
-h |
Provides
help. |
-d |
Sets the debug level. Can be used several times to increase the debug
level. |
-p |
Displays the PathRecord information. |
-N |
Displays the NodeRecord information. |
-D |
Displays the NodeDescriptions of channel adapters only. |
-S |
Displays
ServiceRecord information. |
-I |
Displays InformInfoRecord information. |
-L |
Returns the LIDs of the specified name. |
-l |
Returns the
unique LID of the specified name. |
-G |
Returns the GUIDs of the specified name. |
-O |
Returns
the name of the specified LID. |
-U |
Returns the name of the specified GUID. |
-G |
Uses
the port GUID address. |
-c |
Displays the Subnet Administrator class port information. |
-s |
Returns the PortInforRecords with
the isSM or isSMdisabled capability mask bit enabled. |
-g |
Displays multicast group information. |
-m |
Displays multicast member
information. If a group is specified, provides only the GUID and node description for
each entry. |
-x |
Displays LinkRecord information. |
--src-to-dst |
Displays a PathRecord for source:destination, where source and destination are either
node names or LIDs. |
--sgid-to-dgid |
Displays a PathRecord for source-destination, where source and destination are GIDs
in an IPv6 format acceptable to inet_pton. |
-C |
Uses the specified channel adapter name. |
-P |
Uses
the specified channel adapter port. |
-t |
Overrides the default timeout. |
|
Example
The following example shows how to produce a node record dump of every
LID in the InfiniBand fabric with the saquery command.
# saquery
NodeRecord dump:
lid.....................0x14
reserved................0x0
base_version............0x1
class_version...........0x1
node_type...............Switch
num_ports...............0x24
sys_guid................0x0021283a8620b0a3
node_guid...............0x0021283a8620b0a0
port_guid...............0x0021283a8620b0a0
partition_cap...........0x8
device_id...............0xBD36
revision................0xA0
port_num................0x8
vendor_id...............0x2C9
NodeDescription.........Sun DCS 72 QDR switch 1.2(LC)
NodeRecord dump:
lid.....................0x15
reserved................0x0
.
.
.
#
Note - The output in the example is just a portion of the full output.
Related Information