saquery Command

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

Query Names	Alias for `name`	Format
`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:

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

saquery man page

Exit Print View
Sun Datacenter InfiniBand Switch 72 Command Reference

Sun Datacenter InfiniBand Switch 72 Command Reference