Struct ShimHandler 

pub struct ShimHandler { /* private fields */ }

Handler for a running VM subprocess (shim process).

Provides lifecycle operations (stop, metrics, status) for a VM identified by PID.

Implementations

impl ShimHandler

pub fn from_child(process: Child, box_id: String) -> Self

Create a handler for a spawned VM with process ownership.

This constructor takes ownership of the Child process handle for proper lifecycle management (clean shutdown with wait()).

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

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

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

pub fn box_id(&self) -> &str

Get the box ID.

Trait Implementations

impl VmHandler for ShimHandler

fn pid(&self) -> u32

Return the OS process ID of the VM.

fn stop(&mut self, signal: i32, timeout_ms: u64) -> Result<()>

Stop the VM. Sends signal first, then SIGKILL after timeout_ms.

fn metrics(&self) -> VmMetrics

Get current CPU and memory metrics.

fn is_running(&self) -> bool

Check if the VM process is still alive.

fn exit_code(&self) -> Option<i32>

Return the exit code of the VM process, if it has exited.

fn try_wait_exit(&mut self) -> Result<Option<i32>>

Poll the VM process for natural exit without sending any signal.

fn has_exited(&self) -> bool

Whether the VM process has exited, treating a zombie (an exited child not yet reaped by its parent) as exited.