Typedef PntosPluginsDescription

Typedef Documentation

typedef struct PntosPluginsDescription PntosPluginsDescription

A list and description of a set of plugins to be loaded into pntOS. This structure is used in two ways:

  • The loader, when searching for pntOS plugins to load into the runtime, will search for PntosPluginsDescription definitions. The way it does this depends on the mode of operation (see below).

  • The controller will receive a PntosPluginsDescription, describing the collection of plugins that were found by the loader. The controller is then free to use or not use any plugin listed in the structure as needed.

When used on an operating system supporting shared libraries, pntOS plugins are usually bundled into a shared library which are loaded dynamically by the pntOS loader. Each shared library containing pntOS plugins should define a PntosPluginsDescription at the top level (the name of this symbol should be PNTOS_PLUGIN_MAGIC_SYMBOL). The pntOS loader will find this struct in the shared library, parse its contents, and then load the plugins described by it into the runtime.

When used in a non-hosted environment (i.e. where dlopen() is not available) all the plugins statically linked into the executable should be listed in a PntosPluginsDescription and passed into the controller.