saquery Command - Sun Datacenter InfiniBand Switch 648 Topic Set

`saquery` Command

Queries InfiniBand fabric administration attributes. Issued on the Linux InfiniBand host.

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 software 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.....................0x3A
        reserved................0x0
        base_version............0x1
        class_version...........0x1
        node_type...............Channel Adapter
        num_ports...............0x2
        sys_guid................0x0003ba000100c70b
        node_guid...............0x0003ba000100c708
        port_guid...............0x0003ba000100c70a
        partition_cap...........0x80
        device_id...............0x673C
        revision................0xA0
        port_num................0x2
        vendor_id...............0x2C9
        NodeDescription.........nsn34-39 HCA-1
NodeRecord dump:
        lid.....................0x2
        reserved................0x0
.
.
.
#

Note - The output in the example is just a portion of the full output.

Related Information

saquery man page
getboardstat Command

Exit Print View
Sun Datacenter InfiniBand Switch 648 Topic Set