rds-gen1
Write data from a file to an rds socket rds-sink – write data from an rds socket to a file
Usage
rds-gen [-s
source_address:source_port]
[-d
destination_address:destination_port]
[-f
input_file]
[-m
message_size]
[-l
total_bytes]
[-i
interval]
rds-sink [-s
listen_address:listen_port]
[-f
output_file]
[-i
interval]
Overview
The rds-gen and rds-sink utilities are used to stream data through RDS sockets. rds-gen reads data from a file descriptor and sends it as messages down an RDS socket. rds-sink receives messages from an RDS socket and writes it to a file descriptor.
The following options are shared between rds-gen and rds-sink:
-
-s address:port -
Binds the RDS socket to the given address and port. rds-gen will send messages from this address and port. rds-sink will receive messages sent to this address and port.
-
-f file -
rds-gen will read data from this file and rds-sink will write data to this file. If '-' is given as the filename then rds-gen will use standard input and rds-sink will use standard output.
-
-i interval_seconds -
An iterative summary of the number and size of messages that are sent and received is written to standard error at this interval.
In addition, rds-gen supports the following options:
-
-d address:port -
Messages are sent to this destination address and port. If this option is specified multiple times then the messages are sent to each destination address in a round-robin fashion.
-
-m message_size -
Specifies the size of the messages that are sent down the RDS socket. The default message size is 4k. The message size must not be greater than the buffer size.
-
-l total_bytes -
Specifies the number of bytes that will be sent out the socket before rds-gen exits. If this is not specified and rds-gen was given a source file then it will run until it gets EOF from the file. If no file was given and this option is not specified then rds-gen will send data indefinitely.
Examples
rds-gen on host src sends infinite data to rds-sink on dest who prints out the amount of data it receives every second.
$ rds-sink -s dest:22222 -i 1
$ rds-gen -s src:11111 -d dest:22222
Read 100M from /dev/zero on src and write it to /dev/null on dest, printing stats on both sides every minute.
$ rds-sink -s dest:22222 -f /dev/null -i 60
$ rds-gen -s src:11111 -f /dev/zero -d dest:22222 -i 60
Watch rds-gen write data as fast as it can into a local black hole because there is no bound receiving socket.
$ rds-gen -s src:11111 -d localhost:31337 -i 1
Releases
Unchanged in 2 releases since Debian 6.0 (Squeeze).