Skip to content
charmOS docs

Stat series

include/stat_series.h View source View on GitHub

Structs

Section titled “Structs”

stat_bucket

Section titled “stat_bucket”
struct stat_bucket {
    struct stat_series  *parent;
    atomic_size_t       count;
    atomic_size_t       sum;
    void                *private;
};

stat_series

Section titled “stat_series”
struct stat_series {
    stat_series_callback  bucket_reset;
    struct stat_bucket    *buckets;
    uint32_t              nbuckets;
    _Atomic uint32_t      current;
    time_t                bucket_us;
    _Atomic uint64_t      last_update_us;
    void                  *private;
    struct spinlock       lock;
};

Type Aliases

Section titled “Type Aliases”

stat_series_callback

Section titled “stat_series_callback”
typedef size_t (*stat_series_callback)(struct stat_bucket * bucket);

Functions

Section titled “Functions”

stat_series_create

Section titled “stat_series_create”
struct stat_series * stat_series_create(uint32_t nbuckets, time_t bucket_us, stat_series_callback bucket_reset, void *private);

stat_series_init

Section titled “stat_series_init”
void stat_series_init(struct stat_series *s, struct stat_bucket *buckets, uint32_t nbuckets, time_t bucket_us, stat_series_callback bucket_reset, void *private);

stat_series_reset

Section titled “stat_series_reset”
void stat_series_reset(struct stat_series *s);

stat_series_record

Section titled “stat_series_record”
void stat_series_record(struct stat_series *s, size_t value, stat_series_callback callback);

stat_series_advance

Section titled “stat_series_advance”
void stat_series_advance(struct stat_series *s, time_t now_us);

Macros

Section titled “Macros”

stat_series_for_each

Section titled “stat_series_for_each”
#define stat_series_for_each(series, iter) \
    for (uint32_t __i = 0; \
         (iter = &((series)->buckets[__i]), __i < (series)->nbuckets); __i++)

STAT_SERIES_DEFINE

Section titled “STAT_SERIES_DEFINE”
#define STAT_SERIES_DEFINE(name, n, bucket_us) \
    static struct stat_bucket name##_buckets[(n)] = {0}; \
    static struct stat_series name = { \
        .buckets = name##_buckets, \
        .nbuckets = (n), \
        .bucket_us = (bucket_us), \
    };

STAT_SERIES_CUR_BUCKET

Section titled “STAT_SERIES_CUR_BUCKET”
#define STAT_SERIES_CUR_BUCKET(s) (&(s)->buckets[(s)->current])