From 33689f4803b8fa50b3862272451861610a1ed136 Mon Sep 17 00:00:00 2001 From: Wayne Davison Date: Tue, 23 Jan 2007 15:34:43 +0000 Subject: [PATCH] Added an extra paragraph to the --link-dest option to make it more explicit that it is best used with an empty destination hierarchy. --- rsync.yo | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/rsync.yo b/rsync.yo index 60e1c178..d5f6eadc 100644 --- a/rsync.yo +++ b/rsync.yo @@ -1346,6 +1346,12 @@ and the attributes updated. If a match is not found, a basis file from one of the em(DIR)s will be selected to try to speed up the transfer. +This option works best when copying into an empty destination hierarchy, as +rsync treats existing files as definitive (so it never looks in the link-dest +dirs when a destination file already exists), and as malleable (so it might +change the attributes of a destination file, which affects all the hard-linked +versions). + Note that if you combine this option with bf(--ignore-times), rsync will not link any files together because it only links identical files together as a substitute for transferring the file, never as an additional check after the -- 2.34.1