mergerfs/mkdocs/docs/config/link-exdev.md
2026-11-06 12:10:05 -06:00

1.3 KiB

link-exdev

If using path preservation and a link fails with EXDEV make a call to symlink where the target is the oldlink and the linkpath is the newpath. The target value is determined by the value of link-exdev.

  • link-exdev=passthrough: Return EXDEV as normal.
  • link-exdev=rel-symlink: A relative path from the newpath.
  • link-exdev=abs-base-symlink: An absolute value using the underlying branch.
  • link-exdev=abs-pool-symlink: An absolute value using the mergerfs mount point.
  • Defaults to passthrough.

Replacement symlinks retain the source inode's UID and GID, read without following a source symlink. Relative and pool targets use the first getattr-policy source branch; absolute branch targets use the source selected by the open policy. Creation uses daemon credentials, then sets the source ownership, rather than using the link request's UID/GID, which may be invalid when allow-idmap is enabled. A newly created replacement is removed if its ownership cannot be set.

Source branch selection and path construction retain the same branch snapshot, even when the branch list is updated at runtime.

NOTE: It is possible that some applications check the file they link. In those cases, it is possible it will error or complain.