use tracing::trace;
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(super) enum Charset {
Unknown,
Utf8,
Iso8859p1,
}
#[inline]
pub(super) fn validate_utf8(bytes: &[u8]) -> Option<String> {
std::str::from_utf8(bytes).ok().map(|s| s.to_owned())
}
pub(super) fn iso8859p1_to_utf8(src: &[u8]) -> Option<String> {
let mut out = String::with_capacity(src.len() * 2);
for &c in src {
if c >= 0xa0 {
out.push(c as char);
} else if (0x80..=0x9f).contains(&c) {
return None;
} else {
out.push(c as char);
}
}
Some(out)
}
pub(super) fn is_dir_traversal(s: &str) -> bool {
if s.is_empty() {
return false;
}
for c in s.bytes() {
if c <= 0x1f || c == 0x7f {
return true;
}
}
s == "."
|| s == ".."
|| s.starts_with('/')
|| s.starts_with("./")
|| s.starts_with("../")
|| s.contains("/../")
|| s.contains("/./")
|| s.ends_with('/')
|| s.ends_with("/.")
|| s.ends_with("/..")
|| s.contains('\\')
}
pub(super) fn decode_filename_ascii(bytes: &[u8], default_utf8: bool) -> Option<String> {
if bytes.is_empty() {
return None;
}
let decoded = if default_utf8 {
validate_utf8(bytes)
} else {
iso8859p1_to_utf8(bytes)
}?;
if is_dir_traversal(&decoded) {
trace!(filename = %decoded, "decode_filename_ascii: rejected due to directory traversal");
None
} else {
Some(decoded)
}
}
pub(super) fn decode_filename_ext(bytes: &[u8], charset: Charset) -> Option<String> {
if bytes.is_empty() {
return None;
}
let decoded = match charset {
Charset::Utf8 => validate_utf8(bytes)?,
Charset::Iso8859p1 => iso8859p1_to_utf8(bytes)?,
Charset::Unknown => {
validate_utf8(bytes).or_else(|| iso8859p1_to_utf8(bytes))?
}
};
if is_dir_traversal(&decoded) {
trace!(filename = %decoded, "decode_filename_ext: rejected due to directory traversal");
return None;
}
Some(decoded)
}