Skip to Content
Common ToolsUS3FS Mount ToolRelease History

Release History

US3FS v2.0.3

Fixed

  • Fixed incorrect GID/UID display in some scenarios

US3FS v2.0.2

Fixed

  • Fixed a rare issue where the last part could be missing during large file uploads

US3FS v2.0.1

Added

  • Added fuse_session_cnt to set the number of connections between US3FS and the kernel FUSE module, improving read/write performance

US3FS v2.0.0

Added

  • Added read cache to improve read throughput
  • Added operation synchronization between multiple mountpoints of the same bucket

US3FS v1.7.12

Fixed

  • Fixed some network connection issues

US3FS v1.7.11

Added

  • Added mp_mask parameter to control mountpoint permissions

US3FS v1.7.10

Fixed

  • Fixed an issue where, with finish_write_when_release enabled, moving (mv) a file that was still finishing upload could result in an empty file

US3FS v1.7.9

Fixed

  • Fixed an error when using the prefix parameter

US3FS v1.7.8

Added

  • Added stats, gc, and reload commands

Improved

  • Improved sequential read detection
  • Improved read-cache eviction efficiency

US3FS v1.7.7

Added

  • Added --reload to notify US3FS instances on the same machine to reload their config files (available for v1.7.7 and later)

Improved

  • Improved readahead read efficiency and memory usage

US3FS v1.7.6

Fixed

  • Fixed small-file upload failures in some scenarios

Added

  • Added --disable_remove to disable unlink, rmdir, and rename

US3FS v1.7.5

Fixed

  • Fixed inode loss on the local side caused by rename in some scenarios
  • Fixed excessive memory usage under heavy read pressure with readahead enabled

US3FS v1.7.4

Fixed

  • Fixed abnormal exit caused by closing a file handle multiple times

Added

  • host now supports configuring IP:port

Improved

  • Adapted to newer FUSE configurations

US3FS v1.7.3

Fixed

  • Fixed abnormal exit when using skip_ne_dir_lookup

US3FS v1.7.2

Fixed

  • Fixed an issue where crash logs could be unexpectedly cleaned up in some scenarios

US3FS v1.7.1

Fixed

  • Fixed file lookup failures in some scenarios

US3FS v1.7.0

Added

  • Added cache_db to cache US3FS metadata on disk
  • Added finish_write_when_release to support async completion of file uploads
  • Added read_after_write_finish so reads can wait for writes to finish

Improved

  • Improved file list loading speed

Fixed

  • Fixed memory not being reclaimed in some abnormal scenarios

US3FS v1.6.8

Added

  • Added mimetype detection during writes
  • Added enable_load_dentries to preload directory entries after mounting, improving access performance

Improved

  • Supported configuring mount parameters in the config file
  • Removed the bucket field from the config file so multiple buckets can be mounted with the same config
  • Optimized listing performance when using -gfl

Fixed

  • Fixed local inode cache not updating in some scenarios
  • Fixed dcache_timeout not taking effect in some scenarios
  • Fixed crash after flush followed by write
  • Fixed zero-length file issues in some write scenarios
  • Fixed inode synchronization latency issues

US3FS v1.6.7

Added

  • Added log_dir, log_max_age, log_rotation_time to specify log output location

Fixed

  • Optimized memory usage under high-concurrency read/write workloads

US3FS v1.6.6

Added

  • Added IA (Infrequent Access) storage support

Fixed

  • Fixed incorrect cache eviction timing caused by abnormal index TTL updates

US3FS v1.6.5

Fixed

  • Fixed TCP connection reuse when using the host parameter
  • Fixed TCP connection reuse during multipart uploads of large files

US3FS v1.6.4

Fixed

  • Fixed write exceptions in private cloud scenarios

US3FS v1.6.3

Fixed

  • Fixed an issue where backend errors when committing trailing data were not properly surfaced to user space

US3FS v1.6.2

Improved

  • Improved crash log capture

Fixed

  • Fixed panic during writes
  • Fixed default config path

US3FS v1.6.0

Added

  • Supported mounting on Windows via command line
  • Supported specifying a list of IPs for access

Improved

  • Improved cleanup logic

Fixed

  • Fixed crashes due to concurrent read/write internal data structures
  • Fixed path information loss caused by FUSE kernel forget
  • Fixed -o allow_other not taking effect

US3FS v1.5.5

Added

  • None

Improved

  • Client-side HTTP request load balancing

Fixed

  • Fixed multipart uploads becoming incomplete under heavy upload load
  • Fixed null pointer crash

US3FS v1.5.4

Added

  • Added max_background and congestion_threshold for high-concurrency I/O in direct mode
  • Added async_dio to allow FUSE kernel async direct I/O
  • Added keep_pagecache to cache content in VFS when file modtime/size does not change

Improved

  • Auto-completed missing "key"-format directories by creating "key/" objects and preferring "key/" on path resolution, reducing directory index creation and improving latency
  • Enabled virtual directory detection by default and removed the old parameter; use disable_check_vdir to disable it
  • Added skip_ne_dir_lookup suffix filter dictionary to reduce head frequency; supported suffixes include: .jpe, .jpeg, .png, .gz, .tgz, .log, .plot, .js, .html, .css, .apk

Fixed

  • None

US3FS v1.5.3

Added

  • Added direct_read to bypass US3FS cache and read directly from US3
  • Added periodic performance dump output (default every 1 hour), configurable via perf_dump
  • Set directory mimetype to application/x-directory for easier distinction in console

Improved

  • Enabled entry_timeout, attr_timeout, dcache_timeout by default and set to 5 minutes
  • Updated readahead to support string parsing (e.g., 16m, 8k, 512)
  • Auto-completed missing "key" directories and reduced two head operations ("key" and "key/") to one
  • Enabled nodirbl by default, removed it, and replaced with the semantic check_virtual_dir
  • Added a suffix filter dictionary to reduce head frequency (initially only .jpe and .jpeg)

Fixed

  • Fixed inode allocation not initializing UID/GID and mtime/ctime
  • Fixed incomplete reads when a directory has too many members
  • Fixed allow_other not taking effect

US3FS v1.5.2

Added

  • None

Fixed

  • Fixed a crash when reading files after the backend connection was reset

US3FS v1.5.1

Added

  • Supported using GetFileList to list files under a directory (enable with --gfl)

Fixed

  • Fixed mv failing for empty directories
  • Removed the 64MB maximum limit for readahead

US3FS v1.5.0

Added

  • Supported dynamic multipart size on the US3 backend
  • Supported specifying a bucket prefix path at mount time

US3FS v1.4.0

Added

  • Supported async upload using local cache
  • Supported Read-Your-Write for small file reads

Improved

  • Supported setting log level via --level

Fixed

  • Fixed inability to write filenames with special characters
  • Fixed possible process interruption during writes
  • Fixed listing showing two directories when creating a directory and file with the same name
  • Fixed blocking when multipart upload initialization fails
Frequently Asked QuestionsTool Introduction