saquery - Man Page

saquery [options] [<name> | <lid> | <guid>]

saquery issues the selected SA query. Node records are queried by default.

-p

get PathRecord info

-N

get NodeRecord info

-D,  --list

get NodeDescriptions of CAs only

-S

get ServiceRecord info

-I

get InformInfoRecord (subscription) info

-L

return the Lids of the name specified

-l

return the unique Lid of the name specified

-G

return the Guids of the name specified

-O

return the name for the Lid specified

-U

return the name for the Guid specified

-c

get the SA's class port info

-s

return the PortInfoRecords with isSM or isSMdisabled capability mask bit on

-g

get multicast group info

-m

get multicast member info.  If a group is specified, limit the output to the group specified and print one line containing only the GUID and node description for each entry. Example: saquery -m 0xc000

-x

get LinkRecord info

--src-to-dst <src:dst>

get a PathRecord for <src:dst> where src and dst are either node names or LIDs

--sgid-to-dgid <sgid:dgid>

get a PathRecord for sgid to dgid where both GIDs are in an IPv6 format acceptable to inet_pton (3)

--smkey <val>

use SM_Key value for the query. Will be used only with "trusted" queries.  If non-numeric value (like 'x') is specified then saquery will prompt for a value. Default (when not specified here or in /etc/infiniband-diags/ibdiag.conf) is to use SM_Key == 0 (or "untrusted")

-K,  --show_keys

show security keys (mkey, smkey, etc.) associated with the request.

--slid <lid>

Source LID (PathRecord)

--dlid <lid>

Destination LID (PathRecord)

--mlid <lid>

Multicast LID (MCMemberRecord)

--sgid <gid>

Source GID (IPv6 format) (PathRecord)

--dgid <gid>

Destination GID (IPv6 format) (PathRecord)

--gid <gid>

Port GID (MCMemberRecord)

--mgid <gid>

Multicast GID (MCMemberRecord)

--reversible

Reversible path (PathRecord)

--numb_path

Number of paths (PathRecord)

--pkey P_Key (PathRecord, MCMemberRecord). If non-numeric value (like 'x')

is specified then saquery will prompt for a value

--qos_class

QoS Class (PathRecord)

--sl

Service level (PathRecord, MCMemberRecord)

--mtu

MTU and selector (PathRecord, MCMemberRecord)

--rate

Rate and selector (PathRecord, MCMemberRecord)

--pkt_lifetime

Packet lifetime and selector (PathRecord, MCMemberRecord)

--qkey Q_Key (MCMemberRecord). If non-numeric value (like 'x') is specified

then saquery will prompt for a value

--tclass

Traffic Class (PathRecord, MCMemberRecord)

--flow_label

Flow Label (PathRecord, MCMemberRecord)

--hop_limit

Hop limit (PathRecord, MCMemberRecord)

--scope

Scope (MCMemberRecord)

--join_state

Join state (MCMemberRecord)

--proxy_join

Proxy join (MCMemberRecord)

--service_id

ServiceID (PathRecord)

Supported query names (and aliases):

ClassPortInfo (CPI)
NodeRecord (NR) [lid]
PortInfoRecord (PIR) [[lid]/[port]/[options]]
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]]
GUIDInfoRecord (GIR) [[lid]/[block]]
SwitchInfoRecord (SWIR) [lid]
SMInfoRecord (SMIR) [lid]

ibaddr                 # use the first port (criteria #1 above)
ibaddr -C mthca1       # pick the best port from "mthca1" only.
ibaddr -P 2            # use the second (active/up) port from the first available IB device.
ibaddr -C mthca0 -P 2  # use the specified port only.

OpenSM (or other running SM/SA), libosmcomp, libibumad, libibmad

Ira Weiny

< ira.weiny@intel.com >

Hal Rosenstock

< halr@mellanox.com >