mergerfs/mkdocs/docs/config/link-exdev.md
2026-11-01 21:11:04 -06:00

1.1 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.

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