index bef5e0b4ccb35251f261ff8af4defe54b898d2bf..5928560931932836a4dda90ebae881f38a6365a0 100644 (file)
* missing prototype warnings/errors for the plugin init
* function */
#define SDB_PLUGIN_MAGIC \
* 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;
typedef struct {
_Bool do_loop;
/*
* sdb_plugin_load:
* Load (any type of) plugin by loading the shared object file and calling the
/*
* sdb_plugin_load:
* Load (any type of) plugin by loading the shared object file and calling the
- * sdb_module_init function.
+ * sdb_module_init function. If specified, 'plugin_ctx' fine-tunes the
+ * behavior of the plugin.
*/
int
*/
int
-sdb_plugin_load(const char *name);
+sdb_plugin_load(const char *name, const sdb_plugin_ctx_t *plugin_ctx);
/*
* sdb_plugin_set_info:
/*
* sdb_plugin_set_info:
sdb_plugin_set_info(sdb_plugin_info_t *info, int type, ...);
/*
sdb_plugin_set_info(sdb_plugin_info_t *info, int type, ...);
/*
- * plugin callback functions
+ * plugin callback functions:
+ * See the description of the respective register function for what arguments
+ * the callbacks expect.
*/
typedef int (*sdb_plugin_config_cb)(oconfig_item_t *ci);
typedef int (*sdb_plugin_init_cb)(sdb_object_t *user_data);
typedef int (*sdb_plugin_collector_cb)(sdb_object_t *user_data);
*/
typedef int (*sdb_plugin_config_cb)(oconfig_item_t *ci);
typedef int (*sdb_plugin_init_cb)(sdb_object_t *user_data);
typedef int (*sdb_plugin_collector_cb)(sdb_object_t *user_data);
+typedef char *(*sdb_plugin_cname_cb)(const char *name,
+ sdb_object_t *user_data);
typedef int (*sdb_plugin_shutdown_cb)(sdb_object_t *user_data);
typedef int (*sdb_plugin_log_cb)(int prio, const char *msg,
sdb_object_t *user_data);
typedef int (*sdb_plugin_shutdown_cb)(sdb_object_t *user_data);
typedef int (*sdb_plugin_log_cb)(int prio, const char *msg,
sdb_object_t *user_data);
sdb_plugin_collector_cb callback,
const sdb_time_t *interval, sdb_object_t *user_data);
sdb_plugin_collector_cb callback,
const sdb_time_t *interval, sdb_object_t *user_data);
+/*
+ * sdb_plugin_register_cname:
+ * Register a "cname" (canonicalize name) function. This type of function is
+ * called whenever a host is stored. It accepts the hostname and returns a
+ * canonicalized hostname which will then be used to actually store the host.
+ * If multiple such callbacks are registered, each one of them will be called
+ * in the order they have been registered, each one receiving the result of
+ * the previous callback. If the function returns NULL, the original hostname
+ * is not changed. Any other value has to be dynamically allocated. It will be
+ * freed later on by the core.
+ *
+ * Returns:
+ * - 0 on success
+ * - a negative value else
+ */
+int
+sdb_plugin_register_cname(const char *name, sdb_plugin_cname_cb callback,
+ sdb_object_t *user_data);
+
/*
* sdb_plugin_register_shutdown:
* Register a "shutdown" function to be called after stopping all update
/*
* sdb_plugin_register_shutdown:
* Register a "shutdown" function to be called after stopping all update
* plugin has been called. It may be used to pass around various information
* between the different component of the library without having each and
* every plugin care about it.
* plugin has been called. It may be used to pass around various information
* between the different component of the library without having each and
* every plugin care about it.
+ *
+ * If non-NULL, sdb_plugin_set_ctx stores the previous context in the location
+ * pointed to be 'old'.
*/
sdb_plugin_ctx_t
sdb_plugin_get_ctx(void);
*/
sdb_plugin_ctx_t
sdb_plugin_get_ctx(void);
-sdb_plugin_ctx_t
-sdb_plugin_set_ctx(sdb_plugin_ctx_t ctx);
+int
+sdb_plugin_set_ctx(sdb_plugin_ctx_t ctx, sdb_plugin_ctx_t *old);
/*
* sdb_plugin_configure:
/*
* sdb_plugin_configure:
/*
* sdb_plugin_init_all:
* Initialize all plugins using their registered "init" function.
/*
* sdb_plugin_init_all:
* Initialize all plugins using their registered "init" function.
+ *
+ * Returns:
+ * The number of failed initializations.
*/
int
sdb_plugin_init_all(void);
*/
int
sdb_plugin_init_all(void);
int
sdb_plugin_collector_loop(sdb_plugin_loop_t *loop);
int
sdb_plugin_collector_loop(sdb_plugin_loop_t *loop);
+/*
+ * sdb_plugin_cname:
+ * Returns the canonicalized hostname. The given hostname argument has to
+ * point to dynamically allocated memory and might be freed by the function.
+ * The return value will also be dynamically allocated (but it might be
+ * unchanged) and has to be freed by the caller.
+ */
+char *
+sdb_plugin_cname(char *hostname);
+
/*
* sdb_plugin_log:
* Log the specified message using all registered log callbacks. The message
/*
* sdb_plugin_log:
* Log the specified message using all registered log callbacks. The message