1RIOSTREAM(1)                       librdmacm                      RIOSTREAM(1)
2
3
4

NAME

6       riostream - zero-copy streaming over RDMA ping-pong test.
7

SYNOPSIS

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

DESCRIPTION

14       Uses the streaming over RDMA protocol (rsocket) to connect and exchange
15       data between a client and server application.
16

OPTIONS

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

NOTES

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

SEE ALSO

69       rdma_cm(7) rstream(1)
70
71
72
73librdmacm                         2012-10-24                      RIOSTREAM(1)
Impressum