Struct ExtentMap 

pub struct ExtentMap {
    pub len: u64,
    pub extents: Vec<(u64, u64)>,
}

Allocation map of a file: logical length plus sorted, non-overlapping, byte-granular data extents.

Fields

len: u64

Logical (apparent) file size in bytes.

extents: Vec<(u64, u64)>

Sorted (offset, length) allocated ranges. Everything outside them reads as zeros.

Implementations

impl ExtentMap

pub fn scan(path: &Path) -> Result<Option<ExtentMap>>

Scan path’s allocation map.

Returns Ok(None) when the filesystem cannot enumerate extents (no SEEK_DATA / allocated-ranges support); callers should then treat the file as fully dense. A dense file on a capable filesystem scans as Some with a single (0, len) extent.

Blocking. Callers in async contexts should wrap in tokio::task::spawn_blocking.

pub fn scan_file(file: &File) -> Result<Option<ExtentMap>>

ExtentMap::scan over an already-open file.

pub fn data_bytes(&self) -> u64

Sum of extent lengths — the bytes a sparse-aware reader must actually move.

pub fn has_holes(&self) -> bool

True when some of the logical range is unallocated.

Trait Implementations

impl Clone for ExtentMap

fn clone(&self) -> ExtentMap

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExtentMap

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ExtentMap

impl PartialEq for ExtentMap

fn eq(&self, other: &ExtentMap) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ExtentMap