add 0.6.0 split

[lttv.git] / ltt-control / facilities / timer.xml

<?xml version="1.0"?>
<facility name="timer">
  <description>The timer facility has events related to timer events in the kernel.</description>

  <type name="itimer_kind">
    <enum>
      <label name="ITIMER_REAL" value="0"/> <description>decrements in real time,
      and delivers SIGALRM upon expiration.</description>
      <label name="ITIMER_VIRTUAL" value="1"/> <description>decrements only when the
      process is executing, and delivers SIGVTALRM upon expiration.</description>
      <label name="ITIMER_PROF" value="2"/> <description>decrements both when the
      process executes and when the system is executing on behalf of the
      process. Coupled with ITIMER_VIRTUAL, this timer is usually used to
      profile the time spent by the application in user and kernel space.
      SIGPROF is delivered upon expiration.</description>
    </enum>
  </type>

  <event name="expired">
    <description>A timer or itimer has expired.</description>
    <field name="pid">
			<description>PID of the process to wake up.</description>
			<uint size="4"/>
		</field>
  </event>

  <event name="softirq">
    <description>The timer softirq is currently runned.</description>
  </event>

  <event name="set_itimer">
    <description>An interval timer is set.</description>
    <field name="which"> <description>kind of interval timer.</description>
	    <typeref name="itimer_kind"/>
    </field>
    <field name="interval_seconds"><uint size="4"/></field>
    <field name="interval_microseconds"><uint size="4"/></field>
    <field name="value_seconds"><uint size="4"/></field>
    <field name="value_microseconds"><uint size="4"/></field>
  </event>

  <event name="set_timer">
    <description>A timer is added/modified/migrated.</description>
    <field name="expires"><ulong/></field>
    <field name="function"><pointer/></field>
    <field name="data"><ulong/></field>
  </event>

  <event name="update_time">
    <description>The time is updated (timer interrupt).</description>
    <field name="jiffies"><uint_fixed size="8"/></field>
    <field name="wall_tv_sec"><long/></field>
    <field name="wall_tv_nsec"><long/></field>
    <field name="wall_to_monotonic_tv_sec"><long/></field>
    <field name="wall_to_monotonic_tv_nsec"><long/></field>
  </event>

</facility>