index 6a679ce8a17baa5900573ee38cf0deb3e22882cb..69c18b41d0ff2cd38d432852d2b1854fee9b8ff8 100644 (file)
* missing prototype warnings/errors for the plugin init
* function */
#define SDB_PLUGIN_MAGIC \
- int sdb_module_init(sdb_plugin_info_t *info);
+ int sdb_module_init(sdb_plugin_info_t *info)
typedef struct {
_Bool do_loop;
* sdb_plugin_load:
* Load (any type of) plugin by loading the shared object file and calling the
* sdb_module_init function. If specified, 'plugin_ctx' fine-tunes the
- * behavior of the plugin.
+ * behavior of the plugin. If specified, the plugin will be looked up in
+ * 'basedir', else it defaults to the package libdir.
*/
int
-sdb_plugin_load(const char *name, const sdb_plugin_ctx_t *plugin_ctx);
+sdb_plugin_load(const char *basedir, const char *name,
+ const sdb_plugin_ctx_t *plugin_ctx);
/*
* sdb_plugin_set_info:
int
sdb_plugin_configure(const char *name, oconfig_item_t *ci);
+/*
+ * sdb_plugin_reconfigure_init, sdb_plugin_reconfigure_finish:
+ * Reconfigure all plugins. This happens in multiple steps: first, call
+ * sdb_plugin_reconfigure_init to deconfigure all plugins by calling their
+ * config callbacks with a NULL config tree and unregistering all callbacks.
+ * Then, sdb_plugin_configure and other functions may be used to provide the
+ * new configuration or load new plugins. For all plugins which were already
+ * loaded before, sdb_module_init will be called with a NULL argument when
+ * reloading them.
+ * Finally, sdb_plugin_reconfigure_finish will clean up leftover pieces, like
+ * unloading plugins which are no longer in use.
+ *
+ * Returns:
+ * - 0 on success
+ * - a negative value else
+ */
+int
+sdb_plugin_reconfigure_init(void);
+int
+sdb_plugin_reconfigure_finish(void);
+
/*
* sdb_plugin_init_all:
* Initialize all plugins using their registered "init" function.
+ *
+ * Returns:
+ * The number of failed initializations.
*/
int
sdb_plugin_init_all(void);
+/*
+ * sdb_plugin_shutdown_all:
+ * Shutdown all plugins using their registered "shutdown" function.
+ *
+ * Returns:
+ * The number of failed shutdowns.
+ */
+int
+sdb_plugin_shutdown_all(void);
+
/*
* sdb_plugin_collector_loop:
* Loop until loop->do_loop is false, calling the next collector function on