generic library based alarm timers for various parts of an application(3)

NAME
generic library based alarm timers for various parts of an application -

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

Referenced by netsnmp_cache_timer_stop().

  void snmp_alarm_unregister_all (void)

This function unregisters all alarms currently stored. Returns:
    void

See also:
    snmp_alarm_register

    snmp_alarm_register_hr

    snmp_alarm_unregister

Definition at line 183 of file snmp_alarm.c.

Referenced by snmp_shutdown().