This is the shipped English man-page reference for zerodds-ws-bridged — the same text as man zerodds-ws-bridged. The surrounding navigation follows the language switch; the reference body stays English, as man-pages conventionally do.

Dies ist die ausgelieferte englische man-page-Referenz für zerodds-ws-bridged — derselbe Text wie man zerodds-ws-bridged. Navigation und Seitenrahmen folgen dem Sprach-Umschalter; der Referenz-Body bleibt englisch, wie man-pages es konventionell tun.

NAME

zerodds-ws-bridged - DDS to WebSocket bridge daemon

SYNOPSIS

zerodds-ws-bridged [-c FILE | --config FILE] [--log-level LEVEL] [--metrics-bind ADDR] [--validate-only] [-V | --version] [-h | --help]

DESCRIPTION

zerodds-ws-bridged exposes selected DDS topics to WebSocket clients and forwards inbound WS messages onto matching DDS publishers. It is the reference DDS ←) WS bridge for the ZeroDDS distribution and implements zerodds-ws-bridge-1.0(7).

The daemon is configured via a YAML file (default /etc/zerodds/ws-bridged.yaml). On Linux it integrates with systemd(1) via Type=notify; on macOS with launchd(8); on Windows it runs as service ZeroDDSWSBridge.

OPTIONS

-c, --config=FILE

Path to the YAML configuration. See zerodds-ws-bridged.yaml(5).

--log-level=LEVEL

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

--metrics-bind=ADDR

Override the Prometheus metrics endpoint, e.g. 0.0.0.0:9091.

--validate-only

Parse the config, perform schema + cross-reference checks, exit 0 on success. Used by CI and packaging postinst scripts.

-V, --version

Print version and license info.

-h, --help

Print full option synopsis.

SIGNALS

SIGTERM

Graceful shutdown (drain in-flight WS frames, unregister DDS readers).

SIGHUP

Reload the configuration file. New routes are added, removed routes are disabled, in-flight messages drain.

ENVIRONMENT

ZERODDS_CONFIG

Fallback config path if --config is not provided.

RUST_LOG

Filter directives in tracing-subscriber(3) syntax. Overrides the YAML log section.

EXIT STATUS

0

Successful shutdown via SIGTERM.

64

Configuration error. Run with --validate-only to inspect.

73

Bind error — address in use, permission denied or invalid TLS material.

FILES

/etc/zerodds/ws-bridged.yaml

Default configuration. Documented in zerodds-ws-bridged.yaml(5).

/var/log/zerodds/ws-bridged.log

Log target when logging.destination is file:....

/var/lib/zerodds/

Persistent state (route shadows, durable WS session ids).

SEE ALSO

zerodds-ws-bridged.yaml(5), zerodds-mqtt-bridged(1), zerodds-admin(1), systemd.service(5).

STANDARDS

DDS 1.4, RTPS 2.5, XTypes 1.3, RFC 6455 (WebSocket), RFC 7692 (permessage-deflate).

AUTHORS

ZeroDDS Contributors <release@zerodds.org>.