Documentation

cmd/dtnd/configuration.toml

@@ -110,7 +110,7 @@ endpoint = ":4556"
 
 # Specify routing algorithm
 [routing]
-# One of  "epidemic", "spray", "binary_sparay", "dtlsr", "prophet", "sensor-mule"
+# One of  ["epidemic", "spray", "binary_spray", "dtlsr", "prophet", "sensor-mule"]
 algorithm = "epidemic"
 
 

docs/agents.md

@@ -0,0 +1,17 @@
+<!--
+SPDX-FileCopyrightText: 2021 Markus Sommer
+
+SPDX-License-Identifier: GPL-3.0-or-later
+-->
+
+# Application Agents
+
+## Web Server
+
+### REST-interface
+
+Specify the endpoints
+
+### WebSockets-interface
+
+Same here

docs/config.md

@@ -0,0 +1,73 @@
+<!--
+SPDX-FileCopyrightText: 2021 Markus Sommer
+
+SPDX-License-Identifier: GPL-3.0-or-later
+-->
+
+# Daemon Configuration
+
+Here, we'll go over the [sample config-file](https://github.com/dtn7/dtn7-go/blob/master/cmd/dtnd/configuration.toml) and explain the available options in-depth.
+
+## [core]
+
+### store
+
+Path to the on-disk store used to persis bundles, may be either a relative or absolute path.
+
+The store consist of a [badgerhold](https://github.com/timshannon/badgerhold) database for metadata, the bundle contents are written directly to disk.
+
+### inspect-all-bundles
+
+Hell if I know what that does....
+
+### node-id
+
+Public name of the node. Will be set as the default Endoint id for all CLAs, unless a different one has been speified.
+
+According to the [standard](https://tools.ietf.org/html/draft-ietf-dtn-bpbis-31#section-4.2.5.1.1), your ID should be:
+
+- `dtn:none`, if you are actually nothing
+- `dtn://` + the actual name + `/` <- for a unicast enpoint
+- `dtn://~` + the name of your multicast group + `/`  <- for something that is not a unicast enpoint (it does not neccessarily have to be a multicast group, but that's the only use case I can think off the top of my head)
+
+You might also use the [other](https://tools.ietf.org/html/draft-ietf-dtn-bpbis-31#section-4.2.5.1.2) adressing scheme, but we can't guarantee that such behaviour won't lead to death and/or dismemberment.
+
+## [logging]
+
+## [discovery]
+
+## [agents]
+
+## [[listen]]
+
+## [[peer]]
+
+## [routing]
+
+Select the routing algorithm, you can choose on from the list `["epidemic", "spray", "binary_spray", "dtlsr", "prophet", "sensor-mule"]`
+
+### epidemic
+
+*Epidemic Routing* is the simplest delay-tolerant routing algorithm.
+Alls bundles are always sent to all peers, which gives the best delivery probabilty, but also the highest overhead.
+Note that `dtnd` keeps track of peers who have already been sent a specific bundle, so each bundle should nly be forwarded to each peer once.
+
+### spray
+
+The *Spray & Wait* routing algorithm.
+
+### binary_spray
+
+The *Binary Spray & Wait* routing algorithm.
+
+### dtlsr
+
+The *Delay-Tolerant Link-State Routing* algorithm.
+
+### prophet
+
+The *PRoPHET* routing algorithm.
+
+### sensor-mule
+
+For dtn over equine carriers.

docs/dtn-tool.md

@@ -0,0 +1,7 @@
+<!--
+SPDX-FileCopyrightText: 2021 Markus Sommer
+
+SPDX-License-Identifier: GPL-3.0-or-later
+-->
+
+# Use the `dtn-tool` or die trying

docs/index.md

@@ -0,0 +1,18 @@
+<!--
+SPDX-FileCopyrightText: 2021 Markus Sommer
+
+SPDX-License-Identifier: GPL-3.0-or-later
+-->
+
+# dtn7-go Documentation
+
+Here be dragons.
+
+## Contents
+
+| Topic                           | Description                                                             |
+|:--------------------------------|:------------------------------------------------------------------------|
+| [Installation](install.md)      | Instructions for manual & automatic installations                       |
+| [Configuration](config.md)      | Explanation of the `dtnd` configuration options                         |
+| [Application Agents](agents.md) | APIs of the provided *Application Agents*                               |
+| [dtn-tool](dtn-tool.md)         | How to use use the dtn tool, because it's not really all that intuitive |

docs/install.md

@@ -0,0 +1,58 @@
+<!--
+SPDX-FileCopyrightText: 2021 Markus Sommer
+
+SPDX-License-Identifier: GPL-3.0-or-later
+-->
+
+# Installation Instructions
+
+## Manual
+
+- Install the *Go Programming language*, either through your package manager, or from [here](https://golang.org/dl/).
+- Clone the [source repository](https://github.com/dtn7/dtn7-go).
+- Check out the most recent release tag. Or don't and just build the `HEAD`, but we don't promise that it won't be broken.
+- (Optional) Run `GO111MODULE=on go test ./...` in the repository root to make sur we didn't screw up too badly.
+- Run `GO111MODULE=on go build ./...` in the repositry root to build both `dtnd` and `dtn-tool`
+
+If you want to run `dtnd` as a service, you might also want to do the following:
+
+- Put the config-file (`cmd/dtnd/configuration.toml`) in `/etc/dtn7`
+- Put the systemd-service (`contrib/systemd/service/dtn7.service`) in `/etc/systemd/system`
+- Probably run `systemctl daemon-reload` for good measure
+- Create the working directory `/var/lib/dtn7`
+- Create a `dtn7` user like this: `sudo useradd -r -s /sbin/nologin -d /var/lib/dtn7 dtn7`
+- Set ownership of the working directory `chown dtn7:dtn7 /var/lib/dtn7`
+- Start the service: `systemctl start dtn7`
+
+If you install the arch-package, we do all of that for you.
+
+## Automatic
+
+For some select platforms, packages are provided. (Footnote: ''select'' in this case means those platforms that don't make it 
+prohibitively complicated to package for them - looking at you, Debian)
+
+### NixOS
+
+If you're the kind of person who uses Nix, I assume you know how to install software on your system.
+Because I most certainl don't.
+
+### Arch Linux
+
+Install it from the [AUR](https://aur.archlinux.org/packages/dtn7) either manually, or using your favourite aur-helper.
+
+The package also installs the config file & systemd-service.
+Also takes care of directory & user creation.
+
+Start daemon using `systemctl start dtn7`
+
+### Other Linux
+
+We would like to provide packages for all distributions, however we're not really sure how.
+Attempts at using the *Open SUSE Build Service* were unsuccessfull, since the build VMs don't have internet access and therefore can't get the dependencies from `go.mod`.
+
+If you know how to (automatically) build and packe go applications for other distros, please contact us.
+
+### MacOS
+
+Use [brew](https://github.com/jonashoechst/homebrew-hoechst/blob/master/dtn7.rb), I guess.
+If there's anything special about doing it, someone should probably describe that here.