Struct VmSpec 

pub struct VmSpec {

    pub id: VmId,
    pub cpus: u32,
    pub memory_mib: u32,
    pub boot: BootSpec,
    pub disks: Vec<DiskSpec>,
    pub nics: Vec<NicSpec>,
    pub vsock: Option<VsockSpec>,
    pub shares: Vec<ShareSpec>,
    pub console: ConsoleSpec,
    pub balloon: bool,
    pub entropy: bool,
    pub dirty_tracking: bool,
    pub isolation: IsolationSpec,
}

Everything a driver needs to boot one VM.

Validate with VmSpec::validate before handing it to a driver; drivers validate again at VmDriver::boot, so an orchestrator that forgets still gets Error::InvalidSpec rather than a half-built VM.

Fields

id: VmId

The VM’s identity.

cpus: u32

Virtual CPU count, at least 1.

memory_mib: u32

Guest memory in MiB, at least 1.

boot: BootSpec

How the guest starts.

disks: Vec<DiskSpec>

Block devices, in bus order.

nics: Vec<NicSpec>

Network interfaces, in bus order.

vsock: Option<VsockSpec>

The vsock device, when the guest should have one.

shares: Vec<ShareSpec>

Shared host directories (virtiofs).

console: ConsoleSpec

Where the guest console goes.

balloon: bool

Attach a memory balloon.

entropy: bool

Attach an entropy (virtio-rng) device.

dirty_tracking: bool

Track dirty pages so a checkpoint can be incremental.

isolation: IsolationSpec

How the VMM process is confined.

Implementations

impl VmSpec

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

Checks the invariants no driver can repair.

CPU and memory are at least 1; disk ids are plain names (the path-safe alphabet, wider than VmId’s) and unique; NIC ids and share tags are non-empty and unique; at most one disk is the root; every MAC is a non-nil unicast address; every boot, disk and share path is non-empty; the vsock guest CID is 3 or above.

Trait Implementations

impl Clone for VmSpec

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VmSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VmSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for VmSpec

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for VmSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for VmSpec