use_count.h

Go to the documentation of this file.

 
/*
 * (C) 2019 by sysmocom s.f.m.c. GmbH <info@sysmocom.de>
 *
 * All Rights Reserved
 *
 * Author: Neels Hofmeyr <neels@hofmeyr.de>
 *
 * SPDX-License-Identifier: GPL-2.0+
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 */
 
#pragma once
 
#include <stdint.h>
#include <stdlib.h>
 
#include <osmocom/core/linuxlist.h>
 
struct osmo_use_count_entry;
 
typedef int (* osmo_use_count_cb_t )(struct osmo_use_count_entry *use_count_entry, int32_t old_use_count,
                                     const char *file, int line);
 
struct osmo_use_count {
        void *talloc_object;
        osmo_use_count_cb_t use_cb;
        struct llist_head use_counts;
};
 
struct osmo_use_count_entry {
        struct llist_head entry;
        struct osmo_use_count *use_count;
        const char *use;
        int32_t count;
};
 
#define osmo_use_count_get_put(USE_LIST, USE, CHANGE) \
        _osmo_use_count_get_put(USE_LIST, USE, CHANGE, __FILE__, __LINE__)
 
int _osmo_use_count_get_put(struct osmo_use_count *uc, const char *use, int32_t change,
                            const char *file, int line);
 
const char *osmo_use_count_name_buf(char *buf, size_t buf_len, const struct osmo_use_count *uc);
int osmo_use_count_to_str_buf(char *buf, size_t buf_len, const struct osmo_use_count *uc);
char *osmo_use_count_to_str_c(void *ctx, const struct osmo_use_count *uc);
 
int32_t osmo_use_count_total(const struct osmo_use_count *uc);
int32_t osmo_use_count_by(const struct osmo_use_count *uc, const char *use);
 
struct osmo_use_count_entry *osmo_use_count_find(const struct osmo_use_count *uc, const char *use);
void osmo_use_count_free(struct osmo_use_count_entry *use_count_entry);
 
void osmo_use_count_make_static_entries(struct osmo_use_count *uc, struct osmo_use_count_entry *buf,
                                        size_t buf_n_entries);