#![allow(dead_code)] use std::io; use std::slice; use std::str; use crate::other; // Keywords for PAX extended header records. pub const PAX_NONE: &str = ""; // Indicates that no PAX key is suitable pub const PAX_PATH: &str = "path"; pub const PAX_LINKPATH: &str = "linkpath"; pub const PAX_SIZE: &str = "size"; pub const PAX_UID: &str = "uid"; pub const PAX_GID: &str = "gid"; pub const PAX_UNAME: &str = "uname"; pub const PAX_GNAME: &str = "gname"; pub const PAX_MTIME: &str = "mtime"; pub const PAX_ATIME: &str = "atime"; pub const PAX_CTIME: &str = "ctime"; // Removed from later revision of PAX spec, but was valid pub const PAX_CHARSET: &str = "charset"; // Currently unused pub const PAX_COMMENT: &str = "comment"; // Currently unused pub const PAX_SCHILYXATTR: &str = "SCHILY.xattr."; // Keywords for GNU sparse files in a PAX extended header. pub const PAX_GNUSPARSE: &str = "GNU.sparse."; pub const PAX_GNUSPARSENUMBLOCKS: &str = "GNU.sparse.numblocks"; pub const PAX_GNUSPARSEOFFSET: &str = "GNU.sparse.offset"; pub const PAX_GNUSPARSENUMBYTES: &str = "GNU.sparse.numbytes"; pub const PAX_GNUSPARSEMAP: &str = "GNU.sparse.map"; pub const PAX_GNUSPARSENAME: &str = "GNU.sparse.name"; pub const PAX_GNUSPARSEMAJOR: &str = "GNU.sparse.major"; pub const PAX_GNUSPARSEMINOR: &str = "GNU.sparse.minor"; pub const PAX_GNUSPARSESIZE: &str = "GNU.sparse.size"; pub const PAX_GNUSPARSEREALSIZE: &str = "GNU.sparse.realsize"; /// An iterator over the pax extensions in an archive entry. /// /// This iterator yields structures which can themselves be parsed into /// key/value pairs. pub struct PaxExtensions<'entry> { data: slice::Split<'entry, u8, fn(&u8) -> bool>, } impl<'entry> PaxExtensions<'entry> { /// Create new pax extensions iterator from the given entry data. pub fn new(a: &'entry [u8]) -> Self { fn is_newline(a: &u8) -> bool { *a == b'\n' } PaxExtensions { data: a.split(is_newline), } } } /// A key/value pair corresponding to a pax extension. pub struct PaxExtension<'entry> { key: &'entry [u8], value: &'entry [u8], } pub fn pax_extensions_value(a: &[u8], key: &str) -> Option { for extension in PaxExtensions::new(a) { let current_extension = match extension { Ok(ext) => ext, Err(_) => return None, }; if current_extension.key() != Ok(key) { continue; } let value = match current_extension.value() { Ok(value) => value, Err(_) => return None, }; let result = match value.parse::() { Ok(result) => result, Err(_) => return None, }; return Some(result); } None } impl<'entry> Iterator for PaxExtensions<'entry> { type Item = io::Result>; fn next(&mut self) -> Option>> { let line = match self.data.next() { Some(line) if line.is_empty() => return None, Some(line) => line, None => return None, }; Some( line.iter() .position(|b| *b == b' ') .and_then(|i| { str::from_utf8(&line[..i]) .ok() .and_then(|len| len.parse::().ok().map(|j| (i + 1, j))) }) .and_then(|(kvstart, reported_len)| { if line.len() + 1 == reported_len { line[kvstart..] .iter() .position(|b| *b == b'=') .map(|equals| (kvstart, equals)) } else { None } }) .map(|(kvstart, equals)| PaxExtension { key: &line[kvstart..kvstart + equals], value: &line[kvstart + equals + 1..], }) .ok_or_else(|| other("malformed pax extension")), ) } } impl<'entry> PaxExtension<'entry> { /// Returns the key for this key/value pair parsed as a string. /// /// May fail if the key isn't actually utf-8. pub fn key(&self) -> Result<&'entry str, str::Utf8Error> { str::from_utf8(self.key) } /// Returns the underlying raw bytes for the key of this key/value pair. pub fn key_bytes(&self) -> &'entry [u8] { self.key } /// Returns the value for this key/value pair parsed as a string. /// /// May fail if the value isn't actually utf-8. pub fn value(&self) -> Result<&'entry str, str::Utf8Error> { str::from_utf8(self.value) } /// Returns the underlying raw bytes for this value of this key/value pair. pub fn value_bytes(&self) -> &'entry [u8] { self.value } }