Struct VmConfig 

pub struct VmConfig {

    pub name: String,
    pub namespace: String,
    pub kernel: PathBuf,
    pub initramfs: Option<PathBuf>,
    pub root_disk: Option<PathBuf>,
    pub data_disk: Option<PathBuf>,
    pub seed_iso: Option<PathBuf>,
    pub cpus: usize,
    pub memory_mb: usize,
    pub networks: Vec<NetworkAttachment>,
    pub shared_dirs: Vec<SharedDir>,
    pub serial_log: PathBuf,
    pub cmdline: Option<String>,
    pub netns: Option<String>,
    pub vsock: bool,
    pub machine_id: Option<Vec<u8>>,
    pub efi_variable_store: Option<PathBuf>,
    pub rosetta: bool,
}

Everything needed to boot a VM.

Two boot modes are supported:

Initramfs boot (fast, stateless): Set kernel + initramfs + cmdline + shared_dirs. Leave root_disk and seed_iso as None. Config delivered via VirtioFS shared directories. The initramfs IS the root filesystem (unpacked into RAM by the kernel).

Cloud-init boot (traditional, disk-based): Set kernel + root_disk + seed_iso. Cloud-init reads its config from the seed ISO (NoCloud datasource). Requires a base disk image.

Fields

name: String

Unique name for this VM.

namespace: String

Namespace (logical grouping, e.g., stack name).

kernel: PathBuf

Path to the kernel image.

initramfs: Option<PathBuf>

Path to initramfs (required for initramfs boot, optional for cloud-init boot).

root_disk: Option<PathBuf>

Path to the root disk image (None for stateless initramfs boot).

data_disk: Option<PathBuf>

Path to additional data disk (optional).

seed_iso: Option<PathBuf>

Path to cloud-init seed ISO (None for initramfs boot with VirtioFS config).

cpus: usize

Number of vCPUs.

memory_mb: usize

Memory in megabytes.

networks: Vec<NetworkAttachment>

Network attachments (L2 switch ports or TAP devices).

shared_dirs: Vec<SharedDir>

Shared directories (host → guest via VirtioFS).

serial_log: PathBuf

Path to serial console log file.

cmdline: Option<String>

Kernel command line arguments (optional — platform-specific defaults used if None).

netns: Option<String>

Linux network namespace to run the VM in (optional). When set, the VMM process is spawned inside ip netns exec <netns>.

vsock: bool

Enable vsock device for host-guest communication.

machine_id: Option<Vec<u8>>

Persistent machine identifier (opaque bytes, driver-specific).

efi_variable_store: Option<PathBuf>

Path to EFI variable store for UEFI boot (optional).

rosetta: bool

Enable Rosetta translation layer (macOS only, Apple Silicon).

Implementations

impl VmConfig

pub fn validate(&self) -> Result<(), VmError>

Validate configuration invariants.

Trait Implementations

impl Clone for VmConfig

fn clone(&self) -> VmConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VmConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.