vsc-core 0.1.0

Reader for Windows Volume Shadow Copy (VSS) store/catalog structures
Documentation

vsc-core — Windows Volume Shadow Copy (VSS) reader

A panic-free decoder for the on-disk structures of Windows Volume Shadow Copy (VSS), the [P^H] disk-history substrate of the forensic fleet. Given a positioned Read + Seek over an NTFS volume (offset 0 = the NTFS boot sector), [VssVolume::open] reads the VSS volume header at byte offset 0x1E00, walks the catalog of shadow-copy stores, and exposes each store's [StoreInfo] on demand.

The reader stays pure: it decodes bytes into typed records and makes no forensic judgments (those live in the sibling vsc-forensic analyzer). It never loads the whole volume into memory — the real volumes are hundreds of gigabytes — and every multi-byte read is bounds-checked, so malformed input yields safe defaults or a typed [VssError], never a panic.

Phase 1 (this crate) enumerates stores and decodes store information plus the typed diff-area records ([BlockDescriptor], [StoreBlockRange]). The copy-on-write block-reconstruction engine is Phase 2 and out of scope here.