Package: zenoh
Version: 1.4.0
Architecture: armhf
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 40
Depends: zenoh-plugin-rest (=1.4.0), zenoh-plugin-storage-manager (=1.4.0), zenohd (=1.4.0)
Filename: 1.4.0/zenoh_1.4.0_armhf.deb
Size: 16960
MD5sum: 2308abd0b1927b0e0ef8419d50a075cf
SHA1: 83cd382d00a45235c5f7233ec9763912b2df47e0
SHA256: 1f1557ca198ce25a2fd665a6d21b9adcd5be3f13f43ae00bddb765e292aab4f1
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol.
.
[](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++)
[](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/github/eclipse-zenoh/zenoh)
[](https://github.com/eclipse-zenoh/roadmap/discussions)
[](https://discord.gg/2GJ958VuHs)
[](https://choosealicense.com/licenses/epl-2.0/)
[](https://opensource.org/licenses/Apache-2.0)
.
# Eclipse Zenoh
.
The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute.
.
Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and
computations. It carefully blends traditional pub/sub with geo-distributed
storages, queries and computations, while retaining a level of time and space
efficiency that is well beyond any of the mainstream stacks.
.
Check the website [zenoh.io](http://zenoh.io) and the
[roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed
information.
.
-------------------------------
.
## Getting Started
.
Zenoh is extremely easy to learn, the best place to master the fundamentals is
our [getting started guide](https://zenoh.io/docs/getting-started/first-app/).
.
-------------------------------
.
## How to install it
.
To install the latest release of the Zenoh router (`zenohd`) and its default
plugins (REST API plugin and Storages Manager plugin) you can do as follows:
.
### Manual installation (all platforms)
.
All release packages can be downloaded from
[https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/).
.
Each subdirectory has the name of the Rust target. See the platforms each
target corresponds to on
[https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html).
.
Choose your platform and download the `.zip` file.
Unzip it where you want, and run the extracted `zenohd` binary.
.
### Linux Debian
.
Add Eclipse Zenoh private repository to the sources list, and install the
`zenoh` package:
.
```bash
echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" |
sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null
sudo apt update
sudo apt install zenoh
```
.
Then you can start run `zenohd`.
.
### MacOS
.
Tap our brew package repository and install the `zenoh` formula:
.
```bash
brew tap eclipse-zenoh/homebrew-zenoh
brew install zenoh
```
.
Then you can start run `zenohd`.
.
-------------------------------
.
## Rust API
.
* [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/)
.
-------------------------------
.
## How to build it
.
Install [Cargo and
Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh
can be successfully compiled with Rust stable (>= 1.75.0), so no special
configuration is required from your side. If you already have the Rust
toolchain installed, make sure it is up-to-date with:
.
```bash
rustup update
```
.
To build Zenoh, just type the following command after having followed the
previous instructions:
.
```bash
cargo build --release --all-targets
```
.
Zenoh's router is built as `target/release/zenohd`. All the examples are built
into the `target/release/examples` directory. They can all work in
peer-to-peer, or interconnected via the zenoh router.
.
-------------------------------
.
## Quick tests of your build
.
### Peer-to-peer tests
.
* **pub/sub**
* run: `./target/release/examples/z_sub`
* in another shell run: `./target/release/examples/z_put`
* the subscriber should receive the publication.
.
* **get/queryable**
* run: `./target/release/examples/z_queryable`
* in another shell run: `./target/release/examples/z_get`
* the queryable should display the log in its listener, and the get should
receive the queryable result.
.
### Routed tests
.
> [!NOTE]
> **Windows users**: to properly execute the commands below in PowerShell you
need to escape `"` characters as `\"`.
.
* **put / store / get**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell run:
.
```sh
./target/release/examples/z_put`
```
.
* then run
.
```sh
./target/release/examples/z_get
```
.
* the get should receive the stored publication.
.
* **REST API using `curl` tool**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, do a publication via the REST API:
.
```sh
curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test
```
.
* get it back via the REST API:
.
```sh
curl http://localhost:8000/demo/example/test
```
.
* **router admin space via the REST API**
* run the Zenoh router with permission to perform config changes via the
admin space, and with a memory storage:
.
```sh
./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, get info of the zenoh router via the zenoh admin space
(you may use `jq` for pretty json formatting):
.
```sh
curl -s http://localhost:8000/@/local/router | jq
```
.
* get the volumes of the router (only memory by default):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq
```
.
* get the storages of the local router (the memory storage configured at
startup on '/demo/example/**' should be present):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
* add another memory storage on `/demo/mystore/**`:
.
```sh
curl -X PUT -H 'content-type:application/json' -d
'{"key_expr":"demo/mystore/**","volume":"memory"}'
http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore
```
.
* check it has been created:
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
### Configuration options
.
A Zenoh configuration file can be provided via CLI to all Zenoh examples and
the Zenoh router.
.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and
the available options.
.
See other examples of Zenoh usage in [examples/](examples)
.
> [!NOTE]
> **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh
allows for configuring the number of worker threads and other advanced options
of the runtime. For guidance on utilizing it, please refer to the
[doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html).
.
-------------------------------
.
## Zenoh router command line arguments
.
`zenohd` accepts the following arguments:
.
* `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write
permissions on the admin space. Default is read only.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All
properties of this configuration are optional, so you may not need such a large
configuration for your use-case.
* `--cfg :`: allows you to change specific parts of the
configuration right after it has been constructed. VALUE must be a valid JSON5
value, and key must be a path through the configuration file, where each
element is separated by a `/`. When inserting in parts of the config that are
arrays, you may use indexes, or may use `+` to indicate that you want to append
your value to the array. `--cfg` passed values will always override any
previously existing value for their key in the configuration.
* `-l, --listen ...`: An endpoint on which this router will listen
for incoming sessions.
Repeat this option to open several listeners. By default, `tcp/[::]:7447` is
used. The following endpoints are currently supported:
* TCP: `tcp/:`
* UDP: `udp/:`
* [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:`
* [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:`
* `-e, --connect ...`: An endpoint this router will try to connect
to. Repeat this option to connect to several peers or routers.
* `--no-multicast-scouting`: By default zenohd replies to multicast scouting
messages for being discovered by peers and clients.
This option disables this feature.
* `-i, --id `: The identifier (as an hexadecimal string - e.g.:
A0B23...) that zenohd must use.
**WARNING**: this identifier must be unique in the system! If not set, a
random unsigned 128bit integer will be used.
* `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each
routed Data if there isn't already one.
This option disables this feature.
* `-P, --plugin [ | :]...`: A
[plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted
values:
* a plugin name; zenohd will search for a library named
`libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on
MacOS or `zenoh_plugin_.dll` on Windows.
* `":"`; the plugin will be loaded from library
file at ``.
.
Repeat this option to load several plugins.
* `--plugin-search-dir ...`: A directory where to search for
[plugins](https://zenoh.io/docs/manual/plugins/) libraries to load.
Repeat this option to specify several search directories'. By default, the
plugins libraries will be searched in:
`'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'`
* `--rest-http-port `: Configures the [REST
plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted
values:
* a port number
* a string with format `:` (to bind the HTTP server to
a specific interface)
* `"None"` to deactivate the REST plugin
.
If not specified, the REST plugin will be active on any interface (`[::]`)
and port `8000`.
.
-------------------------------
.
## Plugins
.
> [!WARNING]
> As Rust doesn't have a stable ABI, the plugins should be
built with the exact same Rust version as `zenohd`, and using for `zenoh`
dependency the same version (or commit number) as `zenohd` with the same
set of features. A plugin compiled with different Rust version or with
different set of `zenoh` crate features will be rejected when `zenohd` attempts
to load it. Otherwise, incompatibilities in memory mapping of structures shared
between `zenohd` and the library could lead to a `"SIGSEGV"` crash.
.
By default the Zenoh router is delivered or built with 2 plugins. These may be
configured through a configuration file, or through individual changes to the
configuration via the `--cfg` CLI option or via zenoh puts on individual parts
of the configuration.
.
**[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST
API):
This plugin converts GET and PUT REST requests into Zenoh gets and puts
respectively.
.
Note that to activate the REST plugin on `zenohd` the CLI argument should be
passed: `--rest-http-port=8000` (or any other port of your choice).
.
**[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)**
(managing [backends and
storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes))
This plugin allows you to easily define storages. These will store key-value
pairs they subscribed to, and send the most recent ones when queried. Check out
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them.
.
-------------------------------
.
## Troubleshooting
.
In case of troubles, please first check on [this
page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble
and cause are already known.
Otherwise, you can ask a question on the [zenoh Discord
server](https://discord.gg/vSDSpqnbkm), or [create an
issue](https://github.com/eclipse-zenoh/zenoh/issues).
Package: zenoh
Version: 1.4.0
Architecture: arm64
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 40
Depends: zenoh-plugin-rest (=1.4.0), zenoh-plugin-storage-manager (=1.4.0), zenohd (=1.4.0)
Filename: 1.4.0/zenoh_1.4.0_arm64.deb
Size: 16964
MD5sum: 1425a08017869eb310410850de6f0c36
SHA1: 8a491cb0797bd81e516cc5852f14690c3aeb3145
SHA256: 44b0bd06af16a01ae31fa8f99db814cd259e27a6d9f66acb15a87079295f000c
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol.
.
[](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++)
[](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/github/eclipse-zenoh/zenoh)
[](https://github.com/eclipse-zenoh/roadmap/discussions)
[](https://discord.gg/2GJ958VuHs)
[](https://choosealicense.com/licenses/epl-2.0/)
[](https://opensource.org/licenses/Apache-2.0)
.
# Eclipse Zenoh
.
The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute.
.
Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and
computations. It carefully blends traditional pub/sub with geo-distributed
storages, queries and computations, while retaining a level of time and space
efficiency that is well beyond any of the mainstream stacks.
.
Check the website [zenoh.io](http://zenoh.io) and the
[roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed
information.
.
-------------------------------
.
## Getting Started
.
Zenoh is extremely easy to learn, the best place to master the fundamentals is
our [getting started guide](https://zenoh.io/docs/getting-started/first-app/).
.
-------------------------------
.
## How to install it
.
To install the latest release of the Zenoh router (`zenohd`) and its default
plugins (REST API plugin and Storages Manager plugin) you can do as follows:
.
### Manual installation (all platforms)
.
All release packages can be downloaded from
[https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/).
.
Each subdirectory has the name of the Rust target. See the platforms each
target corresponds to on
[https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html).
.
Choose your platform and download the `.zip` file.
Unzip it where you want, and run the extracted `zenohd` binary.
.
### Linux Debian
.
Add Eclipse Zenoh private repository to the sources list, and install the
`zenoh` package:
.
```bash
echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" |
sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null
sudo apt update
sudo apt install zenoh
```
.
Then you can start run `zenohd`.
.
### MacOS
.
Tap our brew package repository and install the `zenoh` formula:
.
```bash
brew tap eclipse-zenoh/homebrew-zenoh
brew install zenoh
```
.
Then you can start run `zenohd`.
.
-------------------------------
.
## Rust API
.
* [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/)
.
-------------------------------
.
## How to build it
.
Install [Cargo and
Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh
can be successfully compiled with Rust stable (>= 1.75.0), so no special
configuration is required from your side. If you already have the Rust
toolchain installed, make sure it is up-to-date with:
.
```bash
rustup update
```
.
To build Zenoh, just type the following command after having followed the
previous instructions:
.
```bash
cargo build --release --all-targets
```
.
Zenoh's router is built as `target/release/zenohd`. All the examples are built
into the `target/release/examples` directory. They can all work in
peer-to-peer, or interconnected via the zenoh router.
.
-------------------------------
.
## Quick tests of your build
.
### Peer-to-peer tests
.
* **pub/sub**
* run: `./target/release/examples/z_sub`
* in another shell run: `./target/release/examples/z_put`
* the subscriber should receive the publication.
.
* **get/queryable**
* run: `./target/release/examples/z_queryable`
* in another shell run: `./target/release/examples/z_get`
* the queryable should display the log in its listener, and the get should
receive the queryable result.
.
### Routed tests
.
> [!NOTE]
> **Windows users**: to properly execute the commands below in PowerShell you
need to escape `"` characters as `\"`.
.
* **put / store / get**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell run:
.
```sh
./target/release/examples/z_put`
```
.
* then run
.
```sh
./target/release/examples/z_get
```
.
* the get should receive the stored publication.
.
* **REST API using `curl` tool**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, do a publication via the REST API:
.
```sh
curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test
```
.
* get it back via the REST API:
.
```sh
curl http://localhost:8000/demo/example/test
```
.
* **router admin space via the REST API**
* run the Zenoh router with permission to perform config changes via the
admin space, and with a memory storage:
.
```sh
./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, get info of the zenoh router via the zenoh admin space
(you may use `jq` for pretty json formatting):
.
```sh
curl -s http://localhost:8000/@/local/router | jq
```
.
* get the volumes of the router (only memory by default):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq
```
.
* get the storages of the local router (the memory storage configured at
startup on '/demo/example/**' should be present):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
* add another memory storage on `/demo/mystore/**`:
.
```sh
curl -X PUT -H 'content-type:application/json' -d
'{"key_expr":"demo/mystore/**","volume":"memory"}'
http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore
```
.
* check it has been created:
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
### Configuration options
.
A Zenoh configuration file can be provided via CLI to all Zenoh examples and
the Zenoh router.
.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and
the available options.
.
See other examples of Zenoh usage in [examples/](examples)
.
> [!NOTE]
> **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh
allows for configuring the number of worker threads and other advanced options
of the runtime. For guidance on utilizing it, please refer to the
[doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html).
.
-------------------------------
.
## Zenoh router command line arguments
.
`zenohd` accepts the following arguments:
.
* `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write
permissions on the admin space. Default is read only.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All
properties of this configuration are optional, so you may not need such a large
configuration for your use-case.
* `--cfg :`: allows you to change specific parts of the
configuration right after it has been constructed. VALUE must be a valid JSON5
value, and key must be a path through the configuration file, where each
element is separated by a `/`. When inserting in parts of the config that are
arrays, you may use indexes, or may use `+` to indicate that you want to append
your value to the array. `--cfg` passed values will always override any
previously existing value for their key in the configuration.
* `-l, --listen ...`: An endpoint on which this router will listen
for incoming sessions.
Repeat this option to open several listeners. By default, `tcp/[::]:7447` is
used. The following endpoints are currently supported:
* TCP: `tcp/:`
* UDP: `udp/:`
* [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:`
* [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:`
* `-e, --connect ...`: An endpoint this router will try to connect
to. Repeat this option to connect to several peers or routers.
* `--no-multicast-scouting`: By default zenohd replies to multicast scouting
messages for being discovered by peers and clients.
This option disables this feature.
* `-i, --id `: The identifier (as an hexadecimal string - e.g.:
A0B23...) that zenohd must use.
**WARNING**: this identifier must be unique in the system! If not set, a
random unsigned 128bit integer will be used.
* `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each
routed Data if there isn't already one.
This option disables this feature.
* `-P, --plugin [ | :]...`: A
[plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted
values:
* a plugin name; zenohd will search for a library named
`libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on
MacOS or `zenoh_plugin_.dll` on Windows.
* `":"`; the plugin will be loaded from library
file at ``.
.
Repeat this option to load several plugins.
* `--plugin-search-dir ...`: A directory where to search for
[plugins](https://zenoh.io/docs/manual/plugins/) libraries to load.
Repeat this option to specify several search directories'. By default, the
plugins libraries will be searched in:
`'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'`
* `--rest-http-port `: Configures the [REST
plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted
values:
* a port number
* a string with format `:` (to bind the HTTP server to
a specific interface)
* `"None"` to deactivate the REST plugin
.
If not specified, the REST plugin will be active on any interface (`[::]`)
and port `8000`.
.
-------------------------------
.
## Plugins
.
> [!WARNING]
> As Rust doesn't have a stable ABI, the plugins should be
built with the exact same Rust version as `zenohd`, and using for `zenoh`
dependency the same version (or commit number) as `zenohd` with the same
set of features. A plugin compiled with different Rust version or with
different set of `zenoh` crate features will be rejected when `zenohd` attempts
to load it. Otherwise, incompatibilities in memory mapping of structures shared
between `zenohd` and the library could lead to a `"SIGSEGV"` crash.
.
By default the Zenoh router is delivered or built with 2 plugins. These may be
configured through a configuration file, or through individual changes to the
configuration via the `--cfg` CLI option or via zenoh puts on individual parts
of the configuration.
.
**[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST
API):
This plugin converts GET and PUT REST requests into Zenoh gets and puts
respectively.
.
Note that to activate the REST plugin on `zenohd` the CLI argument should be
passed: `--rest-http-port=8000` (or any other port of your choice).
.
**[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)**
(managing [backends and
storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes))
This plugin allows you to easily define storages. These will store key-value
pairs they subscribed to, and send the most recent ones when queried. Check out
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them.
.
-------------------------------
.
## Troubleshooting
.
In case of troubles, please first check on [this
page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble
and cause are already known.
Otherwise, you can ask a question on the [zenoh Discord
server](https://discord.gg/vSDSpqnbkm), or [create an
issue](https://github.com/eclipse-zenoh/zenoh/issues).
Package: zenoh
Version: 1.4.0
Architecture: armel
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 40
Depends: zenoh-plugin-rest (=1.4.0), zenoh-plugin-storage-manager (=1.4.0), zenohd (=1.4.0)
Filename: 1.4.0/zenoh_1.4.0_armel.deb
Size: 16960
MD5sum: 9b0b5c8b31eadf6e8e30a6fe77b06168
SHA1: dd4443ae06014a171e4214f2bf5635a6ca1ae1bf
SHA256: c6e41499a159abfbc050c5157a24235aa7eabf5870561badf6a933a6d918a3c0
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol.
.
[](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++)
[](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/github/eclipse-zenoh/zenoh)
[](https://github.com/eclipse-zenoh/roadmap/discussions)
[](https://discord.gg/2GJ958VuHs)
[](https://choosealicense.com/licenses/epl-2.0/)
[](https://opensource.org/licenses/Apache-2.0)
.
# Eclipse Zenoh
.
The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute.
.
Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and
computations. It carefully blends traditional pub/sub with geo-distributed
storages, queries and computations, while retaining a level of time and space
efficiency that is well beyond any of the mainstream stacks.
.
Check the website [zenoh.io](http://zenoh.io) and the
[roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed
information.
.
-------------------------------
.
## Getting Started
.
Zenoh is extremely easy to learn, the best place to master the fundamentals is
our [getting started guide](https://zenoh.io/docs/getting-started/first-app/).
.
-------------------------------
.
## How to install it
.
To install the latest release of the Zenoh router (`zenohd`) and its default
plugins (REST API plugin and Storages Manager plugin) you can do as follows:
.
### Manual installation (all platforms)
.
All release packages can be downloaded from
[https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/).
.
Each subdirectory has the name of the Rust target. See the platforms each
target corresponds to on
[https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html).
.
Choose your platform and download the `.zip` file.
Unzip it where you want, and run the extracted `zenohd` binary.
.
### Linux Debian
.
Add Eclipse Zenoh private repository to the sources list, and install the
`zenoh` package:
.
```bash
echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" |
sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null
sudo apt update
sudo apt install zenoh
```
.
Then you can start run `zenohd`.
.
### MacOS
.
Tap our brew package repository and install the `zenoh` formula:
.
```bash
brew tap eclipse-zenoh/homebrew-zenoh
brew install zenoh
```
.
Then you can start run `zenohd`.
.
-------------------------------
.
## Rust API
.
* [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/)
.
-------------------------------
.
## How to build it
.
Install [Cargo and
Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh
can be successfully compiled with Rust stable (>= 1.75.0), so no special
configuration is required from your side. If you already have the Rust
toolchain installed, make sure it is up-to-date with:
.
```bash
rustup update
```
.
To build Zenoh, just type the following command after having followed the
previous instructions:
.
```bash
cargo build --release --all-targets
```
.
Zenoh's router is built as `target/release/zenohd`. All the examples are built
into the `target/release/examples` directory. They can all work in
peer-to-peer, or interconnected via the zenoh router.
.
-------------------------------
.
## Quick tests of your build
.
### Peer-to-peer tests
.
* **pub/sub**
* run: `./target/release/examples/z_sub`
* in another shell run: `./target/release/examples/z_put`
* the subscriber should receive the publication.
.
* **get/queryable**
* run: `./target/release/examples/z_queryable`
* in another shell run: `./target/release/examples/z_get`
* the queryable should display the log in its listener, and the get should
receive the queryable result.
.
### Routed tests
.
> [!NOTE]
> **Windows users**: to properly execute the commands below in PowerShell you
need to escape `"` characters as `\"`.
.
* **put / store / get**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell run:
.
```sh
./target/release/examples/z_put`
```
.
* then run
.
```sh
./target/release/examples/z_get
```
.
* the get should receive the stored publication.
.
* **REST API using `curl` tool**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, do a publication via the REST API:
.
```sh
curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test
```
.
* get it back via the REST API:
.
```sh
curl http://localhost:8000/demo/example/test
```
.
* **router admin space via the REST API**
* run the Zenoh router with permission to perform config changes via the
admin space, and with a memory storage:
.
```sh
./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, get info of the zenoh router via the zenoh admin space
(you may use `jq` for pretty json formatting):
.
```sh
curl -s http://localhost:8000/@/local/router | jq
```
.
* get the volumes of the router (only memory by default):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq
```
.
* get the storages of the local router (the memory storage configured at
startup on '/demo/example/**' should be present):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
* add another memory storage on `/demo/mystore/**`:
.
```sh
curl -X PUT -H 'content-type:application/json' -d
'{"key_expr":"demo/mystore/**","volume":"memory"}'
http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore
```
.
* check it has been created:
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
### Configuration options
.
A Zenoh configuration file can be provided via CLI to all Zenoh examples and
the Zenoh router.
.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and
the available options.
.
See other examples of Zenoh usage in [examples/](examples)
.
> [!NOTE]
> **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh
allows for configuring the number of worker threads and other advanced options
of the runtime. For guidance on utilizing it, please refer to the
[doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html).
.
-------------------------------
.
## Zenoh router command line arguments
.
`zenohd` accepts the following arguments:
.
* `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write
permissions on the admin space. Default is read only.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All
properties of this configuration are optional, so you may not need such a large
configuration for your use-case.
* `--cfg :`: allows you to change specific parts of the
configuration right after it has been constructed. VALUE must be a valid JSON5
value, and key must be a path through the configuration file, where each
element is separated by a `/`. When inserting in parts of the config that are
arrays, you may use indexes, or may use `+` to indicate that you want to append
your value to the array. `--cfg` passed values will always override any
previously existing value for their key in the configuration.
* `-l, --listen ...`: An endpoint on which this router will listen
for incoming sessions.
Repeat this option to open several listeners. By default, `tcp/[::]:7447` is
used. The following endpoints are currently supported:
* TCP: `tcp/:`
* UDP: `udp/:`
* [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:`
* [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:`
* `-e, --connect ...`: An endpoint this router will try to connect
to. Repeat this option to connect to several peers or routers.
* `--no-multicast-scouting`: By default zenohd replies to multicast scouting
messages for being discovered by peers and clients.
This option disables this feature.
* `-i, --id `: The identifier (as an hexadecimal string - e.g.:
A0B23...) that zenohd must use.
**WARNING**: this identifier must be unique in the system! If not set, a
random unsigned 128bit integer will be used.
* `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each
routed Data if there isn't already one.
This option disables this feature.
* `-P, --plugin [ | :]...`: A
[plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted
values:
* a plugin name; zenohd will search for a library named
`libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on
MacOS or `zenoh_plugin_.dll` on Windows.
* `":"`; the plugin will be loaded from library
file at ``.
.
Repeat this option to load several plugins.
* `--plugin-search-dir ...`: A directory where to search for
[plugins](https://zenoh.io/docs/manual/plugins/) libraries to load.
Repeat this option to specify several search directories'. By default, the
plugins libraries will be searched in:
`'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'`
* `--rest-http-port `: Configures the [REST
plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted
values:
* a port number
* a string with format `:` (to bind the HTTP server to
a specific interface)
* `"None"` to deactivate the REST plugin
.
If not specified, the REST plugin will be active on any interface (`[::]`)
and port `8000`.
.
-------------------------------
.
## Plugins
.
> [!WARNING]
> As Rust doesn't have a stable ABI, the plugins should be
built with the exact same Rust version as `zenohd`, and using for `zenoh`
dependency the same version (or commit number) as `zenohd` with the same
set of features. A plugin compiled with different Rust version or with
different set of `zenoh` crate features will be rejected when `zenohd` attempts
to load it. Otherwise, incompatibilities in memory mapping of structures shared
between `zenohd` and the library could lead to a `"SIGSEGV"` crash.
.
By default the Zenoh router is delivered or built with 2 plugins. These may be
configured through a configuration file, or through individual changes to the
configuration via the `--cfg` CLI option or via zenoh puts on individual parts
of the configuration.
.
**[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST
API):
This plugin converts GET and PUT REST requests into Zenoh gets and puts
respectively.
.
Note that to activate the REST plugin on `zenohd` the CLI argument should be
passed: `--rest-http-port=8000` (or any other port of your choice).
.
**[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)**
(managing [backends and
storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes))
This plugin allows you to easily define storages. These will store key-value
pairs they subscribed to, and send the most recent ones when queried. Check out
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them.
.
-------------------------------
.
## Troubleshooting
.
In case of troubles, please first check on [this
page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble
and cause are already known.
Otherwise, you can ask a question on the [zenoh Discord
server](https://discord.gg/vSDSpqnbkm), or [create an
issue](https://github.com/eclipse-zenoh/zenoh/issues).
Package: zenoh
Version: 1.4.0
Architecture: amd64
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 40
Depends: zenoh-plugin-rest (=1.4.0), zenoh-plugin-storage-manager (=1.4.0), zenohd (=1.4.0)
Filename: 1.4.0/zenoh_1.4.0_amd64.deb
Size: 16964
MD5sum: ba6041ffa760d6e2084f7855a820d457
SHA1: 1b4960b6adae8c6e564dbcfc70c3eac1a9338fbf
SHA256: c6ea8f19a460c777ebaff64d42f2ff33aee3651c8e683a983bbebc74d1567841
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol.
.
[](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++)
[](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/github/eclipse-zenoh/zenoh)
[](https://github.com/eclipse-zenoh/roadmap/discussions)
[](https://discord.gg/2GJ958VuHs)
[](https://choosealicense.com/licenses/epl-2.0/)
[](https://opensource.org/licenses/Apache-2.0)
.
# Eclipse Zenoh
.
The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute.
.
Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and
computations. It carefully blends traditional pub/sub with geo-distributed
storages, queries and computations, while retaining a level of time and space
efficiency that is well beyond any of the mainstream stacks.
.
Check the website [zenoh.io](http://zenoh.io) and the
[roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed
information.
.
-------------------------------
.
## Getting Started
.
Zenoh is extremely easy to learn, the best place to master the fundamentals is
our [getting started guide](https://zenoh.io/docs/getting-started/first-app/).
.
-------------------------------
.
## How to install it
.
To install the latest release of the Zenoh router (`zenohd`) and its default
plugins (REST API plugin and Storages Manager plugin) you can do as follows:
.
### Manual installation (all platforms)
.
All release packages can be downloaded from
[https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/).
.
Each subdirectory has the name of the Rust target. See the platforms each
target corresponds to on
[https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html).
.
Choose your platform and download the `.zip` file.
Unzip it where you want, and run the extracted `zenohd` binary.
.
### Linux Debian
.
Add Eclipse Zenoh private repository to the sources list, and install the
`zenoh` package:
.
```bash
echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" |
sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null
sudo apt update
sudo apt install zenoh
```
.
Then you can start run `zenohd`.
.
### MacOS
.
Tap our brew package repository and install the `zenoh` formula:
.
```bash
brew tap eclipse-zenoh/homebrew-zenoh
brew install zenoh
```
.
Then you can start run `zenohd`.
.
-------------------------------
.
## Rust API
.
* [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/)
.
-------------------------------
.
## How to build it
.
Install [Cargo and
Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh
can be successfully compiled with Rust stable (>= 1.75.0), so no special
configuration is required from your side. If you already have the Rust
toolchain installed, make sure it is up-to-date with:
.
```bash
rustup update
```
.
To build Zenoh, just type the following command after having followed the
previous instructions:
.
```bash
cargo build --release --all-targets
```
.
Zenoh's router is built as `target/release/zenohd`. All the examples are built
into the `target/release/examples` directory. They can all work in
peer-to-peer, or interconnected via the zenoh router.
.
-------------------------------
.
## Quick tests of your build
.
### Peer-to-peer tests
.
* **pub/sub**
* run: `./target/release/examples/z_sub`
* in another shell run: `./target/release/examples/z_put`
* the subscriber should receive the publication.
.
* **get/queryable**
* run: `./target/release/examples/z_queryable`
* in another shell run: `./target/release/examples/z_get`
* the queryable should display the log in its listener, and the get should
receive the queryable result.
.
### Routed tests
.
> [!NOTE]
> **Windows users**: to properly execute the commands below in PowerShell you
need to escape `"` characters as `\"`.
.
* **put / store / get**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell run:
.
```sh
./target/release/examples/z_put`
```
.
* then run
.
```sh
./target/release/examples/z_get
```
.
* the get should receive the stored publication.
.
* **REST API using `curl` tool**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, do a publication via the REST API:
.
```sh
curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test
```
.
* get it back via the REST API:
.
```sh
curl http://localhost:8000/demo/example/test
```
.
* **router admin space via the REST API**
* run the Zenoh router with permission to perform config changes via the
admin space, and with a memory storage:
.
```sh
./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, get info of the zenoh router via the zenoh admin space
(you may use `jq` for pretty json formatting):
.
```sh
curl -s http://localhost:8000/@/local/router | jq
```
.
* get the volumes of the router (only memory by default):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq
```
.
* get the storages of the local router (the memory storage configured at
startup on '/demo/example/**' should be present):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
* add another memory storage on `/demo/mystore/**`:
.
```sh
curl -X PUT -H 'content-type:application/json' -d
'{"key_expr":"demo/mystore/**","volume":"memory"}'
http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore
```
.
* check it has been created:
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
### Configuration options
.
A Zenoh configuration file can be provided via CLI to all Zenoh examples and
the Zenoh router.
.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and
the available options.
.
See other examples of Zenoh usage in [examples/](examples)
.
> [!NOTE]
> **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh
allows for configuring the number of worker threads and other advanced options
of the runtime. For guidance on utilizing it, please refer to the
[doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html).
.
-------------------------------
.
## Zenoh router command line arguments
.
`zenohd` accepts the following arguments:
.
* `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write
permissions on the admin space. Default is read only.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All
properties of this configuration are optional, so you may not need such a large
configuration for your use-case.
* `--cfg :`: allows you to change specific parts of the
configuration right after it has been constructed. VALUE must be a valid JSON5
value, and key must be a path through the configuration file, where each
element is separated by a `/`. When inserting in parts of the config that are
arrays, you may use indexes, or may use `+` to indicate that you want to append
your value to the array. `--cfg` passed values will always override any
previously existing value for their key in the configuration.
* `-l, --listen ...`: An endpoint on which this router will listen
for incoming sessions.
Repeat this option to open several listeners. By default, `tcp/[::]:7447` is
used. The following endpoints are currently supported:
* TCP: `tcp/:`
* UDP: `udp/:`
* [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:`
* [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:`
* `-e, --connect ...`: An endpoint this router will try to connect
to. Repeat this option to connect to several peers or routers.
* `--no-multicast-scouting`: By default zenohd replies to multicast scouting
messages for being discovered by peers and clients.
This option disables this feature.
* `-i, --id `: The identifier (as an hexadecimal string - e.g.:
A0B23...) that zenohd must use.
**WARNING**: this identifier must be unique in the system! If not set, a
random unsigned 128bit integer will be used.
* `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each
routed Data if there isn't already one.
This option disables this feature.
* `-P, --plugin [ | :]...`: A
[plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted
values:
* a plugin name; zenohd will search for a library named
`libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on
MacOS or `zenoh_plugin_.dll` on Windows.
* `":"`; the plugin will be loaded from library
file at ``.
.
Repeat this option to load several plugins.
* `--plugin-search-dir ...`: A directory where to search for
[plugins](https://zenoh.io/docs/manual/plugins/) libraries to load.
Repeat this option to specify several search directories'. By default, the
plugins libraries will be searched in:
`'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'`
* `--rest-http-port `: Configures the [REST
plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted
values:
* a port number
* a string with format `:` (to bind the HTTP server to
a specific interface)
* `"None"` to deactivate the REST plugin
.
If not specified, the REST plugin will be active on any interface (`[::]`)
and port `8000`.
.
-------------------------------
.
## Plugins
.
> [!WARNING]
> As Rust doesn't have a stable ABI, the plugins should be
built with the exact same Rust version as `zenohd`, and using for `zenoh`
dependency the same version (or commit number) as `zenohd` with the same
set of features. A plugin compiled with different Rust version or with
different set of `zenoh` crate features will be rejected when `zenohd` attempts
to load it. Otherwise, incompatibilities in memory mapping of structures shared
between `zenohd` and the library could lead to a `"SIGSEGV"` crash.
.
By default the Zenoh router is delivered or built with 2 plugins. These may be
configured through a configuration file, or through individual changes to the
configuration via the `--cfg` CLI option or via zenoh puts on individual parts
of the configuration.
.
**[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST
API):
This plugin converts GET and PUT REST requests into Zenoh gets and puts
respectively.
.
Note that to activate the REST plugin on `zenohd` the CLI argument should be
passed: `--rest-http-port=8000` (or any other port of your choice).
.
**[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)**
(managing [backends and
storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes))
This plugin allows you to easily define storages. These will store key-value
pairs they subscribed to, and send the most recent ones when queried. Check out
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them.
.
-------------------------------
.
## Troubleshooting
.
In case of troubles, please first check on [this
page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble
and cause are already known.
Otherwise, you can ask a question on the [zenoh Discord
server](https://discord.gg/vSDSpqnbkm), or [create an
issue](https://github.com/eclipse-zenoh/zenoh/issues).
Package: zenoh-plugin-rest
Version: 1.4.0
Architecture: armhf
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 4312
Depends: zenohd (=1.4.0)
Filename: 1.4.0/zenoh-plugin-rest_1.4.0_armhf.deb
Size: 1182200
MD5sum: 336c37b3c7991c7b089dbba48b775dbf
SHA1: 26ef29c43fe4d4e47e39c85f690b0a537f8227fd
SHA256: 25a6cf008292cee4dfb1925a5d12597ac4c159925729e4700ca7729662ae1e85
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: The zenoh REST plugin
# ⚠️ WARNING ⚠️
.
This crate is intended for Zenoh's internal use.
It is not guaranteed that the API will remain unchanged in any version,
including patch updates.
It is highly recommended to depend solely on the zenoh and zenoh-ext crates and
to utilize their public APIs.
.
- [Click here for Zenoh's main
repository](https://github.com/eclipse-zenoh/zenoh)
- [Click here for Zenoh's documentation](https://zenoh.io)
Package: zenoh-plugin-rest
Version: 1.4.0
Architecture: amd64
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 4607
Depends: zenohd (=1.4.0)
Filename: 1.4.0/zenoh-plugin-rest_1.4.0_amd64.deb
Size: 1240056
MD5sum: 7332992d6bd22bd9d41e4de52d98ffb8
SHA1: 86728a278659498e654b32d981f8f3c771f58e83
SHA256: ecfec093c6069189a873aae10381d13372c9b1f9a69517ce6cd3a3d3a49871a3
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: The zenoh REST plugin
# ⚠️ WARNING ⚠️
.
This crate is intended for Zenoh's internal use.
It is not guaranteed that the API will remain unchanged in any version,
including patch updates.
It is highly recommended to depend solely on the zenoh and zenoh-ext crates and
to utilize their public APIs.
.
- [Click here for Zenoh's main
repository](https://github.com/eclipse-zenoh/zenoh)
- [Click here for Zenoh's documentation](https://zenoh.io)
Package: zenoh-plugin-rest
Version: 1.4.0
Architecture: armel
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 4385
Depends: zenohd (=1.4.0)
Filename: 1.4.0/zenoh-plugin-rest_1.4.0_armel.deb
Size: 1186484
MD5sum: 8fc99d3dfae2b62c7bfcad047cdd9452
SHA1: 85690967d1d41127dfcc7ce7696ff03cd17a35c0
SHA256: 48551626612a4319a8170e5c46cb69df569711d185d03801c545b7563654322a
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: The zenoh REST plugin
# ⚠️ WARNING ⚠️
.
This crate is intended for Zenoh's internal use.
It is not guaranteed that the API will remain unchanged in any version,
including patch updates.
It is highly recommended to depend solely on the zenoh and zenoh-ext crates and
to utilize their public APIs.
.
- [Click here for Zenoh's main
repository](https://github.com/eclipse-zenoh/zenoh)
- [Click here for Zenoh's documentation](https://zenoh.io)
Package: zenoh-plugin-rest
Version: 1.4.0
Architecture: arm64
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 4652
Depends: zenohd (=1.4.0)
Filename: 1.4.0/zenoh-plugin-rest_1.4.0_arm64.deb
Size: 1145896
MD5sum: b8e3d4d2e9dc610fa88b354ade736870
SHA1: dc3f95ca6ab82c0b54aaff954a520e27ba60fed5
SHA256: 225128b2f59321794ef1c27d6526a4623dcc5670b3220df16646b40c704336ac
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: The zenoh REST plugin
# ⚠️ WARNING ⚠️
.
This crate is intended for Zenoh's internal use.
It is not guaranteed that the API will remain unchanged in any version,
including patch updates.
It is highly recommended to depend solely on the zenoh and zenoh-ext crates and
to utilize their public APIs.
.
- [Click here for Zenoh's main
repository](https://github.com/eclipse-zenoh/zenoh)
- [Click here for Zenoh's documentation](https://zenoh.io)
Package: zenoh-plugin-storage-manager
Version: 1.4.0
Architecture: amd64
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 4341
Depends: zenohd (=1.4.0)
Filename: 1.4.0/zenoh-plugin-storage-manager_1.4.0_amd64.deb
Size: 1134400
MD5sum: 91cfafc2d0b2ef01730e8f4cb2f59f70
SHA1: 476152176255f1908eeb961017147ecc9a2e9eb5
SHA256: 1f7630728ffcd07050bba39bc66c4eef1ec3a0b1840522d3af387f93e1a587ba
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: The zenoh storages plugin.
# ⚠️ WARNING ⚠️
.
This crate is intended for Zenoh's internal use.
It is not guaranteed that the API will remain unchanged in any version,
including patch updates.
It is highly recommended to depend solely on the zenoh and zenoh-ext crates and
to utilize their public APIs.
.
- [Click here for Zenoh's main
repository](https://github.com/eclipse-zenoh/zenoh)
- [Click here for Zenoh's documentation](https://zenoh.io)
Package: zenoh-plugin-storage-manager
Version: 1.4.0
Architecture: armel
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 4130
Depends: zenohd (=1.4.0)
Filename: 1.4.0/zenoh-plugin-storage-manager_1.4.0_armel.deb
Size: 1100172
MD5sum: 488a7757d74b364f55c73d93f8c9a314
SHA1: 6659ac7dee1a424d09a3759750d7144ba9d0dc76
SHA256: d73487150f36c0c4df50aee288f6c3cfa1b897be06fbf0659d97d3e66744a3c2
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: The zenoh storages plugin.
# ⚠️ WARNING ⚠️
.
This crate is intended for Zenoh's internal use.
It is not guaranteed that the API will remain unchanged in any version,
including patch updates.
It is highly recommended to depend solely on the zenoh and zenoh-ext crates and
to utilize their public APIs.
.
- [Click here for Zenoh's main
repository](https://github.com/eclipse-zenoh/zenoh)
- [Click here for Zenoh's documentation](https://zenoh.io)
Package: zenoh-plugin-storage-manager
Version: 1.4.0
Architecture: arm64
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 4365
Depends: zenohd (=1.4.0)
Filename: 1.4.0/zenoh-plugin-storage-manager_1.4.0_arm64.deb
Size: 1049664
MD5sum: 8b0762042a017af40b2c5fbda1a4d8a0
SHA1: 4d1225f076575294a395ef314107a735a2a856e7
SHA256: 8d93c6dff015f94593cdf1d20a1da102a65cc20060818222158960218a63dc7c
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: The zenoh storages plugin.
# ⚠️ WARNING ⚠️
.
This crate is intended for Zenoh's internal use.
It is not guaranteed that the API will remain unchanged in any version,
including patch updates.
It is highly recommended to depend solely on the zenoh and zenoh-ext crates and
to utilize their public APIs.
.
- [Click here for Zenoh's main
repository](https://github.com/eclipse-zenoh/zenoh)
- [Click here for Zenoh's documentation](https://zenoh.io)
Package: zenoh-plugin-storage-manager
Version: 1.4.0
Architecture: armhf
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 4041
Depends: zenohd (=1.4.0)
Filename: 1.4.0/zenoh-plugin-storage-manager_1.4.0_armhf.deb
Size: 1094368
MD5sum: 1bf5e3b26a76bea3e6233f424402fcaf
SHA1: 89ef673ad87ea3a6d37998a53be6628c7a95d836
SHA256: 4906dbc4afc0aec96e714c93743b70d1dd126264ccc654784a27201b5fdfeabc
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: The zenoh storages plugin.
# ⚠️ WARNING ⚠️
.
This crate is intended for Zenoh's internal use.
It is not guaranteed that the API will remain unchanged in any version,
including patch updates.
It is highly recommended to depend solely on the zenoh and zenoh-ext crates and
to utilize their public APIs.
.
- [Click here for Zenoh's main
repository](https://github.com/eclipse-zenoh/zenoh)
- [Click here for Zenoh's documentation](https://zenoh.io)
Package: zenohd
Version: 1.4.0
Architecture: armhf
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 13502
Filename: 1.4.0/zenohd_1.4.0_armhf.deb
Size: 3713904
MD5sum: 55219f62eddefa35150eee77b20e38a2
SHA1: df2aecd0493b7401700057a8d532c75bfcd2f9aa
SHA256: 725331d046d3816af914f607a1ddf2c6f1cfa646ae086f8766a703ec4edba644
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol.
.
[](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++)
[](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/github/eclipse-zenoh/zenoh)
[](https://github.com/eclipse-zenoh/roadmap/discussions)
[](https://discord.gg/2GJ958VuHs)
[](https://choosealicense.com/licenses/epl-2.0/)
[](https://opensource.org/licenses/Apache-2.0)
.
# Eclipse Zenoh
.
The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute.
.
Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and
computations. It carefully blends traditional pub/sub with geo-distributed
storages, queries and computations, while retaining a level of time and space
efficiency that is well beyond any of the mainstream stacks.
.
Check the website [zenoh.io](http://zenoh.io) and the
[roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed
information.
.
-------------------------------
.
## Getting Started
.
Zenoh is extremely easy to learn, the best place to master the fundamentals is
our [getting started guide](https://zenoh.io/docs/getting-started/first-app/).
.
-------------------------------
.
## How to install it
.
To install the latest release of the Zenoh router (`zenohd`) and its default
plugins (REST API plugin and Storages Manager plugin) you can do as follows:
.
### Manual installation (all platforms)
.
All release packages can be downloaded from
[https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/).
.
Each subdirectory has the name of the Rust target. See the platforms each
target corresponds to on
[https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html).
.
Choose your platform and download the `.zip` file.
Unzip it where you want, and run the extracted `zenohd` binary.
.
### Linux Debian
.
Add Eclipse Zenoh private repository to the sources list, and install the
`zenoh` package:
.
```bash
echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" |
sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null
sudo apt update
sudo apt install zenoh
```
.
Then you can start run `zenohd`.
.
### MacOS
.
Tap our brew package repository and install the `zenoh` formula:
.
```bash
brew tap eclipse-zenoh/homebrew-zenoh
brew install zenoh
```
.
Then you can start run `zenohd`.
.
-------------------------------
.
## Rust API
.
* [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/)
.
-------------------------------
.
## How to build it
.
Install [Cargo and
Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh
can be successfully compiled with Rust stable (>= 1.75.0), so no special
configuration is required from your side. If you already have the Rust
toolchain installed, make sure it is up-to-date with:
.
```bash
rustup update
```
.
To build Zenoh, just type the following command after having followed the
previous instructions:
.
```bash
cargo build --release --all-targets
```
.
Zenoh's router is built as `target/release/zenohd`. All the examples are built
into the `target/release/examples` directory. They can all work in
peer-to-peer, or interconnected via the zenoh router.
.
-------------------------------
.
## Quick tests of your build
.
### Peer-to-peer tests
.
* **pub/sub**
* run: `./target/release/examples/z_sub`
* in another shell run: `./target/release/examples/z_put`
* the subscriber should receive the publication.
.
* **get/queryable**
* run: `./target/release/examples/z_queryable`
* in another shell run: `./target/release/examples/z_get`
* the queryable should display the log in its listener, and the get should
receive the queryable result.
.
### Routed tests
.
> [!NOTE]
> **Windows users**: to properly execute the commands below in PowerShell you
need to escape `"` characters as `\"`.
.
* **put / store / get**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell run:
.
```sh
./target/release/examples/z_put`
```
.
* then run
.
```sh
./target/release/examples/z_get
```
.
* the get should receive the stored publication.
.
* **REST API using `curl` tool**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, do a publication via the REST API:
.
```sh
curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test
```
.
* get it back via the REST API:
.
```sh
curl http://localhost:8000/demo/example/test
```
.
* **router admin space via the REST API**
* run the Zenoh router with permission to perform config changes via the
admin space, and with a memory storage:
.
```sh
./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, get info of the zenoh router via the zenoh admin space
(you may use `jq` for pretty json formatting):
.
```sh
curl -s http://localhost:8000/@/local/router | jq
```
.
* get the volumes of the router (only memory by default):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq
```
.
* get the storages of the local router (the memory storage configured at
startup on '/demo/example/**' should be present):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
* add another memory storage on `/demo/mystore/**`:
.
```sh
curl -X PUT -H 'content-type:application/json' -d
'{"key_expr":"demo/mystore/**","volume":"memory"}'
http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore
```
.
* check it has been created:
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
### Configuration options
.
A Zenoh configuration file can be provided via CLI to all Zenoh examples and
the Zenoh router.
.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and
the available options.
.
See other examples of Zenoh usage in [examples/](examples)
.
> [!NOTE]
> **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh
allows for configuring the number of worker threads and other advanced options
of the runtime. For guidance on utilizing it, please refer to the
[doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html).
.
-------------------------------
.
## Zenoh router command line arguments
.
`zenohd` accepts the following arguments:
.
* `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write
permissions on the admin space. Default is read only.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All
properties of this configuration are optional, so you may not need such a large
configuration for your use-case.
* `--cfg :`: allows you to change specific parts of the
configuration right after it has been constructed. VALUE must be a valid JSON5
value, and key must be a path through the configuration file, where each
element is separated by a `/`. When inserting in parts of the config that are
arrays, you may use indexes, or may use `+` to indicate that you want to append
your value to the array. `--cfg` passed values will always override any
previously existing value for their key in the configuration.
* `-l, --listen ...`: An endpoint on which this router will listen
for incoming sessions.
Repeat this option to open several listeners. By default, `tcp/[::]:7447` is
used. The following endpoints are currently supported:
* TCP: `tcp/:`
* UDP: `udp/:`
* [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:`
* [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:`
* `-e, --connect ...`: An endpoint this router will try to connect
to. Repeat this option to connect to several peers or routers.
* `--no-multicast-scouting`: By default zenohd replies to multicast scouting
messages for being discovered by peers and clients.
This option disables this feature.
* `-i, --id `: The identifier (as an hexadecimal string - e.g.:
A0B23...) that zenohd must use.
**WARNING**: this identifier must be unique in the system! If not set, a
random unsigned 128bit integer will be used.
* `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each
routed Data if there isn't already one.
This option disables this feature.
* `-P, --plugin [ | :]...`: A
[plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted
values:
* a plugin name; zenohd will search for a library named
`libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on
MacOS or `zenoh_plugin_.dll` on Windows.
* `":"`; the plugin will be loaded from library
file at ``.
.
Repeat this option to load several plugins.
* `--plugin-search-dir ...`: A directory where to search for
[plugins](https://zenoh.io/docs/manual/plugins/) libraries to load.
Repeat this option to specify several search directories'. By default, the
plugins libraries will be searched in:
`'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'`
* `--rest-http-port `: Configures the [REST
plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted
values:
* a port number
* a string with format `:` (to bind the HTTP server to
a specific interface)
* `"None"` to deactivate the REST plugin
.
If not specified, the REST plugin will be active on any interface (`[::]`)
and port `8000`.
.
-------------------------------
.
## Plugins
.
> [!WARNING]
> As Rust doesn't have a stable ABI, the plugins should be
built with the exact same Rust version as `zenohd`, and using for `zenoh`
dependency the same version (or commit number) as `zenohd` with the same
set of features. A plugin compiled with different Rust version or with
different set of `zenoh` crate features will be rejected when `zenohd` attempts
to load it. Otherwise, incompatibilities in memory mapping of structures shared
between `zenohd` and the library could lead to a `"SIGSEGV"` crash.
.
By default the Zenoh router is delivered or built with 2 plugins. These may be
configured through a configuration file, or through individual changes to the
configuration via the `--cfg` CLI option or via zenoh puts on individual parts
of the configuration.
.
**[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST
API):
This plugin converts GET and PUT REST requests into Zenoh gets and puts
respectively.
.
Note that to activate the REST plugin on `zenohd` the CLI argument should be
passed: `--rest-http-port=8000` (or any other port of your choice).
.
**[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)**
(managing [backends and
storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes))
This plugin allows you to easily define storages. These will store key-value
pairs they subscribed to, and send the most recent ones when queried. Check out
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them.
.
-------------------------------
.
## Troubleshooting
.
In case of troubles, please first check on [this
page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble
and cause are already known.
Otherwise, you can ask a question on the [zenoh Discord
server](https://discord.gg/vSDSpqnbkm), or [create an
issue](https://github.com/eclipse-zenoh/zenoh/issues).
Package: zenohd
Version: 1.4.0
Architecture: armel
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 13776
Filename: 1.4.0/zenohd_1.4.0_armel.deb
Size: 3693212
MD5sum: cc90d0582de6bbfa6895b496efc15f60
SHA1: 4a992c11436292c038c9c1fcaaaad3d46155de1d
SHA256: 4aaeca8cd67263fa61b6121c11db990b2f3562f7383bb3b752677d8551dd69ad
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol.
.
[](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++)
[](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/github/eclipse-zenoh/zenoh)
[](https://github.com/eclipse-zenoh/roadmap/discussions)
[](https://discord.gg/2GJ958VuHs)
[](https://choosealicense.com/licenses/epl-2.0/)
[](https://opensource.org/licenses/Apache-2.0)
.
# Eclipse Zenoh
.
The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute.
.
Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and
computations. It carefully blends traditional pub/sub with geo-distributed
storages, queries and computations, while retaining a level of time and space
efficiency that is well beyond any of the mainstream stacks.
.
Check the website [zenoh.io](http://zenoh.io) and the
[roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed
information.
.
-------------------------------
.
## Getting Started
.
Zenoh is extremely easy to learn, the best place to master the fundamentals is
our [getting started guide](https://zenoh.io/docs/getting-started/first-app/).
.
-------------------------------
.
## How to install it
.
To install the latest release of the Zenoh router (`zenohd`) and its default
plugins (REST API plugin and Storages Manager plugin) you can do as follows:
.
### Manual installation (all platforms)
.
All release packages can be downloaded from
[https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/).
.
Each subdirectory has the name of the Rust target. See the platforms each
target corresponds to on
[https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html).
.
Choose your platform and download the `.zip` file.
Unzip it where you want, and run the extracted `zenohd` binary.
.
### Linux Debian
.
Add Eclipse Zenoh private repository to the sources list, and install the
`zenoh` package:
.
```bash
echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" |
sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null
sudo apt update
sudo apt install zenoh
```
.
Then you can start run `zenohd`.
.
### MacOS
.
Tap our brew package repository and install the `zenoh` formula:
.
```bash
brew tap eclipse-zenoh/homebrew-zenoh
brew install zenoh
```
.
Then you can start run `zenohd`.
.
-------------------------------
.
## Rust API
.
* [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/)
.
-------------------------------
.
## How to build it
.
Install [Cargo and
Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh
can be successfully compiled with Rust stable (>= 1.75.0), so no special
configuration is required from your side. If you already have the Rust
toolchain installed, make sure it is up-to-date with:
.
```bash
rustup update
```
.
To build Zenoh, just type the following command after having followed the
previous instructions:
.
```bash
cargo build --release --all-targets
```
.
Zenoh's router is built as `target/release/zenohd`. All the examples are built
into the `target/release/examples` directory. They can all work in
peer-to-peer, or interconnected via the zenoh router.
.
-------------------------------
.
## Quick tests of your build
.
### Peer-to-peer tests
.
* **pub/sub**
* run: `./target/release/examples/z_sub`
* in another shell run: `./target/release/examples/z_put`
* the subscriber should receive the publication.
.
* **get/queryable**
* run: `./target/release/examples/z_queryable`
* in another shell run: `./target/release/examples/z_get`
* the queryable should display the log in its listener, and the get should
receive the queryable result.
.
### Routed tests
.
> [!NOTE]
> **Windows users**: to properly execute the commands below in PowerShell you
need to escape `"` characters as `\"`.
.
* **put / store / get**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell run:
.
```sh
./target/release/examples/z_put`
```
.
* then run
.
```sh
./target/release/examples/z_get
```
.
* the get should receive the stored publication.
.
* **REST API using `curl` tool**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, do a publication via the REST API:
.
```sh
curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test
```
.
* get it back via the REST API:
.
```sh
curl http://localhost:8000/demo/example/test
```
.
* **router admin space via the REST API**
* run the Zenoh router with permission to perform config changes via the
admin space, and with a memory storage:
.
```sh
./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, get info of the zenoh router via the zenoh admin space
(you may use `jq` for pretty json formatting):
.
```sh
curl -s http://localhost:8000/@/local/router | jq
```
.
* get the volumes of the router (only memory by default):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq
```
.
* get the storages of the local router (the memory storage configured at
startup on '/demo/example/**' should be present):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
* add another memory storage on `/demo/mystore/**`:
.
```sh
curl -X PUT -H 'content-type:application/json' -d
'{"key_expr":"demo/mystore/**","volume":"memory"}'
http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore
```
.
* check it has been created:
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
### Configuration options
.
A Zenoh configuration file can be provided via CLI to all Zenoh examples and
the Zenoh router.
.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and
the available options.
.
See other examples of Zenoh usage in [examples/](examples)
.
> [!NOTE]
> **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh
allows for configuring the number of worker threads and other advanced options
of the runtime. For guidance on utilizing it, please refer to the
[doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html).
.
-------------------------------
.
## Zenoh router command line arguments
.
`zenohd` accepts the following arguments:
.
* `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write
permissions on the admin space. Default is read only.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All
properties of this configuration are optional, so you may not need such a large
configuration for your use-case.
* `--cfg :`: allows you to change specific parts of the
configuration right after it has been constructed. VALUE must be a valid JSON5
value, and key must be a path through the configuration file, where each
element is separated by a `/`. When inserting in parts of the config that are
arrays, you may use indexes, or may use `+` to indicate that you want to append
your value to the array. `--cfg` passed values will always override any
previously existing value for their key in the configuration.
* `-l, --listen ...`: An endpoint on which this router will listen
for incoming sessions.
Repeat this option to open several listeners. By default, `tcp/[::]:7447` is
used. The following endpoints are currently supported:
* TCP: `tcp/:`
* UDP: `udp/:`
* [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:`
* [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:`
* `-e, --connect ...`: An endpoint this router will try to connect
to. Repeat this option to connect to several peers or routers.
* `--no-multicast-scouting`: By default zenohd replies to multicast scouting
messages for being discovered by peers and clients.
This option disables this feature.
* `-i, --id `: The identifier (as an hexadecimal string - e.g.:
A0B23...) that zenohd must use.
**WARNING**: this identifier must be unique in the system! If not set, a
random unsigned 128bit integer will be used.
* `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each
routed Data if there isn't already one.
This option disables this feature.
* `-P, --plugin [ | :]...`: A
[plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted
values:
* a plugin name; zenohd will search for a library named
`libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on
MacOS or `zenoh_plugin_.dll` on Windows.
* `":"`; the plugin will be loaded from library
file at ``.
.
Repeat this option to load several plugins.
* `--plugin-search-dir ...`: A directory where to search for
[plugins](https://zenoh.io/docs/manual/plugins/) libraries to load.
Repeat this option to specify several search directories'. By default, the
plugins libraries will be searched in:
`'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'`
* `--rest-http-port `: Configures the [REST
plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted
values:
* a port number
* a string with format `:` (to bind the HTTP server to
a specific interface)
* `"None"` to deactivate the REST plugin
.
If not specified, the REST plugin will be active on any interface (`[::]`)
and port `8000`.
.
-------------------------------
.
## Plugins
.
> [!WARNING]
> As Rust doesn't have a stable ABI, the plugins should be
built with the exact same Rust version as `zenohd`, and using for `zenoh`
dependency the same version (or commit number) as `zenohd` with the same
set of features. A plugin compiled with different Rust version or with
different set of `zenoh` crate features will be rejected when `zenohd` attempts
to load it. Otherwise, incompatibilities in memory mapping of structures shared
between `zenohd` and the library could lead to a `"SIGSEGV"` crash.
.
By default the Zenoh router is delivered or built with 2 plugins. These may be
configured through a configuration file, or through individual changes to the
configuration via the `--cfg` CLI option or via zenoh puts on individual parts
of the configuration.
.
**[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST
API):
This plugin converts GET and PUT REST requests into Zenoh gets and puts
respectively.
.
Note that to activate the REST plugin on `zenohd` the CLI argument should be
passed: `--rest-http-port=8000` (or any other port of your choice).
.
**[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)**
(managing [backends and
storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes))
This plugin allows you to easily define storages. These will store key-value
pairs they subscribed to, and send the most recent ones when queried. Check out
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them.
.
-------------------------------
.
## Troubleshooting
.
In case of troubles, please first check on [this
page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble
and cause are already known.
Otherwise, you can ask a question on the [zenoh Discord
server](https://discord.gg/vSDSpqnbkm), or [create an
issue](https://github.com/eclipse-zenoh/zenoh/issues).
Package: zenohd
Version: 1.4.0
Architecture: amd64
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 14541
Depends: libc6 (>= 2.34)
Filename: 1.4.0/zenohd_1.4.0_amd64.deb
Size: 3948212
MD5sum: 5d7a25b32b4ed8190fb7a7470af68208
SHA1: 7bfb62d5e2ff7190f84e42f037884906ffe1b49e
SHA256: 742277b38468bf70170f46a70702a7766d16d6d2f2288cd153c6ab79c7a63309
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol.
.
[](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++)
[](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/github/eclipse-zenoh/zenoh)
[](https://github.com/eclipse-zenoh/roadmap/discussions)
[](https://discord.gg/2GJ958VuHs)
[](https://choosealicense.com/licenses/epl-2.0/)
[](https://opensource.org/licenses/Apache-2.0)
.
# Eclipse Zenoh
.
The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute.
.
Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and
computations. It carefully blends traditional pub/sub with geo-distributed
storages, queries and computations, while retaining a level of time and space
efficiency that is well beyond any of the mainstream stacks.
.
Check the website [zenoh.io](http://zenoh.io) and the
[roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed
information.
.
-------------------------------
.
## Getting Started
.
Zenoh is extremely easy to learn, the best place to master the fundamentals is
our [getting started guide](https://zenoh.io/docs/getting-started/first-app/).
.
-------------------------------
.
## How to install it
.
To install the latest release of the Zenoh router (`zenohd`) and its default
plugins (REST API plugin and Storages Manager plugin) you can do as follows:
.
### Manual installation (all platforms)
.
All release packages can be downloaded from
[https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/).
.
Each subdirectory has the name of the Rust target. See the platforms each
target corresponds to on
[https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html).
.
Choose your platform and download the `.zip` file.
Unzip it where you want, and run the extracted `zenohd` binary.
.
### Linux Debian
.
Add Eclipse Zenoh private repository to the sources list, and install the
`zenoh` package:
.
```bash
echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" |
sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null
sudo apt update
sudo apt install zenoh
```
.
Then you can start run `zenohd`.
.
### MacOS
.
Tap our brew package repository and install the `zenoh` formula:
.
```bash
brew tap eclipse-zenoh/homebrew-zenoh
brew install zenoh
```
.
Then you can start run `zenohd`.
.
-------------------------------
.
## Rust API
.
* [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/)
.
-------------------------------
.
## How to build it
.
Install [Cargo and
Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh
can be successfully compiled with Rust stable (>= 1.75.0), so no special
configuration is required from your side. If you already have the Rust
toolchain installed, make sure it is up-to-date with:
.
```bash
rustup update
```
.
To build Zenoh, just type the following command after having followed the
previous instructions:
.
```bash
cargo build --release --all-targets
```
.
Zenoh's router is built as `target/release/zenohd`. All the examples are built
into the `target/release/examples` directory. They can all work in
peer-to-peer, or interconnected via the zenoh router.
.
-------------------------------
.
## Quick tests of your build
.
### Peer-to-peer tests
.
* **pub/sub**
* run: `./target/release/examples/z_sub`
* in another shell run: `./target/release/examples/z_put`
* the subscriber should receive the publication.
.
* **get/queryable**
* run: `./target/release/examples/z_queryable`
* in another shell run: `./target/release/examples/z_get`
* the queryable should display the log in its listener, and the get should
receive the queryable result.
.
### Routed tests
.
> [!NOTE]
> **Windows users**: to properly execute the commands below in PowerShell you
need to escape `"` characters as `\"`.
.
* **put / store / get**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell run:
.
```sh
./target/release/examples/z_put`
```
.
* then run
.
```sh
./target/release/examples/z_get
```
.
* the get should receive the stored publication.
.
* **REST API using `curl` tool**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, do a publication via the REST API:
.
```sh
curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test
```
.
* get it back via the REST API:
.
```sh
curl http://localhost:8000/demo/example/test
```
.
* **router admin space via the REST API**
* run the Zenoh router with permission to perform config changes via the
admin space, and with a memory storage:
.
```sh
./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, get info of the zenoh router via the zenoh admin space
(you may use `jq` for pretty json formatting):
.
```sh
curl -s http://localhost:8000/@/local/router | jq
```
.
* get the volumes of the router (only memory by default):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq
```
.
* get the storages of the local router (the memory storage configured at
startup on '/demo/example/**' should be present):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
* add another memory storage on `/demo/mystore/**`:
.
```sh
curl -X PUT -H 'content-type:application/json' -d
'{"key_expr":"demo/mystore/**","volume":"memory"}'
http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore
```
.
* check it has been created:
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
### Configuration options
.
A Zenoh configuration file can be provided via CLI to all Zenoh examples and
the Zenoh router.
.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and
the available options.
.
See other examples of Zenoh usage in [examples/](examples)
.
> [!NOTE]
> **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh
allows for configuring the number of worker threads and other advanced options
of the runtime. For guidance on utilizing it, please refer to the
[doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html).
.
-------------------------------
.
## Zenoh router command line arguments
.
`zenohd` accepts the following arguments:
.
* `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write
permissions on the admin space. Default is read only.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All
properties of this configuration are optional, so you may not need such a large
configuration for your use-case.
* `--cfg :`: allows you to change specific parts of the
configuration right after it has been constructed. VALUE must be a valid JSON5
value, and key must be a path through the configuration file, where each
element is separated by a `/`. When inserting in parts of the config that are
arrays, you may use indexes, or may use `+` to indicate that you want to append
your value to the array. `--cfg` passed values will always override any
previously existing value for their key in the configuration.
* `-l, --listen ...`: An endpoint on which this router will listen
for incoming sessions.
Repeat this option to open several listeners. By default, `tcp/[::]:7447` is
used. The following endpoints are currently supported:
* TCP: `tcp/:`
* UDP: `udp/:`
* [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:`
* [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:`
* `-e, --connect ...`: An endpoint this router will try to connect
to. Repeat this option to connect to several peers or routers.
* `--no-multicast-scouting`: By default zenohd replies to multicast scouting
messages for being discovered by peers and clients.
This option disables this feature.
* `-i, --id `: The identifier (as an hexadecimal string - e.g.:
A0B23...) that zenohd must use.
**WARNING**: this identifier must be unique in the system! If not set, a
random unsigned 128bit integer will be used.
* `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each
routed Data if there isn't already one.
This option disables this feature.
* `-P, --plugin [ | :]...`: A
[plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted
values:
* a plugin name; zenohd will search for a library named
`libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on
MacOS or `zenoh_plugin_.dll` on Windows.
* `":"`; the plugin will be loaded from library
file at ``.
.
Repeat this option to load several plugins.
* `--plugin-search-dir ...`: A directory where to search for
[plugins](https://zenoh.io/docs/manual/plugins/) libraries to load.
Repeat this option to specify several search directories'. By default, the
plugins libraries will be searched in:
`'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'`
* `--rest-http-port `: Configures the [REST
plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted
values:
* a port number
* a string with format `:` (to bind the HTTP server to
a specific interface)
* `"None"` to deactivate the REST plugin
.
If not specified, the REST plugin will be active on any interface (`[::]`)
and port `8000`.
.
-------------------------------
.
## Plugins
.
> [!WARNING]
> As Rust doesn't have a stable ABI, the plugins should be
built with the exact same Rust version as `zenohd`, and using for `zenoh`
dependency the same version (or commit number) as `zenohd` with the same
set of features. A plugin compiled with different Rust version or with
different set of `zenoh` crate features will be rejected when `zenohd` attempts
to load it. Otherwise, incompatibilities in memory mapping of structures shared
between `zenohd` and the library could lead to a `"SIGSEGV"` crash.
.
By default the Zenoh router is delivered or built with 2 plugins. These may be
configured through a configuration file, or through individual changes to the
configuration via the `--cfg` CLI option or via zenoh puts on individual parts
of the configuration.
.
**[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST
API):
This plugin converts GET and PUT REST requests into Zenoh gets and puts
respectively.
.
Note that to activate the REST plugin on `zenohd` the CLI argument should be
passed: `--rest-http-port=8000` (or any other port of your choice).
.
**[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)**
(managing [backends and
storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes))
This plugin allows you to easily define storages. These will store key-value
pairs they subscribed to, and send the most recent ones when queried. Check out
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them.
.
-------------------------------
.
## Troubleshooting
.
In case of troubles, please first check on [this
page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble
and cause are already known.
Otherwise, you can ask a question on the [zenoh Discord
server](https://discord.gg/vSDSpqnbkm), or [create an
issue](https://github.com/eclipse-zenoh/zenoh/issues).
Package: zenohd
Version: 1.4.0
Architecture: arm64
Maintainer: zenoh-dev@eclipse.org
Installed-Size: 13061
Filename: 1.4.0/zenohd_1.4.0_arm64.deb
Size: 3517868
MD5sum: e75d135858ed625c325af0dc7fb3db5f
SHA1: 3979f6a04f838634c24aa9707d14c7f2f0c1dfb0
SHA256: ca09f9869ced269c426db80ef1734eb53b4a5214fcc06fea96a4da8226deefee
Section: net
Priority: optional
Homepage: http://zenoh.io
Description: Zenoh: The Zero Overhead Pub/Sub/Query Protocol.
.
[](https://github.com/eclipse-zenoh/zenoh/actions?query=workflow%3ACI+branch%3Amain++)
[](https://zenoh-rust.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/github/eclipse-zenoh/zenoh)
[](https://github.com/eclipse-zenoh/roadmap/discussions)
[](https://discord.gg/2GJ958VuHs)
[](https://choosealicense.com/licenses/epl-2.0/)
[](https://opensource.org/licenses/Apache-2.0)
.
# Eclipse Zenoh
.
The Eclipse Zenoh: Zero Overhead Pub/sub, Store/Query and Compute.
.
Zenoh (pronounce _/zeno/_) unifies data in motion, data at rest and
computations. It carefully blends traditional pub/sub with geo-distributed
storages, queries and computations, while retaining a level of time and space
efficiency that is well beyond any of the mainstream stacks.
.
Check the website [zenoh.io](http://zenoh.io) and the
[roadmap](https://github.com/eclipse-zenoh/roadmap) for more detailed
information.
.
-------------------------------
.
## Getting Started
.
Zenoh is extremely easy to learn, the best place to master the fundamentals is
our [getting started guide](https://zenoh.io/docs/getting-started/first-app/).
.
-------------------------------
.
## How to install it
.
To install the latest release of the Zenoh router (`zenohd`) and its default
plugins (REST API plugin and Storages Manager plugin) you can do as follows:
.
### Manual installation (all platforms)
.
All release packages can be downloaded from
[https://download.eclipse.org/zenoh/zenoh/latest/](https://download.eclipse.org/zenoh/zenoh/latest/).
.
Each subdirectory has the name of the Rust target. See the platforms each
target corresponds to on
[https://doc.rust-lang.org/stable/rustc/platform-support.html](https://doc.rust-lang.org/stable/rustc/platform-support.html).
.
Choose your platform and download the `.zip` file.
Unzip it where you want, and run the extracted `zenohd` binary.
.
### Linux Debian
.
Add Eclipse Zenoh private repository to the sources list, and install the
`zenoh` package:
.
```bash
echo "deb [trusted=yes] https://download.eclipse.org/zenoh/debian-repo/ /" |
sudo tee -a /etc/apt/sources.list.d/zenoh.list > /dev/null
sudo apt update
sudo apt install zenoh
```
.
Then you can start run `zenohd`.
.
### MacOS
.
Tap our brew package repository and install the `zenoh` formula:
.
```bash
brew tap eclipse-zenoh/homebrew-zenoh
brew install zenoh
```
.
Then you can start run `zenohd`.
.
-------------------------------
.
## Rust API
.
* [Docs.rs for Zenoh](https://docs.rs/zenoh/latest/zenoh/)
.
-------------------------------
.
## How to build it
.
Install [Cargo and
Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html). Zenoh
can be successfully compiled with Rust stable (>= 1.75.0), so no special
configuration is required from your side. If you already have the Rust
toolchain installed, make sure it is up-to-date with:
.
```bash
rustup update
```
.
To build Zenoh, just type the following command after having followed the
previous instructions:
.
```bash
cargo build --release --all-targets
```
.
Zenoh's router is built as `target/release/zenohd`. All the examples are built
into the `target/release/examples` directory. They can all work in
peer-to-peer, or interconnected via the zenoh router.
.
-------------------------------
.
## Quick tests of your build
.
### Peer-to-peer tests
.
* **pub/sub**
* run: `./target/release/examples/z_sub`
* in another shell run: `./target/release/examples/z_put`
* the subscriber should receive the publication.
.
* **get/queryable**
* run: `./target/release/examples/z_queryable`
* in another shell run: `./target/release/examples/z_get`
* the queryable should display the log in its listener, and the get should
receive the queryable result.
.
### Routed tests
.
> [!NOTE]
> **Windows users**: to properly execute the commands below in PowerShell you
need to escape `"` characters as `\"`.
.
* **put / store / get**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell run:
.
```sh
./target/release/examples/z_put`
```
.
* then run
.
```sh
./target/release/examples/z_get
```
.
* the get should receive the stored publication.
.
* **REST API using `curl` tool**
* run the Zenoh router with a memory storage:
.
```sh
./target/release/zenohd
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, do a publication via the REST API:
.
```sh
curl -X PUT -d '"Hello World!"' http://localhost:8000/demo/example/test
```
.
* get it back via the REST API:
.
```sh
curl http://localhost:8000/demo/example/test
```
.
* **router admin space via the REST API**
* run the Zenoh router with permission to perform config changes via the
admin space, and with a memory storage:
.
```sh
./target/release/zenohd --rest-http-port=8000 --adminspace-permissions=rw
--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'
```
.
* in another shell, get info of the zenoh router via the zenoh admin space
(you may use `jq` for pretty json formatting):
.
```sh
curl -s http://localhost:8000/@/local/router | jq
```
.
* get the volumes of the router (only memory by default):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/volumes/*' | jq
```
.
* get the storages of the local router (the memory storage configured at
startup on '/demo/example/**' should be present):
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
* add another memory storage on `/demo/mystore/**`:
.
```sh
curl -X PUT -H 'content-type:application/json' -d
'{"key_expr":"demo/mystore/**","volume":"memory"}'
http://localhost:8000/@/local/router/config/plugins/storage_manager/storages/mystore
```
.
* check it has been created:
.
```sh
curl -s 'http://localhost:8000/@/local/router/**/storages/*' | jq
```
.
### Configuration options
.
A Zenoh configuration file can be provided via CLI to all Zenoh examples and
the Zenoh router.
.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file and
the available options.
.
See other examples of Zenoh usage in [examples/](examples)
.
> [!NOTE]
> **Zenoh Runtime Configuration**: Starting from version 0.11.0-rc, Zenoh
allows for configuring the number of worker threads and other advanced options
of the runtime. For guidance on utilizing it, please refer to the
[doc](https://docs.rs/zenoh-runtime/latest/zenoh_runtime/enum.ZRuntime.html).
.
-------------------------------
.
## Zenoh router command line arguments
.
`zenohd` accepts the following arguments:
.
* `--adminspace-permissions <[r|w|rw|none]>`: Configure the read and/or write
permissions on the admin space. Default is read only.
* `-c, --config `: a [JSON5](https://json5.org) configuration file.
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) shows the schema of this file. All
properties of this configuration are optional, so you may not need such a large
configuration for your use-case.
* `--cfg :`: allows you to change specific parts of the
configuration right after it has been constructed. VALUE must be a valid JSON5
value, and key must be a path through the configuration file, where each
element is separated by a `/`. When inserting in parts of the config that are
arrays, you may use indexes, or may use `+` to indicate that you want to append
your value to the array. `--cfg` passed values will always override any
previously existing value for their key in the configuration.
* `-l, --listen ...`: An endpoint on which this router will listen
for incoming sessions.
Repeat this option to open several listeners. By default, `tcp/[::]:7447` is
used. The following endpoints are currently supported:
* TCP: `tcp/:`
* UDP: `udp/:`
* [TCP+TLS](https://zenoh.io/docs/manual/tls/): `tls/:`
* [QUIC](https://zenoh.io/docs/manual/quic/): `quic/:`
* `-e, --connect ...`: An endpoint this router will try to connect
to. Repeat this option to connect to several peers or routers.
* `--no-multicast-scouting`: By default zenohd replies to multicast scouting
messages for being discovered by peers and clients.
This option disables this feature.
* `-i, --id `: The identifier (as an hexadecimal string - e.g.:
A0B23...) that zenohd must use.
**WARNING**: this identifier must be unique in the system! If not set, a
random unsigned 128bit integer will be used.
* `--no-timestamp`: By default zenohd adds a HLC-generated Timestamp to each
routed Data if there isn't already one.
This option disables this feature.
* `-P, --plugin [ | :]...`: A
[plugin](https://zenoh.io/docs/manual/plugins/) that must be loaded. Accepted
values:
* a plugin name; zenohd will search for a library named
`libzenoh_plugin_.so` on Unix, `libzenoh_plugin_.dylib` on
MacOS or `zenoh_plugin_.dll` on Windows.
* `":"`; the plugin will be loaded from library
file at ``.
.
Repeat this option to load several plugins.
* `--plugin-search-dir ...`: A directory where to search for
[plugins](https://zenoh.io/docs/manual/plugins/) libraries to load.
Repeat this option to specify several search directories'. By default, the
plugins libraries will be searched in:
`'/usr/local/lib:/usr/lib:~/.zenoh/lib:.'`
* `--rest-http-port `: Configures the [REST
plugin](https://zenoh.io/docs/manual/plugin-http/)'s HTTP port. Accepted
values:
* a port number
* a string with format `:` (to bind the HTTP server to
a specific interface)
* `"None"` to deactivate the REST plugin
.
If not specified, the REST plugin will be active on any interface (`[::]`)
and port `8000`.
.
-------------------------------
.
## Plugins
.
> [!WARNING]
> As Rust doesn't have a stable ABI, the plugins should be
built with the exact same Rust version as `zenohd`, and using for `zenoh`
dependency the same version (or commit number) as `zenohd` with the same
set of features. A plugin compiled with different Rust version or with
different set of `zenoh` crate features will be rejected when `zenohd` attempts
to load it. Otherwise, incompatibilities in memory mapping of structures shared
between `zenohd` and the library could lead to a `"SIGSEGV"` crash.
.
By default the Zenoh router is delivered or built with 2 plugins. These may be
configured through a configuration file, or through individual changes to the
configuration via the `--cfg` CLI option or via zenoh puts on individual parts
of the configuration.
.
**[REST plugin](https://zenoh.io/docs/manual/plugin-http/)** (exposing a REST
API):
This plugin converts GET and PUT REST requests into Zenoh gets and puts
respectively.
.
Note that to activate the REST plugin on `zenohd` the CLI argument should be
passed: `--rest-http-port=8000` (or any other port of your choice).
.
**[Storages plugin](https://zenoh.io/docs/manual/plugin-storage-manager/)**
(managing [backends and
storages](https://zenoh.io/docs/manual/plugin-storage-manager/#backends-and-volumes))
This plugin allows you to easily define storages. These will store key-value
pairs they subscribed to, and send the most recent ones when queried. Check out
[DEFAULT_CONFIG.json5](DEFAULT_CONFIG.json5) for info on how to configure them.
.
-------------------------------
.
## Troubleshooting
.
In case of troubles, please first check on [this
page](https://zenoh.io/docs/getting-started/troubleshooting/) if the trouble
and cause are already known.
Otherwise, you can ask a question on the [zenoh Discord
server](https://discord.gg/vSDSpqnbkm), or [create an
issue](https://github.com/eclipse-zenoh/zenoh/issues).