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.
- --config PATH
-
The base configuration file; its sibling PATH.d/ holds drop-ins. Default: the system configuration directory (/etc/zerodds on Linux, /usr/local/etc/zerodds on macOS).
- --set PATH=VALUE
-
One setting above every file, repeatable; +PATH=VALUE appends to a list.
- --check-config
-
Validate and print the effective configuration with the origin of every value, then exit: 0 valid, 1 invalid value or unknown key, 2 unreadable file, syntax error or include cycle.
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>
BEZEICHNUNG
zerodds-bench - Ende-zu-Ende-Messung von Latenz und Durchsatz auf der ZeroDDS-DCPS-Pipeline
ÜBERSICHT
zerodds-bench latency [-d DOMÄNE] [-t TOPIC] [-p NUTZLAST] [--duration DAUER]
zerodds-bench throughput [-d DOMÄNE] [-t TOPIC] [-p NUTZLAST] [--duration DAUER]
zerodds-bench info
BESCHREIBUNG
zerodds-bench führt Mikro-Benchmarks gegen die vollständige ZeroDDS-DCPS-Pipeline aus, über eine Loopback-Verbindung in einem Prozess (ein Writer und ein Reader auf demselben Topic in derselben Laufzeitumgebung). Die vollständige XCDR2-Kodierung, der HistoryCache, das Wire-Protokoll RTPS 2.5 und der UDP-Transport werden durchlaufen; es ist keine Einrichtung außerhalb nötig.
Der Unterbefehl latency misst die Umlaufzeit je Sample und meldet Minimum / p50 / p99 / Maximum in Mikrosekunden.
Der Unterbefehl throughput schreibt für die Dauer von --duration so schnell wie möglich und meldet Nachrichten/s und MiB/s.
info gibt die Fähigkeiten des Backends aus (Transporte, Kodierungen, Modi).
OPTIONEN
- -d, --domain ID
-
DDS-Domain-ID. Standard: 0.
- -t, --topic NAME
-
Topic-Name. Standard: zerodds/bench/loopback.
- -p, --payload N
-
Größe der Nutzlast in Byte. Standard: 64.
- --duration DAUER
-
Laufzeit: 5, 30s, 2m, 1h. Standard: 5s.
- --config PFAD
-
Die Basis-Konfigurationsdatei; das danebenliegende PFAD.d/ enthält Drop-ins. Standard: das System-Konfigurationsverzeichnis (/etc/zerodds unter Linux, /usr/local/etc/zerodds unter macOS).
- --set PFAD=WERT
-
Eine Einstellung über allen Dateien, wiederholbar; +PFAD=WERT hängt an eine Liste an.
- --check-config
-
Prüft die wirksame Konfiguration und gibt sie mit der Herkunft jedes Werts aus, dann Ende: 0 gültig, 1 ungültiger Wert oder unbekannter Schlüssel, 2 nicht lesbare Datei, Syntaxfehler oder Include-Zyklus.
GLOBALE OPTIONEN
- -h, --help
-
Zeigt die Hilfe und beendet sich.
- -V, --version
-
Gibt die Version aus und beendet sich.
EXIT-STATUS
- 0
-
Erfolg.
- 2
-
Fehler beim Parsen der Kommandozeile.
- 3
-
DDS- oder E/A-Fehler.
SIEHE AUCH
zerodds-record(1), zerodds-spy(1), zerodds-monitor(1)
AUTOREN
ZeroDDS Contributors <release@zerodds.org>