Struct BootedStorage 

pub(crate) struct BootedStorage {
    pub(crate) storage: Storage,
}

Storage accessor for a booted system.

This wraps Storage and can determine whether the system is booted via ostree or composefs, providing a unified interface for both.

Fields

storage: Storage

Implementations

impl BootedStorage

pub(crate) async fn new(env: Environment) -> Result<Option<Self>>

Create a new booted storage accessor for the given environment.

The caller must have already called prepare_for_write() if env.needs_mount_namespace() is true.

pub(crate) fn kind(&self) -> Result<BootedStorageKind<'_>>

Determine the boot storage backend kind.

Returns information about whether the system booted via ostree or composefs, along with the relevant sysroot/deployment or repository/cmdline data.

Methods from Deref<Target = Storage>

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

Returns boot_dir if it exists

pub(crate) fn require_esp(&self) -> Result<&TempMount>

Returns the mounted esp if it exists

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

Returns the Directory where the Type1 boot binaries are stored /sysroot/boot for Grub, and ESP/EFI/Linux for systemd-boot

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.

Works on both ostree and composefs-only systems. On ostree the SELinux policy is loaded from the booted deployment; on composefs (where ostree isn’t initialized) we fall back to the host root policy.

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

Ensure the image storage is properly SELinux-labeled. This should be called after all image pulls are complete.

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.

If the repository already exists on disk, it is opened as-is, preserving whatever EROFS format version it was created with (e.g. V2 from an older composefs-rs). A fresh repository is only initialized when no meta.json is found, using the current default format version from composefs-rs.

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

Update the mtime on the storage root directory.

This touches ostree/bootc (or its symlink target on composefs systems) so that bootc-status-updated.path fires.

Trait Implementations

impl Deref for BootedStorage

type Target = Storage

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.