ibtracert (1m)

Name

Synopsis

ibtracert  [-d(ebug)]  [-v(erbose)]  [-G(uids)] [-n(o_info)]
[-m mlid] [-s smlid] [-C ca_name] [-P  ca_port]  [-t(imeout)
timeout_ms]  [-V(ersion)] [--node-name--map <node-name-map>]
[-h(elp)] [<lid|guid> [<startlid> [<endlid>]]]

Description

OpenIB Diagnostics                                  IBTRACERT(1m)



NAME
     ibtracert- trace InfiniBand path


SYNOPSIS
     ibtracert  [-d(ebug)]  [-v(erbose)]  [-G(uids)] [-n(o_info)]
     [-m mlid] [-s smlid] [-C ca_name] [-P  ca_port]  [-t(imeout)
     timeout_ms]  [-V(ersion)] [--node-name--map <node-name-map>]
     [-h(elp)] [<lid|guid> [<startlid> [<endlid>]]]


DESCRIPTION
     ibtracert uses SMPs to trace the path from a source  GID/LID
     to  a  destination  GID/LID. Each hop along the path is dis-
     played until the destination is reached or a  hop  does  not
     respond.  By using the -m option, multicast path tracing can
     be performed between source and destination nodes.


OPTIONS
     -n, --no_info
          simple format; don't show additional information

     -m   show the multicast trace of the specified mlid

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

     -h      show the usage message

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

     -V      show the version info.

     # Addressing flags





OpenIB           Last change: September 14, 2010                1






OpenIB Diagnostics                                  IBTRACERT(1m)



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


EXAMPLES
     Unicast examples

     ibtracert 4 16              # show path between lids  4  and
     16

     ibtracert  -n 4 16           # same, but using simple output
     format

     ibtracert -G 0x8f1040396522d 0x002c9000100d051  #  use  guid
     addresses


     Multicast example

     ibtracert  -m  0xc000  4 16    # show multicast path of mlid
     0xc000 between lids 4 and 16






OpenIB           Last change: September 14, 2010                2






OpenIB Diagnostics                                  IBTRACERT(1m)



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

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


AUTHOR
     Hal Rosenstock
          <hal.rosenstock@gmail.com>

     Ira Weiny
          <weiny2@llnl.gov>



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: September 14, 2010                3