]> git.ipfire.org Git - thirdparty/rsync.git/commitdiff
Mention that --append can be dangerous.
authorWayne Davison <wayned@samba.org>
Wed, 31 Dec 2014 19:12:55 +0000 (11:12 -0800)
committerWayne Davison <wayned@samba.org>
Wed, 31 Dec 2014 21:10:46 +0000 (13:10 -0800)
rsync.yo

index eef47e9176cd457375d4f9428220b116ecc1ef74..20300eb9cd4c8596c6e494a6c478fd497ae88ab0 100644 (file)
--- a/rsync.yo
+++ b/rsync.yo
@@ -864,6 +864,11 @@ Implies bf(--inplace),
 but does not conflict with bf(--sparse) (since it is always extending a
 file's length).
 
+The use of bf(--append) can be dangerous if you aren't 100% sure that the files
+that are longer have only grown by the appending of data onto the end.  You
+should thus use include/exclude/filter rules to ensure that such a transfer is
+only affecting files that you know to be growing via appended data.
+
 dit(bf(--append-verify)) This works just like the bf(--append) option, but
 the existing data on the receiving side is included in the full-file
 checksum verification step, which will cause a file to be resent if the