Struct FxarReader 

pub struct FxarReader<R: Read + Seek> {
    pub header: FxarHeader,
    /* private fields */
}

Read an FXAR v2 archive with random access.

Fields

header: FxarHeader

Implementations

impl<R: Read + Seek> FxarReader<R>

pub fn open(reader: R) -> Result<Self>

Open an FXAR v2 archive for reading.

Automatically handles streaming-mode archives whose header has placeholder offsets (manifest_offset=0, index_offset=0) by falling back to the footer.

pub fn read_manifest(&mut self) -> Result<FxarManifest>

Read and parse the manifest.

pub fn read_chunk_index(&mut self) -> Result<Vec<ChunkIndexEntry>>

Read the chunk index.

pub fn restore_file(&mut self, file_path: &str) -> Result<Vec<u8>>

Restore a single file by path from the archive.

pub fn restore_file_head( &mut self, file_path: &str, max_bytes: usize, ) -> Result<Vec<u8>>

Read the first max_bytes of a file from the archive without verifying the whole-file BLAKE3 hash (partial reads cannot be hash-verified). Per-chunk BLAKE3 is still checked.

Returns fewer than max_bytes if the file is smaller.

pub fn restore_all( &mut self, target: &Path, generate_sigs: bool, ) -> Result<FxarImportStats>

Restore all files to a target directory.

Pipelined: chunk loading overlaps with file writing. Producer thread reads chunks sequentially; consumer rayon threads write files as soon as their chunks become available.

pub fn restore_latest( &mut self, target: &Path, generate_sigs: bool, verbose: bool, ) -> Result<FxarImportStats>

Restore latest version of each file, stripping {snapshot}/tree/ prefix.

Default restore mode – behaves like tar -xvf. When an archive contains multiple snapshots with the same file, only the most recent version is extracted. Output paths are flat relative paths (no snapshot prefix).

When verbose is true, prints per-file version info to stderr.

pub fn list_files(&mut self) -> Result<Vec<FxarManifestEntry>>

List all files in the archive without extracting.

pub fn read_extension_directory( &mut self, ) -> Result<Option<FxarExtensionDirectory>>

pub fn read_extension_section( &mut self, section_type: u32, ) -> Result<Option<Vec<u8>>>