Struct Storage 

pub(crate) struct Storage {
    pub physical_root: Dir,
    pub physical_root_path: Utf8PathBuf,
    pub boot_dir: Option<Dir>,
    pub esp: Option<TempMount>,
    run: Dir,
    ostree: OnceCell<SysrootLock>,
    composefs: OnceCell<Arc<Repository<Sha512HashValue>>>,
    imgstore: OnceCell<CStorage>,
}

A reference to a physical filesystem root, plus accessors for the different types of container storage.

Fields

physical_root: Dir

Directory holding the physical root

physical_root_path: Utf8PathBuf

Absolute path to the physical root directory. This is /sysroot on a running system, or the target mount point during install.

boot_dir: Option<Dir>

The ‘boot’ directory, useful and Some only for composefs systems For grub booted systems, this points to /sysroot/boot For systemd booted systems, this points to the ESP

esp: Option<TempMount>

The ESP mounted at a tmp location

run: Dir

Our runtime state

ostree: OnceCell<SysrootLock>

The OSTree storage

composefs: OnceCell<Arc<Repository<Sha512HashValue>>>

The composefs storage

imgstore: OnceCell<CStorage>

The containers-image storage used for LBIs

Implementations

impl Storage

pub fn new_ostree(sysroot: SysrootLock, run: &Dir) -> Result<Self>

Create a new storage accessor from an existing ostree sysroot.

This is used for non-booted scenarios (e.g., bootc install) where we’re operating on a target filesystem rather than the running system.

pub(crate) fn require_boot_dir(&self) -> Result<&Dir>

Returns boot_dir if it exists

pub(crate) fn get_ostree(&self) -> Result<&SysrootLock>

Access the underlying ostree repository

pub(crate) fn get_ostree_cloned(&self) -> Result<Sysroot>

Get a cloned reference to the ostree sysroot.

This is used when code needs an owned ostree::Sysroot rather than a reference to the SysrootLock.

pub(crate) fn get_ensure_imgstore(&self) -> Result<&CStorage>

Access the image storage; will automatically initialize it if necessary.

pub(crate) fn get_ensure_composefs( &self, ) -> Result<Arc<Repository<Sha512HashValue>>>

Access the composefs repository; will automatically initialize it if necessary.

This lazily opens the composefs repository, creating the directory if needed and bootstrapping verity settings from the ostree configuration.

pub(crate) fn update_mtime(&self) -> Result<()>

Update the mtime on the storage root directory