saquery Command - Sun Datacenter InfiniBand Switch 36 Topic Set

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 unique 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.

The saquery command is available from the /SYS/Fabric_Mgmt Linux shell target of the Oracle ILOM CLI interface.

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.

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

# saquery
NodeRecord dump:
        lid.....................0xE
        reserved................0x0
        base_version............0x1
        class_version...........0x1
        node_type...............Channel Adapter
        num_ports...............0x2
        sys_guid................0x0003ba000100e38b
        node_guid...............0x0003ba000100e388
        port_guid...............0x0003ba000100e38a
        partition_cap...........0x80
        device_id...............0x673C
        revision................0xA0
        port_num................0x2
        vendor_id...............0x2C9
        NodeDescription.........nsn33-43 HCA-1
NodeRecord dump:
        lid.....................0xF
        reserved................0x0
.
.
.
#

Related Information

saquery man page
Linux Shells for InfiniBand Commands

Skip Navigation Links
Exit Print View
	Sun Datacenter InfiniBand Switch 36 Topic Set