X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=src%2Fdaemon%2Futils_cache.h;h=2f408734fb7efdea856d1dd8d08579c572a1c07a;hb=d486225f89ea52d8ed2b4242eba2ad94c409f837;hp=93c2519469f6f9436468719db5da0a49fc0fbdf1;hpb=21ab7512825cf8177d5eee5101344b45d0854610;p=collectd.git diff --git a/src/daemon/utils_cache.h b/src/daemon/utils_cache.h index 93c25194..7200906d 100644 --- a/src/daemon/utils_cache.h +++ b/src/daemon/utils_cache.h @@ -31,30 +31,34 @@ #include "plugin.h" -#define STATE_OKAY 0 -#define STATE_WARNING 1 -#define STATE_ERROR 2 +#define STATE_OKAY 0 +#define STATE_WARNING 1 +#define STATE_ERROR 2 #define STATE_MISSING 15 -int uc_init (void); -int uc_check_timeout (void); -int uc_update (const data_set_t *ds, const value_list_t *vl); -int uc_get_rate_by_name (const char *name, gauge_t **ret_values, size_t *ret_values_num); -gauge_t *uc_get_rate (const data_set_t *ds, const value_list_t *vl); +int uc_init(void); +int uc_check_timeout(void); +int uc_update(const data_set_t *ds, const value_list_t *vl); +int uc_get_rate_by_name(const char *name, gauge_t **ret_values, + size_t *ret_values_num); +gauge_t *uc_get_rate(const data_set_t *ds, const value_list_t *vl); +int uc_get_value_by_name(const char *name, value_t **ret_values, + size_t *ret_values_num); +value_t *uc_get_value(const data_set_t *ds, const value_list_t *vl); -size_t uc_get_size (void); -int uc_get_names (char ***ret_names, cdtime_t **ret_times, size_t *ret_number); +size_t uc_get_size(void); +int uc_get_names(char ***ret_names, cdtime_t **ret_times, size_t *ret_number); -int uc_get_state (const data_set_t *ds, const value_list_t *vl); -int uc_set_state (const data_set_t *ds, const value_list_t *vl, int state); -int uc_get_hits (const data_set_t *ds, const value_list_t *vl); -int uc_set_hits (const data_set_t *ds, const value_list_t *vl, int hits); -int uc_inc_hits (const data_set_t *ds, const value_list_t *vl, int step); +int uc_get_state(const data_set_t *ds, const value_list_t *vl); +int uc_set_state(const data_set_t *ds, const value_list_t *vl, int state); +int uc_get_hits(const data_set_t *ds, const value_list_t *vl); +int uc_set_hits(const data_set_t *ds, const value_list_t *vl, int hits); +int uc_inc_hits(const data_set_t *ds, const value_list_t *vl, int step); -int uc_get_history (const data_set_t *ds, const value_list_t *vl, - gauge_t *ret_history, size_t num_steps, size_t num_ds); -int uc_get_history_by_name (const char *name, - gauge_t *ret_history, size_t num_steps, size_t num_ds); +int uc_get_history(const data_set_t *ds, const value_list_t *vl, + gauge_t *ret_history, size_t num_steps, size_t num_ds); +int uc_get_history_by_name(const char *name, gauge_t *ret_history, + size_t num_steps, size_t num_ds); /* * Iterator interface @@ -73,7 +77,7 @@ typedef struct uc_iter_s uc_iter_t; * RETURN VALUE * An iterator object on success or NULL else. */ -uc_iter_t *uc_get_iterator (void); +uc_iter_t *uc_get_iterator(void); /* * NAME @@ -85,61 +89,53 @@ uc_iter_t *uc_get_iterator (void); * * PARAMETERS * `iter' The iterator object to advance. - * `ret_name' Pointer to a string where to store the name. The returned - * value is a copy of the value and has to be freed by the - * caller. + * `ret_name' Optional pointer to a string where to store the name. If not + * NULL, the returned value is a copy of the value and has to be + * freed by the caller. * * RETURN VALUE * Zero upon success or non-zero if the iterator ie NULL or no further * values are available. */ -int uc_iterator_next (uc_iter_t *iter, char **ret_name); -void uc_iterator_destroy (uc_iter_t *iter); +int uc_iterator_next(uc_iter_t *iter, char **ret_name); +void uc_iterator_destroy(uc_iter_t *iter); /* Return the timestamp of the value at the current position. */ -int uc_iterator_get_time (uc_iter_t *iter, cdtime_t *ret_time); +int uc_iterator_get_time(uc_iter_t *iter, cdtime_t *ret_time); /* Return the (raw) value at the current position. */ -int uc_iterator_get_values (uc_iter_t *iter, value_t **ret_values, size_t *ret_num); +int uc_iterator_get_values(uc_iter_t *iter, value_t **ret_values, + size_t *ret_num); /* Return the interval of the value at the current position. */ -int uc_iterator_get_interval (uc_iter_t *iter, cdtime_t *ret_interval); +int uc_iterator_get_interval(uc_iter_t *iter, cdtime_t *ret_interval); +/* Return the metadata for the value at the current position. */ +int uc_iterator_get_meta(uc_iter_t *iter, meta_data_t **ret_meta); /* * Meta data interface */ -int uc_meta_data_exists (const value_list_t *vl, const char *key); -int uc_meta_data_delete (const value_list_t *vl, const char *key); +int uc_meta_data_exists(const value_list_t *vl, const char *key); +int uc_meta_data_delete(const value_list_t *vl, const char *key); -int uc_meta_data_add_string (const value_list_t *vl, - const char *key, - const char *value); -int uc_meta_data_add_signed_int (const value_list_t *vl, - const char *key, - int64_t value); -int uc_meta_data_add_unsigned_int (const value_list_t *vl, - const char *key, - uint64_t value); -int uc_meta_data_add_double (const value_list_t *vl, - const char *key, - double value); -int uc_meta_data_add_boolean (const value_list_t *vl, - const char *key, - _Bool value); +int uc_meta_data_add_string(const value_list_t *vl, const char *key, + const char *value); +int uc_meta_data_add_signed_int(const value_list_t *vl, const char *key, + int64_t value); +int uc_meta_data_add_unsigned_int(const value_list_t *vl, const char *key, + uint64_t value); +int uc_meta_data_add_double(const value_list_t *vl, const char *key, + double value); +int uc_meta_data_add_boolean(const value_list_t *vl, const char *key, + bool value); -int uc_meta_data_get_string (const value_list_t *vl, - const char *key, - char **value); -int uc_meta_data_get_signed_int (const value_list_t *vl, - const char *key, - int64_t *value); -int uc_meta_data_get_unsigned_int (const value_list_t *vl, - const char *key, - uint64_t *value); -int uc_meta_data_get_double (const value_list_t *vl, - const char *key, - double *value); -int uc_meta_data_get_boolean (const value_list_t *vl, - const char *key, - _Bool *value); +int uc_meta_data_get_string(const value_list_t *vl, const char *key, + char **value); +int uc_meta_data_get_signed_int(const value_list_t *vl, const char *key, + int64_t *value); +int uc_meta_data_get_unsigned_int(const value_list_t *vl, const char *key, + uint64_t *value); +int uc_meta_data_get_double(const value_list_t *vl, const char *key, + double *value); +int uc_meta_data_get_boolean(const value_list_t *vl, const char *key, + bool *value); -/* vim: set shiftwidth=2 softtabstop=2 tabstop=8 : */ #endif /* !UTILS_CACHE_H */