stat_item.h

Go to the documentation of this file.

#pragma once

#include <stdint.h>

#include <osmocom/core/linuxlist.h>

struct osmo_stat_item_desc;

#define OSMO_STAT_ITEM_NOVALUE_ID 0
#define OSMO_STAT_ITEM_NO_UNIT NULL

struct osmo_stat_item_value {
        int32_t id;
        int32_t value;
};

struct osmo_stat_item {
        const struct osmo_stat_item_desc *desc;
        int32_t last_value_index;
        int16_t last_offs;
        struct osmo_stat_item_value values[0];
};

struct osmo_stat_item_desc {
        const char *name;       
        const char *description;
        const char *unit;       
        unsigned int num_values;
        int32_t default_value;
};

struct osmo_stat_item_group_desc {
        const char *group_name_prefix;
        const char *group_description;
        int class_id;
        const unsigned int num_items;
        const struct osmo_stat_item_desc *item_desc;
};

struct osmo_stat_item_group {
        struct llist_head list;
        const struct osmo_stat_item_group_desc *desc;
        unsigned int idx;
        struct osmo_stat_item *items[0];
};

struct osmo_stat_item_group *osmo_stat_item_group_alloc(
        void *ctx,
        const struct osmo_stat_item_group_desc *desc,
        unsigned int idx);

static inline void osmo_stat_item_group_udp_idx(
        struct osmo_stat_item_group *grp, unsigned int idx)
{
        grp->idx = idx;
}

void osmo_stat_item_group_free(struct osmo_stat_item_group *statg);

void osmo_stat_item_set(struct osmo_stat_item *item, int32_t value);

int osmo_stat_item_init(void *tall_ctx);

struct osmo_stat_item_group *osmo_stat_item_get_group_by_name_idx(
        const char *name, const unsigned int idx);

const struct osmo_stat_item *osmo_stat_item_get_by_name(
        const struct osmo_stat_item_group *statg, const char *name);

int osmo_stat_item_get_next(const struct osmo_stat_item *item, int32_t *idx, int32_t *value);

static int32_t osmo_stat_item_get_last(const struct osmo_stat_item *item);

int osmo_stat_item_discard(const struct osmo_stat_item *item, int32_t *idx);

int osmo_stat_item_discard_all(int32_t *idx);

typedef int (*osmo_stat_item_handler_t)(
        struct osmo_stat_item_group *, struct osmo_stat_item *, void *);

typedef int (*osmo_stat_item_group_handler_t)(struct osmo_stat_item_group *, void *);

int osmo_stat_item_for_each_item(struct osmo_stat_item_group *statg,
        osmo_stat_item_handler_t handle_item, void *data);

int osmo_stat_item_for_each_group(osmo_stat_item_group_handler_t handle_group, void *data);

static inline int32_t osmo_stat_item_get_last(const struct osmo_stat_item *item)
{
        return item->values[item->last_offs].value;
}