Skip to main content

Module walk_id

Module walk_id 

Source
Expand description

Synthetic record numbers for scope-mode (folder-walk) indexing (ADR-0024).

The $MFT scanner gets a real NTFS FRN per record; a folder walk has none. But the index keys identity on crate::index::Frn::record — the low 48 bits, resolved by liveness (index/frn.rs), never on the full reference — so any stable, collision-resistant 48-bit key per path serves. We hash the folded absolute path: absolute paths are globally unique, so the low 48 bits stay unique across roots without a separate root id (a root id placed in the high bits would be discarded by record() anyway), and the Phase 2 watcher recomputes the identical key from a changed path with no shared state. Folding the path makes the key case-insensitive, matching NTFS and making the walk’s and the watcher’s spellings agree.

Functions§

path_record
The low-48-bit synthetic record number for a folded-WTF-8 absolute path.