Poster of Linux kernelThe best gift for a Linux geek
SAQUERY

SAQUERY

Section: OpenIB Diagnostics (8) Updated: October 19, 2008
Local index Up

 

NAME

saquery - query InfiniBand subnet administration attributes

 

SYNOPSIS

saquery [-h] [-d] [-p] [-N] [--list | -D] [-S] [-I] [-L] [-l] [-G] [-O] [-U] [-c] [-s] [-g] [-m] [-x] [-C ca_name] [-P ca_port] [--smkey val] [-t(imeout) <msec>] [--src-to-dst <src:dst>] [--sgid-to-dgid <sgid-dgid>] [--node-name-map <node-name-map>] [<name> | <lid> | <guid>]

 

DESCRIPTION

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

 

OPTIONS

-p
get PathRecord info
-N
get NodeRecord info
--list | -D
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
get a PathRecord for <src:dst> where src and dst are either node names or LIDs
--sgid-to-dgid
get a PathRecord for sgid to dgid where both GIDs are in an IPv6 format acceptable to inet_pton(3).
-C <ca_name>
use the specified ca_name.
-P <ca_port>
use the specified ca_port.
--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.
-t, -timeout <msec>
Specify SA query response timeout in milliseconds. Default is 100 milliseconds. You may want to use this option if IB_TIMEOUT is indicated.
--node-name-map <node-name-map>
Specify a node name map. The node name map file maps GUIDs to more user friendly names. See ibnetdiscover(8) for node name map file format. Only used with the -O and -U options.
Supported query names (and aliases):

 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]]
-d
enable debugging
-h
show help

 

AUTHORS

Ira Weiny
<weiny2@llnl.gov>
Hal Rosenstock
<halr@voltaire.com>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
AUTHORS

This document was created by man2html, using the manual pages.
Time: 22:02:18 GMT, April 16, 2011