Skip to content

RustiFlow 1.1.0

Latest

Choose a tag to compare

@Str-Gen Str-Gen released this 06 Nov 16:02
· 7 commits to main since this release

RustiFlow 1.1.0 is the first release since the WTMC workshop release (v0.2.0), which stays available as a historical artifact. It covers about 130 commits.

Highlights

  • No libpcap. Offline capture reads pcap and pcapng with a pure-Rust parser. This covers nanosecond and big-endian files, Linux cooked capture (SLL) and VLAN tags. Corrupt timestamps are rejected before packets are dispatched.
  • One release bundle. rustiflow-1.1.0-x86_64-linux.tar.gz holds the binary, both eBPF objects, a systemd template unit, example configuration and install.sh. The Debian package and both container images install this same bundle.
  • Lean, CPU-targeted build. The binary is built with fat LTO and stripped symbols, and leaves out the profiling dependencies. It is tuned for x86-64-v3 (Intel Haswell, AMD Zen and newer). The installer refuses older CPUs. Use cargo xtask dist --target-cpu to build for other hardware.
  • Realtime. aya is updated to 0.16, the realtime byte order is fixed, and egress classifiers stay attached for the whole capture. Fragment and IPv6 extension parsing now matches offline capture.
  • Flow semantics. Offline expiration is deterministic. TCP handshakes and closes are recognized when packets are reordered, sequence numbers are handled across wraparound, and timing stays monotonic when packets arrive out of order. Early export now follows a fixed per-flow schedule.
  • Features. TCP quality signals, extended ICMP behavior, IP scope and path locality, and ip_version in nf_flow.
  • Performance. Hot-path work covers flow keys, hashing, per-shard CSV encoding and batching. A replay-bench subcommand measures the realtime userspace pipeline.

Requirements

  • x86_64 Linux with glibc 2.36 or newer (Debian bookworm, Ubuntu 24.04 and later).
  • An x86-64-v3 CPU.
  • Realtime capture needs eBPF and the CAP_BPF, CAP_NET_ADMIN and CAP_PERFMON capabilities.

Install

sha256sum -c rustiflow-1.1.0-x86_64-linux.tar.gz.sha256
tar -xzf rustiflow-1.1.0-x86_64-linux.tar.gz
sudo sh rustiflow-1.1.0-x86_64-linux/install.sh

Container images: ghcr.io/idlab-discover/rustiflow:v1.1.0 and :v1.1.0-slim.