libfuse 3.17.1-rc0 Release Notes

First, we apologize for the extended time this release has taken. We wanted to ensure proper ABI compatibility and testing.

Major Changes:

• ABI/API Versioning:
  • API version remains at 3.x as the API is stable
  • SO version increased from 3 to 4 due to ABI issues introduced in 3.11.0 and 3.14.2
  • Restored ABI compatibility to 3.10 (fixing incompatibilities introduced in 3.11 and 3.14.2)
  • Added automated ABI compatibility tests
    Note: Currently tests only verify against previous tag, not 3.10 yet due to too many false positives.
    Further improvements to the ABI testing are planned.
• Version Encoding: The libfuse version is now encoded into programs at compile time using inlined functions in fuse_lowlevel.h and fuse.h
• Switched to posix_spawn for better performance with memory-heavy applications and to prevent RDMA-related issues

New Features:

• Added support for filesystem passthrough read/write when FUSE_PASSTHROUGH capability is enabled
  • New API: fuse_passthrough_open() and fuse_passthrough_close()
  • See example/passthrough_hp.cc for usage
• Added fmask and dmask options to high-level API for separate permission masks for files and directories
• Added signal handling with backtrace printing (fuse_set_fail_signal_handlers())
• Added syslog support for fuse_log() messages
  • New API: fuse_log_enable_syslog() and fuse_log_close_syslog()
• Added thread names to libfuse threads
• Fixed buffer misalignment for FUSE_WRITE