pub struct ResolvedFile {
pub layout: RegionLayout,
pub total_len: u64,
pub track_id: i64,
pub content_version: i64,
pub backing_path: PathBuf,
pub stamp: BackingStamp,
pub mtime_secs: i64,
pub last_page: Mutex<Option<(u64, u64, Vec<u8>)>>,
pub cache_bytes: u64,
pub streams_db_rowid: bool,
}Expand description
A fully resolved synthesized file: its segment layout, total size, the content version it was built from, and where the backing audio lives.
Fields§
§layout: RegionLayout§total_len: u64§track_id: i64Track id this entry resolves. Lets the stateless read path recheck the
live content_version under its WAL snapshot (#502), mirroring the
handle fast path’s use of the handle’s track_id.
content_version: i64§backing_path: PathBuf§stamp: BackingStamp§mtime_secs: i64§last_page: Mutex<Option<(u64, u64, Vec<u8>)>>One-entry memo of the last patched Ogg page, so consecutive reads skip
re-patching the page straddling a chunk boundary. Empty for non-Ogg files
and reset whenever this resolved entry is rebuilt. (Concrete type spelled
out rather than ogg_index::LastPageMemo because that module is private.)
cache_bytes: u64Approximate resident bytes this entry costs the cache (sum of Inline
segment bytes; backing/art/ogg-audio bytes are not resident).
streams_db_rowid: boolPrecomputed from the layout: true if any segment is streamed from the DB
by a rowid (BinaryTag/ArtImage/OggArtSlice). Gates the transactional
content_version guard in the read fast path so plain Inline/BackingAudio
layouts pay no per-read cost (#502).