counters/stats: More...

#include "counters.h"
#include "str_hash.h"
#include "str.h"
#include "compiler_opt.h"
#include "mem/mem.h"
#include "mem/shm_mem.h"

Include dependency graph for counters.c:

Go to the source code of this file.

Functions

static struct counter_record * cnt_hash_add (str *group, str *name, int flags, counter_cbk_f cbk, void *param, const char *doc)
adds new counter to the hash table (no checks, internal version).
static struct counter_record * cnt_hash_get_create (str *group, str *name, int flags, counter_cbk_f cbk, void *param, const char *doc)
lookup a counter and if not found create a new counter record.
static struct counter_record * cnt_hash_lookup (str *group, str *name)
lookup a (group, name) pair into the cnts hash (internal version).
char * counter_get_doc (counter_handle_t handle)
return the description (doc) string for a given counter.
char * counter_get_group (counter_handle_t handle)
return the group name for counter handle.
char * counter_get_name (counter_handle_t handle)
return the name for counter handle.
counter_val_t counter_get_raw_val (counter_handle_t handle)
get the value of the counter, bypassing callbacks.
counter_val_t counter_get_val (counter_handle_t handle)
get the value of the counter, using the callbacks (if defined).
void counter_iterate_grp_names (void(*cbk)(void *p, str *grp_name), void *p)
iterate on all the counter group names.
void counter_iterate_grp_var_names (const char *group, void(*cbk)(void *p, str *var_name), void *p)
iterate on all the variable names in a specified group.
void counter_iterate_grp_vars (const char *group, void(*cbk)(void *p, str *g, str *n, counter_handle_t h), void *p)
iterate on all the variable names and handles in a specified group.
int counter_lookup (counter_handle_t *handle, const char *group, const char *name)
fill in the handle of an existing counter (asciiz parameters).
int counter_lookup_str (counter_handle_t *handle, str *group, str *name)
fill in the handle of an existing counter (str parameters).
int counter_register (counter_handle_t *handle, const char *group, const char *name, int flags, counter_cbk_f cbk, void *cbk_param, const char *doc, int reg_flags)
register a new counter.
int counter_register_array (const char *group, counter_def_t *defs)
register all the counters declared in a null-terminated array.
void counter_reset (counter_handle_t handle)
reset the counter.
int counters_prefork_init (int max_process_no)
complete counter intialization, when the number of processes is known.
static struct grp_record * grp_hash_add (str *group)
adds new group to the group hash table (no checks, internal version).
static struct grp_record * grp_hash_get_create (str *group)
lookup a group and if not found create a new group record.
static struct grp_record * grp_hash_lookup (str *group)
lookup a group into the group hash (internal version).
int init_counters ()
init the coutner hash table(s).

Variables

counter_array_t * _cnts_vals
counters array.
struct counter_record ** cnt_id2record
array maping id 2 record
static struct str_hash_table cnts_hash_table
hash table mapping a counter name to an id
static struct str_hash_table grp_hash_table
hash table for groups (maps a group name to a counter list)
static struct grp_record ** grp_sorted
array of groups, sorted

Detailed Description

Definition in file counters.c.

Function Documentation

static struct counter_record* cnt_hash_add	(	str *	group,
		str *	name,
		int	flags,
		counter_cbk_f	cbk,
		void *	param,
		const char *	doc
	)			`[static, read]`

Returns:: pointer to new record on success, 0 on error.

Definition at line 306 of file counters.c.

References _cnts_vals, cnts_hash_table, grp_hash_get_create(), _str::len, and _str::s.

Referenced by cnt_hash_get_create().

Here is the call graph for this function:

Here is the caller graph for this function:

static struct counter_record* cnt_hash_get_create	(	str *	group,
		str *	name,
		int	flags,
		counter_cbk_f	cbk,
		void *	param,
		const char *	doc
	)			`[static, read]`

Returns:: pointer to counter_record on succes, 0 on failure ( not found and failed to create new group record).

Definition at line 450 of file counters.c.

References cnt_hash_add(), and cnt_hash_lookup().

Referenced by counter_register().

Here is the call graph for this function:

Here is the caller graph for this function:

static struct counter_record* cnt_hash_lookup	(	str *	group,
		str *	name
	)			`[static, read]`

Parameters:

	group	- counter group name. If "" the first matching counter with the given name will be returned (k compat).
	name

Returns:: pointer to counter_record on success, 0 on failure (not found).

Definition at line 414 of file counters.c.

