Struct KvmBackend 

pub struct KvmBackend { /* private fields */ }

KVM/qemu backend.

Implementations

impl KvmBackend

pub fn new(config: KvmConfig) -> Self

pub async fn check_kvm_available() -> Result<String>

Verify qemu + KVM support is present. Provider should call this at startup; surfacing “your host doesn’t support KVM” at config time is much better than at first-spawn time.

pub fn qemu_argv(&self, config: &ContainerConfig) -> Vec<String>

Build the qemu-system-x86_64 argv. Pure function — testable without spawning anything. Caller is responsible for the seed ISO + qcow2 already existing.

Trait Implementations

impl ComputeBackend for KvmBackend

fn find_available_id<'life0, 'async_trait>( &'life0 self, range_start: u32, range_end: u32, ) -> Pin<Box<dyn Future<Output = Result<u32>> + Send + 'async_trait>>

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

Scan vm_root for existing per-id directories and pick the next free id in range.

fn start_container<'life0, 'async_trait>( &'life0 self, _id: u32, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Daemonized qemu starts on create_container; this is a no-op since the lifecycle is single-shot. If we ever migrate to a non-daemonized qemu (e.g. for live migration support), start_container becomes the place that spawns the process.

fn create_container<'life0, 'life1, 'async_trait>( &'life0 self, config: &'life1 ContainerConfig, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

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

Create a new container

fn stop_container<'life0, 'async_trait>( &'life0 self, id: u32, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Stop a container

fn delete_container<'life0, 'async_trait>( &'life0 self, id: u32, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Delete a container

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

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

Get node resource usage

fn get_container_ip<'life0, 'async_trait>( &'life0 self, _id: u32, ) -> Pin<Box<dyn Future<Output = Result<Option<String>>> + Send + 'async_trait>>

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

Get public IP of the container/VM