NAME

zerodds-mqtt-bridged - DDS to MQTT 5 bridge daemon

SYNOPSIS

zerodds-mqtt-bridged [--config FILE] [--broker URL] [--domain ID] [--topic DDS:MQTT]... [--log-level LEVEL] [-V | -h]

DESCRIPTION

zerodds-mqtt-bridged mirrors DDS topics to MQTT 5 broker topics and vice versa. Implements docs/specs/zerodds-mqtt-bridge-1.0.md. Talks to any MQTT 5 broker (Mosquitto, EMQX, HiveMQ) over TCP/TLS, auto-reconnects with exponential back-off, supports per-route MQTT QoS (0/1/2), Retain, MessageExpiry, ContentType and UserProperties.

OPTIONS

--config=FILE

The config file (YAML), with drop-ins in its sibling FILE.d/. Without it the system file is read when it exists: /etc/zerodds/mqtt-bridged.yaml with /etc/zerodds/mqtt-bridged.d/ (on macOS under /usr/local/etc/zerodds); without that file the built-in defaults apply. See zerodds-mqtt-bridged.yaml(5).

--broker=URL

MQTT broker URL (mqtt://, mqtts://, ws://, wss://).

--client-id=ID

MQTT client ID.

--domain=ID

DDS domain ID. Default: 0.

--username=USER

MQTT username.

--password=PASS

MQTT password.

--tls-ca=FILE

CA cert.

--tls-cert=FILE

Client cert.

--tls-key=FILE

Client key.

--topic=DDS:MQTT

Topic override (repeatable).

--log-level=LEVEL

Override log level. One of trace, debug, info, warn, error.

--metrics=ADDR

Prometheus listen addr.

-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 graceful shutdown, SIGHUP reads the configuration again: the topic ACL applies from then on, a withdrawn read right stops the samples of that topic at once; sessions persist. Changed topics, broker address or client id, broker TLS, auth mode 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.

MQTT_PASSWORD

The broker password; the setting mqtt.password, above the files, below --set.

EXIT STATUS

0

Normal shutdown (SIGTERM/SIGINT).

1

Configuration error.

2

Broker connect error.

3

DDS discovery error.

4

TLS error.

5

Authentication error.

FILES

/etc/zerodds/mqtt-bridged.yaml , /var/log/zerodds/mqtt-bridged.log .

SEE ALSO

zerodds-mqtt-bridged.yaml(5), mosquitto(8).

STANDARDS

MQTT v5 (OASIS), DDS 1.4, RTPS 2.5.

AUTHORS

ZeroDDS Contributors <release@zerodds.org>.

BEZEICHNUNG

zerodds-mqtt-bridged - Bridge-Daemon von DDS nach MQTT 5

ÜBERSICHT

zerodds-mqtt-bridged [--config DATEI] [--broker URL] [--domain ID] [--topic DDS:MQTT]... [--log-level STUFE] [-V | -h]

BESCHREIBUNG

zerodds-mqtt-bridged spiegelt DDS-Topics auf Topics eines MQTT-5-Brokers und umgekehrt. Implementiert docs/specs/zerodds-mqtt-bridge-1.0.md. Spricht mit jedem MQTT-5-Broker (Mosquitto, EMQX, HiveMQ) über TCP/TLS, verbindet sich mit exponentiellem Back-off automatisch neu, unterstützt MQTT-QoS je Route (0/1/2), Retain, MessageExpiry, ContentType und UserProperties.

OPTIONEN

--config=DATEI

Die Konfigurationsdatei (YAML), mit Drop-ins im danebenliegenden DATEI.d/. Ohne diese Option wird die Systemdatei gelesen, wenn es sie gibt: /etc/zerodds/mqtt-bridged.yaml mit /etc/zerodds/mqtt-bridged.d/ (unter macOS unter /usr/local/etc/zerodds); ohne diese Datei gelten die eingebauten Standardwerte. Siehe zerodds-mqtt-bridged.yaml(5).

--broker=URL

URL des MQTT-Brokers (mqtt://, mqtts://, ws://, wss://).

--client-id=ID

MQTT-Client-ID.

--domain=ID

DDS-Domain-ID. Standard: 0.

--username=BENUTZER

MQTT-Benutzername.

--password=PASSWORT

MQTT-Passwort.

--tls-ca=DATEI

CA-Zertifikat.

--tls-cert=DATEI

Client-Zertifikat.

--tls-key=DATEI

Client-Schlüssel.

--topic=DDS:MQTT

Topic-Überschreibung (wiederholbar).

--log-level=STUFE

Log-Stufe überschreiben. Eine von trace, debug, info, warn, error.

--metrics=ADR

Listen-Adresse 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 geordnetes Beenden, SIGHUP liest die Konfiguration neu: Die Topic-ACL gilt ab dann, ein entzogenes Leserecht stoppt die Samples dieses Topics sofort; Sitzungen bleiben bestehen. Geänderte Topics, Broker-Adresse oder Client-ID, Broker-TLS, Authentifizierungsmodus 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.

MQTT_PASSWORD

Das Broker-Passwort; die Einstellung mqtt.password, über den Dateien, unter --set.

EXIT-STATUS

0

Normales Beenden (SIGTERM/SIGINT).

1

Konfigurationsfehler.

2

Fehler beim Verbinden mit dem Broker.

3

Fehler bei der DDS-Discovery.

4

TLS-Fehler.

5

Authentifizierungsfehler.

DATEIEN

/etc/zerodds/mqtt-bridged.yaml , /var/log/zerodds/mqtt-bridged.log .

SIEHE AUCH

zerodds-mqtt-bridged.yaml(5), mosquitto(8).

STANDARDS

MQTT v5 (OASIS), DDS 1.4, RTPS 2.5.

AUTOREN

ZeroDDS Contributors <release@zerodds.org>.