1SNMP_ALARM(3) Net-SNMP SNMP_ALARM(3)
2
6 snmp_alarm_register, snmp_alarm_register_hr, snmp_alarm_unregister -
7 alarm functions
8
10 #include <net-snmp/utilities.h>
11 unsigned int
13 snmp_alarm_register(unsigned int seconds,
14 unsigned int flags,
15 SNMPAlarmCallback *f_callback,
16 void *clientarg);
17 unsigned int
19 snmp_alarm_register_hr(struct timeval t,
20 unsigned int flags,
21 SNMPAlarmCallback *f_callback,
22 void *clientarg);
23 void
25 snmp_alarm_unregister(unsigned int reg);
26
28 These functions implement support for a generic timer handling mecha‐
29 nism for multiple parts of an application to register function call‐
30 backs to happen at a particular time in the future.
31
33 The usage is fairly simple and straight-forward: Simply create a func‐
34 tion you want called back at some point in the future. The function
35 definition should be similar to:
36 void my_callback(unsigned int reg, void *clientarg);
38 Then, call snmp_alarm_register() to register your callback to be called
40 seconds from now. The flags field should either be SA_REPEAT or NULL.
41 If flags is set with SA_REPEAT, then the registered callback function
42 will be called every seconds. If flags is NULL then the function will
43 only be called once and then removed from the alarm system registra‐
44 tion.
45 The clientarg parameter in the registration function is used only by
47 the client function and is stored and passed back directly to them on
48 every call to the system.
49 The snmp_alarm_register() function returns a unique unsigned int (which
51 is also passed as the first argument of each callback), which can then
52 be used to remove the callback from the queue at a later point in the
53 future using the snmp_alarm_unregister() function. If the
54 snmp_alarm_register() call fails it returns zero. In particular, note
55 that it is entirely permissible for an alarm function to unregister
56 itself.
57 The snmp_alarm_register_hr() function is identical in operation to the
59 snmp_alarm_register() function, but takes a struct timeval as a first
60 parameter, and schedules the callback after the period represented by t
61 (the letters hr stand for "high resolution"). The operation of this
62 function is dependent on the provision of the setitimer(2) system call
63 by the operating system. If this system call is not available, the
64 alarm will be scheduled as if snmp_alarm_register() had been called
65 with a first argument equal to the value of the tv_sec member of t.
66 See, however, the notes below.
67
69 The init_snmp() function initialises the snmp_alarm subsystem by call‐
70 ing init_snmp_alarm() and then init_alarm_post_config() to set up the
71 first timer to initialise the callback function. These two functions
72 should not be used directly by applications.
73
75 The default behaviour of the snmp_alarm subsystem is to req