Struct Halt

pub struct Halt { /* private fields */ }

Tracks whether the VP should halt due to a guest-initiated condition (triple fault, etc.).

Implementations

impl Halt

pub fn new() -> (Self, HaltReasonReceiver)

Returns a new halt object, plus a receiver to asynchronously receive the reason for a halt.

pub fn halt(&self, reason: HaltReason)

Halts all VPs and sends the halt reason to the receiver returned by Self::new().

After this returns, it’s guaranteed that any VPs that try to run again will instead halt. So if this is called from a VP thread, it will ensure that that VP will not resume.

pub fn replay_mtrrs(&self)

Halts all VPs temporarily, resets their variable MTRRs to their initial state, then resumes the VPs.

This is used by the legacy BIOS, since it stomps over the variable MTRRs in undesirable ways and is difficult to fix.

Trait Implementations

impl DebugEventHandler for Halt

fn on_debug_break(&self, vp: Option<u32>)

Called when a device has requested a debug break.

impl Inspect for Halt

fn inspect(&self, req: Request<'_>)

Inspects the object.

impl PowerEventHandler for Halt

fn on_power_event(&self, evt: PowerEvent)

Called when there is a device-triggered power event.