X-Git-Url: https://git.tokkee.org/?p=sysdb.git;a=blobdiff_plain;f=src%2Finclude%2Fcore%2Fplugin.h;h=6c4a2e16cfdf674c2884f560ac158ef7836733d3;hp=6580e90dfcd55a8df4ea52e0ae4ee4ff3ef7d57e;hb=9a96acd759c31211aa512e174339a9c178c4eb83;hpb=49b5a4d2e8e4fb1e4f67c2a368d8d2e3e76b765f diff --git a/src/include/core/plugin.h b/src/include/core/plugin.h index 6580e90..6c4a2e1 100644 --- a/src/include/core/plugin.h +++ b/src/include/core/plugin.h @@ -30,6 +30,7 @@ #include "sysdb.h" #include "core/object.h" +#include "core/store.h" #include "core/time.h" #include "core/timeseries.h" @@ -258,6 +259,45 @@ int sdb_plugin_register_ts_fetcher(const char *name, sdb_plugin_fetch_ts_cb callback, sdb_object_t *user_data); +/* + * sdb_plugin_register_writer: + * Register a "writer" implementation to be used when adding an object to the + * store. It is invalid to register an incomplete writer which does not + * implement all of the writer interface. + * + * Arguments: + * - user_data: If specified, this will be passed on to each call of the + * callbacks. The function will take ownership of the object, that is, + * increment the reference count by one. In case the caller does not longer + * use the object for other purposes, it should thus deref it. + */ +int +sdb_plugin_register_writer(const char *name, + sdb_store_writer_t *writer, sdb_object_t *user_data); + +/* + * sdb_plugin_register_reader: + * Register a "reader" implementation for querying the store. It is invalid to + * register an incomplete reader which does not implement all of the reader + * interface. + * + * Arguments: + * - user_data: If specified, this will be passed on to each call of the + * callbacks. The function will take ownership of the object, that is, + * increment the reference count by one. In case the caller does not longer + * use the object for other purposes, it should thus deref it. + */ +int +sdb_plugin_register_reader(const char *name, + sdb_store_reader_t *reader, sdb_object_t *user_data); + +/* + * sdb_plugin_unregister_all: + * Unregister all registered plugins and destruct their user-data objects. + */ +void +sdb_plugin_unregister_all(void); + /* * sdb_plugin_get_ctx, sdb_plugin_set_ctx: * The plugin context defines a set of settings that are available whenever a @@ -396,6 +436,48 @@ sdb_timeseries_t * sdb_plugin_fetch_timeseries(const char *type, const char *id, sdb_timeseries_opts_t *opts); +/* + * sdb_plugin_query: + * Query the store using the query specified by 'ast'. The result will be + * written to 'buf' and any errors will be written to 'errbuf'. + * + * Returns: + * - 0 on success + * - a negative value else + */ +int +sdb_plugin_query(sdb_ast_node_t *ast, + sdb_store_writer_t *w, sdb_object_t *wd, sdb_strbuf_t *errbuf); + +/* + * sdb_plugin_store_host, sdb_plugin_store_service, sdb_plugin_store_metric, + * sdb_plugin_store_attribute, sdb_plugin_store_service_attribute, + * sdb_plugin_store_metric_attribute: + * Store an object in the database by sending it to all registered store + * writer plugins. + * + * Returns: + * - 0 on success + * - a negative value else + */ +int +sdb_plugin_store_host(const char *name, sdb_time_t last_update); +int +sdb_plugin_store_service(const char *hostname, const char *name, + sdb_time_t last_update); +int +sdb_plugin_store_metric(const char *hostname, const char *name, + sdb_metric_store_t *store, sdb_time_t last_update); +int +sdb_plugin_store_attribute(const char *hostname, const char *key, + const sdb_data_t *value, sdb_time_t last_update); +int +sdb_plugin_store_service_attribute(const char *hostname, const char *service, + const char *key, const sdb_data_t *value, sdb_time_t last_update); +int +sdb_plugin_store_metric_attribute(const char *hostname, const char *metric, + const char *key, const sdb_data_t *value, sdb_time_t last_update); + #ifdef __cplusplus } /* extern "C" */ #endif