viveris / dvb_gse_tunnel

dvb_gse_tunnel

A tunnel that connects two tap interfaces through udp using the gse protocol.

Directory	Description
c	Source code written in C to perform a GSE tunnel
rust	Source code written in Rust to perform a GSE tunnel
rust_testimonial	Source code written in Rust to perform a transparent tunnel, to measure the TUNTAP impact

Requirements

Before using this software, ensure you have the following prerequisites installed on your system:

• Cargo and Rust: Ensure you have Cargo, the Rust package manager, and the Rust compiler installed. You can install them by following the instructions on the official Rust website.

• GCC: Ensure you have GCC (GNU Compiler Collection) installed on your system. You can typically install GCC through your system's package manager.

• aclocal: This software requires aclocal to be installed on your system. You can typically install aclocal as part of the GNU Autoconf package. On Debian-based systems, you can install it by running

  • sudo apt-get install autoconf

• libgse (language C): You also need the C libgse. Follow these instructions to install it.

  • First, you need to add the Net4Sat repository GPG Key:

    • sudo mkdir /etc/apt/keyrings

    • curl -sS https://raw.githubusercontent.com/CNES/net4sat-packages/master/gpg/net4sat.gpg.key | gpg --dearmor | sudo dd of=/etc/apt/keyrings/net4sat.gpg

  • Then, update sources.list with net4sat opensand repository

    • cat << EOF | sudo tee /etc/apt/sources.list.d/github.net4sat.sources
      Types: deb
      URIs: https://raw.githubusercontent.com/CNES/net4sat-packages/master/jammy/
      Suites: jammy
      Components: stable
      Signed-By: /etc/apt/keyrings/net4sat.gpg
      EOF

  • Then you can install the libgse using :

    • sudo apt update
      

    • sudo apt install libgse-dev
      

• iperf3: iperf3 is a tool for measuring the maximum TCP and UDP bandwidth performance. You can typically install iperf3 through your system's package manager

  • sudo apt install iperf3

Compile

C

host$ cd c
host$ ./autogen.sh
host$ make

Rust

host$ cd rust
host$ cargo build --release

Testbed

The scripts to handle the testbed are stored in the testbed directory.

Using network namespaces

This testbed uses 2 network namespaces on a host, connected by 2 veth pairs of interfaces:

• one for the forward link (the encapsulated one);
• one for the return link.

To set up this testbed:

host$ sudo ./testbed/testbed-netns.sh setup

To clean up this testbed:

host$ sudo ./testbed/testbed-netns.sh cleanup

To start the encapsulation binaries of this testbed:

host$ sudo ./testbed/testbed-netns.sh start BIN_DIR

where BIN_DIR can be:

• c/src/tap_udp
• rust/target/release
• rust_testimonial/target/release
• other...

To stop the encapsulation binaries of this testbed:

host$ sudo ./testbed/testbed-netns.sh stop

Once the testbed is set up and started, tests can be performed:

• ping

host$ sudo ip netns exec encap_tx ping -I 10.0.0.254 -c 4 10.0.0.1
host$ sudo ip netns exec encap_rx ping -I 10.0.0.1 -c 4 10.0.0.254

• iperf3

host$ sudo ip netns exec encap_rx iperf3 -B 10.0.0.1 -s
host$ sudo ip netns exec encap_tx iperf3 -B 10.0.0.254 -c 10.0.0.1 -ub 500M

Using hosts

This testbed uses 2 hosts, connected on the same network.

To set up this testbed:

host1$ sudo ./testbed/testbed-host-encap.sh setup IFACE1

host2$ sudo ./testbed/testbed-host-decap.sh setup IFACE2

where IFACE1 is the network interface of the host 1 and IFACE2 is the one of the host 2 used to connect them together.

To clean up this testbed:

host1$ sudo ./testbed/testbed-host-encap.sh cleanup

host2$ sudo ./testbed/testbed-host-decap.sh cleanup

To start the encapsulation binaries of this testbed:

host1$ sudo ./testbed/testbed-host-encap.sh start BIN_DIR

host2$ sudo ./testbed/testbed-host-decap.sh start BIN_DIR

where BIN_DIR can be:

• c/src/tap_udp
• rust/target/release
• rust_testimonial/target/release
• other...

To stop the encapsulation binaries of this testbed:

host1$ sudo ./testbed/testbed-host-encap.sh stop

host2$ sudo ./testbed/testbed-host-decap.sh stop

Once the testbed is set up and started, tests can be performed:

• ping

host1$ ping -I 10.0.0.254 -c 4 10.0.0.1
host2$ ping -I 10.0.0.1 -c 4 10.0.0.254

• iperf3

host2$ iperf3 -B 10.0.0.1 -s
host1$ iperf3 -B 10.0.0.254 -c 10.0.0.1 -ub 500M