Struct RootfsCache 

pub struct RootfsCache { /* private fields */ }

A content-addressed cache of materialized minimal rootfs trees (#112 / ADR 0013 D7). Building a rootfs (resolving the ldd closure + assembling the tree) is the expensive step; keying it by the (granted-binaries + resolved closure) identity lets repeated runs of the same toolchain reuse the build.

The cache stores materialize_copy trees keyed by RootfsCache::key; production keys the read-only bind-mount jail by the same key.

Implementations

impl RootfsCache

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

A cache rooted at root (created on first store).

pub fn key(plan: &RootfsPlan) -> String

The content key for plan: a BLAKE3 crate::ContentId (hex) over each file entry’s (path, ro/rw, len, mtime) and each directory mount-point’s (path, ro/rw). A changed granted binary or .so (different len/mtime) ⇒ a different key ⇒ a rebuild; a changed exec scope ⇒ different paths ⇒ a different key. Directory mount-points key by path only — their contents are bind-mounted at run time, not part of the built tree.

pub fn get_or_materialize( &self, plan: &RootfsPlan, ) -> Result<(PathBuf, bool), Error>

The cached rootfs directory for plan, materializing it (copy) exactly once. Returns (dir, hit) — hit == true ⇒ a complete prior build was reused. A partial (interrupted) build is detected by the absence of the completion marker and rebuilt from scratch.