Enum VolumeMount 

pub enum VolumeMount {
    Bind {
        host: PathBuf,
        guest: String,
        options: MountOptions,
        stat_virtualization: StatVirtualization,
        host_permissions: HostPermissions,
        follow_root_symlinks: bool,
        quota_mib: Option<u32>,
    },
    Named {
        name: String,
        guest: String,
        create: Option<NamedVolumeCreate>,
        options: MountOptions,
        stat_virtualization: StatVirtualization,
        host_permissions: HostPermissions,
        follow_root_symlinks: bool,
    },
    Tmpfs {
        guest: String,
        size_mib: Option<u32>,
        options: MountOptions,
    },
    DiskImage {
        host: PathBuf,
        guest: String,
        format: DiskImageFormat,
        fstype: Option<String>,
        options: MountOptions,
    },
}

A volume mount specification for a sandbox.

Variants

Bind

Bind mount a host directory into the guest.

Fields

host: PathBuf

Host path to bind mount.

guest: String

Guest mount path.

options: MountOptions

Guest mount behavior.

stat_virtualization: StatVirtualization

Guest-visible stat virtualization policy.

host_permissions: HostPermissions

Host permission propagation policy.

follow_root_symlinks: bool

Whether to follow symlinks when resolving the host mount root.

Defaults to false: the host path is resolved following no symlink in any component, so a symlink planted at (or under) the mount root cannot redirect the mount out of its intended target. Set true to opt out when the host path legitimately traverses a symlink.

quota_mib: Option<u32>

Guest-write byte budget in MiB.

Bounds how much the guest may add beyond the directory’s existing contents. None applies the protective default at spawn time; set a value to override it.

Named

Mount a named volume into the guest.

Fields

name: String

Volume name.

guest: String

Guest mount path.

create: Option<NamedVolumeCreate>

Creation metadata for sandbox-time named volume provisioning.

This is transient and intentionally skipped when sandbox configs are persisted; restarting a sandbox mounts the already-created volume.

options: MountOptions

Guest mount behavior.

stat_virtualization: StatVirtualization

Guest-visible stat virtualization policy.

host_permissions: HostPermissions

Host permission propagation policy.

follow_root_symlinks: bool

Whether to follow symlinks when resolving the host mount root.

Defaults to false (resolve following no symlink). See VolumeMount::Bind for details.

Tmpfs

Temporary filesystem backed by guest memory.

Fields

guest: String

Guest mount path.

size_mib: Option<u32>

Size limit in MiB.

options: MountOptions

Guest mount behavior.

DiskImage

Mount a disk image file as a virtio-blk device at a guest path.

Fields

host: PathBuf

Host path to the disk image file.

guest: String

Guest mount path.

format: DiskImageFormat

Disk image format.

fstype: Option<String>

Inner filesystem type. When None, agentd probes /proc/filesystems.

options: MountOptions

Guest mount behavior.

Implementations

impl VolumeMount

pub fn guest(&self) -> &str

The absolute path where this mount appears inside the guest.

pub fn named_create(&self) -> Option<&NamedVolumeCreate>

Return named-volume creation metadata when this mount provisions a named volume.

Trait Implementations

impl Clone for VolumeMount

fn clone(&self) -> VolumeMount

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VolumeMount

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VolumeMount

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl From<CloudVolumeMount> for VolumeMount

fn from(m: CloudVolumeMount) -> Self

Converts to this type from the input type.

impl From<VolumeMount> for CloudVolumeMount

fn from(m: VolumeMount) -> Self

Converts to this type from the input type.

impl Serialize for VolumeMount

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.