Struct PartitionUnit

pub struct PartitionUnit { /* private fields */ }

The control point for managing a partition unit.

Implementations

impl PartitionUnit

pub fn new( spawner: impl Spawn, builder: UnitBuilder<'_>, partition: impl VmPartition, params: PartitionUnitParams<'_>, ) -> Result<(Self, Vec<VpRunner>), Error>

Creates a new VM partition state unit.

The caller is responsible for launching a thread for each VP and running the VP using the returned VpRunners.

pub fn unit_handle(&self) -> &UnitHandle

Gets the handle for the partition unit.

pub async fn teardown(self) -> Sender<HaltReason>

Tears down the state unit, returning the client_notify_send sender passed to Self::new().

pub async fn clear_halt(&mut self) -> bool

Clears the current halt reason from the partition, resuming the VPs if they are stopped.

pub async fn temporarily_stop_vps(&mut self) -> StopGuard

Temporarily stops the VPs, returning a guard that will resume them when dropped.

pub async fn set_initial_regs( &mut self, vtl: Vtl, state: Arc<InitialRegs>, ) -> Result<(), InitialRegError>

Sets the register state for the VPs for initial boot.

If the VM has been run before and has not been reset since it last ran, the target VTL will be scrubbed first so that the partition state is clean.

pub async fn set_initial_page_visibility( &mut self, vis: Vec<(MemoryRange, PageVisibility)>, ) -> Result<(), InitialVisibilityError>