Crate microsandbox_image 

OCI image pulling, layer extraction, and caching for microsandbox.

This crate implements the OCI image lifecycle:

• Registry communication (pull, auth, platform resolution)
• Layer caching with content-addressable dedup
• Layer extraction (async tar pipeline, stat virtualization, whiteouts)
• Binary sidecar index generation for OverlayFs acceleration

Structs

CachedImageMetadata

Cached metadata for a pulled image reference.

CachedLayerMetadata

Cached metadata for a single layer descriptor.

Digest

OCI content-addressable digest (e.g., sha256:e3b0c44298fc1c14...).

GlobalCache

On-disk global cache for OCI layers.

ImageConfig

Runtime configuration parsed from an OCI image config blob.

Platform

Target platform for OCI image resolution.

PullOptions

Options for Registry::pull().

PullProgressHandle

Receiver for progress events.

PullProgressSender

Emits progress events. Uses try_send — never blocks downloads.

PullResult

Result of a successful image pull.

Reference

Reference provides a general type to represent any way of referencing images within an OCI registry.

Registry

OCI registry client with platform resolution, caching, and progress reporting.

Enums

ImageError

Errors that can occur during image operations.

PullPolicy

Controls when the registry is contacted for manifest freshness.

PullProgress

Progress events emitted during image pull and layer extraction.

RegistryAuth

Authentication credentials for OCI registry access.

Functions

progress_channel

Create a progress channel pair.

Type Aliases

ImageResult

Result type for image operations.