warts

Crates.iowarts
lib.rswarts
version0.4.0
sourcesrc
created_at2022-03-24 08:20:02.994965
updated_at2023-03-05 11:17:58.878892
descriptionRust implementation of the warts format.
homepage
repositoryhttps://github.com/dioptra-io/warts/
max_upload_size
id555649
size153,089
Maxime Mouchet (maxmouchet)

documentation

README

💢 warts

Coverage crates.io docs.rs Tests

This crate implements reading and writing warts(5) files produced by CAIDA's Scamper tool.
It relies on the excellent deku crate for serializing and deserializing the binary format.

Usage

You can run one of the examples in examples/:

cargo run --release --example dump data/trace_google_dns_v6_default.warts
cargo run --release --example read_traceroute data/trace_google_dns_v6_default.warts
cargo run --release --example write_traceroute > test.warts

To use in your own project, add the following dependency to Cargo.toml:

[dependencies]
warts = "0.4"

Limitations

The following features are currently not implemented:

  • DoubleTree and PMTUD data
  • tsprespec data
  • Streaming reading

Performance

Time to parse and print the traceroutes from abz-uk.team-probing.c009127.20210202.warts (52MB).
Measured with hyperfine on a 2020 M1 MacBook Air.

Library Time (s)
warts / read_traceroute 0.797
Scamper / sc_warts2text 1.125
pywarts / parse_from_stdin.py 12.405
cmand/scamper / sc_warts2text.py 21.207

Object types

Type Structure Name Implemented
0x0001 scamper_list_t List Y
0x0002 scamper_cycle_t Cycle start Y
0x0003 scamper_cycle_t Cycle definition Y
0x0004 scamper_cycle_t Cycle stop Y
0x0005 scamper_addr_t Address (deprecated) Y
0x0006 scamper_trace_t Traceroute Y
0x0007 scamper_ping_t Ping Y
0x0008 scamper_tracelb_t MDA traceroute Y
0x0009 scamper_dealias_t Alias resolution N
0x000a scamper_neighbourdisc_t Neighbour discovery N
0x000b scamper_tbit_t TCP behaviour inference tool N
0x000c scamper_sting_t Sting N
0x000d scamper_sniff_t Sniff N
Commit count: 48

cargo fmt