Module index 

Sidecar index for layer acceleration.

Provides wire format types, a zero-copy mmap reader, and a builder/writer for the binary per-layer index generated at OCI extraction time.

Structs

DirRecord

A directory in the index (24 bytes). Sorted by path (lexicographic).

EntryRecord

A filesystem entry in the index (40 bytes, 8-byte aligned). Grouped by parent directory (contiguous), sorted by name within each group.

HardlinkRef

A hardlink reference (16 bytes, 8-byte aligned). Sorted by host_ino, then by path. Only entries with nlink > 1 within the layer.

IndexBuilder

Builds valid sidecar index files from high-level calls.

IndexHeader

Index file header (32 bytes, offset 0).

MmapIndex

Zero-copy reader for a mmap’d layer sidecar index.

TombstoneIter

Iterator over tombstone names packed in the string pool.

Constants

DIR_FLAG_OPAQUE

DirRecord flag: directory is opaque (hides all lower entries).

DIR_RECORD_IDX_NONE

Sentinel value for EntryRecord.dir_record_idx on non-directory entries.

ENTRY_FLAG_WHITEOUT

EntryRecord flag: entry is a whiteout (masks a lower entry).

INDEX_MAGIC

Magic bytes: “MSBi” in little-endian.

INDEX_VERSION

Current wire format version.