Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

rds-ping (1)

Name

rds-ping - test reachability of remote node over RDS

Synopsis

rds-ping [-c count] [-Q tos] [-i interval] [-I local_addr]
remote_addr

Description

RDS-PING(1)                 General Commands Manual                RDS-PING(1)



NAME
       rds-ping - test reachability of remote node over RDS


SYNOPSIS

              rds-ping [-c count] [-Q tos] [-i interval] [-I local_addr]
                  remote_addr


DESCRIPTION
       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(8)
       utility, even though the way it works is pretty different.

       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.

OPTIONS
       The following options are available for use on the command line:

       -c count
              Causes rds-ping to exit after sending (and receiving) the speci-
              fied number of packets.

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

       -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 option, you  can  override
              this choice.

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

              Specifying a timeout considerably smaller than the packet round-
              trip time will produce unexpected results.


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



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | network/open-fabrics  |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+

NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source   was   downloaded   from    ['https://www.openfabrics.org/down-
       loads/ibutils/ibutils-1.5.7-0.2.gbd7e502.tar.gz', 'https://www.openfab-
       rics.org/downloads/libibverbs/libibverbs-1.1.8.tar.gz',
       'https://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.6.tar.gz',
       'https://www.openfabrics.org/downloads/libsdp/lib-
       sdp-1.1.108-0.15.gd7fdb72.tar.gz',   'https://www.openfabrics.org/down-
       loads/management/infiniband-diags-1.6.5.tar.gz',  'https://www.openfab-
       rics.org/downloads/management/libibmad-1.3.12.tar.gz',
       'https://www.openfabrics.org/downloads/management/libibu-
       mad-1.3.10.2.tar.gz',    'https://www.openfabrics.org/downloads/manage-
       ment/opensm-3.3.19.tar.gz',          'https://www.openfabrics.org/down-
       loads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'https://www.open-
       fabrics.org/downloads/qperf/qperf-0.4.9.tar.gz',  'https://www.openfab-
       rics.org/downloads/rdmacm/librdmacm-1.0.21.tar.gz',  'https://www.open-
       fabrics.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/.



                                 Apr 22, 2008                      RDS-PING(1)