UDP Example: socat

socat is a command line based utility that establishes two bidirectional byte streams and transfers data between them. This makes it a great test application for Rely.

Note

For more information about socat, you can read the socat manpage, or this friendly introduction.

On Ubuntu socat can be installed with the following command:

sudo apt install socat

Receiver (10.0.0.1)

application:

socat -d -d - udp-recv:9999

tunnel:

./rely udp --application-out 127.0.0.1:9999 --tunnel-in  10.0.0.1:43321

Sender (10.0.0.2)

tunnel:

./rely udp --application-in 127.0.0.1:8888 --tunnel-out 10.0.0.1:43321

application:

socat -d -d - udp-sendto:127.0.0.1:8888

You should now be able to write a message in the Sender‘s socat terminal and have it appear in the Receiver‘s socat terminal.

Note

this example can also be run on a single host by using 127.0.0.1 as IP for tunnel-in and tunnel-out.