Struct PackManifest 

pub struct PackManifest {

    pub mode: PackMode,
    pub image: String,
    pub digest: String,
    pub platform: String,
    pub entrypoint: Vec<String>,
    pub cmd: Vec<String>,
    pub env: Vec<String>,
    pub secret_refs: BTreeMap<String, SecretRef>,
    pub workdir: Option<String>,
    pub cpus: u8,
    pub mem: u32,
    pub image_size: u64,
    pub network: bool,
    pub gpu: bool,
    pub cuda: bool,
    pub host_platform: String,
    pub created: String,
    pub smolvm_version: String,
    pub assets: AssetInventory,
}

Manifest describing the packed image and configuration.

Fields

mode: PackMode

Execution mode (container or VM).

image: String

Original image reference (e.g., “alpine:latest”).

digest: String

Image digest (sha256:…).

platform: String

Target platform (e.g., “linux/arm64”).

entrypoint: Vec<String>

Entrypoint command (from image config or override).

cmd: Vec<String>

Default command arguments (from image config or override).

env: Vec<String>

Default environment variables.

secret_refs: BTreeMap<String, SecretRef>

Secret references carried with the pack. Each maps an env var name to a reference (host store entry, host env var, or file) — never an inline value. The plaintext is resolved on the run host at exec time, so a .smolmachine never contains secret material at rest.

workdir: Option<String>

Working directory (from image config or override).

cpus: u8

Default number of vCPUs.

mem: u32

Default memory in MiB.

image_size: u64

Total extracted (on-disk) image size in bytes. Used to auto-size the storage disk at runtime.

network: bool

Whether outbound networking is enabled by default.

gpu: bool

Enable GPU acceleration (Vulkan via virtio-gpu).

cuda: bool

Enable CUDA-over-vsock: the runtime starts a host CUDA server and bridges the guest’s CUDA client to it. Preserved from the source VM’s cuda flag when packing --from-vm. #[serde(default)] keeps older sidecars (which lack the field) loadable.

host_platform: String

Host platform this .smolmachine runs on (e.g., “darwin/arm64”). Distinct from platform which is the guest architecture (always linux). Used for registry Image Index resolution. #[serde(default)] keeps pre-reset packs (which predate this field) loadable — a local run selects libs by the actual host, so an empty value is harmless.

created: String

RFC 3339 timestamp when this machine was packed. Defaulted so older packs that lack it still load.

smolvm_version: String

smolvm version that built this machine (e.g., “0.1.15”). Defaulted so older packs that lack it still load.

assets: AssetInventory

Asset inventory - files included in the assets blob.

Implementations

impl PackManifest

pub fn new( image: String, digest: String, platform: String, host_platform: String, ) -> Self

Create a new manifest with default values.

pub fn to_json(&self) -> Result<Vec<u8>>

Serialize manifest to JSON.

pub fn from_json(data: &[u8]) -> Result<Self>

Deserialize manifest from JSON.

Trait Implementations

impl Clone for PackManifest

fn clone(&self) -> PackManifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PackManifest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PackManifest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PackManifest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.