Struct ParsedEntry 

pub struct ParsedEntry<'a> {

    pub header: &'a Header,
    pub entry_type: EntryType,
    pub path: Cow<'a, [u8]>,
    pub link_target: Option<Cow<'a, [u8]>>,
    pub mode: u32,
    pub uid: u64,
    pub gid: u64,
    pub mtime: u64,
    pub size: u64,
    pub uname: Option<Cow<'a, [u8]>>,
    pub gname: Option<Cow<'a, [u8]>>,
    pub dev_major: Option<u32>,
    pub dev_minor: Option<u32>,
    pub xattrs: Vec<(Cow<'a, [u8]>, Cow<'a, [u8]>)>,
    pub pax: Option<&'a [u8]>,
}

A fully-resolved tar entry with all extensions applied.

Borrowed data comes from the input slice, so the entry is valid only as long as the input buffer is live.

Fields

header: &'a Header

The raw 512-byte header.

entry_type: EntryType

The entry type (Regular, Directory, Symlink, etc.).

path: Cow<'a, [u8]>

The resolved file path.

Priority: PAX path > GNU long name > header name (+ UStar prefix).

link_target: Option<Cow<'a, [u8]>>

The resolved link target (for symlinks and hardlinks).

Priority: PAX linkpath > GNU long link > header linkname.

mode: u32

File mode/permissions.

uid: u64

Owner UID.

gid: u64

Owner GID.

mtime: u64

Modification time as Unix timestamp.

size: u64

Content size in bytes.

uname: Option<Cow<'a, [u8]>>

User name.

gname: Option<Cow<'a, [u8]>>

Group name.

dev_major: Option<u32>

Device major number (for block/char devices).

dev_minor: Option<u32>

Device minor number (for block/char devices).

xattrs: Vec<(Cow<'a, [u8]>, Cow<'a, [u8]>)>

Extended attributes from PAX SCHILY.xattr.* entries.

pax: Option<&'a [u8]>

Raw PAX extended header data, if a PAX 'x' entry preceded this entry.

This is the unprocessed content of the PAX extension entry, preserved so that callers can iterate all PAX key-value pairs (not just the ones tar-core resolves into struct fields). Parse it with PaxExtensions::new.

Implementations

impl<'a> ParsedEntry<'a>

pub fn path_lossy(&self) -> Cow<'_, str>

Get the path as a lossy UTF-8 string.

pub fn link_target_lossy(&self) -> Option<Cow<'_, str>>

Get the link target as a lossy UTF-8 string, if present.

pub fn is_file(&self) -> bool

Check if this is a regular file.

pub fn is_dir(&self) -> bool

Check if this is a directory.

pub fn is_symlink(&self) -> bool

Check if this is a symbolic link.

pub fn is_hard_link(&self) -> bool

Check if this is a hard link.

pub fn padded_size(&self) -> u64

Get the padded size (rounded up to block boundary).

Trait Implementations

impl<'a> Debug for ParsedEntry<'a>

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

Formats the value using the given formatter.