Merge remote-tracking branch 'remotes/mst/tags/for_upstream' into staging
[qemu.git] / qemu-timer.c
blob5741f0d0e0d95313a537109655f897e93a8a6145
1 /*
2 * QEMU System Emulator
4 * Copyright (c) 2003-2008 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
25 #include "qemu/main-loop.h"
26 #include "qemu/timer.h"
28 #ifdef CONFIG_POSIX
29 #include <pthread.h>
30 #endif
32 #ifdef CONFIG_PPOLL
33 #include <poll.h>
34 #endif
36 #ifdef CONFIG_PRCTL_PR_SET_TIMERSLACK
37 #include <sys/prctl.h>
38 #endif
40 /***********************************************************/
41 /* timers */
43 typedef struct QEMUClock {
44 /* We rely on BQL to protect the timerlists */
45 QLIST_HEAD(, QEMUTimerList) timerlists;
47 NotifierList reset_notifiers;
48 int64_t last;
50 QEMUClockType type;
51 bool enabled;
52 } QEMUClock;
54 QEMUTimerListGroup main_loop_tlg;
55 static QEMUClock qemu_clocks[QEMU_CLOCK_MAX];
57 /* A QEMUTimerList is a list of timers attached to a clock. More
58 * than one QEMUTimerList can be attached to each clock, for instance
59 * used by different AioContexts / threads. Each clock also has
60 * a list of the QEMUTimerLists associated with it, in order that
61 * reenabling the clock can call all the notifiers.
64 struct QEMUTimerList {
65 QEMUClock *clock;
66 QemuMutex active_timers_lock;
67 QEMUTimer *active_timers;
68 QLIST_ENTRY(QEMUTimerList) list;
69 QEMUTimerListNotifyCB *notify_cb;
70 void *notify_opaque;
72 /* lightweight method to mark the end of timerlist's running */
73 QemuEvent timers_done_ev;
76 /**
77 * qemu_clock_ptr:
78 * @type: type of clock
80 * Translate a clock type into a pointer to QEMUClock object.
82 * Returns: a pointer to the QEMUClock object
84 static inline QEMUClock *qemu_clock_ptr(QEMUClockType type)
86 return &qemu_clocks[type];
89 static bool timer_expired_ns(QEMUTimer *timer_head, int64_t current_time)
91 return timer_head && (timer_head->expire_time <= current_time);
94 QEMUTimerList *timerlist_new(QEMUClockType type,
95 QEMUTimerListNotifyCB *cb,
96 void *opaque)
98 QEMUTimerList *timer_list;
99 QEMUClock *clock = qemu_clock_ptr(type);
101 timer_list = g_malloc0(sizeof(QEMUTimerList));
102 qemu_event_init(&timer_list->timers_done_ev, false);
103 timer_list->clock = clock;
104 timer_list->notify_cb = cb;
105 timer_list->notify_opaque = opaque;
106 qemu_mutex_init(&timer_list->active_timers_lock);
107 QLIST_INSERT_HEAD(&clock->timerlists, timer_list, list);
108 return timer_list;
111 void timerlist_free(QEMUTimerList *timer_list)
113 assert(!timerlist_has_timers(timer_list));
114 if (timer_list->clock) {
115 QLIST_REMOVE(timer_list, list);
117 qemu_mutex_destroy(&timer_list->active_timers_lock);
118 g_free(timer_list);
121 static void qemu_clock_init(QEMUClockType type)
123 QEMUClock *clock = qemu_clock_ptr(type);
125 /* Assert that the clock of type TYPE has not been initialized yet. */
126 assert(main_loop_tlg.tl[type] == NULL);
128 clock->type = type;
129 clock->enabled = true;
130 clock->last = INT64_MIN;
131 QLIST_INIT(&clock->timerlists);
132 notifier_list_init(&clock->reset_notifiers);
133 main_loop_tlg.tl[type] = timerlist_new(type, NULL, NULL);
136 bool qemu_clock_use_for_deadline(QEMUClockType type)
138 return !(use_icount && (type == QEMU_CLOCK_VIRTUAL));
141 void qemu_clock_notify(QEMUClockType type)
143 QEMUTimerList *timer_list;
144 QEMUClock *clock = qemu_clock_ptr(type);
145 QLIST_FOREACH(timer_list, &clock->timerlists, list) {
146 timerlist_notify(timer_list);
150 /* Disabling the clock will wait for related timerlists to stop
151 * executing qemu_run_timers. Thus, this functions should not
152 * be used from the callback of a timer that is based on @clock.
153 * Doing so would cause a deadlock.
155 * Caller should hold BQL.
157 void qemu_clock_enable(QEMUClockType type, bool enabled)
159 QEMUClock *clock = qemu_clock_ptr(type);
160 QEMUTimerList *tl;
161 bool old = clock->enabled;
162 clock->enabled = enabled;
163 if (enabled && !old) {
164 qemu_clock_notify(type);
165 } else if (!enabled && old) {
166 QLIST_FOREACH(tl, &clock->timerlists, list) {
167 qemu_event_wait(&tl->timers_done_ev);
172 bool timerlist_has_timers(QEMUTimerList *timer_list)
174 return !!timer_list->active_timers;
177 bool qemu_clock_has_timers(QEMUClockType type)
179 return timerlist_has_timers(
180 main_loop_tlg.tl[type]);
183 bool timerlist_expired(QEMUTimerList *timer_list)
185 int64_t expire_time;
187 qemu_mutex_lock(&timer_list->active_timers_lock);
188 if (!timer_list->active_timers) {
189 qemu_mutex_unlock(&timer_list->active_timers_lock);
190 return false;
192 expire_time = timer_list->active_timers->expire_time;
193 qemu_mutex_unlock(&timer_list->active_timers_lock);
195 return expire_time < qemu_clock_get_ns(timer_list->clock->type);
198 bool qemu_clock_expired(QEMUClockType type)
200 return timerlist_expired(
201 main_loop_tlg.tl[type]);
205 * As above, but return -1 for no deadline, and do not cap to 2^32
206 * as we know the result is always positive.
209 int64_t timerlist_deadline_ns(QEMUTimerList *timer_list)
211 int64_t delta;
212 int64_t expire_time;
214 if (!timer_list->clock->enabled) {
215 return -1;
218 /* The active timers list may be modified before the caller uses our return
219 * value but ->notify_cb() is called when the deadline changes. Therefore
220 * the caller should notice the change and there is no race condition.
222 qemu_mutex_lock(&timer_list->active_timers_lock);
223 if (!timer_list->active_timers) {
224 qemu_mutex_unlock(&timer_list->active_timers_lock);
225 return -1;
227 expire_time = timer_list->active_timers->expire_time;
228 qemu_mutex_unlock(&timer_list->active_timers_lock);
230 delta = expire_time - qemu_clock_get_ns(timer_list->clock->type);
232 if (delta <= 0) {
233 return 0;
236 return delta;
239 /* Calculate the soonest deadline across all timerlists attached
240 * to the clock. This is used for the icount timeout so we
241 * ignore whether or not the clock should be used in deadline
242 * calculations.
244 int64_t qemu_clock_deadline_ns_all(QEMUClockType type)
246 int64_t deadline = -1;
247 QEMUTimerList *timer_list;
248 QEMUClock *clock = qemu_clock_ptr(type);
249 QLIST_FOREACH(timer_list, &clock->timerlists, list) {
250 deadline = qemu_soonest_timeout(deadline,
251 timerlist_deadline_ns(timer_list));
253 return deadline;
256 QEMUClockType timerlist_get_clock(QEMUTimerList *timer_list)
258 return timer_list->clock->type;
261 QEMUTimerList *qemu_clock_get_main_loop_timerlist(QEMUClockType type)
263 return main_loop_tlg.tl[type];
266 void timerlist_notify(QEMUTimerList *timer_list)
268 if (timer_list->notify_cb) {
269 timer_list->notify_cb(timer_list->notify_opaque);
270 } else {
271 qemu_notify_event();
275 /* Transition function to convert a nanosecond timeout to ms
276 * This is used where a system does not support ppoll
278 int qemu_timeout_ns_to_ms(int64_t ns)
280 int64_t ms;
281 if (ns < 0) {
282 return -1;
285 if (!ns) {
286 return 0;
289 /* Always round up, because it's better to wait too long than to wait too
290 * little and effectively busy-wait
292 ms = (ns + SCALE_MS - 1) / SCALE_MS;
294 /* To avoid overflow problems, limit this to 2^31, i.e. approx 25 days */
295 if (ms > (int64_t) INT32_MAX) {
296 ms = INT32_MAX;
299 return (int) ms;
303 /* qemu implementation of g_poll which uses a nanosecond timeout but is
304 * otherwise identical to g_poll
306 int qemu_poll_ns(GPollFD *fds, guint nfds, int64_t timeout)
308 #ifdef CONFIG_PPOLL
309 if (timeout < 0) {
310 return ppoll((struct pollfd *)fds, nfds, NULL, NULL);
311 } else {
312 struct timespec ts;
313 int64_t tvsec = timeout / 1000000000LL;
314 /* Avoid possibly overflowing and specifying a negative number of
315 * seconds, which would turn a very long timeout into a busy-wait.
317 if (tvsec > (int64_t)INT32_MAX) {
318 tvsec = INT32_MAX;
320 ts.tv_sec = tvsec;
321 ts.tv_nsec = timeout % 1000000000LL;
322 return ppoll((struct pollfd *)fds, nfds, &ts, NULL);
324 #else
325 return g_poll(fds, nfds, qemu_timeout_ns_to_ms(timeout));
326 #endif
330 void timer_init_tl(QEMUTimer *ts,
331 QEMUTimerList *timer_list, int scale,
332 QEMUTimerCB *cb, void *opaque)
334 ts->timer_list = timer_list;
335 ts->cb = cb;
336 ts->opaque = opaque;
337 ts->scale = scale;
338 ts->expire_time = -1;
341 void timer_deinit(QEMUTimer *ts)
343 assert(ts->expire_time == -1);
344 ts->timer_list = NULL;
347 void timer_free(QEMUTimer *ts)
349 g_free(ts);
352 static void timer_del_locked(QEMUTimerList *timer_list, QEMUTimer *ts)
354 QEMUTimer **pt, *t;
356 ts->expire_time = -1;
357 pt = &timer_list->active_timers;
358 for(;;) {
359 t = *pt;
360 if (!t)
361 break;
362 if (t == ts) {
363 *pt = t->next;
364 break;
366 pt = &t->next;
370 static bool timer_mod_ns_locked(QEMUTimerList *timer_list,
371 QEMUTimer *ts, int64_t expire_time)
373 QEMUTimer **pt, *t;
375 /* add the timer in the sorted list */
376 pt = &timer_list->active_timers;
377 for (;;) {
378 t = *pt;
379 if (!timer_expired_ns(t, expire_time)) {
380 break;
382 pt = &t->next;
384 ts->expire_time = MAX(expire_time, 0);
385 ts->next = *pt;
386 *pt = ts;
388 return pt == &timer_list->active_timers;
391 static void timerlist_rearm(QEMUTimerList *timer_list)
393 /* Interrupt execution to force deadline recalculation. */
394 qemu_clock_warp(timer_list->clock->type);
395 timerlist_notify(timer_list);
398 /* stop a timer, but do not dealloc it */
399 void timer_del(QEMUTimer *ts)
401 QEMUTimerList *timer_list = ts->timer_list;
403 if (timer_list) {
404 qemu_mutex_lock(&timer_list->active_timers_lock);
405 timer_del_locked(timer_list, ts);
406 qemu_mutex_unlock(&timer_list->active_timers_lock);
410 /* modify the current timer so that it will be fired when current_time
411 >= expire_time. The corresponding callback will be called. */
412 void timer_mod_ns(QEMUTimer *ts, int64_t expire_time)
414 QEMUTimerList *timer_list = ts->timer_list;
415 bool rearm;
417 qemu_mutex_lock(&timer_list->active_timers_lock);
418 timer_del_locked(timer_list, ts);
419 rearm = timer_mod_ns_locked(timer_list, ts, expire_time);
420 qemu_mutex_unlock(&timer_list->active_timers_lock);
422 if (rearm) {
423 timerlist_rearm(timer_list);
427 /* modify the current timer so that it will be fired when current_time
428 >= expire_time or the current deadline, whichever comes earlier.
429 The corresponding callback will be called. */
430 void timer_mod_anticipate_ns(QEMUTimer *ts, int64_t expire_time)
432 QEMUTimerList *timer_list = ts->timer_list;
433 bool rearm;
435 qemu_mutex_lock(&timer_list->active_timers_lock);
436 if (ts->expire_time == -1 || ts->expire_time > expire_time) {
437 if (ts->expire_time != -1) {
438 timer_del_locked(timer_list, ts);
440 rearm = timer_mod_ns_locked(timer_list, ts, expire_time);
441 } else {
442 rearm = false;
444 qemu_mutex_unlock(&timer_list->active_timers_lock);
446 if (rearm) {
447 timerlist_rearm(timer_list);
451 void timer_mod(QEMUTimer *ts, int64_t expire_time)
453 timer_mod_ns(ts, expire_time * ts->scale);
456 void timer_mod_anticipate(QEMUTimer *ts, int64_t expire_time)
458 timer_mod_anticipate_ns(ts, expire_time * ts->scale);
461 bool timer_pending(QEMUTimer *ts)
463 return ts->expire_time >= 0;
466 bool timer_expired(QEMUTimer *timer_head, int64_t current_time)
468 return timer_expired_ns(timer_head, current_time * timer_head->scale);
471 bool timerlist_run_timers(QEMUTimerList *timer_list)
473 QEMUTimer *ts;
474 int64_t current_time;
475 bool progress = false;
476 QEMUTimerCB *cb;
477 void *opaque;
479 qemu_event_reset(&timer_list->timers_done_ev);
480 if (!timer_list->clock->enabled) {
481 goto out;
484 current_time = qemu_clock_get_ns(timer_list->clock->type);
485 for(;;) {
486 qemu_mutex_lock(&timer_list->active_timers_lock);
487 ts = timer_list->active_timers;
488 if (!timer_expired_ns(ts, current_time)) {
489 qemu_mutex_unlock(&timer_list->active_timers_lock);
490 break;
493 /* remove timer from the list before calling the callback */
494 timer_list->active_timers = ts->next;
495 ts->next = NULL;
496 ts->expire_time = -1;
497 cb = ts->cb;
498 opaque = ts->opaque;
499 qemu_mutex_unlock(&timer_list->active_timers_lock);
501 /* run the callback (the timer list can be modified) */
502 cb(opaque);
503 progress = true;
506 out:
507 qemu_event_set(&timer_list->timers_done_ev);
508 return progress;
511 bool qemu_clock_run_timers(QEMUClockType type)
513 return timerlist_run_timers(main_loop_tlg.tl[type]);
516 void timerlistgroup_init(QEMUTimerListGroup *tlg,
517 QEMUTimerListNotifyCB *cb, void *opaque)
519 QEMUClockType type;
520 for (type = 0; type < QEMU_CLOCK_MAX; type++) {
521 tlg->tl[type] = timerlist_new(type, cb, opaque);
525 void timerlistgroup_deinit(QEMUTimerListGroup *tlg)
527 QEMUClockType type;
528 for (type = 0; type < QEMU_CLOCK_MAX; type++) {
529 timerlist_free(tlg->tl[type]);
533 bool timerlistgroup_run_timers(QEMUTimerListGroup *tlg)
535 QEMUClockType type;
536 bool progress = false;
537 for (type = 0; type < QEMU_CLOCK_MAX; type++) {
538 progress |= timerlist_run_timers(tlg->tl[type]);
540 return progress;
543 int64_t timerlistgroup_deadline_ns(QEMUTimerListGroup *tlg)
545 int64_t deadline = -1;
546 QEMUClockType type;
547 for (type = 0; type < QEMU_CLOCK_MAX; type++) {
548 if (qemu_clock_use_for_deadline(tlg->tl[type]->clock->type)) {
549 deadline = qemu_soonest_timeout(deadline,
550 timerlist_deadline_ns(
551 tlg->tl[type]));
554 return deadline;
557 int64_t qemu_clock_get_ns(QEMUClockType type)
559 int64_t now, last;
560 QEMUClock *clock = qemu_clock_ptr(type);
562 switch (type) {
563 case QEMU_CLOCK_REALTIME:
564 return get_clock();
565 default:
566 case QEMU_CLOCK_VIRTUAL:
567 if (use_icount) {
568 return cpu_get_icount();
569 } else {
570 return cpu_get_clock();
572 case QEMU_CLOCK_HOST:
573 now = get_clock_realtime();
574 last = clock->last;
575 clock->last = now;
576 if (now < last) {
577 notifier_list_notify(&clock->reset_notifiers, &now);
579 return now;
580 case QEMU_CLOCK_VIRTUAL_RT:
581 return cpu_get_clock();
585 void qemu_clock_register_reset_notifier(QEMUClockType type,
586 Notifier *notifier)
588 QEMUClock *clock = qemu_clock_ptr(type);
589 notifier_list_add(&clock->reset_notifiers, notifier);
592 void qemu_clock_unregister_reset_notifier(QEMUClockType type,
593 Notifier *notifier)
595 notifier_remove(notifier);
598 void init_clocks(void)
600 QEMUClockType type;
601 for (type = 0; type < QEMU_CLOCK_MAX; type++) {
602 qemu_clock_init(type);
605 #ifdef CONFIG_PRCTL_PR_SET_TIMERSLACK
606 prctl(PR_SET_TIMERSLACK, 1, 0, 0, 0);
607 #endif
610 uint64_t timer_expire_time_ns(QEMUTimer *ts)
612 return timer_pending(ts) ? ts->expire_time : -1;
615 bool qemu_clock_run_all_timers(void)
617 bool progress = false;
618 QEMUClockType type;
620 for (type = 0; type < QEMU_CLOCK_MAX; type++) {
621 progress |= qemu_clock_run_timers(type);
624 return progress;