Struct tar::Entry [−][src]
A read-only view into an entry of an archive.
This structure is a window into a portion of a borrowed archive which can be inspected. It acts as a file handle by implementing the Reader trait. An entry cannot be rewritten once inserted into an archive.
Implementations
impl<'a, R: Read> Entry<'a, R>
[src]
pub fn path(&self) -> Result<Cow<'_, Path>>
[src]
Returns the path name for this entry.
This method may fail if the pathname is not valid Unicode and this is called on a Windows platform.
Note that this function will convert any \
characters to directory
separators, and it will not always return the same value as
self.header().path()
as some archive formats have support for longer
path names described in separate entries.
It is recommended to use this method instead of inspecting the header
directly to ensure that various archive formats are handled correctly.
pub fn path_bytes(&self) -> Cow<'_, [u8]>
[src]
Returns the raw bytes listed for this entry.
Note that this function will convert any \
characters to directory
separators, and it will not always return the same value as
self.header().path_bytes()
as some archive formats have support for
longer path names described in separate entries.
pub fn link_name(&self) -> Result<Option<Cow<'_, Path>>>
[src]
Returns the link name for this entry, if any is found.
This method may fail if the pathname is not valid Unicode and this is
called on a Windows platform. Ok(None)
being returned, however,
indicates that the link name was not present.
Note that this function will convert any \
characters to directory
separators, and it will not always return the same value as
self.header().link_name()
as some archive formats have support for
longer path names described in separate entries.
It is recommended to use this method instead of inspecting the header
directly to ensure that various archive formats are handled correctly.
pub fn link_name_bytes(&self) -> Option<Cow<'_, [u8]>>
[src]
Returns the link name for this entry, in bytes, if listed.
Note that this will not always return the same value as
self.header().link_name_bytes()
as some archive formats have support for
longer path names described in separate entries.
pub fn pax_extensions(&mut self) -> Result<Option<PaxExtensions<'_>>>
[src]
Returns an iterator over the pax extensions contained in this entry.
Pax extensions are a form of archive where extra metadata is stored in key/value pairs in entries before the entry they’re intended to describe. For example this can be used to describe long file name or other metadata like atime/ctime/mtime in more precision.
The returned iterator will yield key/value pairs for each extension.
None
will be returned if this entry does not indicate that it itself
contains extensions, or if there were no previous extensions describing
it.
Note that global pax extensions are intended to be applied to all archive entries.
Also note that this function will read the entire entry if the entry itself is a list of extensions.
pub fn header(&self) -> &Header
[src]
Returns access to the header of this entry in the archive.
This provides access to the metadata for this entry in the archive.
pub fn size(&self) -> u64
[src]
Returns access to the size of this entry in the archive.
In the event the size is stored in a pax extension, that size value will be referenced. Otherwise, the entry size will be stored in the header.
pub fn raw_header_position(&self) -> u64
[src]
Returns the starting position, in bytes, of the header of this entry in the archive.
The header is always a contiguous section of 512 bytes, so if the
underlying reader implements Seek
, then the slice from header_pos
to
header_pos + 512
contains the raw header bytes.
pub fn raw_file_position(&self) -> u64
[src]
Returns the starting position, in bytes, of the file of this entry in the archive.
If the file of this entry is continuous (e.g. not a sparse file), and
if the underlying reader implements Seek
, then the slice from
file_pos
to file_pos + entry_size
contains the raw file bytes.
pub fn unpack<P: AsRef<Path>>(&mut self, dst: P) -> Result<Unpacked>
[src]
Writes this file to the specified location.
This function will write the entire contents of this file into the
location specified by dst
. Metadata will also be propagated to the
path dst
.
This function will create a file at the path dst
, and it is required
that the intermediate directories are created. Any existing file at the
location dst
will be overwritten.
Note: This function does not have as many sanity checks as
Archive::unpack
orEntry::unpack_in
. As a result if you’re thinking of unpacking untrusted tarballs you may want to review the implementations of the previous two functions and perhaps implement similar logic yourself.
Examples
use std::fs::File; use tar::Archive; let mut ar = Archive::new(File::open("foo.tar").unwrap()); for (i, file) in ar.entries().unwrap().enumerate() { let mut file = file.unwrap(); file.unpack(format!("file-{}", i)).unwrap(); }
pub fn unpack_in<P: AsRef<Path>>(&mut self, dst: P) -> Result<bool>
[src]
Extracts this file under the specified path, avoiding security issues.
This function will write the entire contents of this file into the
location obtained by appending the path of this file in the archive to
dst
, creating any intermediate directories if needed. Metadata will
also be propagated to the path dst
. Any existing file at the location
dst
will be overwritten.
This function carefully avoids writing outside of dst
. If the file has
a ‘..’ in its path, this function will skip it and return false.
Examples
use std::fs::File; use tar::Archive; let mut ar = Archive::new(File::open("foo.tar").unwrap()); for (i, file) in ar.entries().unwrap().enumerate() { let mut file = file.unwrap(); file.unpack_in("target").unwrap(); }
pub fn set_unpack_xattrs(&mut self, unpack_xattrs: bool)
[src]
Indicate whether extended file attributes (xattrs on Unix) are preserved when unpacking this entry.
This flag is disabled by default and is currently only implemented on Unix using xattr support. This may eventually be implemented for Windows, however, if other archive implementations are found which do this as well.
pub fn set_preserve_permissions(&mut self, preserve: bool)
[src]
Indicate whether extended permissions (like suid on Unix) are preserved when unpacking this entry.
This flag is disabled by default and is currently only implemented on Unix.
pub fn set_preserve_mtime(&mut self, preserve: bool)
[src]
Indicate whether access time information is preserved when unpacking this entry.
This flag is enabled by default.
Trait Implementations
impl<'a, R: Read> Read for Entry<'a, R>
[src]
fn read(&mut self, into: &mut [u8]) -> Result<usize>
[src]
pub fn read_vectored(
&mut self,
bufs: &mut [IoSliceMut<'_>]
) -> Result<usize, Error>
1.36.0[src]
&mut self,
bufs: &mut [IoSliceMut<'_>]
) -> Result<usize, Error>
pub fn is_read_vectored(&self) -> bool
[src]
pub unsafe fn initializer(&self) -> Initializer
[src]
pub fn read_to_end(&mut self, buf: &mut Vec<u8, Global>) -> Result<usize, Error>
1.0.0[src]
pub fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
1.0.0[src]
pub fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
1.6.0[src]
pub fn by_ref(&mut self) -> &mut Self
1.0.0[src]
pub fn bytes(self) -> Bytes<Self>
1.0.0[src]
pub fn chain<R>(self, next: R) -> Chain<Self, R> where
R: Read,
1.0.0[src]
R: Read,
pub fn take(self, limit: u64) -> Take<Self>
1.0.0[src]
Auto Trait Implementations
impl<'a, R> !RefUnwindSafe for Entry<'a, R>
impl<'a, R> !Send for Entry<'a, R>
impl<'a, R> !Sync for Entry<'a, R>
impl<'a, R> Unpin for Entry<'a, R>
impl<'a, R> !UnwindSafe for Entry<'a, R>
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,