hairgap is a set of tools to transfer data over a unidirectional network link
(typically a network diode). It uses catid's wirehair
(https://github.com/catid/wirehair) librairy for error correction and is written
to handle high bandwith transfers (> 200 MB/s).
It is meant to be a mere transport on a dedicated, safe link: no authentication nor encryption is guaranteed, although there is a work in progress on this matter.
This should be considered alpha quality, any bug report will be very welcome.
Before anything, to make high bandwith transfers work properly on a linux machine, you might want to change at least these system options on the receiver side:
net.core.rmem_max=67108864 # at least 4MB, 64MB is fine
net.core.rmem_default=67108864 # equal to net.core.rmem_max (if you dare)
net.core.netdev_max_backlog=10000 # works fine
and
net.ipv4.udp_rmem # multiply all three values by 32
Or, on newer kernels:
net.ipv4.udp_mem="49314528 65752736 3082158"
To use, on the receiver side first:
$ hairgapr LISTENING_IP > OUTPUT_FILEThen, on the sender side:
$ hairgaps RECEIVER_IP < INPUT_FILEsee hairgap[sr] -h for various options. For very reliable transfers on
machines with a fast CPU, I would suggest -N 30000 -r 1.5, which sets a
relatively high redundancy (+50% of redundant data) and big redundancy blocks
for a better resistance to loss bursts (N=30000).
Note that a static ARP entry for RECEIVER_IP must be provided for hairgaps
to work properly. One way to achieve this is as follows:
# arp -s 10.0.0.1 aa:bb:cc:00:01:02Compilation has only been tested on linux.
Note: you should either git clone --recursive or
git submodules --init --update to retrieve submodules.
$ make# make installTesting properly will require you to set the aforementioned sysctls. Note
that the tests can currently deadlock, try to restart them. This is another
FIXME. More tests are on their way.
$ make testHairgap implements its own, very simple protocol. Its documentation is on its way too.
See hairgap.h first, it will give you pointers.