Struct InodeUsage 

pub struct InodeUsage { /* private fields */ }

Inode occupancy of one filesystem.

A separate type from the byte figures because it answers a different question, and a classic operational surprise: a filesystem can refuse a create with ENOSPC while df shows plenty of free space, because what ran out was the inode table. Nothing else in this model can express that.

The fields are private so that the two invariants a reader relies on hold by construction: total is never zero — a filesystem with no inode table reports MetricState::Unsupported instead, never 0 of 0 (§4) — and free never exceeds total, so InodeUsage::used cannot underflow into a huge number.

Implementations

impl InodeUsage

pub const fn from_counts(total: u64, free: u64) -> MetricState<Self>

The state a statfs/statvfs (f_files, f_ffree) pair describes.

A zero total is what a filesystem with no fixed inode table reports, and many do: it is MetricState::Unsupported, because “this filesystem has no inode limit” and “0 inodes exist” are opposite claims and only the first is true (§4, §26).

pub const fn total(self) -> u64

Size of the inode table.

pub const fn free(self) -> u64

Inodes still allocatable.

pub const fn used(self) -> u64

Inodes in use: one per file, directory, symlink, and device node.

pub fn usage(self) -> Percent

Share of the inode table in use.

Infallible, unlike the byte-capacity percentage, because Self::from_counts has already rejected the zero-total case. The fallback exists only because Percent::ratio cannot see that invariant, and it is the pessimistic reading on purpose: a table whose size somehow could not be divided by is reported as full, never as empty, since “empty” is the reassuring answer and an uninterpretable count is not a reassuring situation.

Trait Implementations

impl Clone for InodeUsage

fn clone(&self) -> InodeUsage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for InodeUsage

impl Debug for InodeUsage

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

Formats the value using the given formatter.

impl Eq for InodeUsage

impl PartialEq for InodeUsage

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for InodeUsage