Make the --copy-links caveat a little clearer.

This commit is contained in:
Wayne Davison
2020-04-05 09:43:59 -07:00
parent 51e23e0ab7
commit 3bd4e1e8cd

View File

@@ -940,10 +940,11 @@ additional effect if bf(--copy-links) was also specified.
Note that the cut-off point is the top of the transfer, which is the part of
the path that rsync isn't mentioning in the verbose output. If you copy
"subdir" to "/dest/" then the subdir directory is a name inside the transfer
tree, not the top of the transfer (its parent directory is the top) so it is
legal for created relative symlinks to refer to other names inside the /dest
dir.
"/src/subdir" to "/dest/" then the "subdir" directory is a name inside the
transfer tree, not the top of the transfer (which is /src) so it is legal for
created relative symlinks to refer to other names inside the /src and /dest
directories. If you instead copy "/src/subdir/" (with a trailing slash) to
"/dest/subdir" that would not allow symlinks to any files outside of "subdir".
dit(bf(--safe-links)) This tells rsync to ignore any symbolic links
which point outside the copied tree. All absolute symlinks are