DNT is a generic userspace deterministic networking toolbox.
Highlighted features:
- Portable with minimal external dependencies
- Layer 2 TSN virtual switch with IEEE 802.1CB (FRER) support
- Layer 3 DetNet virtual router with PREOF support
- DetNetSRv6 experimental support
- DetNet OAM support and built-in telnet command-line interface
- Generic header matching & editing for many protocols (Ethernet, S-VLAN, C-VLAN, MPLS, IPv4, IPv6, etc.)
- Extensions to the FRER/PREOF standards for better cloud-native operation support (seamless FRER/PREOF, delay function)
- Supporting Ethernet, IPv4, IPv6, SRv6 and MPLS pseudo-wire interfaces for sending/receiving
- Hardware offload support for delay function (hardware support required)
- Dynamic address configuration for tunnel endpoints on DHCP and NDP configured interfaces
- Extensible architecture, well defined interfaces for new protocols and functions
- Many more...
Install the required dependencies.
On Ubuntu/Debian based distros:
sudo apt install build-essential
On Fedora/RHEL and derivates:
sudo dnf groupinstall @development-tools @development-libraries
The minimal required Linux version is 4.20. Kernel versions shipped with major GNU/Linux distributions in the past ~5 years should be fine.
Compile and (optionally) install DNT
Download the source code archive or clone the Git repository. After that the compilation can be done with make command.
cd dnt
make
Optional: install DNT system wide.
sudo make install
To get started with DNT there is a detailed Getting started guide. This presents common practical use-cases (TSN, DetNet, OAM and more) supported by DNT. To try them no special hardware equipment is required, however the scenarios are crafted such that the configs can be run on NXP switches without modifications.
DNT comes with detailed documentation included in the release package. The documentation shows various scenarios and configuration examples.
Important: the recommended way to run DNT is to use root privileges.
Unpriviliged operation also supported, but for Layer2 operation (RAW Ethernet/IP sockets) CAP_NET_RAW capability must be granted.
The only mandatory command line argument is the configuration file.
The verbosity of the logging and the target of the output can be configured with optional command line arguments.
There are per-module default verbosity levels at the moment, and the -v option defines global verbosity.
The default logging output is syslog (-ol, stdout is -os and logfile is -of).
Usage: dnt [OPTION...] CONFIGFILE
-o, --output=logfile Output: log[f]ile, sys[l]og, [s]tdout (default),
std[e]rr
-v, --verbose=MODULE:LEVEL Available levels: NONE, ERROR, WARNING, INFO,
PACKET, DEBUG, ALL
-?, --help Give this help list
--usage Give a short usage message
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
dnt: Config file required!
Try `dnt --help' or `dnt --usage' for more information.
DNT comes with various self-tests to verify its correct operation. These tests designed to be run automatically by part of a CI pipeline. There are debugging tests as well, for rapid development. For more information check their documentation
As mentioned before, the entry point of DNT usage are the getting started guides. All available configuration options are listed in the config specification. Other topics such as the supported protocols, SRv6, OAM, logging, etc. documented in the doc folder.
With questions regarding to DNT bugs/usage, please contact Ferenc Fejes <ferenc.fejes@ericsson.com>
Team:
- Ericsson: Balázs Varga, Ferenc Fejes, Ferenc Orosi, János Farkas
- BME: István Moldován, Miklós Máté