qemu/include/qemu/timer.h
<<
>>
Prefs
   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 * use_icount set, do not count in nanoseconds. Such clocks
 170 * 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_start_warp_timer:
 229 *
 230 * Starts a timer for virtual clock update
 231 */
 232void qemu_start_warp_timer(void);
 233
 234/**
 235 * qemu_clock_run_timers:
 236 * @type: clock on which to operate
 237 *
 238 * Run all the timers associated with the default timer list
 239 * of a clock.
 240 *
 241 * Returns: true if any timer ran.
 242 */
 243bool qemu_clock_run_timers(QEMUClockType type);
 244
 245/**
 246 * qemu_clock_run_all_timers:
 247 *
 248 * Run all the timers associated with the default timer list
 249 * of every clock.
 250 *
 251 * Returns: true if any timer ran.
 252 */
 253bool qemu_clock_run_all_timers(void);
 254
 255
 256/*
 257 * QEMUTimerList
 258 */
 259
 260/**
 261 * timerlist_new:
 262 * @type: the clock type to associate with the timerlist
 263 * @cb: the callback to call on notification
 264 * @opaque: the opaque pointer to pass to the callback
 265 *
 266 * Create a new timerlist associated with the clock of
 267 * type @type.
 268 *
 269 * Returns: a pointer to the QEMUTimerList created
 270 */
 271QEMUTimerList *timerlist_new(QEMUClockType type,
 272                             QEMUTimerListNotifyCB *cb, void *opaque);
 273
 274/**
 275 * timerlist_free:
 276 * @timer_list: the timer list to free
 277 *
 278 * Frees a timer_list. It must have no active timers.
 279 */
 280void timerlist_free(QEMUTimerList *timer_list);
 281
 282/**
 283 * timerlist_has_timers:
 284 * @timer_list: the timer list to operate on
 285 *
 286 * Determine whether a timer list has active timers
 287 *
 288 * Note that this function should not be used when other threads also access
 289 * the timer list.  The return value may be outdated by the time it is acted
 290 * upon.
 291 *
 292 * Returns: true if the timer list has timers.
 293 */
 294bool timerlist_has_timers(QEMUTimerList *timer_list);
 295
 296/**
 297 * timerlist_expired:
 298 * @timer_list: the timer list to operate on
 299 *
 300 * Determine whether a timer list has any timers which
 301 * are expired.
 302 *
 303 * Returns: true if the timer list has timers which
 304 * have expired.
 305 */
 306bool timerlist_expired(QEMUTimerList *timer_list);
 307
 308/**
 309 * timerlist_deadline_ns:
 310 * @timer_list: the timer list to operate on
 311 *
 312 * Determine the deadline for a timer_list, i.e.
 313 * the number of nanoseconds until the first timer
 314 * expires. Return -1 if there are no timers.
 315 *
 316 * Returns: the number of nanoseconds until the earliest
 317 * timer expires -1 if none
 318 */
 319int64_t timerlist_deadline_ns(QEMUTimerList *timer_list);
 320
 321/**
 322 * timerlist_get_clock:
 323 * @timer_list: the timer list to operate on
 324 *
 325 * Determine the clock type associated with a timer list.
 326 *
 327 * Returns: the clock type associated with the
 328 * timer list.
 329 */
 330QEMUClockType timerlist_get_clock(QEMUTimerList *timer_list);
 331
 332/**
 333 * timerlist_run_timers:
 334 * @timer_list: the timer list to use
 335 *
 336 * Call all expired timers associated with the timer list.
 337 *
 338 * Returns: true if any timer expired
 339 */
 340bool timerlist_run_timers(QEMUTimerList *timer_list);
 341
 342/**
 343 * timerlist_notify:
 344 * @timer_list: the timer list to use
 345 *
 346 * call the notifier callback associated with the timer list.
 347 */
 348void timerlist_notify(QEMUTimerList *timer_list);
 349
 350/*
 351 * QEMUTimerListGroup
 352 */
 353
 354/**
 355 * timerlistgroup_init:
 356 * @tlg: the timer list group
 357 * @cb: the callback to call when a notify is required
 358 * @opaque: the opaque pointer to be passed to the callback.
 359 *
 360 * Initialise a timer list group. This must already be
 361 * allocated in memory and zeroed. The notifier callback is
 362 * called whenever a clock in the timer list group is
 363 * reenabled or whenever a timer associated with any timer
 364 * list is modified. If @cb is specified as null, qemu_notify()
 365 * is used instead.
 366 */
 367void timerlistgroup_init(QEMUTimerListGroup *tlg,
 368                         QEMUTimerListNotifyCB *cb, void *opaque);
 369
 370/**
 371 * timerlistgroup_deinit:
 372 * @tlg: the timer list group
 373 *
 374 * Deinitialise a timer list group. This must already be
 375 * initialised. Note the memory is not freed.
 376 */
 377void timerlistgroup_deinit(QEMUTimerListGroup *tlg);
 378
 379/**
 380 * timerlistgroup_run_timers:
 381 * @tlg: the timer list group
 382 *
 383 * Run the timers associated with a timer list group.
 384 * This will run timers on multiple clocks.
 385 *
 386 * Returns: true if any timer callback ran
 387 */
 388bool timerlistgroup_run_timers(QEMUTimerListGroup *tlg);
 389
 390/**
 391 * timerlistgroup_deadline_ns:
 392 * @tlg: the timer list group
 393 *
 394 * Determine the deadline of the soonest timer to
 395 * expire associated with any timer list linked to
 396 * the timer list group. Only clocks suitable for
 397 * deadline calculation are included.
 398 *
 399 * Returns: the deadline in nanoseconds or -1 if no
 400 * timers are to expire.
 401 */
 402int64_t timerlistgroup_deadline_ns(QEMUTimerListGroup *tlg);
 403
 404/*
 405 * QEMUTimer
 406 */
 407
 408/**
 409 * timer_init_full:
 410 * @ts: the timer to be initialised
 411 * @timer_list_group: (optional) the timer list group to attach the timer to
 412 * @type: the clock type to use
 413 * @scale: the scale value for the timer
 414 * @attributes: 0, or one or more OR'ed QEMU_TIMER_ATTR_<id> values
 415 * @cb: the callback to be called when the timer expires
 416 * @opaque: the opaque pointer to be passed to the callback
 417 *
 418 * Initialise a timer with the given scale and attributes,
 419 * and associate it with timer list for given clock @type in @timer_list_group
 420 * (or default timer list group, if NULL).
 421 * The caller is responsible for allocating the memory.
 422 *
 423 * You need not call an explicit deinit call. Simply make
 424 * sure it is not on a list with timer_del.
 425 */
 426void timer_init_full(QEMUTimer *ts,
 427                     QEMUTimerListGroup *timer_list_group, QEMUClockType type,
 428                     int scale, int attributes,
 429                     QEMUTimerCB *cb, void *opaque);
 430
 431/**
 432 * timer_init:
 433 * @ts: the timer to be initialised
 434 * @type: the clock to associate with the timer
 435 * @scale: the scale value for the timer
 436 * @cb: the callback to call when the timer expires
 437 * @opaque: the opaque pointer to pass to the callback
 438 *
 439 * Initialize a timer with the given scale on the default timer list
 440 * associated with the clock.
 441 * See timer_init_full for details.
 442 */
 443static inline void timer_init(QEMUTimer *ts, QEMUClockType type, int scale,
 444                              QEMUTimerCB *cb, void *opaque)
 445{
 446    timer_init_full(ts, NULL, type, scale, 0, cb, opaque);
 447}
 448
 449/**
 450 * timer_init_ns:
 451 * @ts: the timer to be initialised
 452 * @type: the clock to associate with the timer
 453 * @cb: the callback to call when the timer expires
 454 * @opaque: the opaque pointer to pass to the callback
 455 *
 456 * Initialize a timer with nanosecond scale on the default timer list
 457 * associated with the clock.
 458 * See timer_init_full for details.
 459 */
 460static inline void timer_init_ns(QEMUTimer *ts, QEMUClockType type,
 461                                 QEMUTimerCB *cb, void *opaque)
 462{
 463    timer_init(ts, type, SCALE_NS, cb, opaque);
 464}
 465
 466/**
 467 * timer_init_us:
 468 * @ts: the timer to be initialised
 469 * @type: the clock to associate with the timer
 470 * @cb: the callback to call when the timer expires
 471 * @opaque: the opaque pointer to pass to the callback
 472 *
 473 * Initialize a timer with microsecond scale on the default timer list
 474 * associated with the clock.
 475 * See timer_init_full for details.
 476 */
 477static inline void timer_init_us(QEMUTimer *ts, QEMUClockType type,
 478                                 QEMUTimerCB *cb, void *opaque)
 479{
 480    timer_init(ts, type, SCALE_US, cb, opaque);
 481}
 482
 483/**
 484 * timer_init_ms:
 485 * @ts: the timer to be initialised
 486 * @type: the clock to associate with the timer
 487 * @cb: the callback to call when the timer expires
 488 * @opaque: the opaque pointer to pass to the callback
 489 *
 490 * Initialize a timer with millisecond scale on the default timer list
 491 * associated with the clock.
 492 * See timer_init_full for details.
 493 */
 494static inline void timer_init_ms(QEMUTimer *ts, QEMUClockType type,
 495                                 QEMUTimerCB *cb, void *opaque)
 496{
 497    timer_init(ts, type, SCALE_MS, cb, opaque);
 498}
 499
 500/**
 501 * timer_new_full:
 502 * @timer_list_group: (optional) the timer list group to attach the timer to
 503 * @type: the clock type to use
 504 * @scale: the scale value for the timer
 505 * @attributes: 0, or one or more OR'ed QEMU_TIMER_ATTR_<id> values
 506 * @cb: the callback to be called when the timer expires
 507 * @opaque: the opaque pointer to be passed to the callback
 508 *
 509 * Create a new timer with the given scale and attributes,
 510 * and associate it with timer list for given clock @type in @timer_list_group
 511 * (or default timer list group, if NULL).
 512 * The memory is allocated by the function.
 513 *
 514 * This is not the preferred interface unless you know you
 515 * are going to call timer_free. Use timer_init or timer_init_full instead.
 516 *
 517 * The default timer list has one special feature: in icount mode,
 518 * %QEMU_CLOCK_VIRTUAL timers are run in the vCPU thread.  This is
 519 * not true of other timer lists, which are typically associated
 520 * with an AioContext---each of them runs its timer callbacks in its own
 521 * AioContext thread.
 522 *
 523 * Returns: a pointer to the timer
 524 */
 525static inline QEMUTimer *timer_new_full(QEMUTimerListGroup *timer_list_group,
 526                                        QEMUClockType type,
 527                                        int scale, int attributes,
 528                                        QEMUTimerCB *cb, void *opaque)
 529{
 530    QEMUTimer *ts = g_malloc0(sizeof(QEMUTimer));
 531    timer_init_full(ts, timer_list_group, type, scale, attributes, cb, opaque);
 532    return ts;
 533}
 534
 535/**
 536 * timer_new:
 537 * @type: the clock type to use
 538 * @scale: the scale value for the timer
 539 * @cb: the callback to be called when the timer expires
 540 * @opaque: the opaque pointer to be passed to the callback
 541 *
 542 * Create a new timer with the given scale,
 543 * and associate it with the default timer list for the clock type @type.
 544 * See timer_new_full for details.
 545 *
 546 * Returns: a pointer to the timer
 547 */
 548static inline QEMUTimer *timer_new(QEMUClockType type, int scale,
 549                                   QEMUTimerCB *cb, void *opaque)
 550{
 551    return timer_new_full(NULL, type, scale, 0, cb, opaque);
 552}
 553
 554/**
 555 * timer_new_ns:
 556 * @type: the clock type to associate with the timer
 557 * @cb: the callback to call when the timer expires
 558 * @opaque: the opaque pointer to pass to the callback
 559 *
 560 * Create a new timer with nanosecond scale on the default timer list
 561 * associated with the clock.
 562 * See timer_new_full for details.
 563 *
 564 * Returns: a pointer to the newly created timer
 565 */
 566static inline QEMUTimer *timer_new_ns(QEMUClockType type, QEMUTimerCB *cb,
 567                                      void *opaque)
 568{
 569    return timer_new(type, SCALE_NS, cb, opaque);
 570}
 571
 572/**
 573 * timer_new_us:
 574 * @type: the clock type to associate with the timer
 575 * @cb: the callback to call when the timer expires
 576 * @opaque: the opaque pointer to pass to the callback
 577 *
 578 * Create a new timer with microsecond scale on the default timer list
 579 * associated with the clock.
 580 * See timer_new_full for details.
 581 *
 582 * Returns: a pointer to the newly created timer
 583 */
 584static inline QEMUTimer *timer_new_us(QEMUClockType type, QEMUTimerCB *cb,
 585                                      void *opaque)
 586{
 587    return timer_new(type, SCALE_US, cb, opaque);
 588}
 589
 590/**
 591 * timer_new_ms:
 592 * @type: the clock type to associate with the timer
 593 * @cb: the callback to call when the timer expires
 594 * @opaque: the opaque pointer to pass to the callback
 595 *
 596 * Create a new timer with millisecond scale on the default timer list
 597 * associated with the clock.
 598 * See timer_new_full for details.
 599 *
 600 * Returns: a pointer to the newly created timer
 601 */
 602static inline QEMUTimer *timer_new_ms(QEMUClockType type, QEMUTimerCB *cb,
 603                                      void *opaque)
 604{
 605    return timer_new(type, SCALE_MS, cb, opaque);
 606}
 607
 608/**
 609 * timer_deinit:
 610 * @ts: the timer to be de-initialised
 611 *
 612 * Deassociate the timer from any timerlist.  You should
 613 * call timer_del before.  After this call, any further
 614 * timer_del call cannot cause dangling pointer accesses
 615 * even if the previously used timerlist is freed.
 616 */
 617void timer_deinit(QEMUTimer *ts);
 618
 619/**
 620 * timer_free:
 621 * @ts: the timer
 622 *
 623 * Free a timer (it must not be on the active list)
 624 */
 625static inline void timer_free(QEMUTimer *ts)
 626{
 627    g_free(ts);
 628}
 629
 630/**
 631 * timer_del:
 632 * @ts: the timer
 633 *
 634 * Delete a timer from the active list.
 635 *
 636 * This function is thread-safe but the timer and its timer list must not be
 637 * freed while this function is running.
 638 */
 639void timer_del(QEMUTimer *ts);
 640
 641/**
 642 * timer_mod_ns:
 643 * @ts: the timer
 644 * @expire_time: the expiry time in nanoseconds
 645 *
 646 * Modify a timer to expire at @expire_time
 647 *
 648 * This function is thread-safe but the timer and its timer list must not be
 649 * freed while this function is running.
 650 */
 651void timer_mod_ns(QEMUTimer *ts, int64_t expire_time);
 652
 653/**
 654 * timer_mod_anticipate_ns:
 655 * @ts: the timer
 656 * @expire_time: the expiry time in nanoseconds
 657 *
 658 * Modify a timer to expire at @expire_time or the current time,
 659 * whichever comes earlier.
 660 *
 661 * This function is thread-safe but the timer and its timer list must not be
 662 * freed while this function is running.
 663 */
 664void timer_mod_anticipate_ns(QEMUTimer *ts, int64_t expire_time);
 665
 666/**
 667 * timer_mod:
 668 * @ts: the timer
 669 * @expire_time: the expire time in the units associated with the timer
 670 *
 671 * Modify a timer to expiry at @expire_time, taking into
 672 * account the scale associated with the timer.
 673 *
 674 * This function is thread-safe but the timer and its timer list must not be
 675 * freed while this function is running.
 676 */
 677void timer_mod(QEMUTimer *ts, int64_t expire_timer);
 678
 679/**
 680 * timer_mod_anticipate:
 681 * @ts: the timer
 682 * @expire_time: the expiry time in nanoseconds
 683 *
 684 * Modify a timer to expire at @expire_time or the current time, whichever
 685 * comes earlier, taking into account the scale associated with the timer.
 686 *
 687 * This function is thread-safe but the timer and its timer list must not be
 688 * freed while this function is running.
 689 */
 690void timer_mod_anticipate(QEMUTimer *ts, int64_t expire_time);
 691
 692/**
 693 * timer_pending:
 694 * @ts: the timer
 695 *
 696 * Determines whether a timer is pending (i.e. is on the
 697 * active list of timers, whether or not it has not yet expired).
 698 *
 699 * Returns: true if the timer is pending
 700 */
 701bool timer_pending(QEMUTimer *ts);
 702
 703/**
 704 * timer_expired:
 705 * @ts: the timer
 706 * @current_time: the current time
 707 *
 708 * Determines whether a timer has expired.
 709 *
 710 * Returns: true if the timer has expired
 711 */
 712bool timer_expired(QEMUTimer *timer_head, int64_t current_time);
 713
 714/**
 715 * timer_expire_time_ns:
 716 * @ts: the timer
 717 *
 718 * Determine the expiry time of a timer
 719 *
 720 * Returns: the expiry time in nanoseconds
 721 */
 722uint64_t timer_expire_time_ns(QEMUTimer *ts);
 723
 724/**
 725 * timer_get:
 726 * @f: the file
 727 * @ts: the timer
 728 *
 729 * Read a timer @ts from a file @f
 730 */
 731void timer_get(QEMUFile *f, QEMUTimer *ts);
 732
 733/**
 734 * timer_put:
 735 * @f: the file
 736 * @ts: the timer
 737 */
 738void timer_put(QEMUFile *f, QEMUTimer *ts);
 739
 740/*
 741 * General utility functions
 742 */
 743
 744/**
 745 * qemu_timeout_ns_to_ms:
 746 * @ns: nanosecond timeout value
 747 *
 748 * Convert a nanosecond timeout value (or -1) to
 749 * a millisecond value (or -1), always rounding up.
 750 *
 751 * Returns: millisecond timeout value
 752 */
 753int qemu_timeout_ns_to_ms(int64_t ns);
 754
 755/**
 756 * qemu_poll_ns:
 757 * @fds: Array of file descriptors
 758 * @nfds: number of file descriptors
 759 * @timeout: timeout in nanoseconds
 760 *
 761 * Perform a poll like g_poll but with a timeout in nanoseconds.
 762 * See g_poll documentation for further details.
 763 *
 764 * Returns: number of fds ready
 765 */
 766int qemu_poll_ns(GPollFD *fds, guint nfds, int64_t timeout);
 767
 768/**
 769 * qemu_soonest_timeout:
 770 * @timeout1: first timeout in nanoseconds (or -1 for infinite)
 771 * @timeout2: second timeout in nanoseconds (or -1 for infinite)
 772 *
 773 * Calculates the soonest of two timeout values. -1 means infinite, which
 774 * is later than any other value.
 775 *
 776 * Returns: soonest timeout value in nanoseconds (or -1 for infinite)
 777 */
 778static inline int64_t qemu_soonest_timeout(int64_t timeout1, int64_t timeout2)
 779{
 780    /* we can abuse the fact that -1 (which means infinite) is a maximal
 781     * value when cast to unsigned. As this is disgusting, it's kept in
 782     * one inline function.
 783     */
 784    return ((uint64_t) timeout1 < (uint64_t) timeout2) ? timeout1 : timeout2;
 785}
 786
 787/**
 788 * initclocks:
 789 *
 790 * Initialise the clock & timer infrastructure
 791 */
 792void init_clocks(QEMUTimerListNotifyCB *notify_cb);
 793
 794int64_t cpu_get_ticks(void);
 795/* Caller must hold BQL */
 796void cpu_enable_ticks(void);
 797/* Caller must hold BQL */
 798void cpu_disable_ticks(void);
 799
 800static inline int64_t get_max_clock_jump(void)
 801{
 802    /* This should be small enough to prevent excessive interrupts from being
 803     * generated by the RTC on clock jumps, but large enough to avoid frequent
 804     * unnecessary resets in idle VMs.
 805     */
 806    return 60 * NANOSECONDS_PER_SECOND;
 807}
 808
 809/*
 810 * Low level clock functions
 811 */
 812
 813/* get host real time in nanosecond */
 814static inline int64_t get_clock_realtime(void)
 815{
 816    struct timeval tv;
 817
 818    gettimeofday(&tv, NULL);
 819    return tv.tv_sec * 1000000000LL + (tv.tv_usec * 1000);
 820}
 821
 822/* Warning: don't insert tracepoints into these functions, they are
 823   also used by simpletrace backend and tracepoints would cause
 824   an infinite recursion! */
 825#ifdef _WIN32
 826extern int64_t clock_freq;
 827
 828static inline int64_t get_clock(void)
 829{
 830    LARGE_INTEGER ti;
 831    QueryPerformanceCounter(&ti);
 832    return muldiv64(ti.QuadPart, NANOSECONDS_PER_SECOND, clock_freq);
 833}
 834
 835#else
 836
 837extern int use_rt_clock;
 838
 839static inline int64_t get_clock(void)
 840{
 841#ifdef CLOCK_MONOTONIC
 842    if (use_rt_clock) {
 843        struct timespec ts;
 844        clock_gettime(CLOCK_MONOTONIC, &ts);
 845        return ts.tv_sec * 1000000000LL + ts.tv_nsec;
 846    } else
 847#endif
 848    {
 849        /* XXX: using gettimeofday leads to problems if the date
 850           changes, so it should be avoided. */
 851        return get_clock_realtime();
 852    }
 853}
 854#endif
 855
 856/* icount */
 857int64_t cpu_get_icount_raw(void);
 858int64_t cpu_get_icount(void);
 859int64_t cpu_get_clock(void);
 860int64_t cpu_icount_to_ns(int64_t icount);
 861void    cpu_update_icount(CPUState *cpu);
 862
 863/*******************************************/
 864/* host CPU ticks (if available) */
 865
 866#if defined(_ARCH_PPC)
 867
 868static inline int64_t cpu_get_host_ticks(void)
 869{
 870    int64_t retval;
 871#ifdef _ARCH_PPC64
 872    /* This reads timebase in one 64bit go and includes Cell workaround from:
 873       http://ozlabs.org/pipermail/linuxppc-dev/2006-October/027052.html
 874    */
 875    __asm__ __volatile__ ("mftb    %0\n\t"
 876                          "cmpwi   %0,0\n\t"
 877                          "beq-    $-8"
 878                          : "=r" (retval));
 879#else
 880    /* http://ozlabs.org/pipermail/linuxppc-dev/1999-October/003889.html */
 881    unsigned long junk;
 882    __asm__ __volatile__ ("mfspr   %1,269\n\t"  /* mftbu */
 883                          "mfspr   %L0,268\n\t" /* mftb */
 884                          "mfspr   %0,269\n\t"  /* mftbu */
 885                          "cmpw    %0,%1\n\t"
 886                          "bne     $-16"
 887                          : "=r" (retval), "=r" (junk));
 888#endif
 889    return retval;
 890}
 891
 892#elif defined(__i386__)
 893
 894static inline int64_t cpu_get_host_ticks(void)
 895{
 896    int64_t val;
 897    asm volatile ("rdtsc" : "=A" (val));
 898    return val;
 899}
 900
 901#elif defined(__x86_64__)
 902
 903static inline int64_t cpu_get_host_ticks(void)
 904{
 905    uint32_t low,high;
 906    int64_t val;
 907    asm volatile("rdtsc" : "=a" (low), "=d" (high));
 908    val = high;
 909    val <<= 32;
 910    val |= low;
 911    return val;
 912}
 913
 914#elif defined(__hppa__)
 915
 916static inline int64_t cpu_get_host_ticks(void)
 917{
 918    int val;
 919    asm volatile ("mfctl %%cr16, %0" : "=r"(val));
 920    return val;
 921}
 922
 923#elif defined(__s390__)
 924
 925static inline int64_t cpu_get_host_ticks(void)
 926{
 927    int64_t val;
 928    asm volatile("stck 0(%1)" : "=m" (val) : "a" (&val) : "cc");
 929    return val;
 930}
 931
 932#elif defined(__sparc__)
 933
 934static inline int64_t cpu_get_host_ticks (void)
 935{
 936#if defined(_LP64)
 937    uint64_t        rval;
 938    asm volatile("rd %%tick,%0" : "=r"(rval));
 939    return rval;
 940#else
 941    /* We need an %o or %g register for this.  For recent enough gcc
 942       there is an "h" constraint for that.  Don't bother with that.  */
 943    union {
 944        uint64_t i64;
 945        struct {
 946            uint32_t high;
 947            uint32_t low;
 948        }       i32;
 949    } rval;
 950    asm volatile("rd %%tick,%%g1; srlx %%g1,32,%0; mov %%g1,%1"
 951                 : "=r"(rval.i32.high), "=r"(rval.i32.low) : : "g1");
 952    return rval.i64;
 953#endif
 954}
 955
 956#elif defined(__mips__) && \
 957    ((defined(__mips_isa_rev) && __mips_isa_rev >= 2) || defined(__linux__))
 958/*
 959 * binutils wants to use rdhwr only on mips32r2
 960 * but as linux kernel emulate it, it's fine
 961 * to use it.
 962 *
 963 */
 964#define MIPS_RDHWR(rd, value) {                         \
 965        __asm__ __volatile__ (".set   push\n\t"         \
 966                              ".set mips32r2\n\t"       \
 967                              "rdhwr  %0, "rd"\n\t"     \
 968                              ".set   pop"              \
 969                              : "=r" (value));          \
 970    }
 971
 972static inline int64_t cpu_get_host_ticks(void)
 973{
 974    /* On kernels >= 2.6.25 rdhwr <reg>, $2 and $3 are emulated */
 975    uint32_t count;
 976    static uint32_t cyc_per_count = 0;
 977
 978    if (!cyc_per_count) {
 979        MIPS_RDHWR("$3", cyc_per_count);
 980    }
 981
 982    MIPS_RDHWR("$2", count);
 983    return (int64_t)(count * cyc_per_count);
 984}
 985
 986#elif defined(__alpha__)
 987
 988static inline int64_t cpu_get_host_ticks(void)
 989{
 990    uint64_t cc;
 991    uint32_t cur, ofs;
 992
 993    asm volatile("rpcc %0" : "=r"(cc));
 994    cur = cc;
 995    ofs = cc >> 32;
 996    return cur - ofs;
 997}
 998
 999#else
1000/* The host CPU doesn't have an easily accessible cycle counter.
1001   Just return a monotonically increasing value.  This will be
1002   totally wrong, but hopefully better than nothing.  */
1003static inline int64_t cpu_get_host_ticks(void)
1004{
1005    return get_clock();
1006}
1007#endif
1008
1009#ifdef CONFIG_PROFILER
1010static inline int64_t profile_getclock(void)
1011{
1012    return get_clock();
1013}
1014
1015extern int64_t dev_time;
1016#endif
1017
1018#endif
1019