Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   14857 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SAQUERY(8)		      OpenIB Diagnostics		    SAQUERY(8)

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) [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]]

       -d     enable debugging

       -h     show help

FILES
       ib-node-name-map -- see ibnetdiscover for more information

       The node name map is used to specify user friendly names for  nodes  in
       the output.  Node GUIDs are used to perform the lookup.

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

AUTHORS
       Ira Weiny
	      <weiny2@llnl.gov>

       Hal Rosenstock
	      <halr@voltaire.com>

OpenIB				March 14, 2011			    SAQUERY(8)

Vote for polarhome