Struct SnapshotStore 

pub struct SnapshotStore { /* private fields */ }

Persistent store for VM snapshots.

Implementations

impl SnapshotStore

pub fn rootfs_format(&self, id: &str) -> Result<SnapshotRootfsFormat>

Inspect and validate the rootfs representation of a published snapshot.

pub fn restore_rootfs_to_box( &self, id: &str, box_dir: &Path, ) -> Result<RestoredSnapshotRootfs>

Materialize a published snapshot into a newly-created box directory.

Directory payloads publish the historical .snapshot-lower reference while the store lock is held. Raw payloads clone and validate a private writable artifact, so deleting the snapshot later cannot affect the box.

impl SnapshotStore

pub fn new(base_dir: &Path) -> Result<Self>

Create a new snapshot store at the given directory.

pub fn default_path() -> Result<Self>

Open the default snapshot store at ~/.a3s/snapshots.

pub fn save( &self, metadata: SnapshotMetadata, rootfs_source: &Path, ) -> Result<SnapshotMetadata>

Save a snapshot with the given metadata and rootfs source.

Copies the rootfs directory into the snapshot bundle. Returns the updated metadata with size_bytes populated.

pub fn get(&self, id: &str) -> Result<Option<SnapshotMetadata>>

Load snapshot metadata by ID.

pub fn rootfs_path(&self, id: &str) -> PathBuf

Get the rootfs path for a snapshot.

pub fn list(&self) -> Result<Vec<SnapshotMetadata>>

List all snapshots, sorted by creation time (newest first).

pub fn delete(&self, id: &str) -> Result<bool>

Delete a snapshot by ID.

pub fn delete_force(&self, id: &str) -> Result<bool>

Delete a snapshot even when a restored directory-backed box still references it. This deliberately unsafe operation exists only for the CLI’s explicit snapshot rm --force contract.

pub fn count(&self) -> Result<usize>

Count the number of snapshots.

pub fn total_size(&self) -> Result<u64>

Calculate total size of all snapshots in bytes.

pub fn prune(&self, max_count: usize, max_bytes: u64) -> Result<Vec<String>>

Prune old snapshots to stay within limits.

Removes oldest snapshots first until both max_count and max_bytes constraints are satisfied. A value of 0 means unlimited.

Trait Implementations

impl SnapshotStoreBackend for SnapshotStore

fn save( &self, metadata: SnapshotMetadata, rootfs_source: &Path, ) -> Result<SnapshotMetadata>

Save a snapshot with its rootfs source directory.

fn get(&self, id: &str) -> Result<Option<SnapshotMetadata>>

Load snapshot metadata by ID. Returns None if not found.

fn list(&self) -> Result<Vec<SnapshotMetadata>>

List all snapshots, sorted by creation time (newest first).

fn delete(&self, id: &str) -> Result<bool>

Delete a snapshot by ID. Returns true if it existed.

fn count(&self) -> Result<usize>

Total number of stored snapshots.

fn total_size(&self) -> Result<u64>

Total disk usage in bytes across all snapshots.

fn prune(&self, max_count: usize, max_bytes: u64) -> Result<Vec<String>>

Evict old snapshots until under max_count and max_bytes.