This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
realtime:documentation:hr_timers [2016/12/28 00:27] ayates1 created |
— (current) | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | Further information can be found in the paper of the OLS 2006 talk "hrtimers | ||
| - | and beyond". The paper is part of the OLS 2006 Proceedings Volume 1, which can | ||
| - | be found on the OLS website: | ||
| - | [[https://www.kernel.org/doc/ols/2006/ols2006v1-pages-333-346.pdf]] | ||
| - | The slides to this talk are available from: | ||
| - | official http://tglx.de/projects/hrtimers/ols2006-hrtimers.pdf | ||
| - | [[http://www.cs.columbia.edu/~nahum/w6998/papers/ols2006-hrtimers-slides.pdf]] | ||
| - | |||
| - | The slides contain five figures (pages 2, 15, 18, 20, 22), which illustrate the | ||
| - | changes in the time(r) related Linux subsystems. Figure #1 (p. 2) shows the | ||
| - | design of the Linux time(r) system before hrtimers and other building blocks | ||
| - | got merged into mainline. | ||
| - | |||
| - | Note: the paper and the slides are talking about "clock event source", while we | ||
| - | switched to the name "clock event devices" in meantime. | ||
| - | |||
| - | ======The hrtimer base infrastructure====== | ||
| - | |||
| - | The hrtimer base infrastructure was merged into the 2.6.16 kernel. Details of | ||
| - | the base implementation are covered in Documentation/timers/hrtimers.txt. See | ||
| - | also figure #2 (OLS slides p. 15) | ||
| - | |||
| - | The main differences to the timer wheel, which holds the armed timer_list type | ||
| - | timers are: | ||
| - | - time ordered enqueueing into a rb-tree | ||
| - | - independent of ticks (the processing is based on nanoseconds) | ||
| - | |||
| - | |||
| - | ======timeofday and clock source management====== | ||
| - | |||
| - | John Stultz's Generic Time Of Day (GTOD) framework moves a large portion of | ||
| - | code out of the architecture-specific areas into a generic management | ||
| - | framework, as illustrated in figure #3 (OLS slides p. 18). The architecture | ||
| - | specific portion is reduced to the low level hardware details of the clock | ||
| - | sources, which are registered in the framework and selected on a quality based | ||
| - | decision. The low level code provides hardware setup and readout routines and | ||
| - | initializes data structures, which are used by the generic time keeping code to | ||
| - | convert the clock ticks to nanosecond based time values. All other time keeping | ||
| - | related functionality is moved into the generic code. The GTOD base patch got | ||
| - | merged into the 2.6.18 kernel. | ||
| - | |||
| - | Further information about the Generic Time Of Day framework is available in the | ||
| - | OLS 2005 Proceedings Volume 1: | ||
| - | https://www.kernel.org/doc/ols/2005/ols2005v1-pages-227-240.pdf | ||
| - | |||
| - | The paper "We Are Not Getting Any Younger: A New Approach to Time and | ||
| - | Timers" was written by J. Stultz, D.V. Hart, & N. Aravamudan. | ||
| - | |||
| - | Figure #3 (OLS slides p.18) illustrates the transformation. | ||
| - | |||
| - | |||
| - | ======clock event management====== | ||
| - | While clock sources provide read access to the monotonically increasing time | ||
| - | value, clock event devices are used to schedule the next event | ||
| - | interrupt(s). The next event is currently defined to be periodic, with its | ||
| - | period defined at compile time. The setup and selection of the event device | ||
| - | for various event driven functionalities is hardwired into the architecture | ||
| - | dependent code. This results in duplicated code across all architectures and | ||
| - | makes it extremely difficult to change the configuration of the system to use | ||
| - | event interrupt devices other than those already built into the | ||
| - | architecture. Another implication of the current design is that it is necessary | ||
| - | to touch all the architecture-specific implementations in order to provide new | ||
| - | functionality like high resolution timers or dynamic ticks. | ||
| - | |||
| - | The clock events subsystem tries to address this problem by providing a generic | ||
| - | solution to manage clock event devices and their usage for the various clock | ||
| - | event driven kernel functionalities. The goal of the clock event subsystem is | ||
| - | to minimize the clock event related architecture dependent code to the pure | ||
| - | hardware related handling and to allow easy addition and utilization of new | ||
| - | clock event devices. It also minimizes the duplicated code across the | ||
| - | architectures as it provides generic functionality down to the interrupt | ||
| - | service handler, which is almost inherently hardware dependent. | ||
| - | |||
| - | Clock event devices are registered either by the architecture dependent boot | ||
| - | code or at module insertion time. Each clock event device fills a data | ||
| - | structure with clock-specific property parameters and callback functions. The | ||
| - | clock event management decides, by using the specified property parameters, the | ||
| - | set of system functions a clock event device will be used to support. This | ||
| - | includes the distinction of per-CPU and per-system global event devices. | ||
| - | |||
| - | System-level global event devices are used for the Linux periodic tick. Per-CPU | ||
| - | event devices are used to provide local CPU functionality such as process | ||
| - | accounting, profiling, and high resolution timers. | ||
| - | |||
| - | The management layer assigns one or more of the following functions to a clock | ||
| - | event device: | ||
| - | - system global periodic tick (jiffies update) | ||
| - | - cpu local update_process_times | ||
| - | - cpu local profiling | ||
| - | - cpu local next event interrupt (non periodic mode) | ||
| - | |||
| - | The clock event device delegates the selection of those timer interrupt related | ||
| - | functions completely to the management layer. The clock management layer stores | ||
| - | a function pointer in the device description structure, which has to be called | ||
| - | from the hardware level handler. This removes a lot of duplicated code from the | ||
| - | architecture specific timer interrupt handlers and hands the control over the | ||
| - | clock event devices and the assignment of timer interrupt related functionality | ||
| - | to the core code. | ||
| - | |||
| - | The clock event layer API is rather small. Aside from the clock event device | ||
| - | registration interface it provides functions to schedule the next event | ||
| - | interrupt, clock event device notification service and support for suspend and | ||
| - | resume. | ||
| - | |||
| - | The framework adds about 700 lines of code which results in a 2KB increase of | ||
| - | the kernel binary size. The conversion of i386 removes about 100 lines of | ||
| - | code. The binary size decrease is in the range of 400 byte. We believe that the | ||
| - | increase of flexibility and the avoidance of duplicated code across | ||
| - | architectures justifies the slight increase of the binary size. | ||
| - | |||
| - | The conversion of an architecture has no functional impact, but allows to | ||
| - | utilize the high resolution and dynamic tick functionalities without any change | ||
| - | to the clock event device and timer interrupt code. After the conversion the | ||
| - | enabling of high resolution timers and dynamic ticks is simply provided by | ||
| - | adding the kernel/time/Kconfig file to the architecture specific Kconfig and | ||
| - | adding the dynamic tick specific calls to the idle routine (a total of 3 lines | ||
| - | added to the idle function and the Kconfig file) | ||
| - | |||
| - | Figure #4 (OLS slides p.20) illustrates the transformation. | ||
| - | |||
| - | |||
| - | ======high resolution timer functionality====== | ||
| - | |||
| - | During system boot it is not possible to use the high resolution timer | ||
| - | functionality, while making it possible would be difficult and would serve no | ||
| - | useful function. The initialization of the clock event device framework, the | ||
| - | clock source framework (GTOD) and hrtimers itself has to be done and | ||
| - | appropriate clock sources and clock event devices have to be registered before | ||
| - | the high resolution functionality can work. Up to the point where hrtimers are | ||
| - | initialized, the system works in the usual low resolution periodic mode. The | ||
| - | clock source and the clock event device layers provide notification functions | ||
| - | which inform hrtimers about availability of new hardware. hrtimers validates | ||
| - | the usability of the registered clock sources and clock event devices before | ||
| - | switching to high resolution mode. This ensures also that a kernel which is | ||
| - | configured for high resolution timers can run on a system which lacks the | ||
| - | necessary hardware support. | ||
| - | |||
| - | The high resolution timer code does not support SMP machines which have only | ||
| - | global clock event devices. The support of such hardware would involve IPI | ||
| - | calls when an interrupt happens. The overhead would be much larger than the | ||
| - | benefit. This is the reason why we currently disable high resolution and | ||
| - | dynamic ticks on i386 SMP systems which stop the local APIC in C3 power | ||
| - | state. A workaround is available as an idea, but the problem has not been | ||
| - | tackled yet. | ||
| - | |||
| - | The time ordered insertion of timers provides all the infrastructure to decide | ||
| - | whether the event device has to be reprogrammed when a timer is added. The | ||
| - | decision is made per timer base and synchronized across per-cpu timer bases in | ||
| - | a support function. The design allows the system to utilize separate per-CPU | ||
| - | clock event devices for the per-CPU timer bases, but currently only one | ||
| - | reprogrammable clock event device per-CPU is utilized. | ||
| - | |||
| - | When the timer interrupt happens, the next event interrupt handler is called | ||
| - | from the clock event distribution code and moves expired timers from the | ||
| - | red-black tree to a separate double linked list and invokes the softirq | ||
| - | handler. An additional mode field in the hrtimer structure allows the system to | ||
| - | execute callback functions directly from the next event interrupt handler. This | ||
| - | is restricted to code which can safely be executed in the hard interrupt | ||
| - | context. This applies, for example, to the common case of a wakeup function as | ||
| - | used by nanosleep. The advantage of executing the handler in the interrupt | ||
| - | context is the avoidance of up to two context switches - from the interrupted | ||
| - | context to the softirq and to the task which is woken up by the expired | ||
| - | timer. | ||
| - | |||
| - | Once a system has switched to high resolution mode, the periodic tick is | ||
| - | switched off. This disables the per system global periodic clock event device - | ||
| - | e.g. the PIT on i386 SMP systems. | ||
| - | |||
| - | The periodic tick functionality is provided by an per-cpu hrtimer. The callback | ||
| - | function is executed in the next event interrupt context and updates jiffies | ||
| - | and calls update_process_times and profiling. The implementation of the hrtimer | ||
| - | based periodic tick is designed to be extended with dynamic tick functionality. | ||
| - | This allows to use a single clock event device to schedule high resolution | ||
| - | timer and periodic events (jiffies tick, profiling, process accounting) on UP | ||
| - | systems. This has been proved to work with the PIT on i386 and the Incrementer | ||
| - | on PPC. | ||
| - | |||
| - | The softirq for running the hrtimer queues and executing the callbacks has been | ||
| - | separated from the tick bound timer softirq to allow accurate delivery of high | ||
| - | resolution timer signals which are used by itimer and POSIX interval | ||
| - | timers. The execution of this softirq can still be delayed by other softirqs, | ||
| - | but the overall latencies have been significantly improved by this separation. | ||
| - | |||
| - | Figure #5 (OLS slides p.22) illustrates the transformation. | ||
| - | |||
| - | |||
| - | ======dynamic ticks====== | ||
| - | |||
| - | Dynamic ticks are the logical consequence of the hrtimer based periodic tick | ||
| - | replacement (sched_tick). The functionality of the sched_tick hrtimer is | ||
| - | extended by three functions: | ||
| - | |||
| - | - hrtimer_stop_sched_tick | ||
| - | - hrtimer_restart_sched_tick | ||
| - | - hrtimer_update_jiffies | ||
| - | |||
| - | hrtimer_stop_sched_tick() is called when a CPU goes into idle state. The code | ||
| - | evaluates the next scheduled timer event (from both hrtimers and the timer | ||
| - | wheel) and in case that the next event is further away than the next tick it | ||
| - | reprograms the sched_tick to this future event, to allow longer idle sleeps | ||
| - | without worthless interruption by the periodic tick. The function is also | ||
| - | called when an interrupt happens during the idle period, which does not cause a | ||
| - | reschedule. The call is necessary as the interrupt handler might have armed a | ||
| - | new timer whose expiry time is before the time which was identified as the | ||
| - | nearest event in the previous call to hrtimer_stop_sched_tick. | ||
| - | |||
| - | hrtimer_restart_sched_tick() is called when the CPU leaves the idle state before | ||
| - | it calls schedule(). hrtimer_restart_sched_tick() resumes the periodic tick, | ||
| - | which is kept active until the next call to hrtimer_stop_sched_tick(). | ||
| - | |||
| - | hrtimer_update_jiffies() is called from irq_enter() when an interrupt happens | ||
| - | in the idle period to make sure that jiffies are up to date and the interrupt | ||
| - | handler has not to deal with an eventually stale jiffy value. | ||
| - | |||
| - | The dynamic tick feature provides statistical values which are exported to | ||
| - | userspace via /proc/stats and can be made available for enhanced power | ||
| - | management control. | ||
| - | |||
| - | The implementation leaves room for further development like full tickless | ||
| - | systems, where the time slice is controlled by the scheduler, variable | ||
| - | frequency profiling, and a complete removal of jiffies in the future. | ||
| - | |||
| - | |||
| - | Aside the current initial submission of i386 support, the patchset has been | ||
| - | extended to x86_64 and ARM already. Initial (work in progress) support is also | ||
| - | available for MIPS and PowerPC. | ||
| - | |||
| - | Thomas, Ingo | ||