saquery (1m)

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

OpenIB Diagnostics                                    SAQUERY(1m)



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



OpenIB            Last change: October 19, 2008                 1






OpenIB Diagnostics                                    SAQUERY(1m)



     --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 ibnetdis-
          cover(1m) 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]]
           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






OpenIB            Last change: October 19, 2008                 2






OpenIB Diagnostics                                    SAQUERY(1m)



AUTHORS
     Ira Weiny
          <weiny2@llnl.gov>

     Hal Rosenstock
          <halr@voltaire.com>



ATTRIBUTES
     See   attributes(5)   for   descriptions  of  the  following
     attributes:

     +---------------+----------------------+
     |ATTRIBUTE TYPE |   ATTRIBUTE VALUE    |
     +---------------+----------------------+
     |Availability   | network/open-fabrics |
     +---------------+----------------------+
     |Stability      | Volatile             |
     +---------------+----------------------+
NOTES
     This  software  was   built   from   source   available   at
     https://java.net/projects/solaris-userland.    The  original
     community source was downloaded from   ['http://www.openfab-
     rics.org/downloads/ibutils/ibutils-1.5.7.tar.gz',
     'http://www.openfabrics.org/downloads/libibverbs/libib-
     verbs-1.1.4-1.22.g7257cd3.tar.gz',      'http://www.openfab-
     rics.org/down-
     loads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz',
     'http://www.openfabrics.org/downloads/libsdp/lib-
     sdp-1.1.108-0.15.gd7fdb72.tar.gz',      'http://www.openfab-
     rics.org/downloads/management/infiniband-
     diags-1.5.8.tar.gz',       'http://www.openfabrics.org/down-
     loads/management/libibmad-1.3.7.tar.gz',   'http://www.open-
     fabrics.org/downloads/management/libibumad-1.3.7.tar.gz',
     'http://www.openfabrics.org/downloads/manage-
     ment/opensm-3.3.9.tar.gz', 'http://www.openfabrics.org/down-
     loads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz',
     'http://www.openfabrics.org/down-
     loads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz',
     'http://www.openfabrics.org/downloads/rdmacm/librd-
     macm-1.0.14.1.tar.gz',     'http://www.openfabrics.org/down-
     loads/rds-tools/rds-tools-2.0.4.tar.gz']

     Further  information about this software can be found on the
     open  source  community   website   at   http://www.openfab-
     rics.org/.








OpenIB            Last change: October 19, 2008                 3