NAME

zerodds-coap-bridged - DDS to CoAP bridge daemon

SYNOPSIS

zerodds-coap-bridged [--config FILE] [--bind ADDR] [--domain ID] [--topic DDS:URI]... [-V | -h]

DESCRIPTION

zerodds-coap-bridged exposes DDS topics as CoAP resources (RFC 7252) over UDP and DTLS, with support for CoAP-Block (RFC 7959) and Observe (RFC 7641). Maps GET to take_next_sample, PUT/POST to write, OBSERVE to a long-lived reader. Implements docs/specs/zerodds-coap-bridge-1.0.md.

OPTIONS

--config=FILE: Path to the config file (YAML). See zerodds-coap-bridged.yaml(5).
--bind=ADDR: UDP bind address. Default: 0.0.0.0:5683.
--domain=ID: DDS domain ID. Default: 0.
--dtls-psk-id=ID: DTLS PSK identity; enables coaps://.
--dtls-psk=SECRET: DTLS PSK secret, hex; enables coaps://.
--dtls-cert=FILE: DTLS server cert, PEM; enables coaps://.
--dtls-key=FILE: DTLS server key, PKCS#8 PEM.
--topic=DDS:URI: Topic override (repeatable).
--log-level=LEVEL: One of trace, debug, info, warn, error.
--metrics=ADDR: Prometheus listener.
-V, --version: Version info.
-h, --help: Show the option synopsis.
--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.

SIGNALS

SIGTERM stops the daemon. SIGHUP reads the configuration again: the topic ACL and the auth settings apply from then on, the DTLS material to new handshakes. Changed topics, binds or domain need a restart and are logged. A configuration that does not load changes nothing.

ENVIRONMENT

OTEL_EXPORTER_OTLP_ENDPOINT: Optional OTLP endpoint, such as http://localhost:4318.

EXIT STATUS

0: Normal shutdown.
1: Configuration error.
2: Bind error — address in use.
3: DDS discovery error.
4: DTLS or OSCORE setup error.

FILES

/etc/zerodds/coap-bridged.yaml .

AUTHORS

ZeroDDS Contributors.

BEZEICHNUNG

zerodds-coap-bridged - Bridge-Daemon von DDS nach CoAP

ÜBERSICHT

zerodds-coap-bridged [--config DATEI] [--bind ADR] [--domain ID] [--topic DDS:URI]... [-V | -h]

BESCHREIBUNG

zerodds-coap-bridged stellt DDS-Topics als CoAP-Ressourcen (RFC 7252) über UDP und DTLS bereit, mit Unterstützung für CoAP-Block (RFC 7959) und Observe (RFC 7641). Bildet GET auf take_next_sample ab, PUT/POST auf write, OBSERVE auf einen langlebigen Reader. Implementiert docs/specs/zerodds-coap-bridge-1.0.md.

OPTIONEN

--config=DATEI: Pfad zur Konfigurationsdatei (YAML). Siehe zerodds-coap-bridged.yaml(5).
--bind=ADR: UDP-Bind-Adresse. Standard: 0.0.0.0:5683.
--domain=ID: DDS-Domain-ID. Standard: 0.
--dtls-psk-id=ID: DTLS-PSK-Identität; schaltet coaps:// ein.
--dtls-psk=GEHEIMNIS: DTLS-PSK-Geheimnis, hexadezimal; schaltet coaps:// ein.
--dtls-cert=DATEI: DTLS-Server-Zertifikat, PEM; schaltet coaps:// ein.
--dtls-key=DATEI: DTLS-Server-Schlüssel, PKCS#8 PEM.
--topic=DDS:URI: Topic-Überschreibung (wiederholbar).
--log-level=STUFE: Eine von trace, debug, info, warn, error.
--metrics=ADR: Listener für Prometheus.
-V, --version: Versionsangabe.
-h, --help: Zeigt die Übersicht der Optionen.
--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.

SIGNALE

SIGTERM beendet den Daemon. SIGHUP liest die Konfiguration neu: Die Topic-ACL und die Authentifizierungs-Einstellungen gelten ab dann, das DTLS-Material für neue Handshakes. Geänderte Topics, Binds oder Domäne brauchen einen Neustart und werden protokolliert. Eine Konfiguration, die nicht lädt, ändert nichts.

UMGEBUNGSVARIABLEN

OTEL_EXPORTER_OTLP_ENDPOINT: Optionaler OTLP-Endpunkt, etwa http://localhost:4318.

EXIT-STATUS

0: Normales Beenden.
1: Konfigurationsfehler.
2: Bind-Fehler — Adresse belegt.
3: Fehler bei der DDS-Discovery.
4: Fehler beim Einrichten von DTLS oder OSCORE.

DATEIEN