ibping(8) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| OPTIONS \| FILES \| AUTHOR \| COLOPHON

IBPING(8)                  Open IB Diagnostics                  IBPING(8)

NAME top

       IBPING - ping an InfiniBand address

SYNOPSIS top

       ibping [options] <dest lid | guid>

DESCRIPTION top

       ibping uses vendor mads to validate connectivity between IB nodes.
       On exit, (IP) ping like output is show. ibping is run as
       client/server.  Default is to run as client. Note also that a
       default ping server is implemented within the kernel.

OPTIONS top

-c, --count stop after count packets

-f, --flood flood destination: send packets back to back without
delay

-o, --oui use specified OUI number to multiplex vendor mads

-S, --Server start in server mode (do not return)

Addressing Flags
-L, --Lid The address specified is a LID

-G, --Guid The address specified is a Port GUID

-s, --sm_port <smlid> use 'smlid' as the target lid for SA
queries.

Port Selection flags
-C, --Ca <ca_name> use the specified ca_name.

-P, --Port <ca_port> use the specified ca_port.

Local port Selection
Multiple port/Multiple CA support: when no IB device or port is
specified (see the "local umad parameters" below), the libibumad
library selects the port to use 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 libibumad library
attempts to fulfill the user request, and will fail if it is
not possible.

For example:

ibaddr # use the first port (criteria #1 above)
ibaddr -C mthca1 # pick the best port from "mthca1" only.
ibaddr -P 2 # use the second (active/up) port from the first available IB device.
ibaddr -C mthca0 -P 2 # use the specified port only.

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

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

Debugging flags
-h, --help show the usage message

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

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

-V, --version show the version info.

FILES top

   CONFIG FILE
       /ssd11/FOSS/rdma-core/build/etc/infiniband-diags/ibdiag.conf

       A global config file is provided to set some of the common options
       for all tools.  See supplied config file for details.

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]

                                2012-05-14                      IBPING(8)