Struct ShimHandler 

pub struct ShimHandler { /* private fields */ }

Runtime handler for a running VM subprocess.

Provides lifecycle operations (stop, metrics, status) for a VM identified by PID. Works for both spawned VMs and reconnected VMs (same operations).

Implementations

impl ShimHandler

pub fn from_spawned(spawned: SpawnedShim, box_id: BoxID) -> Self

Create a handler from a spawned shim.

Takes ownership of the SpawnedShim (child process + keepalive) for proper lifecycle management. The keepalive keeps the watchdog pipe alive; dropping it triggers shim shutdown.

pub fn from_pid(pid: u32, box_id: BoxID) -> Self

Create a handler for an existing VM (attach mode).

Used when reconnecting to a running box. We don’t have a Child handle or keepalive, so we manage the process by PID only.

Arguments

• pid - Process ID of the running VM
• box_id - Box identifier (for logging)

Trait Implementations

impl VmmHandler for ShimHandler

fn pid(&self) -> u32

Get the process ID of the running VM.

fn stop(&mut self) -> BoxliteResult<()>

Stop the VM.

fn metrics(&self) -> BoxliteResult<VmmMetrics>

Get VM metrics (CPU, memory, disk usage).

fn is_running(&self) -> bool

Check if the VM is still running.