mirror of https://github.com/rustfs/rustfs.git synced 2026-07-26 08:18:18 +00:00

Files

T

escapecode 7a8514bdfa feat(sftp): add macOS and Windows platform support (#3372 )

The session watchdog now selects its detection method per
platform. It previously probed kernel TCP state through a
Linux-only procfs path, so on macOS every healthy idle session
was killed within a minute, and on Windows the watchdog never
spawned at all, leaving wedged sessions with no cleanup. Linux
keeps its fast-kill watchdog unchanged. Other platforms get a
silence-only backstop that kills a session only at the
documented 30-minute idle ceiling.

The host-key loader now has a Windows arm. It loads OpenSSH
format host keys from the configured directory and logs a
one-time warning to restrict NTFS ACLs on the key directory,
the same operator-managed approach FTPS, WebDAV, KMS, and IAM
already use on Windows. Startup previously aborted with
UnsupportedPlatform because the Unix mode-bit permission check
has no Windows equivalent. tokio's io-uring feature is now
enabled only in Linux builds. io-uring is a Linux kernel
interface and enabling it unconditionally broke the Windows
build.

Co-authored-by: houseme <housemecn@gmail.com>

2026-06-12 18:08:23 +08:00

benches

refactor(zip): simplify archive extraction path (#3290 )

2026-06-08 20:03:02 +00:00

src

refactor(zip): simplify archive extraction path (#3290 )

2026-06-08 20:03:02 +00:00

Cargo.toml

feat(sftp): add macOS and Windows platform support (#3372 )

2026-06-12 18:08:23 +08:00

README.md

refactor(zip): simplify archive extraction path (#3290 )

2026-06-08 20:03:02 +00:00

README.md

RustFS Zip - Archive And Compression Primitives

High-performance compression and archiving for RustFS object storage

📖 Documentation · 🐛 Bug Reports · 💬 Discussions

📖 Overview

RustFS Zip provides archive and compression primitives for the RustFS distributed object storage system. Today it is primarily used by RustFS archive extract flows to:

identify archive/compression formats by extension
stream tar and tar+compression inputs through async decoders
provide small ZIP read/write helpers for local archive workflows

Current Features

A clearer type model with:
- CompressionCodec for stream codecs
- ArchiveKind for container families
- ArchiveFormat for concrete archive/container combinations
Async stream codecs for gzip, bzip2, zlib, xz, and zstd
Tar archive iteration over async readers through read_archive_entries() / extract_tar_entries()
Archive guardrails through ArchiveLimits for entry count, entry size, total unpacked size, and path length
In-memory compression helpers for payload round-trip workflows
Blocking ZIP create/extract helpers for local archive files
ZIP helper metadata via ZipEntry, including:
- compression_method
- archive_kind
- format
- unix_mode
ZIP helper options via ZipWriteOptions, including:
- compression_level
- create_directory_entries

Compatibility

CompressionFormat is retained as a compatibility layer for existing callers
New code should prefer ArchiveFormat, ArchiveKind, and CompressionCodec when expressing archive semantics

ZIP Helper Scope

The file-based ZIP helper APIs are best suited for:

local archive import/export flows
admin-side packaging helpers
test fixtures and tooling

They are not intended to be a remote streaming ZIP access engine.

Current Boundaries

ZIP is supported via file-based helper APIs, not the tar-family async stream APIs
Tar-family stream APIs are intended for tar, tar.gz, tar.bz2, tar.xz, tar.zst, and similar compressed tar flows
Default archive guardrails are intentionally conservative and do not replace higher-level RustFS object-path validation
This crate does not currently implement a general-purpose parallel archive engine
Archive extraction safety policy remains the responsibility of the RustFS caller for object-store flows

📚 Documentation

For comprehensive documentation, examples, and usage guides, please visit the main RustFS repository.

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.