mergerfs/tests
Antonio S. Musumeci 9d12bcf235 Return ENOENT, not EBADF, for removed nodes with no open file
Once a file or directory is removed (unlink, rmdir, rename over it)
libfuse has no path for its node and falls back to the fh based
getattr/setattr/statx with fh=0. If mergerfs had no open file for the
node (a directory, an O_PATH fd, a cwd, or a dentry resolved just
before the removal) it returned EBADF. The kernel sends GETATTR for
such nodes in the permission checks of a path walk, so lstat() of a
directory, or of a path below it, could fail with EBADF while rm -rf
removed it. Two rm -rf at once, one on a directory and one on the
directory above it, met it when one removed a directory the other
still had open: the other's unlinkat() through its dirfd failed, rm
reported "Bad file descriptor" and left entries behind.

mergerfs now returns ENOENT. That is what a local filesystem gives
*at() calls in a removed directory, and what rm -f ignores. ESTALE
would make the kernel redo a path based lookup, which helps a stat
racing a rename over the path. But a call through a dirfd or cwd of a
removed directory meets the same node again and fails anyway, and the
concurrent rm -rf still did. Calls on the removed object itself, which
succeed on a local filesystem, get ENOENT instead of EBADF.

TEST_rm_rf_concurrent runs the two cases reported. The rm -rf one is
a narrow race; TEST_use_dirfd_after_rmdir covers its cause without
one, with cache.attr=0 so the kernel sends GETATTR every time.

See #1693.
2026-11-17 12:25:50 -06:00
..
OPTIONS_TEST_PLAN.md Remove timed node removal 2026-05-06 20:49:46 -04:00
posix_parity.py Return ENOENT, not EBADF, for removed nodes with no open file 2026-11-17 12:25:50 -06:00
README.md make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
run-tests make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_api_xattr make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_cfg_link_rename_exdev test: disable minimum free space threshold in EXDEV tests 2026-11-06 11:24:54 -06:00
TEST_cfg_statfs_ignore make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_cfg_xattr_modes make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_io_passthrough_create_open make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_io_passthrough_open_race make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_mount_lifecycle make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_movefile_enospc fix: preserve partial append progress during ENOSPC recovery 2026-11-06 11:24:49 -06:00
TEST_no_fuse_hidden make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_o_direct make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_open_after_unlink make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_policy_lup make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_access make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_bmap make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_chmod make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_chown make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_copy_file_range make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_create_mknod make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_fsync_flush make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_getattr_fgetattr make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_ioctl make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_link_symlink make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_locking make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_mkdir_rmdir make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_open_read_write make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_poll make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_readdir make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_readdir_plus make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_release make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_releasedir make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_statfs make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_statx make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_syncfs make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_tmpfile make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_truncate_ftruncate make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_unlink_rename make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_utimens make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_xattr make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_posix_xattr_matrix make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_readlink_semantics make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_rm_rf_concurrent Return ENOENT, not EBADF, for removed nodes with no open file 2026-11-17 12:25:50 -06:00
TEST_rmdir_enotempty_priority make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_unlink_rename make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_use_dirfd_after_rmdir Return ENOENT, not EBADF, for removed nodes with no open file 2026-11-17 12:25:50 -06:00
TEST_use_fallocate_after_unlink make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_use_fchmod_after_unlink make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_use_fchown_after_unlink make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_use_fstat_after_unlink make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_use_ftruncate_after_unlink make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
TEST_use_futimens_after_unlink make all integration tests self-contained with ephemeral mounts 2026-05-07 21:47:40 -04:00
tests.cpp Fix ARMv5 atomic loads from Boost dummy storage 2026-11-14 18:27:14 -06:00

POSIX Soft Conformance Suite

This directory contains integration tests that exercise mergerfs FUSE operations and compare behavior against equivalent native syscalls on a local filesystem.

The suite is "soft POSIX": it focuses on practical parity for return values, errno, and key side effects, including common error paths.

Each test mounts its own ephemeral mergerfs instance with random temporary branches and cleans everything up automatically.

Run with:

python3 tests/run-tests

Coverage Matrix

  • access -> TEST_posix_access
  • chmod / fchmod -> TEST_posix_chmod, TEST_use_fchmod_after_unlink
  • chown / fchown -> TEST_posix_chown, TEST_use_fchown_after_unlink
  • create / mknod -> TEST_posix_create_mknod
  • getattr / fgetattr -> TEST_posix_getattr_fgetattr, TEST_use_fstat_after_unlink
  • open / read / write -> TEST_posix_open_read_write, TEST_o_direct
  • flush / release / fsync / fsyncdir -> TEST_posix_fsync_flush
  • release close semantics -> TEST_posix_release
  • releasedir close semantics -> TEST_posix_releasedir
  • truncate / ftruncate -> TEST_posix_truncate_ftruncate, TEST_use_ftruncate_after_unlink
  • utimens / futimens -> TEST_posix_utimens, TEST_use_futimens_after_unlink
  • fallocate -> TEST_use_fallocate_after_unlink
  • copy_file_range -> TEST_posix_copy_file_range
  • ioctl -> TEST_posix_ioctl
  • poll -> TEST_posix_poll
  • tmpfile (O_TMPFILE) -> TEST_posix_tmpfile
  • bmap (via FIBMAP ioctl parity) -> TEST_posix_bmap
  • readlink -> TEST_readlink_semantics
  • link / symlink -> TEST_posix_link_symlink
  • mkdir / rmdir -> TEST_posix_mkdir_rmdir
  • unlink / rename -> TEST_posix_unlink_rename, TEST_unlink_rename
  • statfs -> TEST_posix_statfs
  • statx -> TEST_posix_statx
  • syncfs -> TEST_posix_syncfs
  • flock / lock -> TEST_posix_locking
  • setxattr / getxattr / listxattr / removexattr -> TEST_posix_xattr
  • xattr object/flag matrix (file, dir, symlink l*, create/replace) -> TEST_posix_xattr_matrix
  • xattr mode runtime toggles (passthrough/noattr/nosys) -> TEST_cfg_xattr_modes
  • statfs mode and statfs-ignore runtime toggles -> TEST_cfg_statfs_ignore
  • EXDEV fallback runtime toggles for link/rename -> TEST_cfg_link_rename_exdev
  • readdir (+ seek/tell behavior) -> TEST_posix_readdir
  • readdir_plus semantic parity (list+stat and readdir policy toggles) -> TEST_posix_readdir_plus
  • lifecycle (init/destroy) harness check -> TEST_mount_lifecycle
  • hidden temp exposure checks -> TEST_no_fuse_hidden

Error Conditions Emphasized

Across tests, parity checks include combinations of:

  • ENOENT
  • ENOTDIR
  • EEXIST
  • ENOTEMPTY
  • EISDIR
  • EBADF
  • privilege-sensitive outcomes (for example EPERM) where applicable

Notes

  • Some behavior is runtime/environment dependent (kernel, mount options, uid/gid, capabilities). Tests compare mergerfs to native behavior in the same runtime to keep assertions robust.
  • Tests that cannot exercise a behavior in the current environment may exit 77 and are reported as SKIP by tests/run-tests.
  • The xattr test uses a user.* key and assumes user xattrs are enabled.
  • Tests mount their own ephemeral mergerfs instances using the mergerfs_mount context manager in posix_parity.py. Random directories are created and cleaned up automatically.