Crate zenoh_plugin_trait

source ·
Expand description

§The plugin infrastructure for Zenoh.

To build a plugin, implement Plugin.

If building a plugin for zenohd, you should use the types exported in zenoh::plugins to fill Plugin’s associated types.
To check your plugin typing for zenohd, have your plugin implement zenoh::plugins::ZenohPlugin

Plugin is a struct which implements the Plugin trait. This trait has two associated types:

  • StartArgs: the type of the arguments passed to the plugin’s start function.
  • Instance: the type of the plugin’s instance.

The actual work of the plugin is performed by the instance, which is created by the start function.

Plugins are loaded, started and stopped by PluginsManager. Stopping pluign is just dropping it’s instance.

Plugins can be static and dynamic.

Static plugin is just a type which implements Plugin trait. It can be added to PluginsManager by PluginsManager::add_static_plugin method.

Dynamic pluign is a shared library which exports set of C-repr (unmangled) functions which allows to check plugin compatibility and create plugin instance. These functiuons are defined automatically by declare_plugin macro.

Macros§

  • This macro adds non-mangled functions which provides plugin version and loads it into the host. If plugin library should work also as static, consider calling this macro under feature condition

Structs§

  • A plugin report contains a severity level and a list of messages describing the plugin’s situation (for the Declared state - dynamic library loading errors, for the Loaded state - plugin start errors, etc)
  • The structure which contains all information about the plugin status in a single cloneable structure
  • A plugins manager that handles starting and stopping plugins. Plugins can be loaded from shared libraries using [Self::load_plugin_by_name] or [Self::load_plugin_by_paths], or added directly from the binary if available using [Self::add_static].

Enums§

Constants§

Traits§

Type Aliases§