Awesome
dtn7-rs
Rust implementation of a disruption-tolerant networking (DTN) daemon for the Bundle Protocol version 7 - RFC9171.
Plus:
- TCP Convergence Layer v4 - RFC9174
- Minimal TCP Convergence Layer
- A simple HTTP Convergence Layer
- A HTTP pull-based Convergence Layer
- A minimal UDP Convergence Layer (currently, without the extensions)
- An IP neighborhood discovery service
- Convenient command line tools to interact with the daemon
- A simple web interface for status information about
dtnd
- A web-socket interface for application agents
- Interfaces for external processes to provide routing strategies and convergence layers
The actual BP7 implementation (encoding/decoding) is available as a separate project.
Additional dtn extensions and a client library are also available.
Currently, a service discovery based on IPND but adapted to CBOR and BPv7, TCP, MTCP & HTTP CLs, sprayandwait/flooding/epidemic/static/sink-routing and restful/websocket command interfaces are implemented. Both addressing schemes, dtn as well as ipn are supported. Furthermore, some CLI tools are provided to easily integrate dtn7 into shell scripts.
Beware: This code is still under development and thus might change frequently.
Installation
Installation from source using cargo:
cargo install --bins --examples dtn7
In case of compilation issues, try adding --locked
to the command.
This will use the exact versions of all dependencies as used in our repository.
Precompiled binaries for common platforms can be found on GitHub.
Usage
In the following some of the commands shipped with dtn7 are listed. There is also a more in-depth getting started guide available.
Daemon
The main Bundle Protocol Agent dtnd
can be configured either through the CLI (dtnd --help
) or by providing a configuration file.
Command line options override configuration file settings if both are mixed.
The daemon does not fork into background but can be easily started as a background service by invoking it with the nohup
command and &
.
Example usage for node1 with epidemic routing, mtcp convergence layer and the default endpoint 'incoming':
$ dtnd -n node1 -r epidemic -C mtcp -e incoming
The same but with ipn addressing scheme and a default endpoint at 23.42:
$ dtnd -n 23 -r epidemic -C mtcp -e 42
Configuration can also happen via a config file. For an example take a look at examples/dtn7.toml.example.
Helpers
dtnquery
: Querying information fromdtnd
such as peers, bundles, nodeid, etc.dtnrecv
: A simple tool to check for new bundles on a specific endpoint, can be used for scripting.dtnsend
: A simple tool to send a bundle from a provided file or pipe, can be used for scripting.dtntrigger
: Automatic triggering of external binaries for incoming bundles, useful for advanced scripting.
Example Applications
A simple DTN echo service can be found under examples/dtnecho2.rs
.
This service automatically registers its endpoint and listens for any incoming bundles on the local /echo
endpoint or for ipn addresses on service number 7
.
Each bundle is sent back to its source with the same payload and lifetime, no delivery report is requested.
This service can be used together with examples/dtnping.rs
for connectivity tests.
Example Use-Cases
Under tests/
are several shell scripts for integration tests that also showcase how to use the different command line utilities.
Furthermore, under tests/clab
are more complex and dynamic tests that get executed in Docker and coreemu.
For pure docker compose scenarios you can take a look under tests/docker
.
More complex scenarios can be found in the dtn7 showroom.
Acknowledging this work
If you use this software in a scientific publication, please cite the following paper:
@INPROCEEDINGS{baumgaertner2019bdtn7,
author={L. {Baumgärtner} and J. {Höchst} and T. {Meuser}},
booktitle={2019 International Conference on Information and Communication Technologies for Disaster Management (ICT-DM)},
title={B-DTN7: Browser-based Disruption-tolerant Networking via Bundle Protocol 7},
year={2019},
volume={},
number={},
pages={1-8},
keywords={Protocols;Browsers;Software;Convergence;Servers;Synchronization;Wireless fidelity},
doi={10.1109/ICT-DM47966.2019.9032944},
ISSN={2469-8822},
month={Dec},
}
License
Licensed under either of <a href="LICENSE-APACHE">Apache License, Version 2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in dtn7-rs
by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.