From 49eb0c4a3518ad16d9a67f136fc6f1965c8690f0 Mon Sep 17 00:00:00 2001 From: Wayne Davison Date: Mon, 3 Jan 2011 19:49:05 -0800 Subject: [PATCH] Mention that sorting the --files-from input is helpful. --- rsync.yo | 6 ++++++ 1 file changed, 6 insertions(+) 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 -- 2.34.1