Summary
Kick a VCPU, causing it to stop execution.
Declaration
#include <zircon/syscalls.h>
zx_status_t zx_vcpu_kick(zx_handle_t handle);
Description
zx_vcpu_kick()
forces the current or next execution of zx_vcpu_enter()
on
handle to return immediately with ZX_ERR_CANCELED.
zx_vcpu_kick()
may be called multiple times on handle, but will only affect
the current or next execution of zx_vcpu_enter()
.
Rights
handle must be of type ZX_OBJ_TYPE_VCPU and have ZX_RIGHT_EXECUTE.
Return value
zx_vcpu_kick()
returns ZX_OK on success. On failure, an error value is
returned.
Errors
ZX_ERR_ACCESS_DENIED handle does not have the ZX_RIGHT_EXECUTE right.
ZX_ERR_BAD_HANDLE handle is an invalid handle.
ZX_ERR_WRONG_TYPE handle is not a handle to a VCPU.
See also
zx_guest_create()
zx_guest_set_trap()
zx_vcpu_create()
zx_vcpu_enter()
zx_vcpu_interrupt()
zx_vcpu_read_state()
zx_vcpu_write_state()