| 1 | <facility name=timer> |
| 2 | <description>The timer facility has events related to timer events in the kernel.</description> |
| 3 | |
| 4 | <event name=expired> |
| 5 | <description>A timer or itimer has expired.</description> |
| 6 | <struct> |
| 7 | <field name="pid"> <description>PID of the process to wake up.</description> <uint size=4/> </field> |
| 8 | </struct> |
| 9 | </event> |
| 10 | |
| 11 | <event name=softirq> |
| 12 | <description>The timer softirq is currently runned.</description> |
| 13 | </event> |
| 14 | |
| 15 | <event name=set_itimer> |
| 16 | <description>An interval timer is set.</description> |
| 17 | <struct> |
| 18 | <field name="which"> <description>kind of interval timer.</description> |
| 19 | <typeref name=itimer_kind/> |
| 20 | </field> |
| 21 | <field name="interval"> <description>timer interval.</description> |
| 22 | <typeref name=timeval/> |
| 23 | </field> |
| 24 | <field name="value"> <description>current value.</description> |
| 25 | <typeref name=timeval/> |
| 26 | </field> |
| 27 | </struct> |
| 28 | </event> |
| 29 | |
| 30 | <type name=itimer_kind> |
| 31 | <enum size=4> |
| 32 | <label name=ITIMER_REAL value=0/> <description>decrements in real time, |
| 33 | and delivers SIGALRM upon expiration.</description> |
| 34 | <label name=ITIMER_VIRTUAL value=1/> <description>decrements only when the |
| 35 | process is executing, and delivers SIGVTALRM upon expiration.</description> |
| 36 | <label name=ITIMER_PROF value=2/> <description>decrements both when the |
| 37 | process executes and when the system is executing on behalf of the |
| 38 | process. Coupled with ITIMER_VIRTUAL, this timer is usually used to |
| 39 | profile the time spent by the application in user and kernel space. |
| 40 | SIGPROF is delivered upon expiration.</description> |
| 41 | </enum> |
| 42 | </type> |
| 43 | |
| 44 | <type name=timeval> |
| 45 | <struct> |
| 46 | <field name="seconds"><uint size=4/></field> |
| 47 | <field name="microseconds"><uint size=4/></field> |
| 48 | </struct> |
| 49 | </type> |
| 50 | |
| 51 | </facility> |