Files
rustfs/crates/scanner
overtrue 83c0b819bc fix(scanner): canonicalize temp_dir for drive field assertion on macOS
On macOS, /var is a symlink to /private/var. The scanner's local_disk.path()
returns the canonicalized path, but tempfile::tempdir() returns the
non-canonical /var/... path. This caused the drive field assertion in
test_scan_folder_corrupt_xl_meta_stops_erasure_data_dir_descent to fail
with a path mismatch.

Fix by canonicalizing temp_dir only for the drive field comparison,
while keeping the non-canonical path for metadata_path and failed_objects
which use the original directory walk paths.
2026-08-17 02:03:06 +08:00
..

RustFS Scanner

RustFS Scanner is the background maintenance scan loop. It handles usage accounting, lifecycle expiry and transition admission, bucket replication repair admission, scanner-driven heal/bitrot checks, and namespace alerts.

For operator-facing runtime controls, status fields, and tuning workflows, see Scanner Runtime Controls. For repeatable scanner-pressure validation, see Scanner Benchmark Runbook.

Chinese documentation is available in README.zh-CN.md.

Development

Build

cargo build --package rustfs-scanner

Test

cargo test --package rustfs-scanner

License

Apache License 2.0