ibcheckerrs(8) — Linux manual page

IBCHECKERRS(8)              OpenIB Diagnostics             IBCHECKERRS(8)

NAME         top

       ibcheckerrs - validate IB port (or node) and report errors in
       counters above threshold

SYNOPSIS         top

       ibcheckerrs [-h] [-b] [-v] [-G] [-T <threshold_file>]
       [-s(how_thresholds)] [-N | -nocolor] [-C ca_name] [-P ca_port]
       [-t(imeout) timeout_ms] <lid|guid> <port>

DESCRIPTION         top

       Check specified port (or node) and report errors that surpassed
       their predefined threshold. Port address is lid unless -G option
       is used to specify a GUID address. The predefined thresholds can
       be dumped using the -s option, and a user defined threshold_file
       (using the same format as the dump) can be specified using the -t
       <file> option.

OPTIONS         top

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

       -s      show predefined thresholds

       -T      use specified threshold file

       -v      increase the verbosity level

       -b      brief mode. Reduce the output to show only if errors are
               present, not what they are.

       -N | -nocolor use mono rather than color mode

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

EXAMPLE         top

       ibcheckerrs 2           # check aggregated node counter for lid 2

       ibcheckerrs 2   4       # check port counters for lid 2 port 4

       ibcheckerrs -T xxx 2    # check node using xxx threshold file

SEE ALSO         top

       perfquery(8), ibaddr(8)

AUTHOR         top

       Hal Rosenstock
              <[email protected]>

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
       [email protected].  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
       [email protected]

OpenIB                         May 30, 2007                IBCHECKERRS(8)

Pages that refer to this page: ibcheckerrors(8),  ibchecknet(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.