Struct QemuPetriRuntime 

pub struct QemuPetriRuntime { /* private fields */ }

Resources needed at runtime for a QEMU Petri VM

Trait Implementations

impl PetriVmRuntime for QemuPetriRuntime

type VmInspector = NoPetriVmInspector

Interface for inspecting the VM

type VmFramebufferAccess = NoPetriVmFramebufferAccess

Interface for accessing the framebuffer

fn teardown<'async_trait>( self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait,

Cleanly tear down the VM immediately.

fn wait_for_halt<'life0, 'async_trait>( &'life0 mut self, _allow_reset: bool, ) -> Pin<Box<dyn Future<Output = Result<PetriHaltReasonDetail>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Wait for the VM to halt, returning the reason for the halt. The VM should automatically restart the VM on reset if allow_reset is true.

fn wait_for_agent<'life0, 'async_trait>( &'life0 mut self, _set_high_vtl: bool, ) -> Pin<Box<dyn Future<Output = Result<PipetteClient>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Wait for a connection from a pipette agent

fn openhcl_diag(&self) -> Option<OpenHclDiagHandler>

Get an OpenHCL diagnostics handler for the VM

fn wait_for_boot_event<'life0, 'async_trait>( &'life0 mut self, _timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<FirmwareEvent>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Waits for an event emitted by the firmware about its boot status, and returns that status. Returns None if timeout elapsed first.

fn wait_for_enlightened_shutdown_ready<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Waits for the Hyper-V shutdown IC to be ready

fn send_enlightened_shutdown<'life0, 'async_trait>( &'life0 mut self, _kind: ShutdownKind, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Instruct the guest to shutdown via the Hyper-V shutdown IC.

fn restart_openhcl<'life0, 'life1, 'async_trait>( &'life0 mut self, _new_openhcl: &'life1 ResolvedArtifact, _flags: OpenHclServicingFlags, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Instruct the OpenHCL to restart the VTL2 paravisor. Will fail if the VM is not running OpenHCL. Will also fail if the VM is not running.

fn save_openhcl<'life0, 'life1, 'async_trait>( &'life0 mut self, _new_openhcl: &'life1 ResolvedArtifact, _flags: OpenHclServicingFlags, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Instruct the OpenHCL to save the state of the VTL2 paravisor. Will fail if the VM is not running OpenHCL. Will also fail if the VM is not running or if this is called twice in succession without a call to restore_openhcl.

fn restore_openhcl<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Instruct the OpenHCL to restore the state of the VTL2 paravisor. Will fail if the VM is not running OpenHCL. Will also fail if the VM is running or if this is called without prior save.

fn update_command_line<'life0, 'life1, 'async_trait>( &'life0 mut self, _command_line: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Update the command line parameter of the running VM that will apply on next boot. Will fail if the VM is not using IGVM load mode.

fn take_framebuffer_access(&mut self) -> Option<NoPetriVmFramebufferAccess>

If the backend supports it, take the screenshot interface (subsequent calls may return None).

fn reset<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Issue a hard reset to the VM

fn get_guest_state_file<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<PathBuf>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get the path to the VM’s guest state file

fn set_vtl2_settings<'life0, 'life1, 'async_trait>( &'life0 mut self, _settings: &'life1 Vtl2Settings, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Set the OpenHCL VTL2 settings

fn set_vmbus_drive<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, _drive: &'life1 Drive, _controller_id: &'life2 Guid, _controller_location: u32, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Add or modify a VMBus disk drive

fn inspector(&self) -> Option<Self::VmInspector>

If the backend supports it, get an inspect interface

fn add_pcie_device<'life0, 'async_trait>( &'life0 mut self, port_name: String, resource: Resource<PciDeviceHandleKind>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Hot-add a PCIe device to a named port at runtime.

fn remove_pcie_device<'life0, 'async_trait>( &'life0 mut self, port_name: String, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Hot-remove a PCIe device from a named port at runtime.