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

28 lines
1.3 KiB
Markdown

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