README
¶
dtn7-go 
Delay-Tolerant Networking software suite and library based on the Bundle Protocol Version 7.
Protocols
This software implements the current draft of the seventh version of the Bundle Protocol and the MTCP Convergence Layer to exchange bundles between nodes.
- Bundle Protocol Version 7 (draft-ietf-dtn-bpbis-14.txt)
- Minimal TCP Convergence-Layer Protocol (draft-ietf-dtn-mtcpcl-01.txt)
Software
Installation
Install the Go programming language, version 1.11 or later.
git clone https://github.com/dtn7/dtn7-go.git
cd dtn7-go
go build ./cmd/dtncat
go build ./cmd/dtnd
dtnd
dtnd is a delay-tolerant networking daemon. It represents a node inside the
network and is able to transmit, receive and forward bundles to other nodes. A
node's neighbors may be specified in the configuration or detected within the
local network through a peer discovery. Bundles might be sent and received
through a REST-like web interface. The features and their configuration is
described inside the provided example
configuration.toml.
REST-API usage
The API might be used with the dtncat program or by plain HTTP requests.
# Create a outbounding bundle to dtn:host, containing "hello world"
# Payload must be base64 encoded
curl -d "{\"Destination\":\"dtn:host\", \"Payload\":\"`base64 <<< "hello world"`\"}" http://localhost:8080/send/
# Fetch received bundles. Payload is base64 encoded.
curl http://localhost:8080/fetch/
dtncat
dtncat is a companion tool for dtnd and allows both sending and receiving bundles through dtnd's REST-API.
$ ./dtncat help
dtncat [send|fetch|help] ...
dtncat send REST-API ENDPOINT-ID
sends data from stdin through the given REST-API to the endpoint
dtncat fetch REST-API
fetches all bundles from the given REST-API
Examples:
dtncat send "http://127.0.0.1:8080/" "dtn:alpha" <<< "hello world"
dtncat fetch "http://127.0.0.1:8080/"
Go Library
Multiple parts of this software are usable as a Go library. The bundle
package contains code for bundle modification, serialization and
deserialization and would most likely the most interesting part. If you are
interested in working with this code, check out the
documentation.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package bundle provides a library for interaction with Bundles as defined in the Bundle Protocol Version 7 (draft-ietf-dtn-bpbis-14.txt).
|
Package bundle provides a library for interaction with Bundles as defined in the Bundle Protocol Version 7 (draft-ietf-dtn-bpbis-14.txt). |
|
arecord
Package arecord includes an abstration for administrative records, as defined in the Bundle Protocol.
|
Package arecord includes an abstration for administrative records, as defined in the Bundle Protocol. |
|
Package cla defines two interfaces for convergence layers.
|
Package cla defines two interfaces for convergence layers. |
|
mtcp
Package mtcp provides a library for the Minimal TCP Convergence-Layer Protocol as defined in draft-ietf-dtn-mtcpcl-01 Because of the unidirectional design of MTCP, both MTPCServer and MTCPClient exists.
|
Package mtcp provides a library for the Minimal TCP Convergence-Layer Protocol as defined in draft-ietf-dtn-mtcpcl-01 Because of the unidirectional design of MTCP, both MTPCServer and MTCPClient exists. |
|
cmd
|
|
|
dtncat
command
|
|
|
dtnd
command
|
|
|
dtnsend
command
|
|
|
Package core represents a bundle node's router and contains both the bundle protocol agent and application agent.
|
Package core represents a bundle node's router and contains both the bundle protocol agent and application agent. |
|
Package discovery contains code for peer/neighbor discovery of other DTN nodes through UDP multicast packages.
|
Package discovery contains code for peer/neighbor discovery of other DTN nodes through UDP multicast packages. |