Struct SharedContainerLayout 

pub struct SharedContainerLayout { /* private fields */ }

Per-container directory layout within the shared filesystem.

Represents the directory structure for a single container:

{root}/                    # shared/containers/{cid}/
├── overlayfs/
│   ├── diff/              # Image layers (lower dirs for overlayfs)
│   ├── upper/             # Overlayfs upper (writable layer)
│   └── work/              # Overlayfs work directory
├── rootfs/                # All rootfs strategies mount here
└── volumes/               # User volumes (virtiofs mounts)
    ├── {volume-name-1}/
    └── {volume-name-2}/

Implementations

impl SharedContainerLayout

pub fn new(root: impl Into<PathBuf>) -> Self

Create a container layout with the given root path.

pub fn root(&self) -> &Path

Root directory of this container: shared/containers/{cid}

pub fn overlayfs_dir(&self) -> PathBuf

Overlayfs directory: {root}/overlayfs

pub fn upper_dir(&self) -> PathBuf

Upper directory: {root}/overlayfs/upper

Writable layer for overlayfs.

pub fn work_dir(&self) -> PathBuf

Work directory: {root}/overlayfs/work

Overlayfs work directory.

pub fn diff_dir(&self) -> PathBuf

Diff directory: {root}/overlayfs/diff

Contains image layers (lower dirs for overlayfs).

pub fn rootfs_dir(&self) -> PathBuf

Rootfs directory: {root}/rootfs

All rootfs strategies (merged, overlayfs, disk image) mount here. Guest bind mounts /run/boxlite/{cid}/rootfs/ to this location.

pub fn volumes_dir(&self) -> PathBuf

Volumes directory: {root}/volumes

Base directory for user volume mounts.

pub fn volume_dir(&self, volume_name: &str) -> PathBuf

Specific volume directory: {root}/volumes/{volume_name}

Convention-based path for a specific user volume. Both host and guest use this to construct volume mount paths.

pub fn layers_dir(&self) -> PathBuf

Layers directory: {root}/layers

Source directory for image layers (virtiofs mount point). Guest bind-mounts from here to diff_dir for overlayfs.

pub fn prepare(&self) -> Result<()>

Prepare container directories.

Trait Implementations

impl Clone for SharedContainerLayout

fn clone(&self) -> SharedContainerLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SharedContainerLayout

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

Formats the value using the given formatter.