1 .\" Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md
2 .TH "UDPONG" 1 "2017-04-28" "librdmacm" "librdmacm" librdmacm
4 udpong \- unreliable datagram streaming over RDMA ping-pong test.
8 \fIudpong\fR [-s server_address] [-b bind_address]
9 [-B buffer_size] [-C transfer_count]
10 [-S transfer_size] [-p server_port] [-T test_option]
13 Uses unreliable datagram streaming over RDMA protocol (rsocket) to
14 connect and exchange data between a client and server application.
18 The network name or IP address of the server system listening for
19 connections. The used name or address must route over an RDMA device.
20 This option must be specified by the client.
23 The local network address to bind to.
26 Indicates the size of the send and receive network buffers.
29 The number of messages to transfer from the client to the server and
30 back again on each iteration. (default 1000)
33 The size of each send transfer, in bytes. (default 1000)
36 The server's port number.
39 Specifies test parameters. Available options are:
41 s | socket - uses standard socket calls to transfer data
43 a | async - uses asynchronous operation (e.g. select / poll)
45 b | blocking - uses blocking calls
47 n | nonblocking - uses non-blocking calls
49 e | echo - server echoes all messages
51 Basic usage is to start udpong on a server system, then run
52 udpong -s server_name on a client system. udpong
53 will run a series of latency and bandwidth performance tests.
54 Specifying a different transfer_count or transfer_size
55 will run a user customized test using default values where none
58 Because this test maps RDMA resources to userspace, users must ensure
59 that they have available system resources and permissions. See the
60 libibverbs README file for additional details.