Struct StorageFragmentationAnalyzer 

pub struct StorageFragmentationAnalyzer {
    pub extents: Vec<StorageExtent>,
}

Analyzes storage layout to detect fragmentation, recommend defragmentation targets, and estimate compaction savings.

Extents are maintained in ascending start_offset order at all times.

Fields

extents: Vec<StorageExtent>

Storage extents, always sorted by start_offset.

Implementations

impl StorageFragmentationAnalyzer

pub fn new() -> Self

Create a new, empty analyzer.

pub fn add_extent(&mut self, extent: StorageExtent)

Add an extent, maintaining sorted order by start_offset.

pub fn free_extent(&mut self, cid: &str)

Mark the extent whose CID matches cid as free space.

If no extent matches, this is a no-op.

pub fn analyze(&self) -> FragmentationReport

Walk all extents and compute fragmentation statistics.

pub fn compaction_plan(&self) -> Vec<CompactionCandidate>

Compute which live blocks would need to move to achieve a fully left-packed layout, ordered by descending bytes_saved.

Only blocks whose target_offset is strictly less than current_offset are included.

pub fn merge_free_extents(&mut self)

Merge adjacent free extents into a single larger free extent.

After this call the extent list is still sorted by start_offset.

pub fn total_extents(&self) -> usize

Return the total number of extents (used and free).

Trait Implementations

impl Default for StorageFragmentationAnalyzer

fn default() -> Self

Returns the “default value” for a type.