ibstat(8) — Linux manual page

IBSTAT(8)                  Open IB Diagnostics                  IBSTAT(8)

NAME         top

       ibstat - query basic status of InfiniBand device(s)

SYNOPSIS         top

       ibstat [options] <ca_name> [portnum]

DESCRIPTION         top

       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         top

       -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

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

       -h, --help      show the usage message

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

       -V, --version     show the version info.

   Configuration flags
       --config, -z  <config_file> Specify alternate config file.
          Default:
          /ssd11/FOSS/rdma-core/build/etc/infiniband-diags/ibdiag.conf

EXAMPLES         top

          ibstat            # display status of all ports on all IB devices
          ibstat -l         # list all IB devices
          ibstat -p         # show port guids
          ibstat mthca0 2   # show status of port 2 of 'mthca0'

SEE ALSO         top

       ibstatus(8)

AUTHOR         top

       Hal Rosenstock
              <  <halr@voltaire.com>  >

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                                2017-08-21                      IBSTAT(8)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.