Enum rust_unixfs::file::FileError

pub enum FileError {
    LinksAndBlocksizesMismatch,
    NoLinksNoContent,
    NonRootDefinesMetadata(Metadata),
    IntermediateNodeWithoutFileSize,
    TreeExpandsOnLinks,
    TreeOverlapsBetweenLinks,
    EarlierLink,
    TreeJumpsBetweenLinks,
    UnexpectedRawOrFileProperties {
        hash_type: Option<u64>,
        fanout: Option<u64>,
    },
}

Errors which can happen while processing UnixFS type File or Raw blocks.

Variants

LinksAndBlocksizesMismatch

There are nonequal number of links and blocksizes and thus the file ranges for linked trees or blocks cannot be determined.

NoLinksNoContent

Errored when the filesize is non-zero.

NonRootDefinesMetadata(Metadata)

Unsupported: non-root block defines metadata.

IntermediateNodeWithoutFileSize

A non-leaf node in the tree has no filesize value which is used to determine the file range for this tree.

TreeExpandsOnLinks

The tree or merkle dag should only collapse or stay the same length.

TreeOverlapsBetweenLinks

The tree links contain overlapping file segments. This is at least unsupported right now, but the larger segment could be collapsed down to the reused part.

EarlierLink

Reader has been fed a link to earlier range.

TreeJumpsBetweenLinks

The tree links contain a hole from a file segment to the next tree. This is at least unsupported right now. Zeroes could be generated for the hole.

UnexpectedRawOrFileProperties

Fields

hash_type: Option<u64>

Hash type, as read from the protobuf descriptor; should only be used with HAMT directories.

fanout: Option<u64>

Fan out, as read from the protobuf descriptor; should only be used with HAMT directories.

These values should not be present for unixfs files with File or Raw. If they have a valid meaning, support for such has not been implemented.

Trait Implementations

impl Debug for FileError

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

Formats the value using the given formatter.

impl Display for FileError

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

Formats the value using the given formatter.

impl Error for FileError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, demand: &mut Demand<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.

impl From<FileError> for FileReadFailed

fn from(e: FileError) -> Self

Converts to this type from the input type.

impl PartialEq<FileError> for FileError

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for FileError

impl StructuralEq for FileError

impl StructuralPartialEq for FileError