Enum ipfs_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

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.

Fields of UnexpectedRawOrFileProperties

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.

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 Eq for FileError

impl Error for FileError

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

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

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

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

impl From<FileError> for FileReadFailed

fn from(e: FileError) -> Self

Performs the conversion.

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: &FileError) -> bool

This method tests for !=.

impl StructuralEq for FileError

impl StructuralPartialEq for FileError