NAME

zerodds-spy - subscribe to a DDS topic and dump samples

SYNOPSIS

zerodds-spy [subscribe] -t TOPIC [-d DOMAIN] [-n COUNT] [--duration DUR] [-x BYTES] [--type NAME] [--decode --type-file IDL [--dialect NAME]]

DESCRIPTION

zerodds-spy starts a DCPS runtime, subscribes to the given --topic as untyped raw bytes, and prints metadata plus an optional hex snippet for every incoming sample.

The subscribe sub-command is implicit when the first argument is a flag — the two forms below are equivalent:

zerodds-spy subscribe -t Foo
zerodds-spy -t Foo

OPTIONS

-d, --domain ID

DDS Domain ID. Default: 0.

-t, --topic NAME

Topic name to subscribe (REQUIRED).

--type NAME

Announce this IDL type directly. Default: discover and follow.

-n, --count N

Stop after N samples. Default: unlimited.

--duration DUR

Stop after duration: 5, 30s, 2m, 1h.

-x, --hex BYTES

First BYTES of the payload as hex (0 disables). Default: 32.

--decode

Decode samples to typed JSON. Needs --type-file.

--type-file IDL

Out-of-band IDL providing the types to decode.

--dialect NAME

The wire dialect to decode in: cyclone, rti, fastdds, opendds and the others zerodds-idlc generate --dialect takes. Default: the configuration's wire.codec_dialect, itself specification unless set. The decoder does not infer it from the bytes; a sample written in another dialect is reported, not accepted.

--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-snitch(1), zerodds-pcap(1)

AUTHORS

ZeroDDS Contributors <release@zerodds.org>

BEZEICHNUNG

zerodds-spy - ein DDS-Topic abonnieren und die Samples ausgeben

ÜBERSICHT

zerodds-spy [subscribe] -t TOPIC [-d DOMÄNE] [-n ANZAHL] [--duration DAUER] [-x BYTES] [--type NAME] [--decode --type-file IDL [--dialect NAME]]

BESCHREIBUNG

zerodds-spy startet eine DCPS-Laufzeitumgebung, abonniert das angegebene --topic als untypisierte rohe Bytes und gibt für jedes ankommende Sample Metadaten und optional einen Hex-Ausschnitt aus.

Der Unterbefehl subscribe gilt implizit, wenn das erste Argument eine Option ist — die beiden Formen unten sind gleichwertig:

zerodds-spy subscribe -t Foo
zerodds-spy -t Foo

OPTIONEN

-d, --domain ID

DDS-Domain-ID. Standard: 0.

-t, --topic NAME

Name des Topics, das abonniert wird (PFLICHT).

--type NAME

Diesen IDL-Typ direkt ankündigen. Standard: finden und folgen.

-n, --count N

Nach N Samples beenden. Standard: unbegrenzt.

--duration DAUER

Nach dieser Dauer beenden: 5, 30s, 2m, 1h.

-x, --hex BYTES

Die ersten BYTES der Nutzlast als Hex (0 schaltet ab). Standard: 32.

--decode

Samples in typisiertes JSON dekodieren. Braucht --type-file.

--type-file IDL

IDL außerhalb der Daten, die die Typen zum Dekodieren liefert.

--dialect NAME

Der Wire-Dialekt, in dem dekodiert wird: cyclone, rti, fastdds, opendds und die anderen, die zerodds-idlc generate --dialect annimmt. Standard: wire.codec_dialect aus der Konfiguration, selbst specification, solange nicht gesetzt. Der Decoder leitet den Dialekt nicht aus den Bytes ab; ein Sample, das in einem anderen Dialekt geschrieben ist, wird gemeldet, nicht angenommen.

--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-snitch(1), zerodds-pcap(1)

AUTOREN

ZeroDDS Contributors <release@zerodds.org>