Struct GnuHeader

#[repr(C)]
pub struct GnuHeader {

    pub name: [u8; 100],
    pub mode: [u8; 8],
    pub uid: [u8; 8],
    pub gid: [u8; 8],
    pub size: [u8; 12],
    pub mtime: [u8; 12],
    pub cksum: [u8; 8],
    pub typeflag: [u8; 1],
    pub linkname: [u8; 100],
    pub magic: [u8; 6],
    pub version: [u8; 2],
    pub uname: [u8; 32],
    pub gname: [u8; 32],
    pub dev_major: [u8; 8],
    pub dev_minor: [u8; 8],
    pub atime: [u8; 12],
    pub ctime: [u8; 12],
    pub offset: [u8; 12],
    pub longnames: [u8; 4],
    pub unused: [u8; 1],
    pub sparse: [GnuSparseHeader; 4],
    pub isextended: [u8; 1],
    pub realsize: [u8; 12],
    pub pad: [u8; 17],
}

Representation of the header of an entry in an archive

Fields

name: [u8; 100]

mode: [u8; 8]

uid: [u8; 8]

gid: [u8; 8]

size: [u8; 12]

mtime: [u8; 12]

cksum: [u8; 8]

typeflag: [u8; 1]

linkname: [u8; 100]

magic: [u8; 6]

version: [u8; 2]

uname: [u8; 32]

gname: [u8; 32]

dev_major: [u8; 8]

dev_minor: [u8; 8]

atime: [u8; 12]

ctime: [u8; 12]

offset: [u8; 12]

longnames: [u8; 4]

unused: [u8; 1]

sparse: [GnuSparseHeader; 4]

isextended: [u8; 1]

realsize: [u8; 12]

pad: [u8; 17]

Implementations

impl GnuHeader

pub fn username_bytes(&self) -> &[u8]

See Header::username_bytes

pub fn set_username(&mut self, name: &str) -> Result<(), Error>

See Header::set_username

pub fn groupname_bytes(&self) -> &[u8]

See Header::groupname_bytes

pub fn set_groupname(&mut self, name: &str) -> Result<(), Error>

See Header::set_groupname

pub fn device_major(&self) -> Result<u32, Error>

See Header::device_major

pub fn set_device_major(&mut self, major: u32)

See Header::set_device_major

pub fn device_minor(&self) -> Result<u32, Error>

See Header::device_minor

pub fn set_device_minor(&mut self, minor: u32)

See Header::set_device_minor

pub fn atime(&self) -> Result<u64, Error>

Returns the last modification time in Unix time format

pub fn set_atime(&mut self, atime: u64)

Encodes the atime provided into this header.

Note that this time is typically a number of seconds passed since January 1, 1970.

pub fn ctime(&self) -> Result<u64, Error>

Returns the last modification time in Unix time format

pub fn set_ctime(&mut self, ctime: u64)

Encodes the ctime provided into this header.

Note that this time is typically a number of seconds passed since January 1, 1970.

pub fn real_size(&self) -> Result<u64, Error>

Returns the “real size” of the file this header represents.

This is applicable for sparse files where the returned size here is the size of the entire file after the sparse regions have been filled in.

pub fn set_real_size(&mut self, real_size: u64)

Encodes the real_size provided into this header.

pub fn is_extended(&self) -> bool

Indicates whether this header will be followed by additional sparse-header records.

Note that this is handled internally by this library, and is likely only interesting if a raw iterator is being used.

pub fn set_is_extended(&mut self, is_extended: bool)

Sets whether this header should be followed by additional sparse-header records.

To append a sparse std::fs::File to an archive, prefer using the crate::Builder instead.

pub fn as_header(&self) -> &Header

Views this as a normal Header

pub fn as_header_mut(&mut self) -> &mut Header

Views this as a normal Header

Trait Implementations

impl Debug for GnuHeader

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

Formats the value using the given formatter.