Struct FileSectorSource 

pub struct FileSectorSource { /* private fields */ }

SectorSource backed by a file (ISO image). Every read_sectors call is a direct seek + read_exact against the underlying file — kernel readahead handles prefetch, and every [READ_DROP_CHUNK_BYTES_DEFAULT] bytes of consumed data the platform’s DONTNEED hook drops the consumed window from the page cache to bound memory pressure.

Implementations

impl FileSectorSource

pub fn open(path: &Path) -> Result<Self>

Open an existing ISO file for reading. Capacity is derived from metadata().len() / 2048. Returns Error::IsoTooLarge if the file would exceed the 32-bit LBA address space (~8 TB).

Issues the platform’s “sequential access expected” hint on the fd (Linux posix_fadvise(SEQUENTIAL), macOS fcntl(F_RDADVISE), Windows TODO stub) so the kernel’s readahead widens.

Trait Implementations

impl SectorSource for FileSectorSource

fn capacity_sectors(&self) -> u32

Total capacity in sectors, if known. Default 0 = unknown (e.g. live drives that haven’t completed READ CAPACITY yet).

fn read_sectors( &mut self, lba: u32, count: u16, out: &mut [u8], _recovery: bool, ) -> Result<usize>

Read count sectors starting at lba into buf. buf must be at least count * 2048 bytes. recovery: true = full retry/reset loop (ripping), false = single attempt (verify). File-backed sources ignore the flag.

fn set_speed(&mut self, _kbs: u16)

Optional speed control for sources that map to a physical drive. No-op for everything else.