Struct VmManager 

pub struct VmManager { /* private fields */ }

Manages all VMs on this node. Auto-selects the correct hypervisor driver.

Thread-safe: uses RwLock for concurrent access to VM state.

Implementations

impl VmManager

pub fn new(base_dir: PathBuf) -> Result<Self, VmError>

Create a new VmManager with auto-detected driver.

base_dir is the root directory for VM data (disks, logs, configs). Typically ~/.vm-rs/vms/ for development or /var/lib/vm-rs/ for production.

pub fn with_driver( driver: Box<dyn VmDriver>, base_dir: PathBuf, ) -> Result<Self, VmError>

Create a VmManager with a specific driver (useful for testing).

pub fn base_dir(&self) -> &Path

Base directory for all VM data.

pub fn vm_dir(&self, name: &str) -> PathBuf

Directory for a specific VM’s data (logs, disks, seed ISOs).

pub fn start(&self, config: &VmConfig) -> Result<VmHandle, VmError>

Boot a VM. Creates the VM directory and delegates to the driver.

pub fn stop(&self, name: &str) -> Result<(), VmError>

Stop a VM gracefully.

pub fn kill(&self, name: &str) -> Result<(), VmError>

Force-kill a VM.

pub fn stop_by_handle(&self, handle: &VmHandle) -> Result<(), VmError>

Stop a VM using a pre-built handle (e.g. restored from persisted metadata).

pub fn kill_by_handle(&self, handle: &VmHandle) -> Result<(), VmError>

Force-kill a VM using a pre-built handle (e.g. restored from persisted metadata).

pub fn pause(&self, name: &str) -> Result<(), VmError>

Pause a running VM.

pub fn resume(&self, name: &str) -> Result<(), VmError>

Resume a paused VM.

pub fn state(&self, name: &str) -> Result<VmState, VmError>

Query current state of a VM.

pub fn get_ip(&self, name: &str) -> Result<Option<String>, VmError>

Get the IP address of a ready VM.

pub fn list(&self) -> Result<Vec<VmHandle>, VmError>

List all tracked VMs.

pub fn wait_all_ready(&self, timeout_secs: u64) -> Result<(), VmError>

Wait for all VMs to emit the readiness marker within the timeout.

pub fn clone_disk(base: &Path, target: &Path) -> Result<(), VmError>

Create a disk image as a CoW clone of a base image.