From: Robert Obkircher <r.obkircher@proxmox.com>
To: pbs-devel@lists.proxmox.com
Subject: [PATCH v1 proxmox-backup 3/3] datastore: introduce helper function to parse digest from S3ObjectKey
Date: Mon, 13 Jul 2026 15:22:26 +0200 [thread overview]
Message-ID: <20260713132338.170565-4-r.obkircher@proxmox.com> (raw)
In-Reply-To: <20260713132338.170565-1-r.obkircher@proxmox.com>
Do not rely on the platform-specific `Path::file_name` because S3
object keys are flat identifiers that always use `/` by convention.
It would, for example, be incorrect to ignore trailing slashes (or to
treat backslashes differently on Windows).
Signed-off-by: Robert Obkircher <r.obkircher@proxmox.com>
---
pbs-datastore/src/datastore.rs | 28 ++++++------------------
pbs-datastore/src/s3.rs | 39 +++++++++++++++++++++++++++++++---
2 files changed, 43 insertions(+), 24 deletions(-)
diff --git a/pbs-datastore/src/datastore.rs b/pbs-datastore/src/datastore.rs
index bac5ce3b4..d106f5b52 100644
--- a/pbs-datastore/src/datastore.rs
+++ b/pbs-datastore/src/datastore.rs
@@ -48,7 +48,7 @@ use crate::dynamic_index::{DynamicIndexReader, DynamicIndexWriter};
use crate::fixed_index::{FixedIndexReader, FixedIndexWriter};
use crate::hierarchy::{ListGroups, ListGroupsType, ListNamespaces, ListNamespacesRecursive};
use crate::index::IndexFile;
-use crate::s3::S3_CONTENT_PREFIX;
+use crate::s3::{S3_CONTENT_PREFIX, digest_from_object_key};
use crate::task_tracking::{self, update_active_operations};
use crate::{DataBlob, LocalDatastoreLruCache};
@@ -2675,36 +2675,22 @@ impl DataStore {
&self,
object_key: &S3ObjectKey,
) -> Option<(PathBuf, [u8; 32], bool)> {
- // Check object is actually a chunk
- let path = Path::new::<str>(object_key);
- // file_name() should always be Some, as objects will have a filename
- let file_name = path.file_name()?;
- let bytes = file_name.as_bytes();
- let bad_chunk = if is_bad_chunk_suffix(&bytes[64..]) {
+ let (file_name, digest, suffix) = digest_from_object_key(object_key)?;
+
+ let bad_chunk = if is_bad_chunk_suffix(suffix.as_bytes()) {
true
- } else if bytes.len() == 64 {
+ } else if suffix.is_empty() {
false
} else {
return None; // unexpected suffix
};
- if !bytes.iter().take(64).all(u8::is_ascii_hexdigit) {
- return None;
- }
- // Safe since contains valid ascii hexdigits only as checked above.
- let digest_str = file_name.to_string_lossy();
- let hexdigit_prefix = unsafe { digest_str.get_unchecked(0..4) };
let mut chunk_path = self.base_path();
chunk_path.push(".chunks");
- chunk_path.push(hexdigit_prefix);
+ chunk_path.push(&file_name[..4]);
chunk_path.push(file_name);
- let mut digest_bytes = [0u8; 32];
- let digest = file_name.as_bytes();
- // safe to unwrap as already checked above
- hex::decode_to_slice(&digest[..64], &mut digest_bytes).unwrap();
-
- Some((chunk_path, digest_bytes, bad_chunk))
+ Some((chunk_path, digest, bad_chunk))
}
pub fn try_shared_chunk_store_lock(&self) -> Result<ProcessLockSharedGuard, Error> {
diff --git a/pbs-datastore/src/s3.rs b/pbs-datastore/src/s3.rs
index 09affc2e5..c4209d60a 100644
--- a/pbs-datastore/src/s3.rs
+++ b/pbs-datastore/src/s3.rs
@@ -1,6 +1,7 @@
use std::path::{Path, PathBuf};
use anyhow::{Error, bail, format_err};
+use hex::FromHex;
use proxmox_s3_client::{DeleteObjectError, S3ObjectKey};
@@ -48,6 +49,16 @@ pub fn object_key_from_digest_with_suffix(
S3ObjectKey::try_from(object_key_string.as_str())
}
+/// Extract filename, digest, and suffix from the last part of an S3ObjectKey.
+pub fn digest_from_object_key(key: &S3ObjectKey) -> Option<(&str, [u8; 32], &str)> {
+ let filename = key.rsplit('/').next()?;
+ let (hex_digest, suffix) = filename.split_at_checked(64)?;
+
+ let digest = FromHex::from_hex(hex_digest).ok()?;
+
+ Some((filename, digest, suffix))
+}
+
/// Log errors from delete objects api calls
pub(crate) fn log_s3_delete_objects_errors(errors: &[DeleteObjectError]) {
for error in errors {
@@ -96,7 +107,6 @@ fn test_object_key_from_path_incorrect_filename() {
#[test]
fn test_object_key_from_digest() {
- use hex::FromHex;
let digest =
<[u8; 32]>::from_hex("bb9f8df61474d25e71fa00722318cd387396ca1736605e1248821cc0de3d3af8")
.unwrap();
@@ -108,7 +118,6 @@ fn test_object_key_from_digest() {
#[test]
fn test_object_key_from_digest_with_suffix() {
- use hex::FromHex;
let digest =
<[u8; 32]>::from_hex("bb9f8df61474d25e71fa00722318cd387396ca1736605e1248821cc0de3d3af8")
.unwrap();
@@ -122,9 +131,33 @@ fn test_object_key_from_digest_with_suffix() {
#[test]
fn test_object_key_from_digest_with_invalid_suffix() {
- use hex::FromHex;
let digest =
<[u8; 32]>::from_hex("bb9f8df61474d25e71fa00722318cd387396ca1736605e1248821cc0de3d3af8")
.unwrap();
assert!(object_key_from_digest_with_suffix(&digest, "/.0.bad").is_err());
}
+
+#[test]
+fn test_digest_from_object_key() {
+ let hex = "bb9f8df61474d25e71fa00722318cd387396ca1736605e1248821cc0de3d3af8";
+ let digest = <[u8; 32]>::from_hex(hex).unwrap();
+ let k = |s: &str| S3ObjectKey::try_from(s).unwrap();
+
+ assert_eq!(digest_from_object_key(&k(&hex[1..])), None);
+ let invalid_hex = hex.replace("b", "X");
+ assert_eq!(digest_from_object_key(&k(&invalid_hex)), None);
+
+ assert_eq!(digest_from_object_key(&k(hex)), Some((hex, digest, "")));
+
+ let k1 = object_key_from_digest_with_suffix(&digest, "suffix1").unwrap();
+ assert_eq!(
+ digest_from_object_key(&k1),
+ Some((format!("{hex}suffix1").as_str(), digest, "suffix1"))
+ );
+
+ let k2 = S3ObjectKey::try_from(format!(".chunks/bb9f/{hex}.0.bad").as_str()).unwrap();
+ assert_eq!(
+ digest_from_object_key(&k2),
+ Some((format!("{hex}.0.bad").as_str(), digest, ".0.bad"))
+ );
+}
--
2.47.3
prev parent reply other threads:[~2026-07-13 13:24 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-13 13:22 [PATCH v1 proxmox-backup 0/3] improve handling of bad S3 chunks during GC Robert Obkircher
2026-07-13 13:22 ` [PATCH v1 proxmox-backup 1/3] datastore: fix local path for .i.bad chunk files during S3 GC Robert Obkircher
2026-07-13 13:22 ` [PATCH v1 proxmox-backup 2/3] datastore: check that .i.bad files from S3 actually match that pattern Robert Obkircher
2026-07-13 13:22 ` Robert Obkircher [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260713132338.170565-4-r.obkircher@proxmox.com \
--to=r.obkircher@proxmox.com \
--cc=pbs-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox