Expand description
Live USN-journal session: volume handle, FSCTL wrappers, blocking reads and the per-file stat fetcher.
This is the only OS-facing part of the usn module — everything above it
works on parsed records.
Structs§
- UsnJournal
- An open USN journal positioned for tailing: the volume handle plus the current replay cursor.
- Volume
Stat Fetcher - Live stat fetcher: opens the file by FRN on the same volume and reads size + mtime. Read-only, never follows the open with any mutation.
Enums§
- Journal
Gone - Why the journal can no longer be tailed; all of these mean “fall back to a full rescan” (docs/RESEARCH.md established practice).
- Query
Err 🔒 - Read
Outcome - Result of one blocking journal read: either a parsed batch of records or a recoverable signal that the journal can no longer be tailed.
- UsnError
- Hard failure from the OS-facing journal/volume layer (unrecoverable here;
distinct from the recoverable journal-gone conditions in
JournalGone).
Functions§
- open_
volume_ 🔒handle - raw 🔒
- wide 🔒