Even if this uses a secure connection, piping stuff returned by `curl`
into an interpreter is bad practice and can lead to security problems.
We now assume that `pip` and `setuptools` are installed on the target
system, which is reasonable IMO.
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
This moves the commands to install up-to-date versions of all
Python dependencies to the `update-virtualenv` target, so it can be
executed on its own if the user is using an own venv manager.
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
See the added description in the AAP documentation - this adds an
internal format to the 64 bit integer value returned as "bundle ID" in
the `SENDCONFIRM` AAP message to uniquely identify the created bundle in
conformance to RFC 9171.
Closes: #60
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
Former releases of uD3TN have included support for STM32/FreeRTOS.
Having this support from the first moment on was a good thing in
order to optimize for platforms with limited resources. As this
platform is not used in current uD3TN setups and as it results in quite
some maintenance work, it is removed with this commit. The removed parts
cover the implementation itself, tests, tools, documentation, parts of
the build/make scripts as well as licensing information.
Signed-off-by: Marius Feldmann <marius.feldmann@d3tn.com>
This adapts the provided manual page so the current command line
arguments are properly reflected, in alphabetical order (like in the
--help output). Furthermore, some typos are fixed and the name of uD3TN
is mentioned consistently.
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
The quick start guide recommends to add a `--dest-eid` argument to the
call to `aap_config.py` when configuring the contact from node A to B.
This is indeed unnecessary as `aap_config.py` can automatically
determine the local configuaration endpoint. The `--dest-eid` argument
is only required in more advanced cases (configuration over multiple
nodes) and implies enabling remote configuration in uD3TN.
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
-> https://datatracker.ietf.org/doc/html/draft-ietf-dtn-bpbis-31#section-4.2.5
The previous validation methods were not sufficient to check validity of
dtn as well as ipn EIDs. This adds further functions to easily detect
the EID scheme and validate dtn plus ipn EIDs. Tests for the most common
cases where validity checks should be successful and where they might
fail are added as well.
Due to this change the default EID of uD3TN gets a slash appended, as
dtn EIDs always have to contain the name delimiter '/'.
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
Previously uD3TN implicitly assumed string EID in many places such as
the agent manager. This adds proper handling for ipn-scheme EIDs,
using numerical service numbers as agent IDs in case uD3TN is started
with an ipn-scheme EID. If the ipn scheme is used, uD3TN always has to
be configured with the service number 0. The config and management agent
IDs can be configured in config.h and are 9000 and 9001, respectively,
to keep the lower range of service numbers free. It is intentional that
agents can register with a service number of zero - uD3TN does not
provide specific functionality under this service number.
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
In order to have SENDBIBE and RECVBIBE messages have the same kind of
payload data (BPDUs) the creation of the administrative record needed
for BIBE bundles was moved from the bibe_proto.c file to the application
agent.
Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
This commit updates the AAP docs with explanations for the SEND- and
RECVBIBE message types. It also adds a short note regarding backward
compatibility with older AAP implementations that do not support BIBE.
Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
This commit addresses some issues concerning the documentation of
µD3TN's implementation of Bundle-in-Bundle Encapsulation.
It mostly fixes typos and changes unclear wording to be more precise,
but also expands some parts of the docs with more information.
Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
This commit fixes some typos in the BIBE documentation and removes
an unnecessary pair of curly brackets from the bibe_proto.c file.
Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
In order to make BIBE useable for everyone a short documentation
containing information on what BIBE is, how it works in µD3TN and
how to use it has been added.
Signed-off-by: Tobias Nöthlich <tobias.noethlich@d3tn.com>
Previously, we had a build-time flag for enabling configuration via
bundles received from other nodes. Thus, changing the flag required a
re-build. As we are depending on it also for our integration tests and
it is often handy in further setups, this change makes it a command
line argument "--allow-remote-config".
As the STM32 platform does not support command line arguments, remote
configuration is enabled by default there via config.h.
See also: !13, #32
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
The README.md has been rewritten from scratch to make uD3TN more
appealing and accessible. It comes with a new structure that aims
to provide a gradual introduction starting from the end user
perspective. Some new content has been added compared to the
previous version:
- Overview figure from the end user perspective
- List of implemented IETF standards / drafts
- CLI usage
- Directory structure and entry point
- List of related tools with a brief description
The mood of the text tries to be as short and precise as possible
with as much information as necessary. Bold and italic highlights
are avoided.
Closes#46 and #61.
Signed-off-by: Georg Alexander Murzik <georg.murzik@d3tn.com>
This adds an example-driven quick start guide for Linux and POSIX
systems to the doc/ folder, including the setup of two µD3TN instances
connected to each other.
Signed-off-by: Felix Walter <felix.walter@d3tn.com>
To distribute the pyD3TN DTN protocol implementations as well as the
uD3TN python utilities on PyPi, the Python code is organized in separate
directories and the PyPi packaging guideline is applied. The
restructuring also requires an adjustment of the imports in the scripts
in tools/ and test/.
Signed-off-by: Maximilian Nitsch <maximilian.nitsch@d3tn.com>
This is the initial commit for uD3TN. uD3TN is a fork of uPCN v0.8.0,
which will be developed and maintained in a public Git repository.
For questions concerning the history of and code provided with uPCN,
please get in touch with us via: contact <at> d3tn <dot> com
Signed-off-by: Felix Walter <felix.walter@d3tn.com>