smpquery (1m)

Name

smpquery - query InfiniBand subnet management attributes

Synopsis

smpquery  [-d(ebug)]  [-e(rr_show)] [-v(erbose)] [-D(irect)]
[-G(uid)] [-C ca_name] [-P ca_port] [-t(imeout)  timeout_ms]
[--node-name-map  node-name-map] [-V(ersion)] [-h(elp)] <op>
<dest dr_path|lid|guid> [op params]

Description

OpenIB Diagnostics                                   SMPQUERY(1m)



NAME
     smpquery - query InfiniBand subnet management attributes


SYNOPSIS
     smpquery  [-d(ebug)]  [-e(rr_show)] [-v(erbose)] [-D(irect)]
     [-G(uid)] [-C ca_name] [-P ca_port] [-t(imeout)  timeout_ms]
     [--node-name-map  node-name-map] [-V(ersion)] [-h(elp)] <op>
     <dest dr_path|lid|guid> [op params]


DESCRIPTION
     smpquery allows a  basic  subset  of  standard  SMP  queries
     including the following: node info, node description, switch
     info, port info. Fields are displayed in human readable for-
     mat.


OPTIONS
     Current supported operations and their parameters:
                  nodeinfo <addr>
                  nodedesc <addr>
                  portinfo  <addr> [<portnum>]     # default port
          is zero
                  switchinfo <addr>
                  pkeys <addr> [<portnum>]
                  sl2vl <addr> [<portnum>]
                  vlarb <addr> [<portnum>]
                  guids <addr>


     --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.


COMMON OPTIONS
     Most OpenIB diagnostics take the following common flags. The
     exact  list  of  supported flags per utility can be found in
     the usage message and can be shown using  the  util_name  -h
     syntax.

     # Debugging flags

     -d      raise the IB debugging level.
             May be used several times (-ddd or -d -d -d).

     -e      show send and receive errors (timeouts and others)

     -h      show the usage message




OpenIB             Last change: March 14, 2007                  1






OpenIB Diagnostics                                   SMPQUERY(1m)



     -v      increase the application verbosity level.
             May be used several times (-vv or -v -v -v)

     -V      show the version info.

     # Addressing flags

     -D      use directed path address arguments. The path
             is a comma separated list of out ports.
             Examples:
             "0"             # self port
             "0,1,2,1,4"     # out via port 1, then 2, ...

     -c      use combined route address arguments. The
             address is a combination of a LID and a direct route
     path.
             The LID specified is the DLID and the local  LID  is
     used
             as the DrSLID.

     -G       use GUID address argument. In most cases, it is the
     Port GUID.
             Example:
             "0x08f1040023"

     -s <smlid>      use 'smlid' as  the  target  lid  for  SM/SA
     queries.

     # Other common flags:

     -C <ca_name>    use the specified ca_name.

     -P <ca_port>    use the specified ca_port.

     -t   <timeout_ms>  override  the  default  timeout  for  the
     solicited mads.

     Multiple CA/Multiple Port Support

     When no IB device or port is specified, the port to  use  is
     selected by the following criteria:

     1. the first port that is ACTIVE.

     2.  if  not  found, the first port that is UP (physical link
     up).

     If a port and/or CA name is specified, the user  request  is
     attempted to be fulfilled, and will fail if it is not possi-
     ble.





OpenIB             Last change: March 14, 2007                  2






OpenIB Diagnostics                                   SMPQUERY(1m)



EXAMPLES
     smpquery portinfo 3 1        # portinfo by  lid,  with  port
     modifier

     smpquery -G switchinfo 0x2C9000100D051 1        # switchinfo
     by guid

     smpquery -D nodeinfo 0       # nodeinfo by direct route

     smpquery -c nodeinfo 6 0,12  # nodeinfo by combined route



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

     +---------------+----------------------+
     |ATTRIBUTE TYPE |   ATTRIBUTE VALUE    |
     +---------------+----------------------+
     |Availability   | network/open-fabrics |
     +---------------+----------------------+
     |Stability      | Volatile             |
     +---------------+----------------------+
SEE ALSO
     smpdump(1m)


AUTHOR
     Hal Rosenstock
          <halr@voltaire.com>



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',



OpenIB             Last change: March 14, 2007                  3






OpenIB Diagnostics                                   SMPQUERY(1m)



     '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: March 14, 2007                  4