← Back to branch summary

~vcs-imports/rsync/master

« back to all changes in this revision

Viewing changes to rsync.yo

  • Committer: Wayne Davison
  • Date: 2020-05-25 02:52:08 UTC
  • Revision ID: git-v1:5ac353d84580e64d71a6516b72898b59916007c0
Prefer zlibx compression consistently instead of having 2 possible default preference orders.

Show diffs side-by-side

added added

removed removed

Lines of Context:
rsync.yo
2069
2069
bf(-z) option or specifying bf(--compress-choice=zlibx), but it only works if
2070
2070
both sides of the transfer are at least version 3.1.1.
2071
2071
 
2072
 
Note that if your version of rsync was compiled with an external zlib (instead
2073
 
of the zlib that comes packaged with rsync) then it will give preference to
2074
 
using the "zlibx" algorithm over the "zlib" algorithm since the external zlib
2075
 
code doesn't seem to handle the extra compression properly.  You can try
2076
 
forcing the regular algorithm via bf(--zz=zlib) and be on the lookout for
2077
 
transfer failures.  If all else fails, disable compression altogether.
2078
 
 
2079
2072
Note that if you see an error about an option named bf(--old-compress) or
2080
2073
bf(--new-compress), this is rsync trying to send the bf(--compress-choice=zlib)
2081
2074
or bf(--compress-choice=zlibx) option in a backward-compatible manner that more
2089
2082
automatic selection of the compression algorithm that is the default when
2090
2083
bf(--compress) is used.
2091
2084
 
2092
 
Currently the STR can be "zlib", "zlibx", or "none".
 
2085
Currently the STR can be "zlibx", "zlib", or "none".
2093
2086
 
2094
 
The "zlib" algorithm is given preference over "zlibx" if your rsync was
2095
 
compiled with the internal zlib code, otherwise that preference is reversed.
2096
 
These 2 algorithms are the stame except that "zlibx" does not try to include
2097
 
matched data that was not transferred in the compression computations.
 
2087
The "zlibx" algorithm is given preference over "zlib" if both sides of the
 
2088
transfer are at least version 3.2.0, otherwise it will choose "zlib" unless you
 
2089
override it via something like bf(-zz).  These 2 algorithms are the stame
 
2090
except that "zlibx" does not try to include matched data that was not
 
2091
transferred in the compression computations.
2098
2092
 
2099
2093
If "none" is specified, that is equivalent to using bf(--no-compress).
2100
2094