Enum RootDisk 

pub enum RootDisk {
    Managed {
        size_mib: Option<u32>,
    },
    Tmpfs {
        size_mib: Option<u32>,
    },
    DiskImage {
        path: PathBuf,
        format: DiskImageFormat,
        fstype: Option<String>,
    },
    Flat {
        size_mib: Option<u32>,
        fstype: Option<String>,
        clone: FlatClone,
    },
}

Backing for the writable rootfs layer (overlay upper) of an OCI sandbox.

This lives only on OciRootfsSource: the root disk is a property of how an OCI image becomes a rootfs. Every user surface (CLI --root-disk, SDK builders) is sugar resolving into this type.

Variants

Managed

Sparse ext4 created and owned by microsandbox in the sandbox dir. Default. Persistent; grow-only via modify; deleted with the sandbox.

Fields

size_mib: Option<u32>

Virtual size in MiB. None resolves to 4096.

Tmpfs

RAM-backed upper. Ephemeral: the rootfs is pristine on every boot. Pages come from guest memory, so the size must not exceed the sandbox memory.

Fields

size_mib: Option<u32>

Size in MiB. None resolves to half the sandbox memory.

DiskImage

User-supplied disk image attached writable as the upper. User-owned lifecycle: never created, resized, or deleted by microsandbox.

Fields

path: PathBuf

Host path to the image file.

format: DiskImageFormat

Disk image format. Never probed from file contents.

fstype: Option<String>

Inner filesystem type. None resolves to ext4.

Flat

A complete OCI root filesystem materialized into one private writable filesystem.

This is microsandbox-owned like RootDisk::Managed, but it replaces the layered EROFS-plus-OverlayFS topology rather than supplying only its writable upper.

Fields

size_mib: Option<u32>

Final guest filesystem capacity in MiB. None resolves to the greater of 4096 MiB and the materialized image’s minimum size.

fstype: Option<String>

Generated filesystem type. None resolves to ext4.

clone: FlatClone

Requested private-instance strategy.

Implementations

impl RootDisk

pub fn managed(size_mib: u32) -> Self

Create a managed root disk with the given size in MiB.

pub fn tmpfs(size_mib: u32) -> Self

Create a tmpfs root disk with the given size in MiB.

pub fn flat(size_mib: u32) -> Self

Create a flat root disk with the given final capacity in MiB.

pub fn size_mib(&self) -> Option<u32>

Return the configured size in MiB, if this kind carries one.

pub fn kind_str(&self) -> &'static str

Return the lowercase kind tag used on the wire, in the DB, and in CLI output.

pub fn is_managed(&self) -> bool

Whether this is the managed (default) kind.

Trait Implementations

impl Clone for RootDisk

fn clone(&self) -> RootDisk

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RootDisk

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RootDisk

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RootDisk

impl PartialEq for RootDisk

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RootDisk

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 RootDisk