1RIOSTREAM(1) librdmacm RIOSTREAM(1)
2
3
4
6 riostream - zero-copy streaming over RDMA ping-pong test.
7
9 riostream [-s server_address] [-b bind_address] [-B buffer_size]
10 [-I iterations] [-C transfer_count]
11 [-S transfer_size] [-p server_port] [-T test_option]
12
14 Uses the streaming over RDMA protocol (rsocket) to connect and exchange
15 data between a client and server application.
16
18 -s server_address
19 The network name or IP address of the server system listening
20 for connections. The used name or address must route over an
21 RDMA device. This option must be specified by the client.
22
23 -b bind_address
24 The local network address to bind to.
25
26 -B buffer_size
27 Indicates the size of the send and receive network buffers.
28
29 -I iterations
30 The number of times that the specified number of messages will
31 be exchanged between the client and server. (default 1000)
32
33 -C transfer_count
34 The number of messages to transfer from the client to the server
35 and back again on each iteration. (default 1)
36
37 -S transfer_size
38 The size of each send transfer, in bytes. (default 1000) If
39 'all' is specified, rstream will run a series of tests of vari‐
40 ous sizes.
41
42 -p server_port
43 The server's port number.
44
45 -T test_option
46 Specifies test parameters. Available options are:
47
48 a | async - uses asynchronous operation (e.g. select / poll)
49
50 b | blocking - uses blocking calls
51
52 n | nonblocking - uses non-blocking calls
53
54 v | verify - verifies data transfers
55
57 Basic usage is to start riostream on a server system, then run
58 riostream -s server_name on a client system. By default, riostream
59 will run a series of latency and bandwidth performance tests. Specify‐
60 ing a different iterations, transfer_count, or transfer_size will run a
61 user customized test using default values where none have been speci‐
62 fied.
63
64 Because this test maps RDMA resources to userspace, users must ensure
65 that they have available system resources and permissions. See the
66 libibverbs README file for additional details.
67
69 rdma_cm(7) rstream(1)
70
71
72
73librdmacm 2012-10-24 RIOSTREAM(1)