From e630fd11869ca2824154ee585ab77059b91ca0ac Mon Sep 17 00:00:00 2001 From: Wayne Davison Date: Sat, 1 Jan 2011 18:16:49 -0800 Subject: [PATCH 1/1] Some --inplace manpage enhancements. --- rsync.yo | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/rsync.yo b/rsync.yo index 0ad14f39..610cc9d1 100644 --- a/rsync.yo +++ b/rsync.yo @@ -781,7 +781,9 @@ quote(itemization( it() The file's data will be in an inconsistent state during the transfer and will be left that way if the transfer is interrupted or if an update fails. - it() A file that does not have write permissions cannot be updated. + it() A file that rsync cannot write to cannot be updated. While a super user + can update any file, a normal user needs to be granted write permission for + the open of the file for writing to be successful. it() The efficiency of rsync's delta-transfer algorithm may be reduced if some data in the destination file is overwritten before it can be copied to a position later in the file. This does not apply if you use bf(--backup), @@ -794,7 +796,8 @@ accessed by others, so be careful when choosing to use this for a copy. This option is useful for transferring large files with block-based changes or appended data, and also on systems that are disk bound, not network -bound. +bound. It can also help keep a copy-on-write filesystem snapshot from +diverging the entire contents of a file that only has minor changes. The option implies bf(--partial) (since an interrupted transfer does not delete the file), but conflicts with bf(--partial-dir) and bf(--delay-updates). -- 2.34.1