NAME

zerodds-amqp-bridged - DDS to AMQP 1.0 bridge daemon

SYNOPSIS

zerodds-amqp-bridged [--config FILE] [--broker URL] [--domain ID] [--topic DDS=ADDR]... [-V | -h]

DESCRIPTION

zerodds-amqp-bridged bridges DDS topics to AMQP 1.0 endpoints. Supports SASL ANONYMOUS, PLAIN, EXTERNAL, TLS, links with sender/receiver settle modes, and property-based routing. Implements docs/specs/zerodds-amqp-bridge-daemon-1.0.md.

OPTIONS

--config=FILE: YAML config (Spec §3). See zerodds-amqp-bridged.yaml(5).
--broker=URL: AMQP broker URL (amqp://, amqps://).
--container-id=ID: AMQP container-id.
--domain=ID: DDS Domain ID.
--sasl-mechanism=NAME: One of PLAIN, SCRAM-SHA-256, EXTERNAL, ANONYMOUS, XOAUTH2.
--user=USER: SASL username.
--password=PASS: SASL password.
--tls-ca=FILE: TLS CA certificate.
--tls-cert=FILE: TLS client cert.
--tls-key=FILE: TLS client key.
--topic=DDS=ADDR: Inline topic mapping override.
--log-level=LEVEL: One of trace, debug, info, warn, error.
--metrics=ADDR: Prometheus listen addr.

Test hooks. Real options, documented because the program accepts them and an option nobody can find is one nobody maintains.

--once: Serve one connection, then exit.
--connect-timeout-ms=N: Give up connecting after N milliseconds.
-V, --version: Print version.
-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 and SIGINT stop the daemon after the drain. SIGHUP reads the configuration again: a right withdrawn from the topic ACL applies at once, the TLS material to the next connect; a newly granted right, changed topics, broker address 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.
AMQP_PASSWORD: The SASL password; the setting amqp.sasl.password, above the files, below --set.

EXIT STATUS

0: Normal shutdown, or --check-config found the configuration valid.
1: Invalid configuration: a value, the broker URL, the SASL settings, the TLS files.
2: With --once, the broker connection was lost; with --check-config, a configuration file could not be read or does not parse.
3: The DDS participant or one of its endpoints could not be created.

FILES

/etc/zerodds/amqp-bridged.yaml .

AUTHORS

ZeroDDS Contributors.

BEZEICHNUNG

zerodds-amqp-bridged - Bridge-Daemon von DDS nach AMQP 1.0

ÜBERSICHT

zerodds-amqp-bridged [--config DATEI] [--broker URL] [--domain ID] [--topic DDS=ADR]... [-V | -h]

BESCHREIBUNG

zerodds-amqp-bridged verbindet DDS-Topics mit AMQP-1.0-Endpunkten. Unterstützt SASL ANONYMOUS, PLAIN, EXTERNAL, TLS, Links mit Sender-/Receiver-Settle-Modi und Routing anhand von Properties. Implementiert docs/specs/zerodds-amqp-bridge-daemon-1.0.md.

OPTIONEN

--config=DATEI: YAML-Konfiguration (Spec §3). Siehe zerodds-amqp-bridged.yaml(5).
--broker=URL: URL des AMQP-Brokers (amqp://, amqps://).
--container-id=ID: AMQP-Container-ID.
--domain=ID: DDS-Domain-ID.
--sasl-mechanism=NAME: Eines von PLAIN, SCRAM-SHA-256, EXTERNAL, ANONYMOUS, XOAUTH2.
--user=BENUTZER: SASL-Benutzername.
--password=PASSWORT: SASL-Passwort.
--tls-ca=DATEI: TLS-CA-Zertifikat.
--tls-cert=DATEI: TLS-Client-Zertifikat.
--tls-key=DATEI: TLS-Client-Schlüssel.
--topic=DDS=ADR: Topic-Zuordnung auf der Kommandozeile, überschreibt die Konfiguration.
--log-level=STUFE: Eine von trace, debug, info, warn, error.
--metrics=ADR: Listen-Adresse für Prometheus.

Test-Hooks. Echte Optionen, dokumentiert, weil das Programm sie annimmt und eine Option, die niemand findet, auch niemand pflegt.

--once: Eine Verbindung bedienen, dann beenden.
--connect-timeout-ms=N: Den Verbindungsaufbau nach N Millisekunden aufgeben.
-V, --version: Gibt die Version aus.
-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 und SIGINT beenden den Daemon nach dem Leeren der Warteschlangen. SIGHUP liest die Konfiguration neu: Ein in der Topic-ACL entzogenes Recht gilt sofort, das TLS-Material ab dem nächsten Verbindungsaufbau; ein neu gewährtes Recht, geänderte Topics, Broker-Adresse 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.
AMQP_PASSWORD: Das SASL-Passwort; die Einstellung amqp.sasl.password, über den Dateien, unter --set.

EXIT-STATUS

0: Normales Beenden, oder --check-config hat die Konfiguration als gültig befunden.
1: Ungültige Konfiguration: ein Wert, die Broker-URL, die SASL-Einstellungen, die TLS-Dateien.
2: Mit --once ist die Verbindung zum Broker verloren gegangen; mit --check-config war eine Konfigurationsdatei nicht lesbar oder nicht parsebar.
3: Der DDS-Teilnehmer oder einer seiner Endpunkte konnte nicht angelegt werden.

DATEIEN