---
name: "riostream"
section: "1"
platform: "linux"
package: "rdma-core"
version: "65.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/riostream"
---

# riostream(1)

zero-copy streaming over RDMA ping-pong test.

## NAME

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

## SYNOPSIS

```
riostream [-s server_address] [-b bind_address] [-B buffer_size]
			[-I iterations] [-C transfer_count]
			[-S transfer_size] [-p server_port] [-T test_option]
```

## DESCRIPTION

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

## OPTIONS

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

- \-I iterations

  The number of times that the specified number of messages will be exchanged between the client and server.  (default 1000)

- \-C transfer\_count

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

- \-S transfer\_size

  The size of each send transfer, in bytes.  (default 1000)  If 'all' is specified, rstream will run a series of tests of various sizes.

- \-p server\_port

  The server's port number.

- \-T test\_option

  Specifies test parameters.  Available options are:

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

b \| blocking - uses blocking calls

n \| nonblocking - uses non-blocking calls

v \| verify - verifies data transfers

## NOTES

Basic usage is to start riostream on a server system, then run riostream -s server\_name on a client system.  By default, riostream will run a series of latency and bandwidth performance tests. Specifying a different iterations, transfer\_count, or transfer\_size will run a user customized test using default values where none have been specified.

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

[rdma\_cm(7)](/rdma_cm/7.md) [rstream(1)](/rstream/1.md)