From eb1b138ec2b363268acfef07e1face7c4e662409 Mon Sep 17 00:00:00 2001 From: Wayne Davison Date: Sat, 16 Mar 2019 10:55:21 -0700 Subject: [PATCH] Clarify the cut-off point for --copy-safe-links. --- rsync.yo | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/rsync.yo b/rsync.yo index df876022..207d487e 100644 --- a/rsync.yo +++ b/rsync.yo @@ -939,6 +939,13 @@ are also treated like ordinary files, and so are any symlinks in the source path itself when bf(--relative) is used. This option has no 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. + dit(bf(--safe-links)) This tells rsync to ignore any symbolic links which point outside the copied tree. All absolute symlinks are also ignored. Using this option in conjunction with bf(--relative) may -- 2.47.2