Struct WindowsLayerEntry 

pub struct WindowsLayerEntry {
    pub layer_id: String,
    pub layer_path: PathBuf,
    pub blob_path: Option<PathBuf>,
}

On-disk reference to one materialised parent layer.

Stored on BuildSkeleton so subsequent RUN steps can build the HCS LayerChain (child-to-parent order) the storage filter expects. Cross-platform plain data — the chain is only consumed by target_os = "windows" code, but the type compiles everywhere so the public API and unit tests stay portable.

Fields

layer_id: String

Caller-chosen GUID/uuid for the layer. HCS stores it inside the LayerData JSON so the storage filter can route opens.

layer_path: PathBuf

Absolute path to the layer directory (e.g. <cache_dir>/<build_id>/unpacked/<layer_id>/).

This is the HCS-imported read-only layer dir (materialised VHD + Files/ + Hives/), owned by SYSTEM with restrictive ACLs. It is the parent-chain handle the storage filter consumes — it is NOT a readable source for the layer’s gzip blob (the dir holds the unpacked VHD, not the compressed tar). Never fs::read this for the OCI descriptor bytes; use blob_path instead.

blob_path: Option<PathBuf>

Absolute path to the plain, process-owned compressed (tar+gzip) layer blob file — the exact bytes whose sha256 is the OCI descriptor digest, persisted from the in-memory blob the RUN/COPY commit already produced.

Some for builder-produced layers (RUN/COPY/ADD); None for foreign base layers (their bytes are never re-uploaded — the runtime rehydrates them from the manifest’s urls[]). The OCI export ([export_built_image_to_oci_archive]) and the registry push ([push_impl]) read THIS file, never layer_path, which would otherwise hit ERROR_ACCESS_DENIED opening the restricted HCS layer directory.

Trait Implementations

impl Clone for WindowsLayerEntry

fn clone(&self) -> WindowsLayerEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WindowsLayerEntry

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

Formats the value using the given formatter.