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

This function registers function callbacks to occur at a specific 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 415 of file snmp_alarm.c.

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 492 of file snmp_alarm.c.

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

Parameters:

clientreg

is a unique unsigned integer representing a registered alarm which the client wants to unregister.

Returns:

void

See also:

snmp_alarm_register

snmp_alarm_register_hr

snmp_alarm_unregister_all

Definition at line 151 of file snmp_alarm.c.

This function unregisters all alarms currently stored.

Returns:

void

See also:

snmp_alarm_register

snmp_alarm_register_hr

snmp_alarm_unregister

Definition at line 184 of file snmp_alarm.c.