]> git.proxmox.com Git - mirror_qemu.git/blame_incremental - include/qemu/timer.h
cpu-timers, icount: new modules
[mirror_qemu.git] / include / qemu / timer.h
... / ...
CommitLineData
1#ifndef QEMU_TIMER_H
2#define QEMU_TIMER_H
3
4#include "qemu/bitops.h"
5#include "qemu/notify.h"
6#include "qemu/host-utils.h"
7
8#define NANOSECONDS_PER_SECOND 1000000000LL
9
10/* timers */
11
12#define SCALE_MS 1000000
13#define SCALE_US 1000
14#define SCALE_NS 1
15
16/**
17 * QEMUClockType:
18 *
19 * The following clock types are available:
20 *
21 * @QEMU_CLOCK_REALTIME: Real time clock
22 *
23 * The real time clock should be used only for stuff which does not
24 * change the virtual machine state, as it runs even if the virtual
25 * machine is stopped.
26 *
27 * @QEMU_CLOCK_VIRTUAL: virtual clock
28 *
29 * The virtual clock only runs during the emulation. It stops
30 * when the virtual machine is stopped.
31 *
32 * @QEMU_CLOCK_HOST: host clock
33 *
34 * The host clock should be used for device models that emulate accurate
35 * real time sources. It will continue to run when the virtual machine
36 * is suspended, and it will reflect system time changes the host may
37 * undergo (e.g. due to NTP).
38 *
39 * @QEMU_CLOCK_VIRTUAL_RT: realtime clock used for icount warp
40 *
41 * Outside icount mode, this clock is the same as @QEMU_CLOCK_VIRTUAL.
42 * In icount mode, this clock counts nanoseconds while the virtual
43 * machine is running. It is used to increase @QEMU_CLOCK_VIRTUAL
44 * while the CPUs are sleeping and thus not executing instructions.
45 */
46
47typedef enum {
48 QEMU_CLOCK_REALTIME = 0,
49 QEMU_CLOCK_VIRTUAL = 1,
50 QEMU_CLOCK_HOST = 2,
51 QEMU_CLOCK_VIRTUAL_RT = 3,
52 QEMU_CLOCK_MAX
53} QEMUClockType;
54
55/**
56 * QEMU Timer attributes:
57 *
58 * An individual timer may be given one or multiple attributes when initialized.
59 * Each attribute corresponds to one bit. Attributes modify the processing
60 * of timers when they fire.
61 *
62 * The following attributes are available:
63 *
64 * QEMU_TIMER_ATTR_EXTERNAL: drives external subsystem
65 * QEMU_TIMER_ATTR_ALL: mask for all existing attributes
66 *
67 * Timers with this attribute do not recorded in rr mode, therefore it could be
68 * used for the subsystems that operate outside the guest core. Applicable only
69 * with virtual clock type.
70 */
71
72#define QEMU_TIMER_ATTR_EXTERNAL ((int)BIT(0))
73#define QEMU_TIMER_ATTR_ALL 0xffffffff
74
75typedef struct QEMUTimerList QEMUTimerList;
76
77struct QEMUTimerListGroup {
78 QEMUTimerList *tl[QEMU_CLOCK_MAX];
79};
80
81typedef void QEMUTimerCB(void *opaque);
82typedef void QEMUTimerListNotifyCB(void *opaque, QEMUClockType type);
83
84struct QEMUTimer {
85 int64_t expire_time; /* in nanoseconds */
86 QEMUTimerList *timer_list;
87 QEMUTimerCB *cb;
88 void *opaque;
89 QEMUTimer *next;
90 int attributes;
91 int scale;
92};
93
94extern QEMUTimerListGroup main_loop_tlg;
95
96/*
97 * qemu_clock_get_ns;
98 * @type: the clock type
99 *
100 * Get the nanosecond value of a clock with
101 * type @type
102 *
103 * Returns: the clock value in nanoseconds
104 */
105int64_t qemu_clock_get_ns(QEMUClockType type);
106
107/**
108 * qemu_clock_get_ms;
109 * @type: the clock type
110 *
111 * Get the millisecond value of a clock with
112 * type @type
113 *
114 * Returns: the clock value in milliseconds
115 */
116static inline int64_t qemu_clock_get_ms(QEMUClockType type)
117{
118 return qemu_clock_get_ns(type) / SCALE_MS;
119}
120
121/**
122 * qemu_clock_get_us;
123 * @type: the clock type
124 *
125 * Get the microsecond value of a clock with
126 * type @type
127 *
128 * Returns: the clock value in microseconds
129 */
130static inline int64_t qemu_clock_get_us(QEMUClockType type)
131{
132 return qemu_clock_get_ns(type) / SCALE_US;
133}
134
135/**
136 * qemu_clock_has_timers:
137 * @type: the clock type
138 *
139 * Determines whether a clock's default timer list
140 * has timers attached
141 *
142 * Note that this function should not be used when other threads also access
143 * the timer list. The return value may be outdated by the time it is acted
144 * upon.
145 *
146 * Returns: true if the clock's default timer list
147 * has timers attached
148 */
149bool qemu_clock_has_timers(QEMUClockType type);
150
151/**
152 * qemu_clock_expired:
153 * @type: the clock type
154 *
155 * Determines whether a clock's default timer list
156 * has an expired timer.
157 *
158 * Returns: true if the clock's default timer list has
159 * an expired timer
160 */
161bool qemu_clock_expired(QEMUClockType type);
162
163/**
164 * qemu_clock_use_for_deadline:
165 * @type: the clock type
166 *
167 * Determine whether a clock should be used for deadline
168 * calculations. Some clocks, for instance vm_clock with
169 * icount_enabled() set, do not count in nanoseconds.
170 * Such clocks are not used for deadline calculations, and are presumed
171 * to interrupt any poll using qemu_notify/aio_notify
172 * etc.
173 *
174 * Returns: true if the clock runs in nanoseconds and
175 * should be used for a deadline.
176 */
177bool qemu_clock_use_for_deadline(QEMUClockType type);
178
179/**
180 * qemu_clock_deadline_ns_all:
181 * @type: the clock type
182 * @attr_mask: mask for the timer attributes that are included
183 * in deadline calculation
184 *
185 * Calculate the deadline across all timer lists associated
186 * with a clock (as opposed to just the default one)
187 * in nanoseconds, or -1 if no timer is set to expire.
188 *
189 * Returns: time until expiry in nanoseconds or -1
190 */
191int64_t qemu_clock_deadline_ns_all(QEMUClockType type, int attr_mask);
192
193/**
194 * qemu_clock_get_main_loop_timerlist:
195 * @type: the clock type
196 *
197 * Return the default timer list associated with a clock.
198 *
199 * Returns: the default timer list
200 */
201QEMUTimerList *qemu_clock_get_main_loop_timerlist(QEMUClockType type);
202
203/**
204 * qemu_clock_nofify:
205 * @type: the clock type
206 *
207 * Call the notifier callback connected with the default timer
208 * list linked to the clock, or qemu_notify() if none.
209 */
210void qemu_clock_notify(QEMUClockType type);
211
212/**
213 * qemu_clock_enable:
214 * @type: the clock type
215 * @enabled: true to enable, false to disable
216 *
217 * Enable or disable a clock
218 * Disabling the clock will wait for related timerlists to stop
219 * executing qemu_run_timers. Thus, this functions should not
220 * be used from the callback of a timer that is based on @clock.
221 * Doing so would cause a deadlock.
222 *
223 * Caller should hold BQL.
224 */
225void qemu_clock_enable(QEMUClockType type, bool enabled);
226
227/**
228 * qemu_clock_run_timers:
229 * @type: clock on which to operate
230 *
231 * Run all the timers associated with the default timer list
232 * of a clock.
233 *
234 * Returns: true if any timer ran.
235 */
236bool qemu_clock_run_timers(QEMUClockType type);
237
238/**
239 * qemu_clock_run_all_timers:
240 *
241 * Run all the timers associated with the default timer list
242 * of every clock.
243 *
244 * Returns: true if any timer ran.
245 */
246bool qemu_clock_run_all_timers(void);
247
248
249/*
250 * QEMUTimerList
251 */
252
253/**
254 * timerlist_new:
255 * @type: the clock type to associate with the timerlist
256 * @cb: the callback to call on notification
257 * @opaque: the opaque pointer to pass to the callback
258 *
259 * Create a new timerlist associated with the clock of
260 * type @type.
261 *
262 * Returns: a pointer to the QEMUTimerList created
263 */
264QEMUTimerList *timerlist_new(QEMUClockType type,
265 QEMUTimerListNotifyCB *cb, void *opaque);
266
267/**
268 * timerlist_free:
269 * @timer_list: the timer list to free
270 *
271 * Frees a timer_list. It must have no active timers.
272 */
273void timerlist_free(QEMUTimerList *timer_list);
274
275/**
276 * timerlist_has_timers:
277 * @timer_list: the timer list to operate on
278 *
279 * Determine whether a timer list has active timers
280 *
281 * Note that this function should not be used when other threads also access
282 * the timer list. The return value may be outdated by the time it is acted
283 * upon.
284 *
285 * Returns: true if the timer list has timers.
286 */
287bool timerlist_has_timers(QEMUTimerList *timer_list);
288
289/**
290 * timerlist_expired:
291 * @timer_list: the timer list to operate on
292 *
293 * Determine whether a timer list has any timers which
294 * are expired.
295 *
296 * Returns: true if the timer list has timers which
297 * have expired.
298 */
299bool timerlist_expired(QEMUTimerList *timer_list);
300
301/**
302 * timerlist_deadline_ns:
303 * @timer_list: the timer list to operate on
304 *
305 * Determine the deadline for a timer_list, i.e.
306 * the number of nanoseconds until the first timer
307 * expires. Return -1 if there are no timers.
308 *
309 * Returns: the number of nanoseconds until the earliest
310 * timer expires -1 if none
311 */
312int64_t timerlist_deadline_ns(QEMUTimerList *timer_list);
313
314/**
315 * timerlist_get_clock:
316 * @timer_list: the timer list to operate on
317 *
318 * Determine the clock type associated with a timer list.
319 *
320 * Returns: the clock type associated with the
321 * timer list.
322 */
323QEMUClockType timerlist_get_clock(QEMUTimerList *timer_list);
324
325/**
326 * timerlist_run_timers:
327 * @timer_list: the timer list to use
328 *
329 * Call all expired timers associated with the timer list.
330 *
331 * Returns: true if any timer expired
332 */
333bool timerlist_run_timers(QEMUTimerList *timer_list);
334
335/**
336 * timerlist_notify:
337 * @timer_list: the timer list to use
338 *
339 * call the notifier callback associated with the timer list.
340 */
341void timerlist_notify(QEMUTimerList *timer_list);
342
343/*
344 * QEMUTimerListGroup
345 */
346
347/**
348 * timerlistgroup_init:
349 * @tlg: the timer list group
350 * @cb: the callback to call when a notify is required
351 * @opaque: the opaque pointer to be passed to the callback.
352 *
353 * Initialise a timer list group. This must already be
354 * allocated in memory and zeroed. The notifier callback is
355 * called whenever a clock in the timer list group is
356 * reenabled or whenever a timer associated with any timer
357 * list is modified. If @cb is specified as null, qemu_notify()
358 * is used instead.
359 */
360void timerlistgroup_init(QEMUTimerListGroup *tlg,
361 QEMUTimerListNotifyCB *cb, void *opaque);
362
363/**
364 * timerlistgroup_deinit:
365 * @tlg: the timer list group
366 *
367 * Deinitialise a timer list group. This must already be
368 * initialised. Note the memory is not freed.
369 */
370void timerlistgroup_deinit(QEMUTimerListGroup *tlg);
371
372/**
373 * timerlistgroup_run_timers:
374 * @tlg: the timer list group
375 *
376 * Run the timers associated with a timer list group.
377 * This will run timers on multiple clocks.
378 *
379 * Returns: true if any timer callback ran
380 */
381bool timerlistgroup_run_timers(QEMUTimerListGroup *tlg);
382
383/**
384 * timerlistgroup_deadline_ns:
385 * @tlg: the timer list group
386 *
387 * Determine the deadline of the soonest timer to
388 * expire associated with any timer list linked to
389 * the timer list group. Only clocks suitable for
390 * deadline calculation are included.
391 *
392 * Returns: the deadline in nanoseconds or -1 if no
393 * timers are to expire.
394 */
395int64_t timerlistgroup_deadline_ns(QEMUTimerListGroup *tlg);
396
397/*
398 * QEMUTimer
399 */
400
401/**
402 * timer_init_full:
403 * @ts: the timer to be initialised
404 * @timer_list_group: (optional) the timer list group to attach the timer to
405 * @type: the clock type to use
406 * @scale: the scale value for the timer
407 * @attributes: 0, or one or more OR'ed QEMU_TIMER_ATTR_<id> values
408 * @cb: the callback to be called when the timer expires
409 * @opaque: the opaque pointer to be passed to the callback
410 *
411 * Initialise a timer with the given scale and attributes,
412 * and associate it with timer list for given clock @type in @timer_list_group
413 * (or default timer list group, if NULL).
414 * The caller is responsible for allocating the memory.
415 *
416 * You need not call an explicit deinit call. Simply make
417 * sure it is not on a list with timer_del.
418 */
419void timer_init_full(QEMUTimer *ts,
420 QEMUTimerListGroup *timer_list_group, QEMUClockType type,
421 int scale, int attributes,
422 QEMUTimerCB *cb, void *opaque);
423
424/**
425 * timer_init:
426 * @ts: the timer to be initialised
427 * @type: the clock to associate with the timer
428 * @scale: the scale value for the timer
429 * @cb: the callback to call when the timer expires
430 * @opaque: the opaque pointer to pass to the callback
431 *
432 * Initialize a timer with the given scale on the default timer list
433 * associated with the clock.
434 * See timer_init_full for details.
435 */
436static inline void timer_init(QEMUTimer *ts, QEMUClockType type, int scale,
437 QEMUTimerCB *cb, void *opaque)
438{
439 timer_init_full(ts, NULL, type, scale, 0, cb, opaque);
440}
441
442/**
443 * timer_init_ns:
444 * @ts: the timer to be initialised
445 * @type: the clock to associate with the timer
446 * @cb: the callback to call when the timer expires
447 * @opaque: the opaque pointer to pass to the callback
448 *
449 * Initialize a timer with nanosecond scale on the default timer list
450 * associated with the clock.
451 * See timer_init_full for details.
452 */
453static inline void timer_init_ns(QEMUTimer *ts, QEMUClockType type,
454 QEMUTimerCB *cb, void *opaque)
455{
456 timer_init(ts, type, SCALE_NS, cb, opaque);
457}
458
459/**
460 * timer_init_us:
461 * @ts: the timer to be initialised
462 * @type: the clock to associate with the timer
463 * @cb: the callback to call when the timer expires
464 * @opaque: the opaque pointer to pass to the callback
465 *
466 * Initialize a timer with microsecond scale on the default timer list
467 * associated with the clock.
468 * See timer_init_full for details.
469 */
470static inline void timer_init_us(QEMUTimer *ts, QEMUClockType type,
471 QEMUTimerCB *cb, void *opaque)
472{
473 timer_init(ts, type, SCALE_US, cb, opaque);
474}
475
476/**
477 * timer_init_ms:
478 * @ts: the timer to be initialised
479 * @type: the clock to associate with the timer
480 * @cb: the callback to call when the timer expires
481 * @opaque: the opaque pointer to pass to the callback
482 *
483 * Initialize a timer with millisecond scale on the default timer list
484 * associated with the clock.
485 * See timer_init_full for details.
486 */
487static inline void timer_init_ms(QEMUTimer *ts, QEMUClockType type,
488 QEMUTimerCB *cb, void *opaque)
489{
490 timer_init(ts, type, SCALE_MS, cb, opaque);
491}
492
493/**
494 * timer_new_full:
495 * @timer_list_group: (optional) the timer list group to attach the timer to
496 * @type: the clock type to use
497 * @scale: the scale value for the timer
498 * @attributes: 0, or one or more OR'ed QEMU_TIMER_ATTR_<id> values
499 * @cb: the callback to be called when the timer expires
500 * @opaque: the opaque pointer to be passed to the callback
501 *
502 * Create a new timer with the given scale and attributes,
503 * and associate it with timer list for given clock @type in @timer_list_group
504 * (or default timer list group, if NULL).
505 * The memory is allocated by the function.
506 *
507 * This is not the preferred interface unless you know you
508 * are going to call timer_free. Use timer_init or timer_init_full instead.
509 *
510 * The default timer list has one special feature: in icount mode,
511 * %QEMU_CLOCK_VIRTUAL timers are run in the vCPU thread. This is
512 * not true of other timer lists, which are typically associated
513 * with an AioContext---each of them runs its timer callbacks in its own
514 * AioContext thread.
515 *
516 * Returns: a pointer to the timer
517 */
518static inline QEMUTimer *timer_new_full(QEMUTimerListGroup *timer_list_group,
519 QEMUClockType type,
520 int scale, int attributes,
521 QEMUTimerCB *cb, void *opaque)
522{
523 QEMUTimer *ts = g_malloc0(sizeof(QEMUTimer));
524 timer_init_full(ts, timer_list_group, type, scale, attributes, cb, opaque);
525 return ts;
526}
527
528/**
529 * timer_new:
530 * @type: the clock type to use
531 * @scale: the scale value for the timer
532 * @cb: the callback to be called when the timer expires
533 * @opaque: the opaque pointer to be passed to the callback
534 *
535 * Create a new timer with the given scale,
536 * and associate it with the default timer list for the clock type @type.
537 * See timer_new_full for details.
538 *
539 * Returns: a pointer to the timer
540 */
541static inline QEMUTimer *timer_new(QEMUClockType type, int scale,
542 QEMUTimerCB *cb, void *opaque)
543{
544 return timer_new_full(NULL, type, scale, 0, cb, opaque);
545}
546
547/**
548 * timer_new_ns:
549 * @type: the clock type to associate with the timer
550 * @cb: the callback to call when the timer expires
551 * @opaque: the opaque pointer to pass to the callback
552 *
553 * Create a new timer with nanosecond scale on the default timer list
554 * associated with the clock.
555 * See timer_new_full for details.
556 *
557 * Returns: a pointer to the newly created timer
558 */
559static inline QEMUTimer *timer_new_ns(QEMUClockType type, QEMUTimerCB *cb,
560 void *opaque)
561{
562 return timer_new(type, SCALE_NS, cb, opaque);
563}
564
565/**
566 * timer_new_us:
567 * @type: the clock type to associate with the timer
568 * @cb: the callback to call when the timer expires
569 * @opaque: the opaque pointer to pass to the callback
570 *
571 * Create a new timer with microsecond scale on the default timer list
572 * associated with the clock.
573 * See timer_new_full for details.
574 *
575 * Returns: a pointer to the newly created timer
576 */
577static inline QEMUTimer *timer_new_us(QEMUClockType type, QEMUTimerCB *cb,
578 void *opaque)
579{
580 return timer_new(type, SCALE_US, cb, opaque);
581}
582
583/**
584 * timer_new_ms:
585 * @type: the clock type to associate with the timer
586 * @cb: the callback to call when the timer expires
587 * @opaque: the opaque pointer to pass to the callback
588 *
589 * Create a new timer with millisecond scale on the default timer list
590 * associated with the clock.
591 * See timer_new_full for details.
592 *
593 * Returns: a pointer to the newly created timer
594 */
595static inline QEMUTimer *timer_new_ms(QEMUClockType type, QEMUTimerCB *cb,
596 void *opaque)
597{
598 return timer_new(type, SCALE_MS, cb, opaque);
599}
600
601/**
602 * timer_deinit:
603 * @ts: the timer to be de-initialised
604 *
605 * Deassociate the timer from any timerlist. You should
606 * call timer_del before. After this call, any further
607 * timer_del call cannot cause dangling pointer accesses
608 * even if the previously used timerlist is freed.
609 */
610void timer_deinit(QEMUTimer *ts);
611
612/**
613 * timer_free:
614 * @ts: the timer
615 *
616 * Free a timer (it must not be on the active list)
617 */
618static inline void timer_free(QEMUTimer *ts)
619{
620 g_free(ts);
621}
622
623/**
624 * timer_del:
625 * @ts: the timer
626 *
627 * Delete a timer from the active list.
628 *
629 * This function is thread-safe but the timer and its timer list must not be
630 * freed while this function is running.
631 */
632void timer_del(QEMUTimer *ts);
633
634/**
635 * timer_mod_ns:
636 * @ts: the timer
637 * @expire_time: the expiry time in nanoseconds
638 *
639 * Modify a timer to expire at @expire_time
640 *
641 * This function is thread-safe but the timer and its timer list must not be
642 * freed while this function is running.
643 */
644void timer_mod_ns(QEMUTimer *ts, int64_t expire_time);
645
646/**
647 * timer_mod_anticipate_ns:
648 * @ts: the timer
649 * @expire_time: the expiry time in nanoseconds
650 *
651 * Modify a timer to expire at @expire_time or the current time,
652 * whichever comes earlier.
653 *
654 * This function is thread-safe but the timer and its timer list must not be
655 * freed while this function is running.
656 */
657void timer_mod_anticipate_ns(QEMUTimer *ts, int64_t expire_time);
658
659/**
660 * timer_mod:
661 * @ts: the timer
662 * @expire_time: the expire time in the units associated with the timer
663 *
664 * Modify a timer to expiry at @expire_time, taking into
665 * account the scale associated with the timer.
666 *
667 * This function is thread-safe but the timer and its timer list must not be
668 * freed while this function is running.
669 */
670void timer_mod(QEMUTimer *ts, int64_t expire_timer);
671
672/**
673 * timer_mod_anticipate:
674 * @ts: the timer
675 * @expire_time: the expire time in the units associated with the timer
676 *
677 * Modify a timer to expire at @expire_time or the current time, whichever
678 * comes earlier, taking into account the scale associated with the timer.
679 *
680 * This function is thread-safe but the timer and its timer list must not be
681 * freed while this function is running.
682 */
683void timer_mod_anticipate(QEMUTimer *ts, int64_t expire_time);
684
685/**
686 * timer_pending:
687 * @ts: the timer
688 *
689 * Determines whether a timer is pending (i.e. is on the
690 * active list of timers, whether or not it has not yet expired).
691 *
692 * Returns: true if the timer is pending
693 */
694bool timer_pending(QEMUTimer *ts);
695
696/**
697 * timer_expired:
698 * @ts: the timer
699 * @current_time: the current time
700 *
701 * Determines whether a timer has expired.
702 *
703 * Returns: true if the timer has expired
704 */
705bool timer_expired(QEMUTimer *timer_head, int64_t current_time);
706
707/**
708 * timer_expire_time_ns:
709 * @ts: the timer
710 *
711 * Determine the expiry time of a timer
712 *
713 * Returns: the expiry time in nanoseconds
714 */
715uint64_t timer_expire_time_ns(QEMUTimer *ts);
716
717/**
718 * timer_get:
719 * @f: the file
720 * @ts: the timer
721 *
722 * Read a timer @ts from a file @f
723 */
724void timer_get(QEMUFile *f, QEMUTimer *ts);
725
726/**
727 * timer_put:
728 * @f: the file
729 * @ts: the timer
730 */
731void timer_put(QEMUFile *f, QEMUTimer *ts);
732
733/*
734 * General utility functions
735 */
736
737/**
738 * qemu_timeout_ns_to_ms:
739 * @ns: nanosecond timeout value
740 *
741 * Convert a nanosecond timeout value (or -1) to
742 * a millisecond value (or -1), always rounding up.
743 *
744 * Returns: millisecond timeout value
745 */
746int qemu_timeout_ns_to_ms(int64_t ns);
747
748/**
749 * qemu_poll_ns:
750 * @fds: Array of file descriptors
751 * @nfds: number of file descriptors
752 * @timeout: timeout in nanoseconds
753 *
754 * Perform a poll like g_poll but with a timeout in nanoseconds.
755 * See g_poll documentation for further details.
756 *
757 * Returns: number of fds ready
758 */
759int qemu_poll_ns(GPollFD *fds, guint nfds, int64_t timeout);
760
761/**
762 * qemu_soonest_timeout:
763 * @timeout1: first timeout in nanoseconds (or -1 for infinite)
764 * @timeout2: second timeout in nanoseconds (or -1 for infinite)
765 *
766 * Calculates the soonest of two timeout values. -1 means infinite, which
767 * is later than any other value.
768 *
769 * Returns: soonest timeout value in nanoseconds (or -1 for infinite)
770 */
771static inline int64_t qemu_soonest_timeout(int64_t timeout1, int64_t timeout2)
772{
773 /* we can abuse the fact that -1 (which means infinite) is a maximal
774 * value when cast to unsigned. As this is disgusting, it's kept in
775 * one inline function.
776 */
777 return ((uint64_t) timeout1 < (uint64_t) timeout2) ? timeout1 : timeout2;
778}
779
780/**
781 * initclocks:
782 *
783 * Initialise the clock & timer infrastructure
784 */
785void init_clocks(QEMUTimerListNotifyCB *notify_cb);
786
787static inline int64_t get_max_clock_jump(void)
788{
789 /* This should be small enough to prevent excessive interrupts from being
790 * generated by the RTC on clock jumps, but large enough to avoid frequent
791 * unnecessary resets in idle VMs.
792 */
793 return 60 * NANOSECONDS_PER_SECOND;
794}
795
796/*
797 * Low level clock functions
798 */
799
800/* get host real time in nanosecond */
801static inline int64_t get_clock_realtime(void)
802{
803 struct timeval tv;
804
805 gettimeofday(&tv, NULL);
806 return tv.tv_sec * 1000000000LL + (tv.tv_usec * 1000);
807}
808
809/* Warning: don't insert tracepoints into these functions, they are
810 also used by simpletrace backend and tracepoints would cause
811 an infinite recursion! */
812#ifdef _WIN32
813extern int64_t clock_freq;
814
815static inline int64_t get_clock(void)
816{
817 LARGE_INTEGER ti;
818 QueryPerformanceCounter(&ti);
819 return muldiv64(ti.QuadPart, NANOSECONDS_PER_SECOND, clock_freq);
820}
821
822#else
823
824extern int use_rt_clock;
825
826static inline int64_t get_clock(void)
827{
828 if (use_rt_clock) {
829 struct timespec ts;
830 clock_gettime(CLOCK_MONOTONIC, &ts);
831 return ts.tv_sec * 1000000000LL + ts.tv_nsec;
832 } else {
833 /* XXX: using gettimeofday leads to problems if the date
834 changes, so it should be avoided. */
835 return get_clock_realtime();
836 }
837}
838#endif
839
840/*******************************************/
841/* host CPU ticks (if available) */
842
843#if defined(_ARCH_PPC)
844
845static inline int64_t cpu_get_host_ticks(void)
846{
847 int64_t retval;
848#ifdef _ARCH_PPC64
849 /* This reads timebase in one 64bit go and includes Cell workaround from:
850 http://ozlabs.org/pipermail/linuxppc-dev/2006-October/027052.html
851 */
852 __asm__ __volatile__ ("mftb %0\n\t"
853 "cmpwi %0,0\n\t"
854 "beq- $-8"
855 : "=r" (retval));
856#else
857 /* http://ozlabs.org/pipermail/linuxppc-dev/1999-October/003889.html */
858 unsigned long junk;
859 __asm__ __volatile__ ("mfspr %1,269\n\t" /* mftbu */
860 "mfspr %L0,268\n\t" /* mftb */
861 "mfspr %0,269\n\t" /* mftbu */
862 "cmpw %0,%1\n\t"
863 "bne $-16"
864 : "=r" (retval), "=r" (junk));
865#endif
866 return retval;
867}
868
869#elif defined(__i386__)
870
871static inline int64_t cpu_get_host_ticks(void)
872{
873 int64_t val;
874 asm volatile ("rdtsc" : "=A" (val));
875 return val;
876}
877
878#elif defined(__x86_64__)
879
880static inline int64_t cpu_get_host_ticks(void)
881{
882 uint32_t low,high;
883 int64_t val;
884 asm volatile("rdtsc" : "=a" (low), "=d" (high));
885 val = high;
886 val <<= 32;
887 val |= low;
888 return val;
889}
890
891#elif defined(__hppa__)
892
893static inline int64_t cpu_get_host_ticks(void)
894{
895 int val;
896 asm volatile ("mfctl %%cr16, %0" : "=r"(val));
897 return val;
898}
899
900#elif defined(__s390__)
901
902static inline int64_t cpu_get_host_ticks(void)
903{
904 int64_t val;
905 asm volatile("stck 0(%1)" : "=m" (val) : "a" (&val) : "cc");
906 return val;
907}
908
909#elif defined(__sparc__)
910
911static inline int64_t cpu_get_host_ticks (void)
912{
913#if defined(_LP64)
914 uint64_t rval;
915 asm volatile("rd %%tick,%0" : "=r"(rval));
916 return rval;
917#else
918 /* We need an %o or %g register for this. For recent enough gcc
919 there is an "h" constraint for that. Don't bother with that. */
920 union {
921 uint64_t i64;
922 struct {
923 uint32_t high;
924 uint32_t low;
925 } i32;
926 } rval;
927 asm volatile("rd %%tick,%%g1; srlx %%g1,32,%0; mov %%g1,%1"
928 : "=r"(rval.i32.high), "=r"(rval.i32.low) : : "g1");
929 return rval.i64;
930#endif
931}
932
933#elif defined(__mips__) && \
934 ((defined(__mips_isa_rev) && __mips_isa_rev >= 2) || defined(__linux__))
935/*
936 * binutils wants to use rdhwr only on mips32r2
937 * but as linux kernel emulate it, it's fine
938 * to use it.
939 *
940 */
941#define MIPS_RDHWR(rd, value) { \
942 __asm__ __volatile__ (".set push\n\t" \
943 ".set mips32r2\n\t" \
944 "rdhwr %0, "rd"\n\t" \
945 ".set pop" \
946 : "=r" (value)); \
947 }
948
949static inline int64_t cpu_get_host_ticks(void)
950{
951 /* On kernels >= 2.6.25 rdhwr <reg>, $2 and $3 are emulated */
952 uint32_t count;
953 static uint32_t cyc_per_count = 0;
954
955 if (!cyc_per_count) {
956 MIPS_RDHWR("$3", cyc_per_count);
957 }
958
959 MIPS_RDHWR("$2", count);
960 return (int64_t)(count * cyc_per_count);
961}
962
963#elif defined(__alpha__)
964
965static inline int64_t cpu_get_host_ticks(void)
966{
967 uint64_t cc;
968 uint32_t cur, ofs;
969
970 asm volatile("rpcc %0" : "=r"(cc));
971 cur = cc;
972 ofs = cc >> 32;
973 return cur - ofs;
974}
975
976#else
977/* The host CPU doesn't have an easily accessible cycle counter.
978 Just return a monotonically increasing value. This will be
979 totally wrong, but hopefully better than nothing. */
980static inline int64_t cpu_get_host_ticks(void)
981{
982 return get_clock();
983}
984#endif
985
986#ifdef CONFIG_PROFILER
987static inline int64_t profile_getclock(void)
988{
989 return get_clock();
990}
991
992extern int64_t dev_time;
993#endif
994
995#endif