guest_timer_notify()

Request notification when a guest timer passes a given point

Synopsis:

#include <qvm/guest.h>
int guest_timer_notify(struct guest_timer *vtp,
                       const struct guest_timer_data *tdp,
                       uint64_t deadline)

Arguments:

vtp
A pointer to a guest timer; this is returned by a call to guest_timer_create().
tdp
One of the following values:
  • NULL for a single-shot timer with a relative deadline
  • GUEST_TIMER_ABSOLUTE for a single-shot timer with an absolute deadline
  • NULL for the first activation of a repeating timer
  • A pointer to the guest_timer_data structure given to a timer callback of a vdev; this setting is used for a recurring activation of a repeating timer
deadline
The time at which the timer should fire. This value is relative to the current guest time unless tdp is GUEST_TIMER_ABSOLUTE.

Description:

This function requests notification when the specified guest timer passes the specified time. The time can be relative or absolute.

Returns:

EOK if successful; otherwise, an errno value.

Page updated: