summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorWayne Davison <wayned@samba.org>2011-01-03 19:49:05 -0800
committerWayne Davison <wayned@samba.org>2011-01-03 19:49:05 -0800
commit49eb0c4a3518ad16d9a67f136fc6f1965c8690f0 (patch)
treed58596a7689c091f6796590931145f0f9a327461
parent050e5334d8eb98b3b851bdeb4e174d2afc53b795 (diff)
downloadrsync-49eb0c4a3518ad16d9a67f136fc6f1965c8690f0.tar.gz
rsync-49eb0c4a3518ad16d9a67f136fc6f1965c8690f0.tar.bz2
rsync-49eb0c4a3518ad16d9a67f136fc6f1965c8690f0.zip
Mention that sorting the --files-from input is helpful.
-rw-r--r--rsync.yo6
1 files changed, 6 insertions, 0 deletions
diff --git a/rsync.yo b/rsync.yo
index 456bd4ff..af95b851 100644
--- a/rsync.yo
+++ b/rsync.yo
@@ -1619,6 +1619,12 @@ bf(--files-from) filenames are being sent from one host to another, the
filenames will be translated from the sending host's charset to the
receiving host's charset.
+NOTE: sorting the list of files in the --files-from input helps rsync to be
+more efficient, as it will avoid re-visiting the path elements that are shared
+between adjacent entries. If the input is not sorted, some path elements
+(implied directories) may end up being scanned multiple times, and rsync will
+eventually unduplicate them after they get turned into file-list elements.
+
dit(bf(-0, --from0)) This tells rsync that the rules/filenames it reads from a
file are terminated by a null ('\0') character, not a NL, CR, or CR+LF.
This affects bf(--exclude-from), bf(--include-from), bf(--files-from), and any