pub struct VolumeFill {
pub used_sectors: u16,
pub free_sectors: u16,
pub total_sectors: u16,
pub entries: u32,
}Expand description
How much room is left on a log, and how close it is to overwriting.
Built from DbStats by from_stats, and reached
through TieredDb::volume_fill.
§Why this matters more on a removable volume
Under WritePolicy::OnboardFirst
a full volume wraps and overwrites its own oldest copy of data the onboard
log may still hold — bad, but recoverable. Under
CardFirst the volume holds the
only copy of everything past the point it took over, so wrapping is real
loss. Neither is reported as an error at the time it happens, because the
ring overwriting its tail is normal operation for a log. Watching this is how
an operator learns the swap window is closing while there is still time to
swap.
Fields§
§used_sectors: u16Sectors holding data — sealed, plus the one being written.
free_sectors: u16Sectors still erased. Writes have this much room before the ring starts reclaiming sectors that hold data.
total_sectors: u16Sectors in the volume’s database region.
entries: u32Entries the volume holds.
Implementations§
Source§impl VolumeFill
impl VolumeFill
Sourcepub fn from_stats(stats: &DbStats) -> Self
pub fn from_stats(stats: &DbStats) -> Self
Summarise a volume’s statistics.
Sourcepub fn used_permille(&self) -> u16
pub fn used_permille(&self) -> u16
Fraction of the region holding data, in tenths of a percent (0..=1000).
Tenths rather than percent because a large card has enough sectors that whole percent is a coarse warning, and this crate cannot use floats. Zero when the geometry is empty.
Sourcepub fn will_overwrite(&self) -> bool
pub fn will_overwrite(&self) -> bool
No erased sectors remain, so the next sector rotation reclaims one that holds data.
The last moment at which swapping the medium still costs nothing: the
sector being written is not full yet, so this warns of loss rather than
reporting it. A volume configured with enough reserved sectors refuses
the write with NoSpace instead of overwriting, which is louder but
arrives just as late.
Trait Implementations§
Source§impl Clone for VolumeFill
impl Clone for VolumeFill
impl Copy for VolumeFill
Source§impl Debug for VolumeFill
impl Debug for VolumeFill
Source§impl Default for VolumeFill
impl Default for VolumeFill
impl Eq for VolumeFill
Source§impl Format for VolumeFill
Available on crate feature defmt only.
impl Format for VolumeFill
defmt only.