This is the shipped English man-page reference for zerodds-bench — the same text as man zerodds-bench. The surrounding navigation follows the language switch; the reference body stays English, as man-pages conventionally do.
Dies ist die ausgelieferte englische man-page-Referenz für zerodds-bench — derselbe Text wie man zerodds-bench. Navigation und Seitenrahmen folgen dem Sprach-Umschalter; der Referenz-Body bleibt englisch, wie man-pages es konventionell tun.
NAME
zerodds-bench - end-to-end latency and throughput benchmarking on the ZeroDDS DCPS pipeline
SYNOPSIS
zerodds-bench latency [-d DOMAIN] [-t TOPIC] [-p PAYLOAD] [--duration DUR]
zerodds-bench throughput [-d DOMAIN] [-t TOPIC] [-p PAYLOAD] [--duration DUR]
zerodds-bench info
DESCRIPTION
zerodds-bench runs micro-benchmarks against the full ZeroDDS DCPS pipeline using a single-process loopback (one writer and one reader on the same topic inside the same runtime). The full XCDR2 encoding, HistoryCache, RTPS 2.5 wire protocol, and UDP transport are exercised — no external setup is required.
The latency sub-command times round-trip per sample and reports min / p50 / p99 / max in microseconds.
The throughput sub-command writes as fast as possible for --duration and reports messages/s and MiB/s.
info prints backend capabilities (transports, encodings, modes).
OPTIONS
- -d, --domain ID
-
DDS Domain ID. Default: 0.
- -t, --topic NAME
-
Topic name. Default: zerodds/bench/loopback.
- -p, --payload N
-
Payload size in bytes. Default: 64.
- --duration DUR
-
Run duration: 5, 30s, 2m, 1h. Default: 5s.
GLOBAL OPTIONS
- -h, --help
-
Show help and exit.
- -V, --version
-
Print version and exit.
EXIT STATUS
- 0
-
Success.
- 2
-
CLI parse error.
- 3
-
DDS or I/O error.
SEE ALSO
zerodds-record(1), zerodds-spy(1), zerodds-monitor(1)
AUTHORS
ZeroDDS Contributors <release@zerodds.org>