ibstat (1m)

名称

ibstat - query basic status of InfiniBand device(s)

用法概要

ibstat [-d(ebug)] [-l(ist_of_cas)] [-s(hort)] [-p(ort_list)]
[-V(ersion)] [-h] <ca_name> [portnum]

描述

OpenIB Diagnostics                                     IBSTAT(1m)



NAME
     ibstat - query basic status of InfiniBand device(s)


SYNOPSIS
     ibstat [-d(ebug)] [-l(ist_of_cas)] [-s(hort)] [-p(ort_list)]
     [-V(ersion)] [-h] <ca_name> [portnum]


DESCRIPTION
     ibstat is a binary which displays basic information obtained
     from  the  local IB driver. Output includes LID, SMLID, port
     state, link width active, and port physical state.

     It is similar to the ibstatus utility but implemented  as  a
     binary  rather  than  a  script.  It has options to list CAs
     and/or ports and displays more information than ibstatus.


OPTIONS
     -l, --list_of_cas
          list all IB devices

     -s, --short
          short output

     -p, --port_list
          show port list

     ca_name
          InfiniBand device name

     portnum
          port number of InfiniBand device


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: July 25, 2006                  1






OpenIB Diagnostics                                     IBSTAT(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, ...

     -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
     ibstat            # display status of all ports  on  all  IB
     devices

     ibstat -l         # list all IB devices





OpenIB              Last change: July 25, 2006                  2






OpenIB Diagnostics                                     IBSTAT(1m)



     ibstat -p         # show port guids

     ibstat mthca0 2   # show status of port 2 of 'mthca0'



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

     +---------------+----------------------+
     |ATTRIBUTE TYPE |   ATTRIBUTE VALUE    |
     +---------------+----------------------+
     |Availability   | network/open-fabrics |
     +---------------+----------------------+
     |Stability      | Volatile             |
     +---------------+----------------------+
SEE ALSO
     ibstatus(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',
     '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



OpenIB              Last change: July 25, 2006                  3






OpenIB Diagnostics                                     IBSTAT(1m)



     open  source  community   website   at   http://www.openfab-
     rics.org/.





















































OpenIB              Last change: July 25, 2006                  4