udpong(1) — Linux manual page


UDPONG(1)                       librdmacm                      UDPONG(1)

NAME         top

       udpong - unreliable datagram streaming over RDMA ping-pong test.

SYNOPSIS         top

       udpong [-s server_address] [-b bind_address]
                      [-B buffer_size] [-C transfer_count]
                      [-S transfer_size] [-p server_port] [-T test_option]

DESCRIPTION         top

       Uses unreliable datagram streaming over RDMA protocol (rsocket)
       to connect and exchange data between a client and server

OPTIONS         top

       -s server_address
              The network name or IP address of the server system
              listening for connections.  The used name or address must
              route over an RDMA device.  This option must be specified
              by the client.

       -b bind_address
              The local network address to bind to.

       -B buffer_size
              Indicates the size of the send and receive network

       -C transfer_count
              The number of messages to transfer from the client to the
              server and back again on each iteration.  (default 1000)

       -S transfer_size
              The size of each send transfer, in bytes.  (default 1000)

       -p server_port
              The server's port number.

       -T test_option
              Specifies test parameters.  Available options are:

       s | socket  - uses standard socket calls to transfer data

       a | async - uses asynchronous operation (e.g. select / poll)

       b | blocking - uses blocking calls

       n | nonblocking - uses non-blocking calls

       e | echo - server echoes all messages

NOTES         top

       Basic usage is to start udpong on a server system, then run
       udpong -s server_name on a client system.  udpong will run a
       series of latency and bandwidth performance tests.  Specifying a
       different transfer_count or transfer_size will run a user
       customized test using default values where none have been

       Because this test maps RDMA resources to userspace, users must
       ensure that they have available system resources and permissions.
       See the libibverbs README file for additional details.

SEE ALSO         top


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
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2023-06-23.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-06-14.)  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

librdmacm                      2017-04-28                      UDPONG(1)