bp7-rs

Rust implementation of dtn bundle protocol 7 draft https://tools.ietf.org/html/draft-ietf-dtn-bpbis-13

This library only handles encoding and decoding of bundles, not transmission or other processing of the data. A full daemon using this library can be found here: https://github.com/gh0st42/dtn7-rs

This code is not production ready!

Benchmarking

A simple benchmark is shipped with the library. It (de)serializes Bundles with a primary block, bundle age block and a payload block with the contents (b"ABC"). This benchmark can be used to compare the rust implementation to the golang, python or java implementations.

cargo run --release --example benchmark Finished release [optimized] target(s) in 0.29s Running `target/release/examples/benchmark` Creating 100000 bundles with CRC_NO: 206964 bundles/second Creating 100000 bundles with CRC_16: 172704 bundles/second Creating 100000 bundles with CRC_32: 174935 bundles/second Encoding 100000 bundles with CRC_NO: 356908 bundles/second Encoding 100000 bundles with CRC_16: 259877 bundles/second Encoding 100000 bundles with CRC_32: 261549 bundles/second Loading 100000 bundles with CRC_NO: 598800 bundles/second Loading 100000 bundles with CRC_16: 500347 bundles/second Loading 100000 bundles with CRC_32: 497460 bundles/second

These numbers were generated on a MBP 13" 2018 with i5 CPU and 16GB of ram.

bp7 helper tool

For debugging a small helper tool is shipped: ``` $ cargo install bp7 [...] $ usage "bp7" [args] decode dtntime [dtntimestamp] - prints current time as dtntimestamp or prints dtntime human readable d2u [dtntimestamp] - converts dtntime to unixstimestamp rnd - return a hexencoded random bundle $ bp7 rnd 9f8907000182016b6e6f6465332f696e626f7882016b6e6f6465332f696e626f7882016b6e6f6465332f696e626f78821a247966ba001ad693a4004225b686010000014341424342237186080100010042dbccff

$ bp7 decode 9f8907000182016b6e6f6465332f696e626f7882016b6e6f6465332f696e626f7882016b6e6f6465332f696e626f78821a247966ba001ad693a4004225b686010000014341424342237186080100010042dbccff

[src/main.rs:17] &bndl = Bundle { primary: PrimaryBlock { version: 7, bundlecontrolflags: 0, crctype: 1, destination: Dtn( 1, "node3/inbox" ), source: Dtn( 1, "node3/inbox" ), reportto: Dtn( 1, "node3/inbox" ), creationtimestamp: CreationTimestamp( 611935930, 0 ), lifetime: 3600000000, fragmentationoffset: 0, totaldatalength: 0, crc: [ 37, 182 ] }, canonicals: [ CanonicalBlock { blocktype: 1, blocknumber: 0, blockcontrolflags: 0, crctype: 1, data: Data( [ 65, 66, 67 ] ), crc: [ 35, 113 ] }, CanonicalBlock { blocktype: 8, blocknumber: 1, blockcontrolflags: 0, crctype: 1, data: BundleAge( 0 ), crc: [ 219, 204 ] } ] } ```

The generated hex string can also be directly discplayed as raw cbor on the awesome cbor.me website, e.g. http://cbor.me/?bytes=9f8907000182016b6e6f6465332f696e626f7882016b6e6f6465332f696e626f7882016b6e6f6465332f696e626f78821a247966ba001ad693a4004225b686010000014341424342237186080100010042dbccff

License

^{Licensed under either of Apache License, Version 2.0 or MIT license at your option.}

_{Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in bp7-rs by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.}