Current File : //usr/man/man1/rds-ping.1

'\" te
.TH RDS-PING 1 "Apr 22, 2008"
.SH NAME
rds-ping - test reachability of remote node over RDS

.SH SYNOPSIS
.HP
.nf
rds-ping [-c count] [-Q tos] [-i interval] [-I local_addr]
    remote_addr
.fi

.SH DESCRIPTION
.PP
rds-ping is used to test whether a remote node is reachable over RDS.
Its interface is designed to operate pretty much the standard ping(1M) 
utility, even though the way it works is pretty different.
.PP
rds-ping opens several RDS sockets and sends packets to port 0 on
the indicated host. This is a special port number to which
no socket is bound; instead, the kernel processes incoming
packets and responds to them.
.SH OPTIONS
The following options are available for use on the command line:
.PP
.TP 7
\fB\-c count
Causes rds-ping to exit after sending (and receiving) the specified number of
packets.
.TP
\fB\-Q tos
By default, rds-ping sends the ping requests on base (tos = 0) RDS connection.
With this option, the requests are sent on RDS connection with the specified tos
value.  Valid values are 0-255.
.TP
\fB\-I address
By default, rds-ping will pick the local source address for the RDS socket based
on routing information for the destination address (i.e. if
packets to the given destination would be routed through interface
ib0 ,
then it will use the IP address of
ib0
as source address).
Using the
.Fl I
option, you can override this choice.
.TP
\fB\-i timeout
By default, rds-ping will wait for one second between sending packets. Use this option
to specified a different interval. The timeout value is given in
seconds, and can be a floating point number. Optionally, append
msec
or
usec
to specify a timeout in milliseconds or microseconds, respectively.
.IP
Specifying a timeout considerably smaller than the packet round-trip
time will produce unexpected results.

.SH AUTHORS
rds-ping
was written by Olaf Kirch <olaf.kirch@oracle.com>.
.S~ SEE ALSO
rds 7, rds-info 1, rds-stress 1.


.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	network/open-fabrics
=
Stability	Volatile
.TE 
.PP

.SH NOTES

.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  ['http://download.oracle.com/otn-pub/oss/networking/libsif-1.0.tar.gz', 'http://www.openfabrics.org/downloads/ibutils/ibutils-1.5.7.tar.gz', 'http://www.openfabrics.org/downloads/libibverbs/libibverbs-1.1.4-1.22.g7257cd3.tar.gz', 'http://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz', 'http://www.openfabrics.org/downloads/libsdp/libsdp-1.1.108-0.15.gd7fdb72.tar.gz', 'http://www.openfabrics.org/downloads/management/infiniband-diags-1.5.8.tar.gz', 'http://www.openfabrics.org/downloads/management/libibmad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/management/libibumad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/management/opensm-3.3.9.tar.gz', 'http://www.openfabrics.org/downloads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'http://www.openfabrics.org/downloads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz', 'http://www.openfabrics.org/downloads/rdmacm/librdmacm-1.0.14.1.tar.gz', 'http://www.openfabrics.org/downloads/rds-tools/rds-tools-2.0.4.tar.gz']

Further information about this software can be found on the open source community website at http://www.openfabrics.org/.