Saquery - Qlogic Fast Fabric User Manual

5 – Detailed Descriptions of Command LineTools
Fabric Analysis Tools
5.4.4

saquery

(All): saquery can perform various queries of the subnet manager/subnet agent
and provide detailed fabric information.
In many cases iba_report provides a more powerful tool, however in some
cases saquery is preferred, especially when dealing with service records and
multicast.
Saquery is installed on all hosts as part of the IB stack, but it is also included
in Fast Fabric. As such it can be a useful tool to run on the Fast Fabric host and
is therefore also documented here.
By default saquery uses the first active port on the local system. However, if
the IB management node is connected to more than one fabric (i.e., a subnet),
the HCA and port may be specified to select the fabric whose SA is to be queried.
Usage:
saquery [-v] [-h hca] [-p port] [-o type]
Options:
-v/--verbose: verbose output
-h/--hca hca: hca to send via, default is 1st hca
-p/--port port: port to send via, default is 1st active port
-l/--lid lid: query a specific lid
-t/--type type: query by node type
-s/--sysguid guid: query by system image guid
-n/--nodeguid guid: query by node guid
-g/--portguid guid: query by port guid
-u/--portgid gid: query by port gid
-m/--mcgid gid: query by multicast gid
-d/--desc name: query by node name/description
-P/--guidpair 'guid guid': query by a pair of port Guids
-G/--gidpair 'gid gid': query by a pair of Gids
-a/--guidlist 'sguid ...;dguid ...': query by a list of port Guids
5-56
[-l lid] [-t type] [-s guid] [-n guid] [-g guid]
[-u gid] [-m gid] [-d name]
[-P 'guid guid'] [-G 'gid gid']
[-a 'sguid...;dguid...'] [-A 'sgid...;dgid...']
Q
D000006-000 Rev A