148 lines
4.8 KiB
Rust
148 lines
4.8 KiB
Rust
#![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<u64> {
|
|
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::<u64>() {
|
|
Ok(result) => result,
|
|
Err(_) => return None,
|
|
};
|
|
return Some(result);
|
|
}
|
|
None
|
|
}
|
|
|
|
impl<'entry> Iterator for PaxExtensions<'entry> {
|
|
type Item = io::Result<PaxExtension<'entry>>;
|
|
|
|
fn next(&mut self) -> Option<io::Result<PaxExtension<'entry>>> {
|
|
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::<usize>().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
|
|
}
|
|
}
|