summaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorHarald Welte <laforge@gnumonks.org>2017-10-15 20:02:07 +0200
committerHarald Welte <laforge@gnumonks.org>2017-10-16 14:18:54 +0200
commit17bbaa324b9873a965634c60f5696ebd57b5d6a1 (patch)
tree38ba1d84c9415060d97abd34ec18f2b346a7041e /include
parent781951bcf9864ae06741a0d76d3807e332a8faf9 (diff)
[doc] counter.[ch] Add Doxygen API documentation
This adds a more complete set of API documentation for all osmo_counter relatedd functions and definitions. Change-Id: I24283c05620ee86a8beb165af98a85d754549efb
Diffstat (limited to 'include')
-rw-r--r--include/osmocom/core/counter.h21
1 files changed, 5 insertions, 16 deletions
diff --git a/include/osmocom/core/counter.h b/include/osmocom/core/counter.h
index f4429cdb..e692f7e6 100644
--- a/include/osmocom/core/counter.h
+++ b/include/osmocom/core/counter.h
@@ -3,7 +3,7 @@
/*! \file counter.h
* Common routines regarding counter handling */
-/*! structure representing a single counter */
+/*! Structure representing a single counter */
struct osmo_counter {
struct llist_head list; /*!< internal list head */
const char *name; /*!< human-readable name */
@@ -12,13 +12,15 @@ struct osmo_counter {
unsigned long previous; /*!< previous value */
};
-/*! Decrement counter */
+/*! Decrement given counter by one
+ * \param[in] ctr Counter that's to be decremented */
static inline void osmo_counter_dec(struct osmo_counter *ctr)
{
ctr->value--;
}
-/*! Increment counter */
+/*! Increment counter by one.
+ * \param[in] Counter that's to be incremented */
static inline void osmo_counter_inc(struct osmo_counter *ctr)
{
ctr->value++;
@@ -36,25 +38,12 @@ static inline void osmo_counter_reset(struct osmo_counter *ctr)
ctr->value = 0;
}
-/*! Allocate a new counter */
struct osmo_counter *osmo_counter_alloc(const char *name);
-/*! Free the specified counter
- * \param[in] ctr Counter
- */
void osmo_counter_free(struct osmo_counter *ctr);
-/*! Iterate over all counters
- * \param[in] handle_counter Call-back function, aborts if rc < 0
- * \param[in] data Private dtata handed through to \a handle_counter
- */
int osmo_counters_for_each(int (*handle_counter)(struct osmo_counter *, void *), void *data);
-/*! Resolve counter by human-readable name
- * \param[in] name human-readable name of counter
- * \returns pointer to counter (\ref osmo_counter) or NULL otherwise
- */
struct osmo_counter *osmo_counter_get_by_name(const char *name);
-/*! Return the counter difference since the last call to this function */
int osmo_counter_difference(struct osmo_counter *ctr);