Enum IoSite 

#[non_exhaustive]
pub enum IoSite {
    Dir,
    Segment(PathBuf),
    Unknown,
}

Which filesystem site an SegmentError::Io failure happened on.

Replaces the pre-v0.5.0 Option<PathBuf> on the Io variant with an explicit enumeration: directory operations (create_dir_all, scan, clean_tmp, dir fsync), segment-file operations (read/write/rename), and the catch-all for ?-propagated io::Errors that have not yet been tagged with context.

Dir carries no path: the directory is reachable via crate::SegmentBuffer::path, so the variant just records the kind of operation that failed. Segment carries the offending segment’s path so an operator can quarantine, alert, or move it aside without re-deriving it. Unknown is what ? produces before any high-value call site upgrades the error with SegmentError::with_path or SegmentError::with_dir.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Dir

The failure happened on the segment directory itself (create_dir_all, scan, clean_tmp, directory fsync). The directory path is reachable via crate::SegmentBuffer::path.

Segment(PathBuf)

The failure happened on a specific segment file. Carries the file’s path so an operator can act on it (move aside, quarantine, alert) without re-deriving it.

Unknown

The failure has no specific site attached — typically an io::Error propagated via ? before a high-value call site has upgraded it via SegmentError::with_path or SegmentError::with_dir.

Trait Implementations

impl Clone for IoSite

fn clone(&self) -> IoSite

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IoSite

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

Formats the value using the given formatter.

impl Eq for IoSite

impl PartialEq for IoSite

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IoSite