zerodds-chaos 1.0.0-rc.1

Chaos-engineering CLI for DDS networks: UDP proxy with packet loss / latency / reordering, plus tc / iptables / netem wrappers and endpoint flap simulation.
Documentation
  • Coverage
  • 100%
    77 out of 77 items documented0 out of 23 items with examples
  • Size
  • Source code size: 56.69 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 974.78 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 12s Average build duration of successful builds.
  • all releases: 12s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Homepage
  • zero-objects/zero-dds
    2 1 0
  • crates.io
  • Dependencies
    • —
  • Versions
  • Owners
  • SandraK82

zerodds-chaos

Chaos-engineering CLI for DDS networks: UDP proxy with packet loss / latency / reordering, plus tc / iptables / netem wrappers and endpoint-flap simulation.

Crates.io License: Apache-2.0

ZeroDDS chaos-testing tool. Two operating modes:

  • In-process UDP proxy — no root required; intercepts packets between two configured endpoints and applies deterministic chaos policies (drop, delay, dup, reorder).
  • Linux tc / netem wrapper — orchestrates kernel-level qdiscs for whole-interface chaos. Requires root.

A pseudo-random sequence with a fixed seed makes every run reproducible: same seed → same dropped packets at the same offsets.

Spec mapping

This is internal tooling — no OMG spec mapping. The behaviour is defined by the in-tree docs/test-harness/chaos-policies.md.

Safety classification

COMFORT — test tooling, never on a runtime path.

Quickstart

# Drop 5% of packets between localhost:7400 and localhost:7401:
zerodds-chaos proxy --listen 127.0.0.1:7400 \
                    --upstream 127.0.0.1:7401 \
                    --drop 0.05 --seed 42

# Add 50ms latency on eth0:
sudo zerodds-chaos tc-apply --iface eth0 --delay 50ms

# Clean up:
sudo zerodds-chaos tc-clear --iface eth0

Sub-commands

Command Purpose
proxy In-process UDP chaos proxy (no root).
tc-apply Apply a netem qdisc on a Linux interface (root).
tc-clear Remove a netem qdisc (root).
endpoint-flap Repeatedly create + destroy a discovery endpoint.
partition Two-way proxy with a one-way blackhole.

Stability

1.0.0-rc.1 — public CLI is stable. Breaking changes require a major version bump.

Build & test

cargo build -p zerodds-chaos
cargo test  -p zerodds-chaos

Links

Licence

Apache-2.0. See LICENSE.