Enum ParseError 

pub enum ParseError {
    Io(Error),
    Header(HeaderError),
    Pax(PaxError),
    InvalidUtf8(Utf8Error),
    PathTooLong {
        len: usize,
        limit: u32,
    },
    MetadataTooLarge {
        size: u64,
        limit: u32,
    },
    DuplicateGnuLongName,
    DuplicateGnuLongLink,
    DuplicatePaxHeader,
    OrphanedMetadata,
    TooManyPendingEntries {
        count: usize,
        limit: usize,
    },
    TooManySparseEntries {
        count: usize,
        limit: usize,
    },
    SparseNotGnu,
    InvalidPaxSparseMap(Cow<'static, str>),
    InvalidPaxValue {
        key: &'static str,
        value: Cow<'static, str>,
    },
    EmptyPath,
    InvalidSize(u64),
    UnexpectedEof {
        pos: u64,
    },
}

Errors that can occur during tar archive parsing.

Variants

Io(Error)

I/O error from the underlying reader.

Header(HeaderError)

Header parsing error (checksum, invalid octal, etc.).

Pax(PaxError)

PAX extension parsing error.

InvalidUtf8(Utf8Error)

Invalid UTF-8 in PAX key.

PathTooLong

Path exceeds configured maximum length.

Fields

len: usize

Actual path length.

limit: u32

Configured limit.

MetadataTooLarge

Extension metadata exceeds configured maximum size.

The aggregate size of all extension data (PAX headers, GNU long name/link) for a single entry exceeded Limits::max_metadata_size.

Fields

size: u64

Total metadata size that would result.

limit: u32

Configured limit.

DuplicateGnuLongName

Duplicate GNU long name entry without an intervening actual entry.

DuplicateGnuLongLink

Duplicate GNU long link entry without an intervening actual entry.

DuplicatePaxHeader

Duplicate PAX extended header without an intervening actual entry.

OrphanedMetadata

Metadata entries (GNU long name, PAX, etc.) found but no actual entry followed.

TooManyPendingEntries

Too many consecutive metadata entries (possible infinite loop or malicious archive).

Fields

count: usize

Number of pending metadata entries.

limit: usize

Configured limit.

TooManySparseEntries

Too many sparse entries (possible denial-of-service attack).

Fields

count: usize

Number of sparse entries found.

limit: usize

Configured limit.

SparseNotGnu

Sparse entry type present but header is not GNU format.

InvalidPaxSparseMap(Cow<'static, str>)

A PAX sparse map field is malformed.

InvalidPaxValue

A PAX extension value failed to parse.

Fields

key: &'static str

The PAX key (e.g. “uid”, “size”).

value: Cow<'static, str>

The raw value string.

EmptyPath

Entry path is empty after applying all overrides (GNU long name, PAX path, etc.).

InvalidSize(u64)

Entry size in header is invalid (e.g., overflow when computing padded size).

UnexpectedEof

Unexpected EOF while reading entry content or padding.

Fields

pos: u64

Position in the stream where EOF occurred.

Trait Implementations

impl Debug for ParseError

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

Formats the value using the given formatter.

impl Display for ParseError

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

Formats the value using the given formatter.

impl Error for ParseError

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

Returns 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, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<Error> for ParseError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<HeaderError> for ParseError

fn from(source: HeaderError) -> Self

Converts to this type from the input type.

impl From<PaxError> for ParseError

fn from(source: PaxError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for ParseError

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.