statistics.h File Reference

This function will retrieve a list of all ip addresses and ports that OpenSER is listening on, with respect to the transport protocol specified with 'protocol'.

The first parameter, ipList, is a pointer to a pointer. It will be assigned a new block of memory holding the IP Addresses and ports being listened to with respect to 'protocol'. The array maps a 2D array into a 1 dimensional space, and is layed out as follows:

The first NUM_IP_OCTETS indices will be the IP address, and the next index the port. So if NUM_IP_OCTETS is equal to 4 and there are two IP addresses found, then:

ipList[0] will be the first octet of the first ip address
ipList[3] will be the last octet of the first ip address.
iplist[4] will be the port of the first ip address
iplist[5] will be the first octet of the first ip address,
and so on.

The function will return the number of sockets which were found. This can be used to index into ipList.

Note:: This function assigns a block of memory equal to:

returnedValue * (NUM_IP_OCTETS + 1) * sizeof(int);

Therefore it is CRUCIAL that you free ipList when you are done with its contents, to avoid a nasty memory leak.

Referenced by init_openserSIPPortTable().

int get_total_bytes_waiting ( void )

Returns the sum of the number of bytes waiting to be consumed on all network interfaces and transports that OpenSER is listening on.

Note: This currently only works on systems supporting the /proc/net/[tcp|udp] interface. On other systems, zero will always be returned. Details of why this is so can be found in network_stats.c

Referenced by check_msg_queue_alarm(), handle_openserMsgQueueDepth(), and rl_timer().


Data Structures
struct	module_stats_
struct	stat_export_
struct	stat_var_
struct	stats_collector_
Defines
#define	destroy_stats_collector()
#define	get_stat(_name) 0
#define	get_stat_val(_var) 0
#define	get_stat_var_from_num_code(_n_code, _in_code) NULL
#define	if_reset_stat(_c, _var)
#define	if_update_stat(_c, _var, _n)
#define	init_stats_collector() 0
#define	NUM_IP_OCTETS 4
#define	register_module_stats(_mod, _stats) 0
#define	register_stat(_mod, _name, _pvar, _flags) 0
#define	reset_stat(_var)
#define	STAT_IS_FUNC (1<<3)
#define	STAT_NO_RESET (1<<0)
#define	STAT_NO_SYNC (1<<1)
#define	STAT_SHM_NAME (1<<2)
#define	STATS_HASH_POWER 8
#define	STATS_HASH_SIZE (1<<(STATS_HASH_POWER))
#define	update_stat(_var, _n)
Typedefs
typedef struct module_stats_	module_stats
typedef struct stat_export_	stat_export_t
typedef unsigned long(*	stat_function )(void)
typedef unsigned int	stat_val
typedef struct stat_var_	stat_var
typedef struct stats_collector_	stats_collector
Functions
int	get_socket_list_from_proto (int **ipList, int protocol)
int	get_total_bytes_waiting (void)