Bug 9427 - Description of "--max-delete=" in manual page needs clarification
Description of "--max-delete=" in manual page needs clarification
Product: rsync
Classification: Unclassified
Component: core
All All
: P5 normal
: ---
Assigned To: Wayne Davison
Rsync QA Contact
Depends on:
  Show dependency treegraph
Reported: 2012-11-23 19:47 UTC by Sebastian
Modified: 2013-05-27 00:07 UTC (History)
1 user (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Sebastian 2012-11-23 19:47:19 UTC
The description of "--max-delete=" option in the man page is a bit ambiguous and open to interpretation:

       This  tells  rsync not to delete more than NUM files or directo‐
       ries.  If that limit is exceeded, a warning is output and  rsync
       exits with an error code of 25 (new for 3.0.0)."

The above could be easily interpreted to mean that rsync aborts the current operation as soon as "max-delete" is reached. However, according to my tests, that is not the case - rsync only aborts *deleting* files, but continues with updates/transfers to the end. By the way, I think the current behaviour is good and desirable - I just think that the man page could clarify that rsync will only abort the deletions, but continue with the updates/transfers to the end of the current fileset. Otherwise some users might get quite different results from what they expect when using this option.
Comment 1 Wayne Davison 2013-05-27 00:07:26 UTC
Thanks for the suggestion -- this was improved a few weeks ago.