2024-12-23 22:12:26 -06:00
|
|
|
# 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`.
|
2026-10-28 12:12:38 -05:00
|
|
|
|
|
|
|
|
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.
|
2026-11-06 12:10:05 -06:00
|
|
|
|
|
|
|
|
Source branch selection and path construction retain the same branch
|
|
|
|
|
snapshot, even when the branch list is updated at runtime.
|
2024-12-23 22:12:26 -06:00
|
|
|
|
|
|
|
|
**NOTE:** It is possible that some applications check the file they
|
|
|
|
|
link. In those cases, it is possible it will error or complain.
|