NAME

zerodds-replay - replay recorded ZeroDDS captures to stdout or a live domain

SYNOPSIS

zerodds-replay inspect FILE
zerodds-replay dump FILE
zerodds-replay replay FILE [--time-scale F] [--topic NAME]... [--inject [--inject-domain N]]

DESCRIPTION

zerodds-replay reads a capture and re-emits its frames in recorded order, preserving the inter-frame timing of the original trace.

The input FILE format is auto-detected from its extension: .zddsrec (binary capture), .ndjson / .json (decoded NDJSON), or .db / .sqlite (decoded SQLite). The NDJSON and SQLite forms carry the original raw_cdr bytes, so a sample captured once replays byte-identically from whichever artifact was kept.

By default frames are printed to stdout. With --inject each frame is re-published into a live DDS domain through a cached per-topic writer, re-stamping the recorded wire payload.

COMMANDS

inspect: A .zddsrec capture's header: format version, time base, participants with their GUIDs, topics with their types, and the number of frames, payload bytes and time span.
dump: One line per frame of a .zddsrec capture: time offset, participant, topic, kind, payload length.
replay: Re-emit the frames with their recorded timing, to stdout or, with --inject, into a live domain.

OPTIONS FOR replay

--time-scale F: Playback speed relative to wallclock. 1.0 = real time; 60.0 replays a one-hour trace in one minute; 0.5 runs at half speed. Default: 1.0.
--topic NAME: Replay only frames of this DDS / ROS topic name (repeatable). Default: all topics in the capture.
--inject: Re-inject frames into a live DDS domain instead of printing to stdout.
--inject-domain N: DCPS Domain ID for --inject. Default: 0.

GLOBAL OPTIONS

-h, --help: Show help and exit.
-V, --version: Print version and exit.

EXIT STATUS

0: Success.
1: The capture could not be read, or the replay failed.
2: The command line was wrong (no or an unknown command, a missing file, a bad option).

AUTHORS

ZeroDDS Contributors <release@zerodds.org>

BEZEICHNUNG

zerodds-replay - aufgezeichnete ZeroDDS-Mitschnitte auf die Standardausgabe oder in eine laufende Domäne abspielen

ÜBERSICHT

zerodds-replay inspect DATEI
zerodds-replay dump DATEI
zerodds-replay replay DATEI [--time-scale F] [--topic NAME]... [--inject [--inject-domain N]]

BESCHREIBUNG

zerodds-replay liest einen Mitschnitt und gibt seine Frames in der aufgezeichneten Reihenfolge wieder aus, mit den Zeitabständen zwischen den Frames aus der ursprünglichen Aufzeichnung.

Das Format der Eingabe DATEI wird an ihrer Endung erkannt: .zddsrec (binärer Mitschnitt), .ndjson / .json (dekodiertes NDJSON) oder .db / .sqlite (dekodiertes SQLite). Die NDJSON- und die SQLite-Form tragen die ursprünglichen raw_cdr-Bytes, sodass ein einmal aufgezeichnetes Sample byteidentisch abgespielt wird, gleich welches Artefakt aufbewahrt wurde.

Standardmäßig werden die Frames auf stdout ausgegeben. Mit --inject wird jedes Frame über einen zwischengespeicherten Writer je Topic erneut in eine laufende DDS-Domäne veröffentlicht, mit neu gestempelter aufgezeichneter Wire-Nutzlast.

BEFEHLE

inspect: Der Kopf eines .zddsrec-Mitschnitts: Formatversion, Zeitbasis, Teilnehmer mit ihren GUIDs, Topics mit ihren Typen und die Anzahl der Frames, Nutzlast-Bytes und die Zeitspanne.
dump: Eine Zeile je Frame eines .zddsrec-Mitschnitts: Zeitversatz, Teilnehmer, Topic, Art, Nutzlastlänge.
replay: Gibt die Frames mit ihren aufgezeichneten Zeitabständen wieder aus, auf stdout oder, mit --inject, in eine laufende Domäne.

OPTIONEN FÜR replay

--time-scale F: Abspielgeschwindigkeit relativ zur Uhrzeit. 1.0 = Echtzeit; 60.0 spielt eine einstündige Aufzeichnung in einer Minute ab; 0.5 läuft mit halber Geschwindigkeit. Standard: 1.0.
--topic NAME: Nur Frames mit diesem DDS-/ROS-Topic-Namen abspielen (wiederholbar). Standard: alle Topics im Mitschnitt.
--inject: Frames erneut in eine laufende DDS-Domäne einspeisen, statt sie auf stdout auszugeben.
--inject-domain N: DCPS-Domain-ID für --inject. Standard: 0.

GLOBALE OPTIONEN

-h, --help: Zeigt die Hilfe und beendet sich.
-V, --version: Gibt die Version aus und beendet sich.

EXIT-STATUS

0: Erfolg.
1: Der Mitschnitt konnte nicht gelesen werden, oder das Abspielen ist fehlgeschlagen.
2: Die Kommandozeile war falsch (kein oder ein unbekannter Befehl, eine fehlende Datei, eine ungültige Option).

SIEHE AUCH

zerodds-record(1), zerodds-spy(1)

Spec: docs/specs/zddsrec-1.0.md

AUTOREN