generic library based alarm timers for various parts of an application
[The Net-SNMP library]


Functions
int	init_alarm_post_config (int majorid, int minorid, void serverarg, void clientarg)
void	init_snmp_alarm (void)
void	sa_update_entry (struct snmp_alarm *a)
void	snmp_alarm_unregister (unsigned int clientreg)
	This function removes the callback function from a list of registered alarms, unregistering the alarm.
void	snmp_alarm_unregister_all (void)
	This function unregisters all alarms currently stored.
snmp_alarm *	sa_find_next (void)
snmp_alarm *	sa_find_specific (unsigned int clientreg)
void	run_alarms (void)
RETSIGTYPE	alarm_handler (int a)
int	get_next_alarm_delay_time (struct timeval *delta)
void	set_an_alarm (void)
unsigned int	snmp_alarm_register (unsigned int when, unsigned int flags, SNMPAlarmCallback thecallback, void clientarg)
	This function registers function callbacks to occur at a speciifc time in the future.
unsigned int	snmp_alarm_register_hr (struct timeval t, unsigned int flags, SNMPAlarmCallback cb, void cd)
	This function offers finer granularity as to when the callback function is called by making use of t->tv_usec value forming the "when" aspect of snmp_alarm_register().

Function Documentation

unsigned int snmp_alarm_register	(	unsigned int	when,
		unsigned int	flags,
		SNMPAlarmCallback *	thecallback,
		void *	clientarg
	)

This function registers function callbacks to occur at a speciifc time in the future.

Parameters:

	when	is an unsigned integer specifying when the callback function will be called in seconds.
	flags	is an unsigned integer that specifies how frequent the callback function is called in seconds. Should be SA_REPEAT or 0. If flags is set with SA_REPEAT, then the registered callback function will be called every SA_REPEAT seconds. If flags is 0 then the function will only be called once and then removed from the registered alarm list.
	thecallback	is a pointer SNMPAlarmCallback which is the callback function being stored and registered.
	clientarg	is a void pointer used by the callback function. This pointer is assigned to snmp_alarm->clientarg and passed into the callback function for the client's specifc needs.

Returns:: Returns a unique unsigned integer(which is also passed as the first argument of each callback), which can then be used to remove the callback from the list at a later point in the future using the snmp_alarm_unregister() function. If memory could not be allocated for the snmp_alarm struct 0 is returned.

See also:

snmp_alarm_unregister

snmp_alarm_register_hr

snmp_alarm_unregister_all

Examples:: delayed_instance.c, and notification.c.

Definition at line 403 of file snmp_alarm.c.

References SNMP_MALLOC_STRUCT.

Referenced by netsnmp_cache_timer_start(), and release_cached_resources().

unsigned int snmp_alarm_register_hr	(	struct timeval	t,
		unsigned int	flags,
		SNMPAlarmCallback *	cb,
		void *	cd
	)

This function offers finer granularity as to when the callback function is called by making use of t->tv_usec value forming the "when" aspect of snmp_alarm_register().

Parameters:

	t	is a timeval structure used to specify when the callback function(alarm) will be called. Adds the ability to specify microseconds. t.tv_sec and t.tv_usec are assigned to snmp_alarm->tv_sec and snmp_alarm->tv_usec respectively internally. The snmp_alarm_register function only assigns seconds(it's when argument).
	flags	is an unsigned integer that specifies how frequent the callback function is called in seconds. Should be SA_REPEAT or NULL. If flags is set with SA_REPEAT, then the registered callback function will be called every SA_REPEAT seconds. If flags is NULL then the function will only be called once and then removed from the registered alarm list.
	cb	is a pointer SNMPAlarmCallback which is the callback function being stored and registered.
	cd	is a void pointer used by the callback function. This pointer is assigned to snmp_alarm->clientarg and passed into the callback function for the client's specifc needs.

Returns:: Returns a unique unsigned integer(which is also passed as the first argument of each callback), which can then be used to remove the callback from the list at a later point in the future using the snmp_alarm_unregister() function. If memory could not be allocated for the snmp_alarm struct 0 is returned.

See also:

snmp_alarm_register

snmp_alarm_unregister

snmp_alarm_unregister_all

Definition at line 475 of file snmp_alarm.c.

References SNMP_MALLOC_STRUCT.

void snmp_alarm_unregister

(

unsigned int

clientreg

)

This function removes the callback function from a list of registered alarms, unregistering the alarm.