.\" Man page generated from reStructuredText.

.

.TH IBPING 8 "" "" "Open IB Diagnostics"

.SH NAME

IBPING \- ping an InfiniBand address

.

.nr rst2man-indent-level 0

.

.de1 rstReportMargin

\\$1 \\n[an-margin]

level \\n[rst2man-indent-level]

level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]

-

\\n[rst2man-indent0]

\\n[rst2man-indent1]

\\n[rst2man-indent2]

..

.de1 INDENT

.\" .rstReportMargin pre:

. RS \\$1

. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]

. nr rst2man-indent-level +1

.\" .rstReportMargin post:

..

.de UNINDENT

. RE

.\" indent \\n[an-margin]

.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]

.nr rst2man-indent-level -1

.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]

.in \\n[rst2man-indent\\n[rst2man-indent-level]]u

..

.SH SYNOPSIS

.sp

ibping [options] <dest lid | guid>

.SH DESCRIPTION

.sp

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.

.SH OPTIONS

.sp

\fB\-c, \-\-count\fP

stop after count packets

.sp

\fB\-f, \-\-flood\fP

flood destination: send packets back to back without delay

.sp

\fB\-o, \-\-oui\fP

use specified OUI number to multiplex vendor mads

.sp

\fB\-S, \-\-Server\fP

start in server mode (do not return)

.SS Addressing Flags

.\" Define the common option -L

.

.sp

\fB\-L, \-\-Lid\fP   The address specified is a LID

.\" Define the common option -G

.

.sp

\fB\-G, \-\-Guid\fP     The address specified is a Port GUID

.\" Define the common option -s

.

.sp

\fB\-s, \-\-sm_port <smlid>\fP     use \(aqsmlid\(aq as the target lid for SA queries.

.SS Port Selection flags

.\" Define the common option -C

.

.sp

\fB\-C, \-\-Ca <ca_name>\fP    use the specified ca_name.

.\" Define the common option -P

.

.sp

\fB\-P, \-\-Port <ca_port>\fP    use the specified ca_port.

.\" Explanation of local port selection

.

.SS Local port Selection

.sp

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:

.INDENT 0.0

.INDENT 3.5

.INDENT 0.0

.IP 1. 3

the first port that is ACTIVE.

.IP 2. 3

if not found, the first port that is UP (physical link up).

.UNINDENT

.sp

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.

.sp

For example:

.INDENT 0.0

.INDENT 3.5

.sp

.nf

.ft C

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.

.ft P

.fi

.UNINDENT

.UNINDENT

.UNINDENT

.UNINDENT

.SS Configuration flags

.\" Define the common option -z

.

.sp

\fB\-\-config, \-z  <config_file>\fP Specify alternate config file.

.INDENT 0.0

.INDENT 3.5

Default: /usr/local/etc/infiniband-diags/ibdiag.conf

.UNINDENT

.UNINDENT

.\" Define the common option -t

.

.sp

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

.SS Debugging flags

.\" Define the common option -h

.

.sp

\fB\-h, \-\-help\fP      show the usage message

.\" Define the common option -d

.

.INDENT 0.0

.TP

.B \-d

raise the IB debugging level.

May be used several times (\-ddd or \-d \-d \-d).

.UNINDENT

.\" Define the common option -e

.

.INDENT 0.0

.TP

.B \-e

show send and receive errors (timeouts and others)

.UNINDENT

.\" Define the common option -v

.

.INDENT 0.0

.TP

.B \fB\-v, \-\-verbose\fP

increase the application verbosity level.

May be used several times (\-vv or \-v \-v \-v)

.UNINDENT

.\" Define the common option -V

.

.sp

\fB\-V, \-\-version\fP     show the version info.

.SH FILES

.\" Common text for the config file

.

.SS CONFIG FILE

.sp

/usr/local/etc/infiniband-diags/ibdiag.conf

.sp

A global config file is provided to set some of the common options for all

tools.  See supplied config file for details.

.SH AUTHOR

.INDENT 0.0

.TP

.B Hal Rosenstock

< \fI\%halr@voltaire.com\fP >

.UNINDENT

.\" Generated by docutils manpage writer.

.