Struct IndexStats 

pub struct IndexStats {

    pub volume: String,
    pub entries: u64,
    pub live_entries: u64,
    pub tombstones: u64,
    pub name_pool_bytes: u64,
    pub lower_pool_bytes: u64,
    pub offsets_bytes: u64,
    pub parent_bytes: u64,
    pub size_bytes: u64,
    pub mtime_bytes: u64,
    pub frn_bytes: u64,
    pub flag_bytes: u64,
    pub permutations_bytes: u64,
    pub frn_map_bytes: u64,
    pub dead_name_bytes: u64,
    pub pool_garbage_ratio: f64,
    pub derived_cache_bytes: u64,
    pub total_bytes: u64,
    pub bytes_per_entry: f64,
    pub content_generation: u64,
    pub structural_generation: u64,
}

Per-column memory accounting for one volume index.

Fields

volume: String

The volume this index covers (e.g. “C:”).

entries: u64

Total rows in the index (live + tombstones).

live_entries: u64

Number of live (non-tombstoned) rows.

tombstones: u64

Number of tombstoned (deleted) rows.

name_pool_bytes: u64

Bytes held by the original-case name pool.

lower_pool_bytes: u64

Bytes held by the case-folded (lowercase) name pool.

offsets_bytes: u64

Bytes held by the name-pool offset table.

parent_bytes: u64

Bytes held by the parent-pointer column.

size_bytes: u64

Bytes held by the file-size column.

mtime_bytes: u64

Bytes held by the modification-time column.

frn_bytes: u64

Bytes held by the File Reference Number column.

flag_bytes: u64

Bytes held by the per-entry flag column.

permutations_bytes: u64

Bytes held by the sort permutations.

frn_map_bytes: u64

Bytes held by the FRN-to-row lookup map.

dead_name_bytes: u64

Abandoned name bytes across both pools (tombstoned rows, in-place dir renames: the folded copy always, the original copy when one existed) — the reclaimable garbage. Compaction-trigger input; a lower bound right after a snapshot restore.

pool_garbage_ratio: f64

dead_name_bytes / (name_pool + lower_pool).

derived_cache_bytes: u64

Generation-cached query accelerators (offset table, dir-path memo). Part of the bytes/entry gate — they live in the engine process.

total_bytes: u64

Total resident bytes for this index (sum of all columns + caches).

bytes_per_entry: f64

total_bytes / entries — the bytes/entry gate metric.

content_generation: u64

Content generation counter (bumps on name/data changes).

structural_generation: u64

Structural generation counter (bumps on add/remove/rename).

Implementations

impl IndexStats

pub fn add_derived_bytes(&mut self, bytes: u64)

Fold the derived-cache footprint in (the index module cannot compute it itself — the cached types belong to the query layer).

Trait Implementations

impl Clone for IndexStats

fn clone(&self) -> IndexStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IndexStats

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

Formats the value using the given formatter.

impl Default for IndexStats

fn default() -> IndexStats

Returns the “default value” for a type.

impl Serialize for IndexStats

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.