References cnts_hash_table, _str::len, and _str::s.

Referenced by cnt_hash_get_create(), counter_lookup_str(), and counter_register().

Here is the caller graph for this function:

char* counter_get_doc ( counter_handle_t handle )

Parameters:

handle

- counter handle obtained using counter_lookup() or counter_register().

Returns:: asciiz pointer on success, 0 on error.

Definition at line 721 of file counters.c.

References _cnts_vals.

char* counter_get_group ( counter_handle_t handle )

Parameters:

handle

- counter handle obtained using counter_lookup() or counter_register().

Returns:: asciiz pointer on success, 0 on error.

Definition at line 698 of file counters.c.

References _cnts_vals.

char* counter_get_name ( counter_handle_t handle )

Parameters:

handle

- counter handle obtained using counter_lookup() or counter_register().

Returns:: asciiz pointer on success, 0 on error.

Definition at line 675 of file counters.c.

References _cnts_vals.

counter_val_t counter_get_raw_val ( counter_handle_t handle )

Parameters:

handle

- counter handle obtained using counter_lookup() or counter_register().

Returns:: counter value.

Definition at line 599 of file counters.c.

References _cnts_vals, and counter_pprocess_val.

Referenced by counter_get_val().

Here is the caller graph for this function:

counter_val_t counter_get_val ( counter_handle_t handle )

Parameters:

handle

- counter handle obtained using counter_lookup() or counter_register().

Returns:: counter value.

Definition at line 625 of file counters.c.

References _cnts_vals, and counter_get_raw_val().

Here is the call graph for this function:

void counter_iterate_grp_names	(	void()(void p, str *grp_name)	cbk,
		void *	p
	)

Parameters:

	cbk	- pointer to a callback function that will be called for each group name.
	p	- parameter that will be passed to the callback function (along the group name).

Definition at line 745 of file counters.c.

void counter_iterate_grp_var_names	(	const char *	group,
		void()(void p, str *var_name)	cbk,
		void *	p
	)

Parameters:

	group	- group name.
	cbk	- pointer to a callback function that will be called for each variable name.
	p	- parameter that will be passed to the callback function (along the variable name).

Definition at line 762 of file counters.c.

References grp_hash_lookup(), _str::len, and _str::s.

Here is the call graph for this function:

void counter_iterate_grp_vars	(	const char *	group,
		void()(void p, str g, str n, counter_handle_t h)	cbk,
		void *	p
	)

Parameters:

	group	- group name.
	cbk	- pointer to a callback function that will be called for each [variable name, variable handle] pair.
	p	- parameter that will be passed to the callback function (along the group name, variable name and variable handle).

Definition at line 787 of file counters.c.

References grp_hash_lookup(), _str::len, and _str::s.

Here is the call graph for this function:

int counter_lookup	(	counter_handle_t *	handle,
		const char *	group,
		const char *	name
	)

Parameters:

	handle	- filled with the corresp. handle on success.
	group	- counter group name. If 0 or "" the first matching counter with the given name will be returned (k compat).
	name	- counter name.

Returns:: 0 on success, < 0 on error

Definition at line 559 of file counters.c.

References counter_lookup_str(), _str::len, and _str::s.

Here is the call graph for this function:

int counter_lookup_str	(	counter_handle_t *	handle,
		str *	group,
		str *	name
	)

Parameters:

	handle	- filled with the corresp. handle on success.
	group	- counter group name. If "" the first matching counter with the given name will be returned (k compat).
	name	- counter name.

Returns:: 0 on success, < 0 on error

Definition at line 536 of file counters.c.

References cnt_hash_lookup().

Referenced by counter_lookup().

Here is the call graph for this function:

Here is the caller graph for this function:

int counter_register	(	counter_handle_t *	handle,
		const char *	group,
		const char *	name,
		int	flags,
		counter_cbk_f	cbk,
		void *	cbk_param,
		const char *	doc,
		int	reg_flags
	)

Can be called only before forking (e.g. from mod_init() or init_child(PROC_INIT)).

Parameters:

	handle	- result parameter, it will be filled with the counter handle on success (can be null if not needed).
	group	- group name
	name	- counter name (group.name must be unique).
	flags	- counter flags: one of CNT_F_*.
	cbk	- read callback function (if set it will be called each time someone will call counter_get()).
	cbk_param	- callback param.
	doc	- description/documentation string.
	reg_flags	- register flags: 1 - don't fail if counter already registered (act like counter_lookup(handle, group, name).