Update the NEWS.
[rsync.git] / NEWS.md
1 # NEWS for rsync 3.2.5 (UNRELEASED)
2
3 ## Changes in this version:
4
5 ### SECURITY FIXES:
6
7 - Added some file-list safety checking that helps to ensure that a rogue
8   sending rsync can't add unrequested top-level names and/or include recursive
9   names that should have been excluded by the sender.  These extra safety
10   checks only require the receiver rsync to be updated.  When dealing with an
11   untrusted sending host, it is safest to copy into a dedicated destination
12   directory for the remote content (i.e. don't copy into a destination
13   directory that contains files that aren't from the remote host unless you
14   trust the remote host). Fixes CVE-2022-29154.
15
16  - A fix for CVE-2022-37434 in the bundled zlib (buffer overflow issue).
17
18 ### BUG FIXES:
19
20 - Fixed the handling of filenames specified with backslash-quoted wildcards
21   when the default remote-arg-escaping is enabled.
22
23 - Fixed the configure check for signed char that was causing a host that
24   defaults to unsigned characters to generate bogus rolling checksums. This
25   made rsync send mostly literal data for a copy instead of finding matching
26   data in the receiver's basis file (for a file that contains high-bit
27   characters).
28
29 - Lots of manpage improvements, including an attempt to better describe how
30   include/exclude filters work.
31
32 - If rsync is compiled with an xxhash 0.8 library and then moved to a system
33   with a dynamically linked xxhash 0.7 library, we now detect this and disable
34   the XX3 hashes (since these routines didn't stabilize until 0.8).
35
36 ### ENHANCEMENTS:
37
38 - The [`--trust-sender`](rsync.1#opt) option was added as a way to bypass the
39   extra file-list safety checking (should that be required).
40
41 ### PACKAGING RELATED:
42
43 - A note to those wanting to patch older rsync versions: the changes in this
44   release requires the quoted argument change from 3.2.4. Then, you'll want
45   every single code change from 3.2.5 since there is no fluff in this release.
46
47 - The build date that goes into the manpages is now based on the developer's
48   release date, not on the build's local-timezone interpretation of the date.
49
50 ### DEVELOPER RELATED:
51
52 - Configure now defaults GETGROUPS_T to gid_t when cross compiling.
53
54 - Configure now looks for the bsd/string.h include file in order to fix the
55   build on a host that has strlcpy() in the main libc but not defined in the
56   main string.h file.
57
58 ------------------------------------------------------------------------------
59
60 # NEWS for rsync 3.2.4 (15 Apr 2022)
61
62 ## Changes in this version:
63
64 ### BEHAVIOR CHANGES:
65
66  - A new form of arg protection was added that works similarly to the older
67    [`--protect-args`](rsync.1#opt) (`-s`) option but in a way that avoids
68    breaking things like rrsync (the restricted rsync script): rsync now uses
69    backslash escaping for sending "shell-active" characters to the remote
70    shell. This includes spaces, so fetching a remote file via a simple quoted
71    filename value now works by default without any extra quoting:
72
73    ```shell
74        rsync -aiv host:'a simple file.pdf' .
75    ```
76
77    Wildcards are not escaped in filename args, but they are escaped in options
78    like the [`--suffix`](rsync.1#opt) and [`--usermap`](rsync.1#opt) values.
79    If your rsync script depends on the old arg-splitting behavior, either run
80    it with the [`--old-args`](rsync.1#opt) option or `export RSYNC_OLD_ARGS=1`
81    in the script's environment.  See also the [ADVANCED USAGE](rsync.1#)
82    section of rsync's manpage for how to use a more modern arg style.
83
84  - A long-standing bug was preventing rsync from figuring out the current
85    locale's decimal point character, which made rsync always output numbers
86    using the "C" locale.  Since this is now fixed in 3.2.4, a script that
87    parses rsync's decimal numbers (e.g. from the verbose footer) may want to
88    setup the environment in a way that the output continues to be in the C
89    locale.  For instance, one of the following should work fine:
90
91    ```shell
92        export LC_ALL=C.UTF-8
93    ```
94
95    or if iconv translations are needed:
96
97    ```shell
98        if [ "${LC_ALL:-}" ]; then
99            export LANG="$LC_ALL"
100            export LC_CTYPE="$LC_ALL"
101            unset LC_ALL
102        fi
103        export LC_NUMERIC=C.UTF-8
104    ```
105
106 ### SECURITY FIXES:
107
108  - A fix for CVE-2018-25032 in the bundled zlib (memory corruption issue).
109
110 ### BUG FIXES:
111
112  - Fixed a bug with [`--inplace`](rsync.1#opt) + [`--sparse`](rsync.1#opt) (and
113    a lack of [`--whole-file`](rsync.1#opt)) where the destination file could
114    get reconstructed with bogus data.  Since the bug can also be avoided by
115    using (the seemingly redundant) [`--no-W`](rsync.1#opt) on the receiving
116    side, the latest rsync will now send `--no-W` to a remote receiver when this
117    option combination occurs.  If your client rsync is not new enough to do
118    this for you (or if you're just paranoid), you can manually specify `--no-W
119    -M--no-W` (when not using [`--whole-file`](rsync.1#opt)) to make sure the
120    bug is avoided.
121
122  - Fixed a bug with [`--mkpath`](rsync.1#opt) if a single-file copy specifies
123    an existing destination dir with a non-existing destination filename.
124
125  - Fixed `--update -vv` to output "is uptodate" instead of "is newer" messages
126    for files that are being skipped due to an identical modify time.  (This was
127    a new output quirk in 3.2.3.)
128
129  - When doing an append transfer, the sending side's file must not get shorter
130    or it is skipped. Fixes a crash that could occur when the size changes to 0
131    in the middle of the send negotiations.
132
133  - When dealing with special files (see [`--specials`](rsync.1#opt)) in an
134    alt-dest hierarchy, rsync now checks the non-permission mode bits to ensure
135    that the 2 special files are really the same before hard-linking them
136    together.
137
138  - Fixed a bug where [`--delay-updates`](rsync.1#opt) with stale partial data
139    could cause a file to fail to update.
140
141  - Fixed a few places that would output an INFO message with
142    [`--info=NAME`](rsync.1#opt) that should only have been output given
143    [`--verbose`](rsync.1#opt) or [`--itemize-changes`](rsync.1#opt).
144
145  - Avoid a weird failure if you run a local copy with a (useless)
146    [`--rsh`](rsync.1#opt) option that contains a `V` in the command.
147
148  - Fixed a long-standing compression bug where the compression level of the
149    first file transferred affected the level for all future files.  Also, the
150    per-file compression skipping has apparently never worked, so it is now
151    documented as being ineffective.
152
153  - Fixed a truncate error when a `--write-devices` copy wrote a file onto a
154    device that was shorter than the device.
155
156  - Made `--write-devices` support both `--checksum` and `--no-whole-file` when
157    copying to a device.
158
159  - Improved how the [`--stop-at`](rsync.1#opt), [`--stop-after`](rsync.1#opt),
160    and (the deprecated) [`--time-limit`](rsync.1#opt) options check to see if
161    the allowed time is over, which should make rsync exit more consistently.
162
163  - Tweak --progress to display "`??:??:??`" when the time-remaining value is so
164    large as to be meaningless.
165
166  - Silence some chmod warnings about symlinks when it looks like we have a
167    function to set their permissions but they can't really be set.
168
169  - Fixed a potential issue in git-set-file-times when handling commits with
170    high-bit characters in the description & when handling a description that
171    might mimick the git raw-commit deliniators.  (See the support dir.)
172
173  - The bundled systemd/rsync.service file now includes `Restart=on-failure`.
174
175 ### ENHANCEMENTS:
176
177  - Use openssl's `-verify_hostname` option in the rsync-ssl script.
178
179  - Added extra info to the "FILENAME exists" output of
180    [`--ignore-existing`](rsync.1#opt) when [`--info=skip2`](rsync.1#opt) is
181    used.  The skip message becomes "FILENAME exists (INFO)" where the INFO is
182    one of "type change", "sum change" (requires [`--checksum`](rsync.1#opt)),
183    "file change" (based on the quick check), "attr change", or "uptodate".
184    Prior versions only supported `--info=skip1`.
185
186  - Added the [`--fsync`](rsync.1#opt) option (promoted from the patches repo).
187
188  - Added the [`--copy-devices`](rsync.1#opt) option.  Compared to the
189    historical version from the rsync-patches repo, this version: properly
190    handles `--checksum`; fixes a truncation bug when doing an `--inplace` copy
191    onto a longer file; fixes several bugs in the `--itemize` output; and only
192    the sending side needs the enhanced rsync for the copy to work.
193
194  - Reduced memory usage for an incremental transfer that has a bunch of small
195    directories.
196
197  - The rsync daemon can now handle a client address with an implied "%scope"
198    suffix.
199
200  - Added support for [`--atimes`](rsync.1#opt) on macOS and fixed a bug where
201    it wouldn't work without [`--times`](rsync.1#opt).
202
203  - Rsync can now update the xattrs on a read-only file when your user can
204    temporarily add user-write permission to the file. (It always worked for a
205    root transfer.)
206
207  - Rsync can now work around an [`--inplace`](rsync.1#opt) update of a file
208    that is being refused due to the Linux fs.protected_regular sysctl setting.
209
210  - When [`--chown`](rsync.1#opt), [`--usermap`](rsync.1#opt), or
211    [`--groupmap`](rsync.1#opt) is specified, rsync now makes sure that the
212    appropriate [`--owner`](rsync.1#opt) and/or [`--group`](rsync.1#opt) options
213    are enabled.
214
215  - Added the [`--info=NONREG`](rsync.1#opt) setting to control if rsync should
216    warn about non-regular files in the transfer.  This is enabled by default
217    (keeping the behavior the same as before), so specifying `--info=nonreg0`
218    can be used to turn the warnings off.
219
220  - An optional asm optimization for the rolling checksum from Shark64. Enable
221    it with `./configure --enable-roll-asm`.
222
223  - Using `--debug=FILTER` now outputs a caution message if a filter rule
224    has trailing whitespace.
225
226  - Transformed rrsync into a python script with improvements:
227    - Security has been beefed up.
228    - The known rsync options were updated to include recent additions.
229    - Make rrsync reject [`--copy-links`](rsync.1#opt) (`-L`),
230      [`--copy-dirlinks`](rsync.1#opt) (`-k`), &
231      [`--keep-dirlinks`](rsync.1#opt) (`-K`) by default to make it harder to
232      exploit any out-of-subdir symlinks.
233    - A new rrsync option of [`-munge`](rrsync.1#opt) tells rrsync to always
234      enable rsync's [`--munge-links`](rsync.1#opt) option on the server side.
235    - A new rrsync option of [`-no-lock`](rrsync.1#opt) disables a new
236      single-use locking idiom that is the default when [`-ro`](rrsync.1#opt) is
237      not used (useful with [`-munge`](rrsync.1#opt)).
238    - A new rrsync option of [`-no-del`](rrsync.1#opt) disables all `--remove*`
239      and `--delete*` rsync options on the server side.
240    - The log format has been tweaked slightly to add seconds to the timestamp
241      and to output the command executed as a tuple (making the args clearer).
242    - An rrsync.1 manpage was added (in the support dir with rrsync).
243
244  - Added options to the lsh script to facilitate rrsync testing. (See the
245    support dir.)
246
247  - Transformed the atomic-rsync script into a python script and added the
248    ability to ignore one or more non-zero exit codes.  By default, it now
249    ignores code 24, the file-vanished exit code. (See the support dir.)
250
251  - Transformed the munge-symlinks script into python. (See the support dir.)
252
253  - Improved the rsync-no-vanished script to not join stdout & stderr together.
254    (See the support dir.)
255
256  - Work around a glibc bug where lchmod() breaks in a chroot w/o /proc mounted.
257
258  - Try to support a client that sent a remote rsync a wacko stderr file handle
259    (such as an older File::RsyncP perl library used by BackupPC).
260
261  - Lots of manpage improvements, including better HTML versions.
262
263 ### PACKAGING RELATED:
264
265  - Give configure the `--with-rrsync` option if you want `make install` to
266    install the (now python3) rrsync script and its new manpage.
267
268  - If the rrsync script is installed, its package should be changed to depend
269    on python3 and the (suggested but not mandatory) python3 braceexpand lib.
270
271  - When creating a package from a non-release version (w/o a git checkout), the
272    packager can elect to create git-version.h and define RSYNC_GITVER to the
273    string they want `--version` to output.  (The file is still auto-generated
274    using the output of `git describe` when building inside a non-shallow git
275    checkout, though.)
276
277  - Renamed configure's `--enable-simd` option to `--enable-roll-simd` and added
278    the option `--enable-roll-asm` to use the new asm version of the code.  Both
279    are x86_64/amd64 only.
280
281  - Renamed configure's `--enable-asm` option to `--enable-md5-asm` to avoid
282    confusion with the asm option for the rolling checksum.  It is also honored
283    even when openssl crypto is in use.  This allows: normal MD4 & MD5, normal
284    MD4 + asm MD5, openssl MD4 & MD5, or openssl MD4 + asm MD5 depending on the
285    configure options selected.
286
287  - Made SIMD & asm configure checks default to "no" on non-Linux hosts due to
288    various reports of problems on NetBSD & macOS hosts.  These were also
289    tweaked to allow enabling the feature on a host_cpu of amd64 (was only
290    allowed on x86_64 before).
291
292  - Fixed configure to not fail at the SIMD check when cross-compiling.
293
294  - Improved the IPv6 determination in configure.
295
296  - Compile the C files with `-pedantic-errors` (when possible) so that we will
297    get warned if a static initialization overflows in the future (among other
298    things).
299
300  - When linking with an external zlib, rsync renames its `read_buf()` function
301    to `read_buf_()` to avoid a symbol clash on an unpatched zlib.
302
303  - Added a SECURITY.md file.
304
305 ### DEVELOPER RELATED:
306
307  - Made it easier to write rsync tests that diff the output while also checking
308    the status code, and used the idiom to improve the existing tests. (See the
309    `checkdiff` and `checkdiff2` idioms in the `testsuite/*.test` files.
310
311  - The packaging scripts & related python lib got some minor enhancements.
312
313 ### INTERNAL
314
315  - Use setenv() instead of putenv() when it is available.
316
317  - Improve the logic in compat.c so that we don't need to try to remember to
318    sprinkle `!local_server` exceptions throughout the protocol logic.
319
320  - One more C99 Flexible Array improvement (started in the last release) and
321    make use of the C99 `%zd` format string when printing size_t values (when
322    possible).
323
324  - Use mallinfo2() instead of mallinfo(), when available.
325
326 ------------------------------------------------------------------------------
327
328 # NEWS for rsync 3.2.3 (6 Aug 2020)
329
330 ## Changes in this version:
331
332 ### BUG FIXES:
333
334  - Fixed a bug in the xattr code that was freeing the wrong object when trying
335    to cleanup the xattr list.
336
337  - Fixed a bug in the xattr code that was not leaving room for the "rsync."
338    prefix in some instances where it needed to be added.
339
340  - Restored the ability to use [`--bwlimit=0`](rsync.1#opt) to specify no
341    bandwidth limit.  (It was accidentally broken in 3.2.2.)
342
343  - Fixed a bug when combining [`--delete-missing-args`](rsync.1#opt) with
344    [`--no-implied-dirs`](rsync.1#opt) & [`-R`](rsync.1#opt) where rsync might
345    create the destination path of a missing arg.  The code also avoids some
346    superfluous warnings for nested paths of removed args.
347
348  - Fixed an issue where hard-linked devices could cause the rdev_major value to
349    get out of sync between the sender and the receiver, which could cause a
350    device to get created with the wrong major value in its major,minor pair.
351
352  - Rsync now complains about a missing [`--temp-dir`](rsync.1#opt) before
353    starting any file transfers.
354
355  - A completely empty source arg is now a fatal error.  This doesn't change
356    the handling of implied dot-dir args such as "localhost:" and such.
357
358 ### ENHANCEMENTS:
359
360  - Allow [`--max-alloc=0`](rsync.1#opt) to specify no limit to the alloc sanity
361    check.
362
363  - Allow [`--block-size=SIZE`](rsync.1#opt) to specify the size using units
364    (e.g. "100K").
365
366  - The name of the id-0 user & group are now sent to the receiver along with
367    the other user/group names in the transfer (instead of assuming that both
368    sides have the same id-0 names).
369
370  - Added the [`--stop-after`](rsync.1#opt) and [`--stop-at`](rsync.1#opt)
371    options (with a [`--time-limit`](rsync.1#opt) alias for `--stop-after`).
372    This is an enhanced version of the time-limit patch from the patches repo.
373
374  - Added the [`name converter`](rsyncd.conf.5#opt) daemon parameter to make it
375    easier to convert user & group names inside a chrooted daemon module.  This
376    is based on the nameconverter patch with some improvements, including a
377    tweak to the request protocol (so if you used this patch in the past, be
378    sure to update your converter script to use newlines instead of null chars).
379
380  - Added [`--crtimes`](rsync.1#opt) (`-N`) option for preserving the file's
381    create time (I believe that this is macOS only at the moment).
382
383  - Added [`--mkpath`](rsync.1#opt) option to tell rsync that it should create a
384    non-existing path component of the destination arg.
385
386  - Added [`--stderr=errors|all|client`](rsync.1#opt) to replace the
387    `--msgs2stderr` and `--no-msgs2stderr` options (which are still accepted).
388    The default use of stderr was changed to be `--stderr=errors` where all the
389    processes that have stderr available output directly to stderr, which should
390    help error messages get to the user more quickly, especially when doing a
391    push (which includes local copying).  This also allows rsync to exit quickly
392    when a receiver failure occurs, since rsync doesn't need to try to keep the
393    connection alive long enough for the fatal error to go from the receiver to
394    the generator to the sender.  The old default can be requested via
395    `--stderr=client`.  Also changed is that a non-default stderr mode is
396    conveyed to the remote rsync (using the older option names) instead of
397    requiring the user to use [`--remote-option`](rsync.1#opt) (`-M`) to tell
398    the remote rsync what to do.
399
400  - Added the ability to specify "@netgroup" names to the [`hosts
401    allow`](rsyncd.conf.5#opt) and [`hosts deny`](rsyncd.conf.5#opt) daemon
402    parameters.  This is a finalized version of the netgroup-auth patch from the
403    patches repo.
404
405  - Rsync can now hard-link symlinks on FreeBSD due to it making use of the
406    linkat() function when it is available.
407
408  - Output file+line info on out-of-memory & overflow errors while also avoiding
409    the output of alternate build-dir path info that is not useful to the user.
410
411  - Change configure to know that Cygwin supports Linux xattrs.
412
413  - Improved the testsuite on FreeBSD & Cygwin.
414
415  - Added some compatibility code for HPE NonStop platforms.
416
417  - Improved the INSTALL.md info.
418
419  - Added a few more suffixes to the default skip-compress list.
420
421  - Improved configure's error handling to notify about several issues at once
422    instead of one by one (for the newest optional features).
423
424 ### INTERNAL:
425
426  - Use a simpler overflow check idiom in a few spots.
427
428  - Use a C99 Flexible Array for a trailing variable-size filename in a struct
429    (with a fallback to the old 1-char string kluge for older compilers).
430
431 ------------------------------------------------------------------------------
432
433 # NEWS for rsync 3.2.2 (4 Jul 2020)
434
435 ## Changes in this version:
436
437 ### BUG FIXES:
438
439  - Avoid a crash when a daemon module enables `transfer logging` without
440    setting a `log format` value.
441
442  - Fixed installing rsync-ssl script from an alternate build dir.
443
444  - Fixed the updating of configure.sh from an alternate build dir.
445
446  - Apple requires the asm function name to begin with an underscore.
447
448  - Avoid a test failure in the daemon test when `--atimes` is disabled.
449
450 ### ENHANCEMENTS:
451
452  - Allow the server side to restrict checksum & compression choices via the
453    same environment variables the client uses.  The env vars can be divided
454    into "client list & server list" by the "`&`" char or the same list can
455    apply to both.
456
457  - Simplify how the negotiation environment variables apply when interacting
458    with an older rsync and also when a list contains only invalid names.
459
460  - Do not allow a negotiated checksum or compression choice of "none" unless
461    the user authorized it via an environment variable or command-line option.
462
463  - Added the `--max-alloc=SIZE` option to be able to override the memory
464    allocator's sanity-check limit.  It defaults to 1G (as before) but the error
465    message when exceeding it specifically mentions the new option so that you
466    can differentiate an out-of-memory error from a failure of this limit.  It
467    also allows you to specify the value via the RSYNC_MAX_ALLOC environment
468    variable.
469
470  - Add the "open atime" daemon parameter to allow a daemon to always enable or
471    disable the use of O_NOATIME (the default is to let the user control it).
472
473  - The default systemd config was changed to remove the `ProtectHome=on`
474    setting since rsync is often used to serve files in /home and /root and this
475    seemed a bit too strict.  Feel free to use `systemctl edit rsync` to add
476    that restriction (or maybe `ProtectHome=read-only`), if you like.  See the
477    3.2.0 NEWS for the other restrictions that were added compared to 3.1.3.
478
479  - The memory allocation functions now automatically check for a failure and
480    die when out of memory.  This eliminated some caller-side check-and-die
481    code and added some missing sanity-checking of allocations.
482
483  - Put optimizations into their own list in the `--version` output.
484
485  - Improved the manpage a bit more.
486
487 ### PACKAGING RELATED:
488
489  - Prepared the checksum code for an upcoming xxHash release that provides new
490    XXH3 (64-bit) & XXH128 (128-bit) checksum routines.  These will not be
491    compiled into rsync until the xxhash v0.8.0 include files are installed on
492    the build host, and that release is a few weeks away at the time this was
493    written.  So, if it's now the future and you have packaged and installed
494    xxhash-0.8.0-devel, a fresh rebuild of rsync 3.2.2 will give you the new
495    checksum routines.  Just make sure that the new rsync package depends on
496    xxhash >= 0.8.0.
497
498 ### DEVELOPER RELATED:
499
500  - Moved the version number out of configure.ac into its own version.h file so
501    that we don't need to reconfigure just because the version number changes.
502
503  - Moved the daemon parameter list into daemon-parm.txt so that an awk script
504    can create the interrelated structs and accessors that loadparm.c needs.
505
506 ------------------------------------------------------------------------------
507
508 # NEWS for rsync 3.2.1 (22 Jun 2020)
509
510 ## Changes in this version:
511
512 ### BUG FIXES:
513
514  - Fixed a potential build issue with the MD5 assembly-language code by
515    removing some non-portable directives.
516
517  - Use the preprocessor with the asm file to ensure that if the code is
518    unneeded, it doesn't get built.
519
520  - Avoid the stack getting set to executable when including the asm code.
521
522  - Some improvements in the SIMD configure testing to try to avoid build
523    issues, such as avoiding a clang++ core dump when `-g` is combined with
524    `-O2`.  Note that clang++ is quite buggy in this area, and it does still
525    crash for some folks, so just use `--disable-simd` if you need to avoid
526    their buggy compiler (since the configure test is apparently not finding
527    all the compilers that will to crash and burn).
528
529  - Fixed an issue in the md2man script when building from an alternate dir.
530
531  - Disable `--atimes` on macOS (it apparently just ignores the atime change).
532
533 ### ENHANCEMENTS:
534
535  - The use of `--backup-dir=STR` now implies `--backup`.
536
537  - Added `--zl=NUM` as a short-hand for `--compress-level=NUM`.
538
539  - Added `--early-input=FILE` option that allows the client to send some
540    data to a daemon's (optional) "early exec" script on its stdin.
541
542  - Mention atimes in the capabilities list that `--version` outputs.
543
544  - Mention either "default protect-args" or "optional protect-args" in the
545    `--version` capabilities depending on how rsync was configured.
546
547  - Some info on optimizations is now elided from the `--version` capabilities
548    since they aren't really user-facing capabilities.  You can still see the
549    info (plus the status of a couple extra optimizations) by repeating the
550    `--version` option (e.g. `-VV`).
551
552  - Updated various URLs to be https instead of http.
553
554  - Some documentation improvements.
555
556 ### PACKAGING RELATED:
557
558  - If you had to use `--disable-simd` for 3.2.0, you might want to try removing
559    that and see if it will succeed or auto-disable.  Some buggy clang++
560    compilers are still not auto disabled, though.
561
562  - The MD5 asm code is now under its own configure flag (not shared with the
563    SIMD setting), so if you have any issues compiling it, re-run configure with
564    `--disable-asm`.
565
566  - Merged the OLDNEWS.md file into NEWS.md.
567
568 ------------------------------------------------------------------------------
569
570 # NEWS for rsync 3.2.0 (19 Jun 2020)
571
572 ## Changes in this version:
573
574 ### BUG FIXES:
575
576  - Avoid a potential out-of-bounds read in daemon mode if argc can be made to
577    become 0.
578
579  - Fix the default list of skip-compress files for non-daemon transfers.
580
581  - Fix xattr filter rules losing an 'x' attribute in a non-local transfer.
582
583  - Avoid an error when a check for a potential fuzzy file happens to reference
584    a directory.
585
586  - Make the atomic-rsync helper script have a more consistent error-exit.
587
588  - Make sure that a signal handler's use of exit_cleanup() calls `_exit()`
589    instead of exit().
590
591  - Various zlib fixes, including security fixes for CVE-2016-9843,
592    CVE-2016-9842, CVE-2016-9841, and CVE-2016-9840.
593
594  - Fixed an issue with `--remove-source-files` not removing a source symlink
595    when combined with `--copy-links`.
596
597  - Fixed a bug where the daemon would fail to write early fatal error messages
598    to the client, such as refused or unknown command-line options.
599
600  - Fixed the block-size validation logic when dealing with older protocols.
601
602  - Some rrsync fixes and enhancements to handle the latest options.
603
604  - Fixed a problem with the `--link-dest`|`--copy-dest` code when `--xattrs`
605    was specified along with multiple alternate-destination directories (it
606    could possibly choose a bad file match while trying to find a better xattr
607    match).
608
609  - Fixed a couple bugs in the handling of files with the `--sparse` option.
610
611  - Fixed a bug in the writing of the batch.sh file (w/`--write-batch`) when the
612    source & destination args were not last on the command-line.
613
614  - Avoid a hang when an overabundance of messages clogs up all the I/O buffers.
615
616  - Fixed a mismatch in the RSYNC_PID values put into the environment of
617    `pre-xfer exec` and a `post-xfer exec`.
618
619  - Fixed a crash in the `--iconv` code.
620
621  - Fixed a rare crash in the popt_unalias() code.
622
623 ### ENHANCEMENTS:
624
625  - The default systemd config was made stricter by default.  For instance,
626    `ProtectHome=on` (which hides content in /root and /home/USER dirs),
627    `ProtectSystem=full` (which makes /usr, /boot, & /etc dirs read-only), and
628    `PrivateDevices=on` (which hides devices).  You can override any of these
629    using the standard `systemctl edit rsync` and add one or more directives
630    under a `[Service]` heading (and restart the rsync service).
631
632  - Various checksum enhancements, including the optional use of openssl's MD4 &
633    MD5 checksum algorithms, some x86-64 optimizations for the rolling checksum,
634    some x86-64 optimizations for the (non-openssl) MD5 checksum, the addition
635    of xxHash checksum support, and a negotiation heuristic that ensures that it
636    is easier to add new checksum algorithms in the future.  The environment
637    variable `RSYNC_CHECKSUM_LIST` can be used to customize the preference order
638    of the negotiation, or use `--checksum-choice` (`--cc`) to force a choice.
639
640  - Various compression enhancements, including the addition of zstd and lz4
641    compression algorithms and a negotiation heuristic that picks the best
642    compression option supported by both sides.  The environment variable
643    `RSYNC_COMPRESS_LIST` can be used to customize the preference order of the
644    negotiation, or use `--compress-choice` (`--zc`) to force a choice.
645
646  - Added a `--debug=NSTR` option that outputs details of the new negotiation
647    strings (for checksums and compression).  The first level just outputs the
648    result of each negotiation on the client, level 2 outputs the values of the
649    strings that were sent to and received from the server, and level 3 outputs
650    all those values on the server side too (when the server was given the debug
651    option).
652
653  - The `--debug=OPTS` command-line option is no longer auto-forwarded to the
654    remote rsync which allows for the client and server to have different levels
655    of debug specified. This also allows for newer debug options to be
656    specified, such as using `--debug=NSTR` to see the negotiated hash result,
657    without having the command fail if the server version is too old to handle
658    that debug item. Use `-M--debug=OPTS` to send the options to the remote side.
659
660  - Added the `--atimes` option based on the long-standing patch (just with some
661    fixes that the patch has been needing).
662
663  - Added `--open-noatime` option to open files using `O_NOATIME`.
664
665  - Added the `--write-devices` option based on the long-standing patch.
666
667  - Added openssl & preliminary gnutls support to the rsync-ssl script, which is
668    now installed by default.  This was unified with the old stunnel-rsync
669    helper script to simplify packaging.  Note that the script accepts the use
670    of `--type=gnutls` for gnutls testing, but does not look for gnutls-cli on
671    the path yet.  The use of `--type=gnutls` will not work right until
672    gnutls-cli no longer drops data.
673
674  - Rsync was enhanced to set the `RSYNC_PORT` environment variable when running
675    a daemon-over-rsh script. Its value is the user-specified port number (set
676    via `--port` or an rsync:// URL) or 0 if the user didn't override the port.
677
678  - Added the `proxy protocol` daemon parameter that allows your rsyncd to know
679    the real remote IP when it is setup behind a proxy.
680
681  - Added negated matching to the daemon's `refuse options` setting by using
682    match strings that start with a `!` (such as `!compress*`).  This lets you
683    refuse all options except for a particular approved list, for example.  It
684    also lets rsync refuse certain options by default (such as `write-devices`)
685    while allowing the config to override that, as desired.
686
687  - Added the `early exec` daemon parameter that runs a script before the
688    transfer parameters are known, allowing some early setup based on module
689    name.
690
691  - Added status output in response to a signal (via both SIGINFO & SIGVTALRM).
692
693  - Added `--copy-as=USER` option to give some extra security to root-run rsync
694    commands into/from untrusted directories (such as backups and restores).
695
696  - When resuming the transfer of a file in the `--partial-dir`, rsync will now
697    update that partial file in-place instead of creating yet another tmp file
698    copy.  This requires both sender & receiver to be at least v3.2.0.
699
700  - Added support for `RSYNC_SHELL` & `RSYNC_NO_XFER_EXEC` environment variables
701    that affect the early, pre-xfer, and post-xfer exec rsync daemon parameters.
702
703  - Optimize the `--fuzzy --fuzzy` heuristic to avoid the fuzzy directory scan
704    until all other basis-file options are exhausted (such as `--link-dest`).
705
706  - Have the daemon log include the normal-exit sent/received stats when the
707    transfer exited with an error when possible (i.e. if it is the sender).
708
709  - The daemon now locks its pid file (when configured to use one) so that it
710    will not fail to start when the file exists but no daemon is running.
711
712  - Various manpage improvements, including some html representations (that
713    aren't installed by default).
714
715  - Made `-V` the short option for `--version` and improved its information.
716
717  - Pass the `-4` or `-6` option to the ssh command, making it easier to type
718    than `--rsh='ssh -4'` (or the `-6` equivalent).
719
720  - Added example config for rsyncd SSL proxy configs to rsyncd.conf.
721
722  - More errors messages now mention if the error is coming from the sender or
723    the receiver.
724
725 ### PACKAGING RELATED:
726
727  - Add installed bash script: /usr/bin/rsync-ssl
728
729  - Add installed manpage: /usr/man/man1/rsync-ssl.1
730
731  - Tweak auxiliary doc file names, such as: README.md, INSTALL.md, & NEWS.md.
732
733  - The rsync-ssl script wants to run openssl or stunnel4, so consider adding a
734    dependency for one of those options (though it's probably fine to just let
735    it complain about being unable to find the program and let the user decide
736    if they want to install one or the other).
737
738  - If you packaged rsync + rsync-ssl + rsync-ssl-daemon as separate packages,
739    the rsync-ssl package is now gone (rsync-ssl should be considered to be
740    mainstream now that Samba requires SSL for its rsync daemon).
741
742  - Add _build_ dependency for liblz4-dev, libxxhash-dev, libzstd-dev, and
743    libssl-dev.  These development libraries will give rsync extra compression
744    algorithms, extra checksum algorithms, and allow use of openssl's crypto
745    lib for (potentially) faster MD4/MD5 checksums.
746
747  - Add _build_ dependency for g++ or clang++ on x86_64 systems to enable the
748    SIMD checksum optimizations.
749
750  - Add _build_ dependency for _either_ python3-cmarkcfm or python3-commonmark
751    to allow for patching of manpages or building a git release.  This is not
752    required for a release-tar build, since it comes with pre-built manpages.
753    Note that cmarkcfm is faster than commonmark, but they generate the same
754    data.  The commonmark dependency is easiest to install since it's native
755    python, and can even be installed via `pip3 install --user commonmark` if
756    you want to just install it for the build user.
757
758  - Remove yodl _build_ dependency (if it was even listed before).
759
760 ### DEVELOPER RELATED:
761
762  - Silenced some annoying warnings about major() & minor() by improving an
763    autoconf include-file check.
764
765  - Converted the manpages from yodl to markdown. They are now processed via a
766    simple python3 script using the cmarkgfm **or** commonmark library.  This
767    should make it easier to package rsync, since yodl is rather obscure.
768
769  - Improved some configure checks to work better with strict C99 compilers.
770
771  - Some perl building/packaging scripts were recoded into awk and python3.
772
773  - Some defines in byteorder.h were changed into static inline functions that
774    will help to ensure that the args don't get evaluated multiple times on
775    "careful alignment" hosts.
776
777  - Some code typos were fixed (as pointed out by a Fossies run).
778
779 ------------------------------------------------------------------------------
780
781 # NEWS for rsync 3.1.3 (28 Jan 2018)
782
783 ## Changes in this version:
784
785 ### SECURITY FIXES:
786
787  - Fixed a buffer overrun in the protocol's handling of xattr names and ensure
788    that the received name is null terminated.
789
790  - Fix an issue with `--protect-args` where the user could specify the arg in the
791    protected-arg list and short-circuit some of the arg-sanitizing code.
792
793 ### BUG FIXES:
794
795  - Don't output about a new backup dir without appropriate info verbosity.
796
797  - Fixed some issues with the sort functions in the rsyncstats script (in the
798    support dir).
799
800  - Added a way to specify daemon config lists (e.g. users, groups, etc) that
801    contain spaces (see `auth users` in the latest rsyncd.conf manpage).
802
803  - If a backup fails (e.g. full disk) rsync exits with an error.
804
805  - Fixed a problem with a doubled `--fuzzy` option combined with `--link-dest`.
806
807  - Avoid invalid output in the summary if either the start or end time had an
808    error.
809
810  - We don't allow a popt alias to affect the `--daemon` or `--server` options.
811
812  - Fix daemon exclude code to disallow attribute changes in addition to
813    disallowing transfers.
814
815  - Don't force nanoseconds to match if a non-transferred, non-checksummed file
816    only passed the quick-check w/o comparing nanoseconds.
817
818 ### ENHANCEMENTS:
819
820  - Added the ability for rsync to compare nanosecond times in its file-check
821    comparisons, and added support nanosecond times on Mac OS X.
822
823  - Added a short-option (`-@`) for `--modify-window`.
824
825  - Added the `--checksum-choice=NAME[,NAME]` option to choose the checksum
826    algorithms.
827
828  - Added hashing of xattr names (with using `-X`) to improve the handling of
829    files with large numbers of xattrs.
830
831  - Added a way to filter xattr names using include/exclude/filter rules (see
832    the `--xattrs` option in the manpage for details).
833
834  - Added `daemon chroot|uid|gid` to the daemon config (in addition to the old
835    chroot|uid|gid settings that affect the daemon's transfer process).
836
837  - Added `syslog tag` to the daemon configuration.
838
839  - Some manpage improvements.
840
841 ### DEVELOPER RELATED:
842
843  - Tweak the `make` output when yodl isn't around to create the manpages.
844
845  - Changed an obsolete autoconf compile macro.
846
847  - Support newer yodl versions when converting manpages.
848
849 ------------------------------------------------------------------------------
850
851 # NEWS for rsync 3.1.2 (21 Dec 2015)
852
853 ## Changes in this version:
854
855 ### SECURITY FIXES:
856
857  - Make sure that all transferred files use only path names from inside the
858    transfer. This makes it impossible for a malicious sender to try to make the
859    receiver use an unsafe destination path for a transferred file, such as a
860    just-sent symlink.
861
862 ### BUG FIXES:
863
864  - Change the checksum seed order in the per-block checksums. This prevents
865    someone from trying to create checksum blocks that match in sum but not
866    content.
867
868  - Fixed a with the per-dir filter files (using `-FF`) that could trigger an
869    assert failure.
870
871  - Only skip `set_modtime()` on a transferred file if the time is exactly
872    right.
873
874  - Don't create an empty backup dir for a transferred file that doesn't exist
875    yet.
876
877  - Fixed a bug where `--link-dest` and `--xattrs` could cause rsync to exit if
878    a filename had a matching dir of the same name in the alt-dest area.
879
880  - Allow more than 32 group IDs per user in the daemon's gid=LIST config.
881
882  - Fix the logging of %b & %c via `--log-file` (daemon logging was already
883    correct, as was `--out-format='%b/%c'`).
884
885  - Fix erroneous acceptance of `--info=5` & `--debug=5` (an empty flag name is
886    not valid).
887
888 ### ENHANCEMENTS:
889
890  - Added `(DRY RUN)` info to the `--debug=exit` output line.
891
892  - Use usleep() for our msleep() function if it is available.
893
894  - Added a few extra long-option names to rrsync script, which will make
895    BackupPC happier.
896
897  - Made configure choose to use Linux xattrs on NetBSD (rather than not
898    supporting xattrs).
899
900  - Added `-wo` (write-only) option to rrsync support script.
901
902  - Misc. manpage tweaks.
903
904 ### DEVELOPER RELATED:
905
906  - Fixed a bug with the Makefile's use of `INSTALL_STRIP`.
907
908  - Improve a test in the suite that could get an erroneous timestamp error.
909
910  - Tweaks for newer versions of git in the packaging tools.
911
912  - Improved the m4 generation rules and some autoconf idioms.
913
914 ------------------------------------------------------------------------------
915
916 # NEWS for rsync 3.1.1 (22 Jun 2014)
917
918 ## Changes in this version:
919
920 ### BUG FIXES:
921
922  - If the receiver gets bogus filenames from the sender (an unexpected leading
923    slash or a `..` infix dir), exit with an error. This prevents a malicious
924    sender from trying to inject filenames that would affect an area outside the
925    destination directories.
926
927  - Fixed a failure to remove the partial-transfer temp file when interrupted
928    (and rsync is not saving the partial files).
929
930  - Changed the chown/group/xattr-set order to avoid losing some security-
931    related xattr info (that would get cleared by a chown).
932
933  - Fixed a bug in the xattr-finding code that could make a non-root-run
934    receiver not able to find some xattr numbers.
935
936  - Fixed a bug in the early daemon protocol where a timeout failed to be
937    honored (e.g. if the remote side fails to send us the initial protocol
938    greeting).
939
940  - Fixed unintended inclusion of commas in file numbers in the daemon log.
941
942  - We once again send the 'f' sub-flag (of `-e`) to the server side so it knows
943    that we can handle incremental-recursion directory errors properly in older
944    protocols.
945
946  - Fixed an issue with too-aggressive keep-alive messages causing a problem for
947    older rsync versions early in the transfer.
948
949  - Fixed an incorrect message about backup-directory-creation when using
950    `--dry-run` and the backup dir is not an absolute path.
951
952  - Fixed a bug where a failed deletion and/or a failed sender-side removal
953    would not affect the exit code.
954
955  - Fixed a bug that caused a failure when combining `--delete-missing-args`
956    with `--xattrs` and/or `--acls`.
957
958  - Fixed a strange `dir_depth` assertion error that was caused by empty-dir
959    removals and/or duplicate files in the transfer.
960
961  - Fixed a problem with `--info=progress2`'s output stats where rsync would
962    only update the stats at the end of each file's transfer. It now uses the
963    data that is flowing for the current file, making the stats more accurate
964    and less jumpy.
965
966  - Fixed an itemize bug that affected the combo of `--link-dest`, `-X`, and
967    `-n`.
968
969  - Fixed a problem with delete messages not appearing in the log file when the
970    user didn't use `--verbose`.
971
972  - Improve chunked xattr reading for OS X.
973
974  - Removed an attempted hard-link xattr optimization that was causing a
975    transfer failure. This removal is flagged in the compatibility code, so if a
976    better fix can be discovered, we have a way to flip it on again.
977
978  - Fixed a bug when the receiver is not configured to be able to hard link
979    symlimks/devices/special-file items but the sender sent some of these items
980    flagged as hard-linked.
981
982  - We now generate a better error if the buffer overflows in `do_mknod()`.
983
984  - Fixed a problem reading more than 16 ACLs on some OSes.
985
986  - Fixed the reading of the secrets file to avoid an infinite wait when the
987    username is missing.
988
989  - Fixed a parsing problem in the `--usermap`/`--groupmap` options when using
990    MIN-MAX numbers.
991
992  - Switched Cygwin back to using socketpair `pipes` to try to speed it up.
993
994  - Added knowledge of a few new options to rrsync.
995
996 ### ENHANCEMENTS:
997
998  - Tweaked the temp-file naming when `--temp-dir=DIR` is used: the temp-file
999    names will not get a '.' prepended.
1000
1001  - Added support for a new-compression idiom that does not compress all the
1002    matching data in a transfer. This can help rsync to use less cpu when a
1003    transfer has a lot of matching data, and also makes rsync compatible with a
1004    non-bundled zlib. See the `--new-compress` and `--old-compress` options in
1005    the manpage.
1006
1007  - Added the rsync-no-vanished shell script. (See the support dir.)
1008
1009  - Made configure more prominently mention when we failed to find yodl (in case
1010    the user wants to be able to generate manpages from `*.yo` files).
1011
1012  - Have manpage mention how a daemon's max-verbosity setting affects info and
1013    debug options. Also added more clarification on backslash removals for
1014    excludes that contain wildcards.
1015
1016  - Have configure check if for the attr lib (for getxattr) for those systems
1017    that need to link against it explicitly.
1018
1019  - Change the early dir-creation logic to only use that idiom in an
1020    inc-recursive copy that is preserving directory times. e.g. using
1021    `--omit-dir-times` will avoid these early directories being created.
1022
1023  - Fix a bug in `cmp_time()` that would return a wrong result if the 2 times
1024    differed by an amount greater than what a `time_t` can hold.
1025
1026 ### DEVELOPER RELATED:
1027
1028  - We now include an example systemd file (in packaging/systemd).
1029
1030  - Tweaked configure to make sure that any intended use of the included popt
1031    and/or zlib code is put early in the CFLAGS.
1032
1033 ------------------------------------------------------------------------------
1034
1035 # NEWS for rsync 3.1.0 (28 Sep 2013)
1036
1037 ## Changes in this version:
1038
1039 ### PROTOCOL NUMBER:
1040
1041  - The protocol number was changed to 31.
1042
1043 ### OUTPUT CHANGES:
1044
1045  - Output numbers in 3-digit groups by default (e.g. 1,234,567). See the
1046    `--human-readable` option for a way to turn it off. See also the daemon's
1047    `log format` parameter and related command-line options (including
1048    `--out-format`) for a modifier that can be used to request digit-grouping or
1049    human-readable output in log escapes. (Note that log output is unchanged by
1050    default.)
1051
1052  - The `--list-only` option is now affected by the `--human-readable` setting.
1053    It will display digit groupings by default, and unit suffixes if higher
1054    levels of readability are requested. Also, the column width for the size
1055    output has increased from 11 to 14 characters when human readability is
1056    enabled. Use `--no-h` to get the old-style output and column size.
1057
1058  - The output of the `--progress` option has changed: the string `xfer` was
1059    shortened to `xfr`, and the string `to-check` was shortened to `to-chk`,
1060    both designed to make room for the (by default) wider display of file size
1061    numbers without making the total line-length longer. Also, when incremental
1062    recursion is enabled, the string `ir-chk` will be used instead of `to-chk`
1063    up until the incremental-recursion scan is done, letting you know that the
1064    value to check and the total value will still be increasing as new files are
1065    found.
1066
1067  - Enhanced the `--stats` output: 1) to mention how many files were created
1068    (protocol >= 28), 2) to mention how many files were deleted (a new line for
1069    protocol 31, but only output when `--delete` is in effect), and 3) to follow
1070    the file-count, created-count, and deleted-count with a subcount list that
1071    shows the counts by type. The wording of the transferred count has also
1072    changed so that it is clearer that it is only a count of regular files.
1073
1074 ### BUG FIXES:
1075
1076  - Fixed a bug in the iconv code when EINVAL or EILSEQ is returned with a full
1077    output buffer.
1078
1079  - Fixed some rare bugs in `--iconv` processing that might cause a multi-byte
1080    character to get translated incorrectly.
1081
1082  - Fixed a bogus `vanished file` error if some files were specified with `./`
1083    prefixes and others were not.
1084
1085  - Fixed a bug in `--sparse` where an extra gap could get inserted after a
1086    partial write.
1087
1088  - Changed the way `--progress` overwrites its prior output in order to make it
1089    nearly impossible for the progress to get overwritten by an error.
1090
1091  - Improved the propagation of abnormal-exit error messages. This should help
1092    the client side to receive errors from the server when it is exiting
1093    abnormally, and should also avoid dying with an `connection unexpectedly
1094    closed` exit when the closed connection is really expected.
1095
1096  - The sender now checks each file it plans to remove to ensure that it hasn't
1097    changed from the first stat's info. This helps to avoid losing file data
1098    when the user is not using the option in a safe manner.
1099
1100  - Fixed a data-duplication bug in the compress option that made compression
1101    less efficient. This improves protocol 31 onward, while behaving in a
1102    compatible (buggy) manner with older rsync protocols.
1103
1104  - When creating a temp-file, rsync is now a bit smarter about it dot-char
1105    choices, which can fix a problem on OS X with names that start with `..`.
1106
1107  - Rsync now sets a cleanup flag for `--inplace` and `--append` transfers that
1108    will flush the write buffer if the transfer aborts. This ensures that more
1109    received data gets written out to the disk on an aborted transfer (which is
1110    quite helpful on a slow, flaky connection).
1111
1112  - The reads that `map_ptr()` now does are aligned on 1K boundaries. This helps
1113    some filesystems and/or files that don't like unaligned reads.
1114
1115  - Fix an issue in the msleep() function if time jumps backwards.
1116
1117  - Fix daemon-server module-name splitting bug where an arg would get split
1118    even if `--protect-args` was used.
1119
1120 ### ENHANCEMENTS:
1121
1122  - Added the `--remote-option=OPT` (`-M OPT`) command-line option that is
1123    useful for things like sending a remote `--log-file=FILE` or `--fake-super`
1124    option.
1125
1126  - Added the `--info=FLAGS` and `--debug=FLAGS` options to allow finer-grained
1127    control over what is output. Added an extra type of `--progress` output
1128    using `--info=progress2`.
1129
1130  - The `--msgs2stderr` option can help with debugging rsync by allowing the
1131    debug messages to get output to stderr rather than travel via the socket
1132    protocol.
1133
1134  - Added the `--delete-missing-args` and `--ignore-missing-args` options to
1135    either delete or ignore user-specified files on the receiver that are
1136    missing on the sender (normally the absence of user-specified files
1137    generates an error).
1138
1139  - Added a `T` (terabyte) category to the `--human-readable` size suffixes.
1140
1141  - Added the `--usermap`/`--groupmap`/`--chown` options for manipulating file
1142    ownership during the copy.
1143
1144  - Added the `%C` escape to the log-output handling, which will output the MD5
1145    checksum of any transferred file, or all files if `--checksum` was specified
1146    (when protocol 30 or above is in effect).
1147
1148  - Added the `reverse lookup` parameter to the rsync daemon config file to
1149    allow reverse-DNS lookups to be disabled.
1150
1151  - Added a forward-DNS lookup for the daemon's hosts allow/deny config. Can be
1152    disabled via `forward lookup` parameter (defaults to enabled).
1153
1154  - Added a way for more than one group to be specified in the daemon's config
1155    file, including a way to specify that you want all of the specified user's
1156    groups without having to name them. Also changed the daemon to complain
1157    about an inability to set explicitly-specified uid/gid values, even when not
1158    run by a super-user.
1159
1160  - The daemon now tries to send the user the error messages from the pre-xfer
1161    exec script when it fails.
1162
1163  - Improved the use of alt-dest options into an existing hierarchy of files: If
1164    a match is found in an alt-dir, it takes precedence over an existing file.
1165    (We'll need to wait for a future version before attribute-changes on
1166    otherwise unchanged files are safe when using an existing hierarchy.)
1167
1168  - Added per-user authorization options and group-authorization support to the
1169    daemon's `auth users` parameter.
1170
1171  - Added a way to reference environment variables in a daemon's config file
1172    (using %VAR% references).
1173
1174  - When replacing a non-dir with a symlink/hard-link/device/special-file, the
1175    update should now be done in an atomic manner.
1176
1177  - Avoid re-sending xattr info for hard-linked files w/the same xattrs
1178    (protocol 31).
1179
1180  - The backup code was improved to use better logic maintaining the backup
1181    directory hierarchy. Also, when a file is being backed up, rsync tries to
1182    hard-link it into place so that the upcoming replacement of the destination
1183    file will be atomic (for the normal, non-inplace logic).
1184
1185  - Added the ability to synchronize nanosecond modified times.
1186
1187  - Added a few more default suffixes for the `dont compress` settings.
1188
1189  - Added the checking of the `RSYNC_PROTECT_ARGS` environment variable to allow
1190    the default for the `--protect-args` command-line option to be overridden.
1191
1192  - Added the `--preallocate` command-line option.
1193
1194  - Allow `--password-file=-` to read the password from stdin (filename `-`).
1195
1196  - Rsync now comes packaged with an rsync-ssl helper script that can be used to
1197    contact a remote rsync daemon using a piped-stunnel command.  It also
1198    includes an stunnel config file to run the server side to support ssl daemon
1199    connections. See the packaging/lsb/rsync.spec file for one way to package
1200    the resulting files. (Suggestions for how to make this even easier to
1201    install & use are welcomed.)
1202
1203  - Improved the speed of some `--inplace` updates when there are lots of
1204    identical checksum blocks that end up being unusable.
1205
1206  - Added the `--outbuf=N|L|B` option for choosing the output buffering.
1207
1208  - Repeating the `--fuzzy` option now causes the code to look for fuzzy matches
1209    inside alt-dest directories too.
1210
1211  - The `--chmod` option now supports numeric modes, e.g. `--chmod=644,D755`
1212
1213  - Added some Solaris xattr code.
1214
1215  - Made an rsync daemon (the listening process) exit with a 0 status when it
1216    was signaled to die. This helps launchd.
1217
1218  - Improved the `RSYNC_*` environment variables for the pre-xfer exec script:
1219    when a daemon is sent multiple request args, they are now joined into a
1220    single return value (separated by spaces) so that the `RSYNC_REQUEST`
1221    environment variable is accurate for any `pre-xfer exec`. The values in
1222    `RSYNC_ARG#` vars are no longer truncated at the `.` arg (prior to the
1223    request dirs/files), so that all the requested values are also listed
1224    (separately) in `RSYNC_ARG#` variables.
1225
1226 ### EXTRAS:
1227
1228  - Added an `instant-rsyncd` script to the support directory, which makes it
1229    easy to configure a simple rsync daemon in the current directory.
1230
1231  - Added the `mapfrom` and `mapto` scripts to the support directory, which
1232    makes it easier to do user/group mapping in a local transfer based on
1233    passwd/group files from another machine.
1234
1235  - There's a new, improved version of the lsh script in the support dir: it's
1236    written in perl and supports `-u` without resorting to using sudo (when run
1237    as root). The old shell version is now named lsh.sh.
1238
1239  - There is a helper script named rsync-slash-strip in the support directory
1240    for anyone that wants to change the way rsync handles args with trailing
1241    slashes. (e.g. arg/ would get stripped to arg while arg/. would turn into
1242    arg/).
1243
1244 ### INTERNAL:
1245
1246  - The I/O code was rewritten to be simpler and do bigger buffered reads over
1247    the socket. The I/O between the receiver and the generator was changed to be
1248    standard multiplexed-I/O (like that over the socket).
1249
1250  - The sender tries to use any dead time while the generator is looking for
1251    files to transfer in order to do sender-side directory scanning in a more
1252    parallel manner.
1253
1254  - A daemon can now inform a client about a daemon-configured timeout value so
1255    that the client can assist in the keep-alive activity (protocol 31).
1256
1257  - The filter code received some refactoring to make it more extendable, to
1258    read better, and do better sanity checking.
1259
1260  - Really big numbers are now output using our own big-num routine rather than
1261    casting them to a double and using a %.0f conversion.
1262
1263  - The `pool_alloc` library has received some minor improvements in alignment
1264    handling.
1265
1266  - Added `init_stat_x()` function to avoid duplication of acl/xattr init code.
1267
1268  - The included zlib was upgraded from 1.2.3 to 1.2.8.
1269
1270  - Rsync can now be compiled to use an unmodified zlib library instead of the
1271    tweaked one that is included with rsync. This will eventually become the
1272    default, at which point we'll start the countdown to removing the included
1273    zlib. Until then, feel free to configure using:
1274
1275    ./configure `--with-included-zlib=no`
1276
1277 ### DEVELOPER RELATED:
1278
1279  - Added more conditional debug output.
1280
1281  - Fixed some build issues for Android and Minix.
1282
1283 ------------------------------------------------------------------------------
1284
1285 # NEWS for rsync 3.0.9 (23 Sep 2011)
1286
1287 ## Changes in this version:
1288
1289 ### BUG FIXES:
1290
1291  - Fix a crash bug in checksum scanning when `--inplace` is used.
1292
1293  - Fix a hang if a hard-linked file cannot be opened by the sender (e.g.  if it
1294    has no read permission).
1295
1296  - Fix preservation of a symlink's system xattrs (e.g. selinux) on Linux.
1297
1298  - Fix a memory leak in the xattr code.
1299
1300  - Fixed a bug with `--delete-excluded` when a filter merge file has a rule
1301    that specifies a receiver-only side restriction.
1302
1303  - Fix a bug with the modifying of unwritable directories.
1304
1305  - Fix `--fake-super`'s interaction with `--link-dest` same-file comparisons.
1306
1307  - Fix the updating of the `curr_dir` buffer to avoid a duplicate slash.
1308
1309  - Fix the directory permissions on an implied dot-dir when using `--relative`
1310    (e.g. /outside/path/././send/path).
1311
1312  - Fixed some too-long sleeping instances when using `--bwlimit`.
1313
1314  - Fixed when symlink ownership difference-checking gets compiled into
1315    `unchanged_attrs()`.
1316
1317  - Improved the socket-error reporting when multiple protocols fail.
1318
1319  - Fixed a case where a socket error could reference just-freed memory.
1320
1321  - Failing to use a password file that was specified on the command-line is now
1322    a fatal error.
1323
1324  - Fix the non-root updating of directories that don't have the read and/or
1325    execute permission.
1326
1327  - Make daemon-excluded file errors more error-like.
1328
1329  - Fix a compilation issue on older C compilers (due to a misplaced var
1330    declaration).
1331
1332  - Make configure avoid finding socketpair on Cygwin.
1333
1334  - Avoid trying to reference `SO_BROADCAST` if the OS doesn't support it.
1335
1336  - Fix some issues with the post-processing of the manpages.
1337
1338  - Fixed the user home-dir handling in the lsh script. (See the support dir.)
1339
1340  - Some minor manpage improvements.
1341
1342 ------------------------------------------------------------------------------
1343
1344 # NEWS for rsync 3.0.8 (26 Mar 2011)
1345
1346 ## Changes in this version:
1347
1348 ### BUG FIXES:
1349
1350  - Fixed two buffer-overflow issues: one where a directory path that is exactly
1351    MAXPATHLEN was not handled correctly, and one handling a `--backup-dir` that
1352    is extra extra large.
1353
1354  - Fixed a data-corruption issue when preserving hard-links without preserving
1355    file ownership, and doing deletions either before or during the transfer
1356    (CVE-2011-1097). This fixes some assert errors in the hard-linking code, and
1357    some potential failed checksums (via `-c`) that should have matched.
1358
1359  - Fixed a potential crash when an rsync daemon has a filter/exclude list and
1360    the transfer is using ACLs or xattrs.
1361
1362  - Fixed a hang if a really large file is being processed by an rsync that
1363    can't handle 64-bit numbers. Rsync will now complain about the file being
1364    too big and skip it.
1365
1366  - For devices and special files, we now avoid gathering useless ACL and/or
1367    xattr information for files that aren't being copied. (The un-copied files
1368    are still put into the file list, but there's no need to gather data that is
1369    not going to be used.) This ensures that if the user uses `--no-D`, that
1370    rsync can't possibly complain about being unable to gather extended
1371    information from special files that are in the file list (but not in the
1372    transfer).
1373
1374  - Properly handle requesting remote filenames that start with a dash. This
1375    avoids a potential error where a filename could be interpreted as a (usually
1376    invalid) option.
1377
1378  - Fixed a bug in the comparing of upper-case letters in file suffixes for
1379    `--skip-compress`.
1380
1381  - If an rsync daemon has a module configured without a path setting, rsync
1382    will now disallow access to that module.
1383
1384  - If the destination arg is an empty string, it will be treated as a reference
1385    to the current directory (as 2.x used to do).
1386
1387  - If rsync was compiled with a newer time-setting function (such as lutimes),
1388    rsync will fall-back to an older function (such as utimes) on a system where
1389    the newer function is not around. This helps to make the rsync binary more
1390    portable in mixed-OS-release situations.
1391
1392  - Fixed a batch-file writing bug that would not write out the full set of
1393    compatibility flags that the transfer was using. This fixes a potential
1394    protocol problem for a batch file that contains a sender-side I/O error: it
1395    would have been sent in a way that the batch-reader wasn't expecting.
1396
1397  - Some improvements to the hard-linking code to ensure that device-number
1398    hashing is working right, and to supply more information if the hard-link
1399    code fails.
1400
1401  - The `--inplace` code was improved to not search for an impossible checksum
1402    position. The quadruple-verbose chunk[N] message will now mention when an
1403    inplace chunk was handled by a seek rather than a read+write.
1404
1405  - Improved ACL mask handling, e.g. for Solaris.
1406
1407  - Fixed a bug that prevented `--numeric-ids` from disabling the translation of
1408    user/group IDs for ACLs.
1409
1410  - Fixed an issue where an xattr and/or ACL transfer that used an alt-dest
1411    option (e.g. `--link-dest`) could output an error trying to itemize the
1412    changes against the alt-dest directory's xattr/ACL info but was instead
1413    trying to access the not-yet-existing new destination directory.
1414
1415  - Improved xattr system-error messages to mention the full path to the file.
1416
1417  - The `--link-dest` checking for identical symlinks now avoids considering
1418    attribute differences that cannot be changed on the receiver.
1419
1420  - Avoid trying to read/write xattrs on certain file types for certain OSes.
1421    Improved configure to set `NO_SYMLINK_XATTRS`, `NO_DEVICE_XATTRS`, and/or
1422    `NO_SPECIAL_XATTRS` defines in config.h.
1423
1424  - Improved the unsafe-symlink errors messages.
1425
1426  - Fixed a bug setting xattrs on new files that aren't user writable.
1427
1428  - Avoid re-setting xattrs on a hard-linked file w/the same xattrs.
1429
1430  - Fixed a bug with `--fake-super` when copying files and dirs that aren't user
1431    writable.
1432
1433  - Fixed a bug where a sparse file could have its last sparse block turned into
1434    a real block when rsync sets the file size (requires ftruncate).
1435
1436  - If a temp-file name is too long, rsync now avoids truncating the name in the
1437    middle of adjacent high-bit characters. This prevents a potential filename
1438    error if the filesystem doesn't allow a name to contain an invalid
1439    multi-byte sequence.
1440
1441  - If a muli-protocol socket connection fails (i.e., when contacting a daemon),
1442    we now report all the failures, not just the last one. This avoids losing a
1443    relevant error (e.g. an IPv4 connection-refused error) that happened before
1444    the final error (e.g. an IPv6 protocol-not-supported error).
1445
1446  - Generate a transfer error if we try to call chown with a `-1` for a uid or a
1447    gid (which is not settable).
1448
1449  - Fixed the working of `--force` when used with `--one-file-system`.
1450
1451  - Fix the popt arg parsing so that an option that doesn't take an arg will
1452    reject an attempt to supply one (can configure `--with-included-popt` if
1453    your system's popt library doesn't yet have this fix).
1454
1455  - A couple minor option tweaks to the rrsync script, and also some regex
1456    changes that make vim highlighting happier. (See the support dir.)
1457
1458  - Fixed some issues in the mnt-excl script. (See the support dir.)
1459
1460  - Various manpage improvements.
1461
1462 ### ENHANCEMENTS:
1463
1464  - Added `.hg/` to the default cvs excludes (see `-C` & `--cvs-exclude`).
1465
1466 ### DEVELOPER RELATED:
1467
1468  - Use lchmod() whenever it is available (not just on symlinks).
1469
1470  - A couple fixes to the `socketpair_tcp()` routine.
1471
1472  - Updated the helper scripts in the packaging subdirectory.
1473
1474  - Renamed configure.in to configure.ac.
1475
1476  - Fixed configure's checking for iconv routines for newer OS X versions.
1477
1478  - Fixed the testsuite/xattrs.test script on OS X.
1479
1480 ------------------------------------------------------------------------------
1481
1482 # NEWS for rsync 3.0.7 (31 Dec 2009)
1483
1484 ## Changes in this version:
1485
1486 ### BUG FIXES:
1487
1488  - Fixed a bogus free when using `--xattrs` with `--backup`.
1489
1490  - Avoid an error when `--dry-run` was trying to stat a prior hard-link file
1491    that hasn't really been created.
1492
1493  - Fixed a problem with `--compress` (`-z`) where the receiving side could
1494    return the error "`inflate (token) returned -5`".
1495
1496  - Fixed a bug where `--delete-during` could delete in a directory before it
1497    noticed that the sending side sent an I/O error for that directory (both
1498    sides of the transfer must be at least 3.0.7).
1499
1500  - Improved `--skip-compress`'s error handling of bad character-sets and got
1501    rid of a lingering debug fprintf().
1502
1503  - Fixed the daemon's conveyance of `io_error` value from the sender.
1504
1505  - An rsync daemon use seteuid() (when available) if it used setuid().
1506
1507  - Get the permissions right on a `--fake-super` transferred directory that
1508    needs more owner permissions to emulate root behavior.
1509
1510  - An absolute-path filter rule (i.e. with a '/' modifier) no longer loses its
1511    modifier when sending the filter rules to the remote rsync.
1512
1513  - Improved the "`--delete does not work without -r or -d`" message.
1514
1515  - Improved rsync's handling of `--timeout` to avoid a weird timeout case where
1516    the sender could timeout even though it has recently written data to the
1517    socket (but hasn't read data recently, due to the writing).
1518
1519  - Some misc manpage improvements.
1520
1521  - Fixed the chmod-temp-dir testsuite on a system without /var/tmp.
1522
1523  - Make sure that a timeout specified in the daemon's config is used as a
1524    maximum timeout value when the user also specifies a timeout.
1525
1526  - Improved the error-exit reporting when rsync gets an error trying to cleanup
1527    after an error: the initial error is reported.
1528
1529  - Improved configure's detection of IPv6 for Solaris and Cygwin.
1530
1531  - The AIX sysacls routines will now return ENOSYS if ENOTSUP is missing.
1532
1533  - Made our (only used if missing) getaddrinfo() routine use `inet_pton()`
1534    (which we also provide) instead of `inet_aton()`.
1535
1536  - The exit-related debug messages now mention the program's role so it is
1537    clear who output what message.
1538
1539 ### DEVELOPER RELATED:
1540
1541  - Got rid of type-punned compiler warnings output by newer gcc versions.
1542
1543  - The Makefile now ensures that proto.h will be rebuilt if config.h changes.
1544
1545  - The testsuite no longer uses `id -u`, so it works better on Solaris.
1546
1547 ------------------------------------------------------------------------------
1548
1549 # NEWS for rsync 3.0.6 (8 May 2009)
1550
1551 ## Changes in this version:
1552
1553 ### BUG FIXES:
1554
1555  - Fixed a `--read-batch` hang when rsync is reading a batch file that was
1556    created from an incremental-recursion transfer.
1557
1558  - Fixed the daemon's socket code to handle the simultaneous arrival of
1559    multiple connections.
1560
1561  - Fix `--safe-links`/`--copy-unsafe-links` to properly handle symlinks that
1562    have consecutive slashes in the value.
1563
1564  - Fixed the parsing of an `[IPv6_LITERAL_ADDR]` when a USER@ is prefixed.
1565
1566  - The sender now skips a (bogus) symlink that has a 0-length value, which
1567    avoids a transfer error in the receiver.
1568
1569  - Fixed a case where the sender could die with a tag-0 error if there was an
1570    I/O during the sending of the file list.
1571
1572  - Fixed the rrsync script to avoid a server-side problem when `-e` is at the
1573    start of the short options.
1574
1575  - Fixed a problem where a vanished directory could turn into an exit code 23
1576    instead of the proper exit code 24.
1577
1578  - Fixed the `--iconv` conversion of symlinks when doing a local copy.
1579
1580  - Fixed a problem where `--one-file-system` was not stopping deletions on the
1581    receiving side when a mount-point directory did not match a directory in the
1582    transfer.
1583
1584  - Fixed the dropping of an ACL mask when no named ACL values were present.
1585
1586  - Fixed an ACL/xattr corruption issue where the `--backup` option could cause
1587    rsync to associate the wrong ACL/xattr information with received files.
1588
1589  - Fixed the use of `--xattrs` with `--only-write-batch`.
1590
1591  - Fixed the use of `--dry-run` with `--read-batch`.
1592
1593  - Fixed configure's erroneous use of target.
1594
1595  - Fixed configure's `--disable-debug` option.
1596
1597  - Fixed a run-time issue for systems that can't find `iconv_open()` by adding
1598    the `--disable-iconv-open` configure option.
1599
1600  - Complain and die if the user tries to combine `--remove-source-files` (or
1601    the deprecated `--remove-sent-files`) with `--read-batch`.
1602
1603  - Fixed an failure transferring special files from Solaris to Linux.
1604
1605 ------------------------------------------------------------------------------
1606
1607 # NEWS for rsync 3.0.5 (28 Dec 2008)
1608
1609 ## Changes in this version:
1610
1611 ### BUG FIXES:
1612
1613  - Initialize xattr data in a couple spots in the hlink code, which avoids a
1614    crash when the xattr pointer's memory happens to start out non-zero.  Also
1615    fixed the itemizing of an alt-dest file's xattrs when hard-linking.
1616
1617  - Don't send a bogus `-` option to an older server if there were no short
1618    options specified.
1619
1620  - Fixed skipping of unneeded updates in a batch file when incremental
1621    recursion is active. Added a test for this. Made batch-mode handle `redo`
1622    files properly (and without hanging).
1623
1624  - Fix the %P logfile escape when the daemon logs from inside a chroot.
1625
1626  - Fixed the use of `-s` (`--protect-args`) when used with a remote source or
1627    destination that had an empty path (e.g. `host:`). Also fixed a problem when
1628    `-s` was used when accessing a daemon via a remote-shell.
1629
1630  - Fixed the use of a dot-dir path (e.g. foo/./bar) inside a `--files-from`
1631    file when the root of the transfer isn't the current directory.
1632
1633  - Fixed a bug with `-K --delete` removing symlinks to directories when
1634    incremental recursion is active.
1635
1636  - Fixed a hard to trigger hang when using `--remove-source-files`.
1637
1638  - Got rid of an annoying delay when accessing a daemon via a remote-shell.
1639
1640  - Properly ignore (superfluous) source args on a `--read-batch` command.
1641
1642  - Improved the manpage's description of the `*` wildcard to remove the
1643    confusing `non-empty` qualifier.
1644
1645  - Fixed reverse lookups in the compatibility-library version of getnameinfo().
1646
1647  - Fixed a bug when using `--sparse` on a sparse file that has over 2GB of
1648    consecutive sparse data.
1649
1650  - Avoid a hang when using at least 3 `--verbose` options on a transfer with a
1651    client sender (which includes local copying).
1652
1653  - Fixed a problem with `--delete-delay` reporting an error when it was ready
1654    to remove a directory that was now gone.
1655
1656  - Got rid of a bunch of `warn_unused_result` compiler warnings.
1657
1658  - If an ftruncate() on a received file fails, it now causes a partial-
1659    transfer warning.
1660
1661  - Allow a path with a leading `//` to be preserved (CYGWIN only).
1662
1663 ### ENHANCEMENTS:
1664
1665  - Made the atomic-rsync script able to perform a fully atomic update of the
1666    copied hierarchy when the destination is setup using a particular symlink
1667    idiom. (See the support dir.)
1668
1669 ------------------------------------------------------------------------------
1670
1671 # NEWS for rsync 3.0.4 (6 Sep 2008)
1672
1673 ## Changes in this version:
1674
1675 ### BUG FIXES:
1676
1677  - Fixed a bug in the hard-linking code where it would sometimes try to
1678    allocate 0 bytes of memory (which fails on some OSes, such as AIX).
1679
1680  - Fixed the hard-linking of files from a device that has a device number of 0
1681    (which seems to be a common device number on NetBSD).
1682
1683  - Fixed the handling of a `--partial-dir` that cannot be created. This
1684    particularly impacts the `--delay-updates` option (since the files cannot be
1685    delayed without a partial-dir), and was potentially destructive if the
1686    `--remove-source-files` was also specified.
1687
1688  - Fixed a couple issues in the `--fake-super` handling of xattrs when the
1689    destination files have root-level attributes (e.g. selinux values) that a
1690    non-root copy can't affect.
1691
1692  - Improved the keep-alive check in the generator to fire consistently in
1693    incremental-recursion mode when `--timeout` is enabled.
1694
1695  - The `--iconv` option now converts the content of a symlink too, instead of
1696    leaving it in the wrong character-set (requires 3.0.4 on both sides of the
1697    transfer).
1698
1699  - When using `--iconv`, if a filename fails to convert on the receiving side,
1700    this no longer makes deletions in the root-dir of the transfer fail silently
1701    (the user now gets a warning about deletions being disabled due to IO error
1702    as long as `--ignore-errors` was not specified).
1703
1704  - When using `--iconv`, if a server-side receiver can't convert a filename,
1705    the error message sent back to the client no longer mangles the name with
1706    the wrong charset conversion.
1707
1708  - Fixed a potential alignment issue in the IRIX ACL code when allocating the
1709    initial `struct acl` object. Also, cast mallocs to avoid warnings.
1710
1711  - Changed some errors that were going to stdout to go to stderr.
1712
1713  - Made `human_num()` and `human_dnum()` able to output a negative number
1714    (rather than outputting a cryptic string of punctuation).
1715
1716 ### ENHANCEMENTS:
1717
1718  - Rsync will avoid sending an `-e` option to the server if an older protocol
1719    is requested (and thus the option would not be useful). This lets the user
1720    specify the `--protocol=29` option to access an overly-restrictive server
1721    that is rejecting the protocol-30 use of `-e` to the server.
1722
1723  - Improved the message output for an `RERR_PARTIAL` exit.
1724
1725 ### DEVELOPER RELATED:
1726
1727  - The Makefile will not halt for just a timestamp change on the Makefile or
1728    the configure files, only for actual changes in content.
1729
1730  - Changed some commands in the testsuite's xattrs.test that called `rsync`
1731    instead of `$RSYNC`.
1732
1733  - Enhanced the release scripts to be able to handle a branch release and to do
1734    even more consistency checks on the files.
1735
1736 ------------------------------------------------------------------------------
1737
1738 # NEWS for rsync 3.0.3 (29 Jun 2008)
1739
1740 ## Changes in this version:
1741
1742 ### BUG FIXES:
1743
1744  - Fixed a wildcard matching problem in the daemon when a module has `use
1745    chroot` enabled.
1746
1747  - Fixed a crash bug in the hard-link code.
1748
1749  - Fixed the sending of xattr directory information when the code finds a
1750    `--link-dest` or `--copy-dest` directory with unchanged xattrs -- the
1751    destination directory now gets these unchanged xattrs properly applied.
1752
1753  - Fixed an xattr-sending glitch that could cause an `Internal abbrev` error.
1754
1755  - Fixed the combination of `--xattrs` and `--backup`.
1756
1757  - The generator no longer allows a '.' dir to be excluded by a daemon-exclude
1758    rule.
1759
1760  - Fixed deletion handling when copying a single, empty directory (with no
1761    files) to a differently named, non-existent directory.
1762
1763  - Fixed the conversion of spaces into dashes in the %M log escape.
1764
1765  - Fixed several places in the code that were not returning the right errno
1766    when a function failed.
1767
1768  - Fixed the backing up of a device or special file into a backup dir.
1769
1770  - Moved the setting of the socket options prior to the connect().
1771
1772  - If rsync exits in the middle of a `--progress` output, it now outputs a
1773    newline to help prevent the progress line from being overwritten.
1774
1775  - Fixed a problem with how a destination path with a trailing slash or a
1776    trailing dot-dir was compared against the daemon excludes.
1777
1778  - Fixed the sending of large (size > 16GB) files when talking to an older
1779    rsync (protocols < 30): we now use a compatible block size limit.
1780
1781  - If a file's length is so huge that we overflow a checksum buffer count (i.e.
1782    several hundred TB), warn the user and avoid sending an invalid checksum
1783    struct over the wire.
1784
1785  - If a source arg is excluded, `--relative` no longer adds the excluded arg's
1786    implied dirs to the transfer. This fix also made the exclude check happen in
1787    the better place in the sending code.
1788
1789  - Use the `overflow_exit()` function for overflows, not `out_of_memory()`.
1790
1791  - Improved the code to better handle a system that has only 32-bit file
1792    offsets.
1793
1794 ### ENHANCEMENTS:
1795
1796  - The rsyncd.conf manpage now consistently refers to the parameters in the
1797    daemon config file as `parameters`.
1798
1799  - The description of the `--inplace` option was improved.
1800
1801 ### EXTRAS:
1802
1803  - Added a new script in the support directory, deny-rsync, which allows an
1804    admin to (temporarily) replace the rsync command with a script that sends an
1805    error message to the remote client via the rsync protocol.
1806
1807 ### DEVELOPER RELATED:
1808
1809  - Fixed a testcase failure if the tests are run as root and made some
1810    compatibility improvements.
1811
1812  - Improved the daemon tests, including checking module comments, the listing
1813    of files, and the ensuring that daemon excludes can't affect a dot-dir arg.
1814
1815  - Improved some build rules for those that build in a separate directory from
1816    the source, including better install rules for the manpages, and the fixing
1817    of a proto.h-tstamp rule that could make the binaries get rebuild without
1818    cause.
1819
1820  - Improved the testsuite to work around a problem with some utilities (e.g.
1821    `cp -p` & `touch -r`) rounding sub-second timestamps.
1822
1823  - Ensure that the early patches don't cause any generated-file hunks to
1824    bleed-over into patches that follow.
1825
1826 ------------------------------------------------------------------------------
1827
1828 # NEWS for rsync 3.0.2 (8 Apr 2008)
1829
1830 ## Changes in this version:
1831
1832 ### BUG FIXES:
1833
1834  - Fixed a potential buffer overflow in the xattr code.
1835
1836 ### ENHANCEMENTS:
1837
1838  - None.
1839
1840 ### DEVELOPER RELATED:
1841
1842  - The RPM spec file was improved to install more useful files.
1843
1844  - A few developer-oriented scripts were moved from the support dir to the
1845    packaging dir.
1846
1847 ------------------------------------------------------------------------------
1848
1849 # NEWS for rsync 3.0.1 (3 Apr 2008)
1850
1851 ## Changes in this version:
1852
1853 ### NOTABLE CHANGES IN BEHAVIOR:
1854
1855  - Added the 'c'-flag to the itemizing of non-regular files so that the
1856    itemized output doesn't get hidden if there were no attribute changes, and
1857    also so that the itemizing of a `--copy-links` run will distinguish between
1858    copying an identical non-regular file and the creation of a revised version
1859    with a new value (e.g. a changed symlink referent, a new device number,
1860    etc.).
1861
1862 ### BUG FIXES:
1863
1864  - Fixed a crash bug when a single-use rsync daemon (via remote shell) was run
1865    without specifying a `--config=FILE` option.
1866
1867  - Fixed a crash when backing up a directory that has a default ACL.
1868
1869  - Fixed a bug in the handling of xattr values that could cause rsync to not
1870    think that a file's extended attributes are up-to-date.
1871
1872  - Fixed the working of `--fake-super` with `--link-dest` and `--xattrs`.
1873
1874  - Fixed a hang when combining `--dry-run` with `--remove-source-files`.
1875
1876  - Fixed a bug with `--iconv`'s handling of files that cannot be converted: a
1877    failed name can no longer cause a transfer failure.
1878
1879  - Fixed the building of the rounding.h file on systems that need custom
1880    CPPFLAGS to be used. Also improved the error reporting if the building of
1881    rounding.h fails.
1882
1883  - Fixed the use of the `--protect-args` (`-s`) option when talking to a
1884    daemon.
1885
1886  - Fixed the `--ignore-existing` option's protection of files on the receiver
1887    that are non-regular files on the sender (e.g. if a symlink or a dir on the
1888    sender is trying to replace a file on the receiver). The reverse protection
1889    (protecting a dir/symlink/device from being replaced by a file) was already
1890    working.
1891
1892  - Fixed an assert failure if `--hard-links` is combined with an option that
1893    can skip a file in a set of hard-linked files (i.e. `--ignore-existing`,
1894    `--append`, etc.), without skipping all the files in the set.
1895
1896  - Avoid setting the modify time on a directory that already has the right
1897    modify time set. This avoids tweaking the dir's ctime.
1898
1899  - Improved the daemon-exclude handling to do a better job of applying the
1900    exclude rules to path entries. It also sends the user an error just as if
1901    the files were actually missing (instead of silently ignoring the user's
1902    args), and avoids sending the user the filter-action messages for these
1903    non-user-initiated rules.
1904
1905  - Fixed some glitches with the dry-run code's missing-directory handling,
1906    including a problem when combined with `--fuzzy`.
1907
1908  - Fixed some glitches with the skipped-directory handling.
1909
1910  - Fixed the 'T'-flag itemizing of symlinks when `--time` isn't preserved.
1911
1912  - Fixed a glitch in the itemizing of permissions with the `-E` option.
1913
1914  - The `--append` option's restricting of transfers to those that add data no
1915    longer prevents the updating of non-content changes to otherwise up-to-date
1916    files (i.e. those with the same content but differing permissions,
1917    ownership, xattrs, etc.).
1918
1919  - Don't allow `--fake-super` to be specified with `-XX` (double `--xattrs`)
1920    because the options conflict. If a daemon has `fake super` enabled, it
1921    automatically downgrades a `-XX` request to `-X`.
1922
1923  - Fixed a couple bugs in the parsing of daemon-config excludes that could make
1924    a floating exclude rule get treated as matching an absolute path.
1925
1926  - A daemon doesn't try to auto-refuse the `iconv` option if iconv-support
1927    wasn't compiled in to the daemon (avoiding a warning in the logs).
1928
1929  - Fixed the inclusion of per-dir merge files from implied dirs.
1930
1931  - Fixed the rrsync script to work with the latest options that rsync sends,
1932    including its flag-specifying use of `-e` to the server. (See the support
1933    dir.)
1934
1935 ### ENHANCEMENTS:
1936
1937  - Added the `--old-dirs` (`--old-d`) option to make it easier for a user to
1938    ask for file-listings with older rsync versions (this is easier than having
1939    to type `-r --exclude='/*/*'` manually).
1940
1941  - When getting an error while asking an older rsync daemon for a file listing,
1942    rsync will try to notice if the error is a rejection of the `--dirs` (`-d`)
1943    option and let the user know how to work around the issue.
1944
1945  - Added a few more `--no-OPTION` overrides.
1946
1947  - Improved the documentation of the `--append` option.
1948
1949  - Improved the documentation of the filter/exclude/include daemon parameters.
1950
1951 ### INTERNAL:
1952
1953  - Fixed a couple minor bugs in the included popt library (ones which I sent to
1954    the official popt project for inclusion in the 1.14 release).
1955
1956  - Fixed a stat() call that should have been `do_stat()` so that the proper
1957    normal/64-bit stat() function gets called. (Was in an area that should not
1958    have caused problems, though.)
1959
1960  - Changed the file-glob code to do a directory scan without using the `glob`
1961    and `glob.h`. This lets us do the globbing with less memory churn, and also
1962    avoid adding daemon-excluded items to the returned args.
1963
1964 ### DEVELOPER RELATED:
1965
1966  - The configure script tries to get the user's compiler to not warn about
1967    unused function parameters if the build is not including one or more of the
1968    ACL/xattrs/iconv features.
1969
1970  - The configure script now has better checks for figuring out if the included
1971    popt code should be used or not.
1972
1973  - Fixed two testsuite glitches: avoid a failure if someone's `cd` command
1974    outputs the current directory when cd-ing to a relative path, and made the
1975    itemized test query how rsync was built to determine if it should expect
1976    hard-linked symlinks or not.
1977
1978  - Updated the testsuite to verify that various bug fixes remain fixed.
1979
1980  - The RPM spec file was updated to have: (1) comments for how to use the
1981    rsync-patch tar file, and (2) an /etc/xinetd.d/rsync file.
1982
1983  - Updated the build scripts to work with a revised FTP directory structure.
1984
1985 ------------------------------------------------------------------------------
1986
1987 # NEWS for rsync 3.0.0 (1 Mar 2008)
1988
1989 ## Changes in this version:
1990
1991 ### PROTOCOL NUMBER:
1992
1993  - The protocol number was changed to 30.
1994
1995 ### NOTABLE CHANGES IN BEHAVIOR:
1996
1997  - The handling of implied directories when using `--relative` has changed to
1998    send them as directories (e.g. no implied dir is ever sent as a symlink).
1999    This avoids unexpected behavior and should not adversely affect most people.
2000    If you're one of those rare individuals who relied upon having an implied
2001    dir be duplicated as a symlink, you should specify the transfer of the
2002    symlink and the transfer of the referent directory as separate args. (See
2003    also `--keep-dirlinks` and `--no-implied-dirs`.) Also, exclude rules no
2004    longer have a partial effect on implied dirs.
2005
2006  - Requesting a remote file-listing without specifying `-r` (`--recursive`) now
2007    sends the `-d` (`--dirs`) option to the remote rsync rather than sending
2008    `-r` along with an extra exclude of `/*/*`. If the remote rsync does not
2009    understand the `-d` option (i.e. it is 2.6.3 or older), you will need to
2010    either turn off `-d` (`--no-d`), or specify `-r --exclude='/*/*'` manually.
2011
2012  - In `--dry-run` mode, the last line of the verbose summary text is output
2013    with a "(DRY RUN)" suffix to help remind you that no updates were made.
2014    Similarly, `--only-write-batch` outputs `(BATCH ONLY)`.
2015
2016  - A writable rsync daemon with `use chroot` disabled now defaults to a
2017    symlink-munging behavior designed to make symlinks safer while also allowing
2018    absolute symlinks to be stored and retrieved. This also has the effect of
2019    making symlinks unusable while they're in the daemon's hierarchy. See the
2020    daemon's `munge symlinks` parameter for details.
2021
2022  - Starting up an extra copy of an rsync daemon will not clobber the pidfile
2023    for the running daemon -- if the pidfile exists, the new daemon will exit
2024    with an error. This means that your wrapper script that starts the rsync
2025    daemon should be made to handle lock-breaking (if you want any automatic
2026    breaking of locks to be done).
2027
2028 ### BUG FIXES:
2029
2030  - A daemon with `use chroot = no` and excluded items listed in the daemon
2031    config file now properly checks an absolute-path arg specified for these
2032    options: `--compare-dest`, `--link-dest`, `--copy-dest`, `--partial-dir`,
2033    `--backup-dir`, `--temp-dir`, and `--files-from`.
2034
2035  - A daemon can now be told to disable all user- and group-name translation on
2036    a per-module basis. This avoids a potential problem with a writable daemon
2037    module that has `use chroot` enabled -- if precautions weren't taken, a user
2038    could try to add a missing library and get rsync to use it. This makes rsync
2039    safer by default, and more configurable when id-translation is not desired.
2040    See the daemon's `numeric ids` parameter for full details.
2041
2042  - A chroot daemon can now indicate which part of its path should affect the
2043    chroot call, and which part should become an inside-chroot path for the
2044    module. This allows you to have outside-the-transfer paths (such as for
2045    libraries) even when you enable chroot protection. The idiom used in the
2046    rsyncd.conf file is: `path = /chroot/dirs/./dirs/inside`
2047
2048  - If a file's data arrived successfully on the receiving side but the rename
2049    of the temporary file to the destination file failed AND the
2050    `--remove-source-files` (or the deprecated `--remove-sent-files`) option was
2051    specified, rsync no longer erroneously removes the associated source file.
2052
2053  - Fixed the output of `-ii` when combined with one of the `--*-dest` options:
2054    it now itemizes all the items, not just the changed ones.
2055
2056  - Made the output of all file types consistent when using a `--*-dest` option.
2057    Prior versions would output too many creation events for matching items.
2058
2059  - The code that waits for a child pid now handles being interrupted by a
2060    signal. This fixes a problem with the pre-xfer exec function not being able
2061    to get the exit status from the script.
2062
2063  - A negated filter rule (i.e. with a '!' modifier) no longer loses the
2064    negation when sending the filter rules to the remote rsync.
2065
2066  - Fixed a problem with the `--out-format` (aka `--log-format`) option %f: it
2067    no longer outputs superfluous directory info for a non-daemon rsync.
2068
2069  - Fixed a problem with `-vv` (double `--verbose`) and `--stats` when `pushing`
2070    files (which includes local copies). Version 2.6.9 would complete the copy,
2071    but exit with an error when the receiver output its memory stats.
2072
2073  - If `--password-file` is used on a non-daemon transfer, rsync now complains
2074    and exits. This should help users figure out that they can't use this option
2075    to control a remote shell's password prompt.
2076
2077  - Make sure that directory permissions of a newly-created destination
2078    directory are handled right when `--perms` is left off.
2079
2080  - The itemized output of a newly-created destination directory is now output
2081    as a creation event, not a change event.
2082
2083  - Improved `--hard-link` so that more corner cases are handled correctly when
2084    combined with options such as `--link-dest` and/or `--ignore-existing`.
2085
2086  - The `--append` option no longer updates a file that has the same size.
2087
2088  - Fixed a bug when combining `--backup` and `--backup-dir` with `--inplace`:
2089    any missing backup directories are now created.
2090
2091  - Fixed a bug when using `--backup` and `--inplace` with `--whole-file` or
2092    `--read-batch`: backup files are actually created now.
2093
2094  - The daemon pidfile is checked and created sooner in the startup sequence.
2095
2096  - If a daemon module's `path` value is not an absolute pathname, the code now
2097    makes it absolute internally (making it work properly).
2098
2099  - Ensure that a temporary file always has owner-write permission while we are
2100    writing to it. This avoids problems with some network filesystems when
2101    transferring read-only files.
2102
2103  - Any errors output about password-file reading no longer cause an error at
2104    the end of the run about a partial transfer.
2105
2106  - The `--read-batch` option for protocol 30 now ensures that several more
2107    options are set correctly for the current batch file: `--iconv`, `--acls`,
2108    `--xattrs`, `--inplace`, `--append`, and `--append-verify`.
2109
2110  - Using `--only-write-batch` to a daemon receiver now works properly (older
2111    versions would update some files while writing the batch).
2112
2113  - Avoid outputting a "file has vanished" message when the file is a broken
2114    symlink and `--copy-unsafe-links` or `--copy-dirlinks` is used (the code
2115    already handled this for `--copy-links`).
2116
2117  - Fixed the combination of `--only-write-batch` and `--dry-run`.
2118
2119  - Fixed rsync's ability to remove files that are not writable by the file's
2120    owner when rsync is running as the same user.
2121
2122  - When transferring large files, the sender's hashtable of checksums is kept
2123    at a more reasonable state of fullness (no more than 80% full) so that the
2124    scanning of the hashtable will not bog down as the number of blocks
2125    increases.
2126
2127 ### ENHANCEMENTS:
2128
2129  - A new incremental-recursion algorithm is now used when rsync is talking to
2130    another 3.x version. This starts the transfer going more quickly (before all
2131    the files have been found), and requires much less memory.  See the
2132    `--recursive` option in the manpage for some restrictions.
2133
2134  - Lowered memory use in the non-incremental-recursion algorithm for typical
2135    option values (usually saving from 21-29 bytes per file).
2136
2137  - The default `--delete` algorithm is now `--delete-during` when talking to a
2138    3.x rsync. This is a faster scan than using `--delete-before` (which is the
2139    default when talking to older rsync versions), and is compatible with the
2140    new incremental recursion mode.
2141
2142  - Rsync now allows multiple remote-source args to be specified rather than
2143    having to rely on a special space-splitting side-effect of the remote-
2144    shell. Additional remote args must specify the same host or an empty one
2145    (e.g. empty: `:file1` or `::module/file2`). For example, this means that
2146    local use of brace expansion now works: `rsync -av host:dir/{f1,f2} .`
2147
2148  - Added the `--protect-args` (`-s`) option, that tells rsync to send most of
2149    the command-line args at the start of the transfer rather than as args to
2150    the remote-shell command. This protects them from space-splitting, and only
2151    interprets basic wildcard special shell characters (`*?[`).
2152
2153  - Added the `--delete-delay` option, which is a more efficient way to delete
2154    files at the end of the transfer without needing a separate delete pass.
2155
2156  - Added the `--acls` (`-A`) option to preserve Access Control Lists. This is
2157    an improved version of the prior patch that was available, and it even
2158    supports OS X ACLs. If you need to have backward compatibility with old,
2159    ACL-patched versions of rsync, apply the acls.diff file from the patches
2160    dir.
2161
2162  - Added the `--xattrs` (`-X`) option to preserve extended attributes. This is
2163    an improved version of the prior patch that was available, and it even
2164    supports OS X xattrs (which includes their resource fork data). If you need
2165    to have backward compatibility with old, xattr-patched versions of rsync,
2166    apply the xattrs.diff file from the patches dir.
2167
2168  - Added the `--fake-super` option that allows a non-super user to preserve all
2169    attributes of a file by using a special extended-attribute idiom.  It even
2170    supports the storing of foreign ACL data on your backup server.  There is
2171    also an analogous `fake super` parameter for an rsync daemon.
2172
2173  - Added the `--iconv` option, which allows rsync to convert filenames from one
2174    character-set to another during the transfer. The default is to make this
2175    feature available as long as your system has `iconv_open()`.  If compilation
2176    fails, specify `--disable-iconv` to configure, and then rebuild. If you want
2177    rsync to perform character-set conversions by default, you can specify
2178    `--enable-iconv=CONVERT_STRING` with the default value for the `--iconv`
2179    option that you wish to use. For example, `--enable-iconv=.` is a good
2180    choice. See the rsync manpage for an explanation of the `--iconv` option's
2181    settings.
2182
2183  - A new daemon config parameter, `charset`, lets you control the character-
2184    set that is used during an `--iconv` transfer to/from a daemon module. You
2185    can also set your daemon to refuse `no-iconv` if you want to force the
2186    client to use an `--iconv` transfer (requiring an rsync 3.x client).
2187
2188  - Added the `--skip-compress=LIST` option to override the default list of file
2189    suffixes that will not be compressed when using `--compress` (`-z`).
2190
2191  - The daemon's default for `dont compress` was extended to include: `*.7z`
2192    `*.mp[34]` `*.mov` `*.avi` `*.ogg` `*.jpg` `*.jpeg` and the name-matching routine was also
2193    optimized to run more quickly.
2194
2195  - The `--max-delete` option now outputs a warning if it skipped any file
2196    deletions, including a count of how many deletions were skipped. (Older
2197    versions just silently stopped deleting things.)
2198
2199  - You may specify `--max-delete=0` to a 3.0.0 client to request that it warn
2200    about extraneous files without deleting anything. If you're not sure what
2201    version the client is, you can use the less-obvious `--max-delete=-1`, as
2202    both old and new versions will treat that as the same request (though older
2203    versions don't warn).
2204
2205  - The `--hard-link` option now uses less memory on both the sending and
2206    receiving side for all protocol versions. For protocol 30, the use of a
2207    hashtable on the sending side allows us to more efficiently convey to the
2208    receiver what files are linked together. This reduces the amount of data
2209    sent over the socket by a considerable margin (rather than adding more
2210    data), and limits the in-memory storage of the device+inode information to
2211    just the sending side for the new protocol 30, or to the receiving side when
2212    speaking an older protocol (note that older rsync versions kept the
2213    device+inode information on both sides).
2214
2215  - The filter rules now support a perishable (`p`) modifier that marks rules
2216    that should not have an effect in a directory that is being deleted. e.g.
2217    `-f '-p .svn/'` would only affect `live` .svn directories.
2218
2219  - Rsync checks all the alternate-destination args for validity (e.g.
2220    `--link-dest`). This lets the user know when they specified a directory that
2221    does not exist.
2222
2223  - If we get an ENOSYS error setting the time on a symlink, we don't complain
2224    about it anymore (for those systems that even support the setting of the
2225    modify-time on a symlink).
2226
2227  - Protocol 30 now uses MD5 checksums instead of MD4.
2228
2229  - Changed the `--append` option to not checksum the existing data in the
2230    destination file, which speeds up file appending.
2231
2232  - Added the `--append-verify` option, which works like the older `--append`
2233    option (verifying the existing data in the destination file). For
2234    compatibility with older rsync versions, any use of `--append` that is
2235    talking protocol 29 or older will revert to the `--append-verify` method.
2236
2237  - Added the `--contimeout=SECONDS` option that lets the user specify a
2238    connection timeout for rsync daemon access.
2239
2240  - Documented and extended the support for the `RSYNC_CONNECT_PROG` variable
2241    that can be used to enhance the client side of a daemon connection.
2242
2243  - Improved the dashes and double-quotes in the nroff manpage output.
2244
2245  - Rsync now supports a lot more `--no-OPTION` override options.
2246
2247 ### INTERNAL:
2248
2249  - The file-list sorting algorithm now uses a sort that keeps any same-named
2250    items in the same order as they were specified. This allows rsync to always
2251    ensure that the first of the duplicates is the one that will be included in
2252    the copy. The new sort is also faster than the glibc version of qsort() and
2253    mergesort().
2254
2255  - Rsync now supports the transfer of 64-bit timestamps (`time_t` values).
2256
2257  - Made the file-deletion code use a little less stack when recursing through a
2258    directory hierarchy of extraneous files.
2259
2260  - Fixed a build problem with older (2.x) versions of gcc.
2261
2262  - Added some isType() functions that make dealing with signed characters
2263    easier without forcing variables via casts.
2264
2265  - Changed strcat/strcpy/sprintf function calls to use safer versions.
2266
2267  - Upgraded the included popt version to 1.10.2 and improved its use of
2268    string-handling functions.
2269
2270  - Added missing prototypes for compatibility functions from the lib dir.
2271
2272  - Configure determines if iconv() has a const arg, allowing us to avoid a
2273    compiler warning.
2274
2275  - Made the sending of some numbers more efficient for protocol 30.
2276
2277  - Make sure that a daemon process doesn't mind if the client was weird and
2278    omitted the `--server` option.
2279
2280  - There are more internal logging categories available in protocol 30 than the
2281    age-old FINFO and FERROR, including `FERROR_XFER` and FWARN. These new
2282    categories allow some errors and warnings to go to stderr without causing an
2283    erroneous end-of-run warning about some files not being able to be
2284    transferred.
2285
2286  - Improved the use of `const` on pointers.
2287
2288  - Improved J.W.'s `pool_alloc` routines to add a way of incrementally freeing
2289    older sections of a pool's memory.
2290
2291  - The getaddrinfo.c compatibility code in the `lib` dir was replaced with some
2292    new code (derived from samba, derived from PostgreSQL) that has a better
2293    license than the old code.
2294
2295 ### DEVELOPER RELATED:
2296
2297  - Rsync is now licensed under the GPLv3 or later.
2298
2299  - Rsync is now being maintained in a `git` repository instead of CVS (though
2300    the old CVS repository still exists for historical access).  Several
2301    maintenance scripts were updated to work with git.
2302
2303  - Generated files are no longer committed into the source repository. The
2304    autoconf and autoheader commands are now automatically run during the normal
2305    use of `configure` and `make`. The latest dev versions of all generated
2306    files can also be copied from the samba.org web site (see the prepare-source
2307    script's fetch option).
2308
2309  - The `patches` directory of diff files is now built from branches in the
2310    rsync git repository (branch patch/FOO creates file patches/FOO.diff).  This
2311    directory is now distributed in a separate separate tar file named
2312    rsync-patches-VERSION.tar.gz instead of the main rsync-VERSION.tar.gz.
2313
2314  - The proto.h file is now built using a simple perl script rather than a
2315    complex awk script, which proved to be more widely compatible.
2316
2317  - When running the tests, we now put our per-test temp dirs into a sub-
2318    directory named testtmp (which is created, if missing). This allows someone
2319    to symlink the testtmp directory to another filesystem (which is useful if
2320    the build dir's filesystem does not support ACLs and xattrs, but another
2321    filesystem does).
2322
2323  - Rsync now has a way of handling protocol-version changes during the
2324    development of a new protocol version. This causes any out-of-sync versions
2325    to speak an older protocol rather than fail in a cryptic manner.  This
2326    addition makes it safer to deploy a pre-release version that may interact
2327    with the public. This new exchange of sub-version info does not interfere
2328    with the `{MIN,MAX}_PROTOCOL_VERSION` checking algorithm (which does not
2329    have enough range to allow the main protocol number to be incremented for
2330    every minor tweak in that happens during development).
2331
2332  - The csprotocol.txt file was updated to mention the daemon protocol change in
2333    the 3.0.0 release.
2334
2335 ------------------------------------------------------------------------------
2336
2337 # NEWS for rsync 2.6.9 (6 Nov 2006)
2338
2339 ## Changes in this version:
2340
2341 ### BUG FIXES:
2342
2343  - If rsync is interrupted via a handled signal (such as SIGINT), it will once
2344    again clean-up its temp file from the destination dir.
2345
2346  - Fixed an overzealous sanitizing bug in the handling of the `--link-dest`,
2347    `--copy-dest`, and `--compare-dest` options to a daemon without chroot: if
2348    the copy's destination dir is deeper than the top of the module's path,
2349    these options now accept a safe number of parent-dir (../) references (since
2350    these options are relative to the destination dir). The old code incorrectly
2351    chopped off all `../` prefixes for these options, no matter how deep the
2352    destination directory was in the module's hierarchy.
2353
2354  - Fixed a bug where a deferred info/error/log message could get sent directly
2355    to the sender instead of being handled by rwrite() in the generator. This
2356    fixes an `unexpected tag 3` fatal error, and should also fix a potential
2357    problem where a deferred info/error message from the receiver might bypass
2358    the log file and get sent only to the client process. (These problems could
2359    only affect an rsync daemon that was receiving files.)
2360
2361  - Fixed a bug when `--inplace` was combined with a `--*-dest` option and we
2362    update a file's data using an alternate basis file. The code now notices
2363    that it needs to copy the matching data from the basis file instead of
2364    (wrongly) assuming that it was already present in the file.
2365
2366  - Fixed a bug where using `--dry-run` with a `--*-dest` option with a path
2367    relative to a directory that does not yet exist: the affected option gets
2368    its proper path value so that the output of the dry-run is right.
2369
2370  - Fixed a bug in the %f logfile escape when receiving files: the destination
2371    path is now included in the output (e.g. you can now tell when a user
2372    specifies a subdir inside a module).
2373
2374  - If the receiving side fails to create a directory, it will now skip trying
2375    to update everything that is inside that directory.
2376
2377  - If `--link-dest` is specified with `--checksum` but without `--times`, rsync
2378    will now allow a hard-link to be created to a matching link-dest file even
2379    when the file's modify-time doesn't match the server's file.
2380
2381  - The daemon now calls more timezone-using functions prior to doing a chroot.
2382    This should help some C libraries to generate proper timestamps from inside
2383    a chrooted daemon (and to not try to access /etc/timezone over and over
2384    again).
2385
2386  - Fixed a bug in the handling of an absolute `--partial-dir=ABS_PATH` option:
2387    it now deletes an alternate basis file from the partial-dir that was used to
2388    successfully update a destination file.
2389
2390  - Fixed a bug in the handling of `--delete-excluded` when using a per-dir
2391    merge file: the merge file is now honored on the receiving side, and only
2392    its unqualified include/exclude commands are ignored (just as is done for
2393    global include/excludes).
2394
2395  - Fixed a recent bug where `--delete` was not working when transferring from
2396    the root (/) of the filesystem with `--relative` enabled.
2397
2398  - Fixed a recent bug where an `--exclude='*'` could affect the root (/) of the
2399    filesystem with `--relative` enabled.
2400
2401  - When `--inplace` creates a file, it is now created with owner read/write
2402    permissions (0600) instead of no permissions at all. This avoids a problem
2403    continuing a transfer that was interrupted (since `--inplace` will not
2404    update a file that has no write permissions).
2405
2406  - If either `--remove-source-files` or `--remove-sent-files` is enabled and we
2407    are unable to remove the source file, rsync now outputs an error.
2408
2409  - Fixed a bug in the daemon's `incoming chmod` rule: newly-created directories
2410    no longer get the 'F' (file) rules applied to them.
2411
2412  - Fixed an infinite loop bug when a filter rule was rejected due to being
2413    overly long.
2414
2415  - When the server receives a `--partial-dir` option from the client, it no
2416    longer runs the client-side code that adds an assumed filter rule (since the
2417    client will be sending us the rules in the usual manner, and they may have
2418    chosen to override the auto-added rule).
2419
2420 ### ENHANCEMENTS:
2421
2422  - Added the `--log-file=FILE` and `--log-file-format=FORMAT` options. These
2423    can be used to tell any rsync to output what it is doing to a log file.
2424    They work with a client rsync, a non-daemon server rsync (see the manpage
2425    for instructions), and also allows the overriding of rsyncd.conf settings
2426    when starting a daemon.
2427
2428  - The `--log-format` option was renamed to be `--out-format` to avoid
2429    confusing it with affecting the log-file output. (The old option remains as
2430    an alias for the new to preserve backward compatibility.)
2431
2432  - Made `log file` and `syslog facility` settable on a per-module basis in the
2433    daemon's config file.
2434
2435  - Added the `--remove-source-files` option as a replacement for the (now
2436    deprecated) `--remove-sent-files` option. This new option removes all
2437    non-dirs from the source directories, even if the file was already
2438    up-to-date. This fixes a problem where interrupting an rsync that was using
2439    `--remove-sent-files` and restarting it could leave behind a file that the
2440    earlier rsync synchronized, but didn't get to remove.  (The deprecated
2441    `--remove-sent-files` is still understood for now, and still behaves in the
2442    same way as before.)
2443
2444  - Added the option `--no-motd` to suppress the message-of-the-day output from
2445    a daemon when doing a copy. (See the manpage for a caveat.)
2446
2447  - Added a new environment variable to the pre-/post-xfer exec commands (in the
2448    daemon's config file): `RSYNC_PID`. This value will be the same in both the
2449    pre- and post-xfer commands, so it can be used as a unique ID if the
2450    pre-xfer command wants to cache some arg/request info for the post-xfer
2451    command.
2452
2453 ### INTERNAL:
2454
2455  - Did a code audit using IBM's code-checker program and made several changes,
2456    including: replacing most of the strcpy() and sprintf() calls with
2457    strlcpy(), snprintf(), and memcpy(), adding a 0-value to an enum that had
2458    been intermingling a literal 0 with the defined enum values, silencing some
2459    uninitialized memory checks, marking some functions with a `noreturn`
2460    attribute, and changing an `if` that could never succeed on some platforms
2461    into a pre-processor directive that conditionally compiles the code.
2462
2463  - Fixed a potential bug in `f_name_cmp()` when both the args are a top-level
2464    `.` dir (which doesn't happen in normal operations).
2465
2466  - Changed `exit_cleanup()` so that it can never return instead of exit.  The
2467    old code might return if it found the `exit_cleanup()` function was being
2468    called recursively. The new code is segmented so that any recursive calls
2469    move on to the next step of the exit-processing.
2470
2471  - The macro WIFEXITED(stat) will now be defined if the OS didn't already
2472    define it.
2473
2474 ### DEVELOPER RELATED:
2475
2476  - The acls.diff and xattrs.diff patches have received a bunch of work to make
2477    them much closer to being acceptable in the main distribution.  The xattrs
2478    patch also has some preliminary Mac OS X and FreeBSD compatibility code that
2479    various system types to exchange extended file-attributes.
2480
2481  - A new diff in the patches dir, fake-root.diff, allows rsync to maintain a
2482    backup hierarchy with full owner, group, and device info without actually
2483    running as root. It does this using a special extended attribute, so it
2484    depends on xattrs.diff (which depends on acls.diff).
2485
2486  - The rsync.yo and rsyncd.conf.yo files have been updated to work better with
2487    the latest yodl 2.x releases.
2488
2489  - Updated config.guess and config.sub to their 2006-07-02 versions.
2490
2491  - Updated various files to include the latest FSF address and to have
2492    consistent opening comments.
2493
2494 ------------------------------------------------------------------------------
2495
2496 # NEWS for rsync 2.6.8 (22 Apr 2006)
2497
2498 ## Changes in this version:
2499
2500 ### BUG FIXES:
2501
2502  - Fixed a bug in the exclude code where an anchored exclude without any
2503    wildcards fails to match an absolute source arg, but only when `--relative`
2504    is in effect.
2505
2506  - Improved the I/O code for the generator to fix a potential hang when the
2507    receiver gets an EOF on the socket but the generator's select() call never
2508    indicates that the socket is writable for it to be notified about the EOF.
2509    (This can happen when using stunnel).
2510
2511  - Fixed a problem with the file-reading code where a failed read (such as that
2512    caused by a bad sector) would not advance the file's read-position beyond
2513    the failed read's data.
2514
2515  - Fixed a logging bug where the `log file` directive was not being honored in
2516    a single-use daemon (one spawned by a remote-shell connection or by init).
2517
2518  - If rsync cannot honor the `--delete` option, we output an error and exit
2519    instead of silently ignoring the option.
2520
2521  - Fixed a bug in the `--link-dest` code that prevented special files (such as
2522    fifos) from being linked.
2523
2524  - The ability to hard-link symlinks and special files is now determined at
2525    configure time instead of at runtime. This fixes a bug with `--link-dest`
2526    creating a hard-link to a symlink's referent on a BSD system.
2527
2528 ### ENHANCEMENTS:
2529
2530  - In daemon mode, if rsync fails to bind to the requested port, the error(s)
2531    returned by socket() and/or bind() are now logged.
2532
2533  - When we output a fatal error, we now output the version of rsync in the
2534    message.
2535
2536  - Improved the documentation for the `--owner` and `--group` options.
2537
2538  - The rsyncstats script in `support` has an improved line-parsing regex that
2539    is easier to read and also makes it to parse syslog-generated lines.
2540
2541  - A new script in `support`: file-attr-restore, can be used to restore the
2542    attributes of a file-set (the permissions, ownership, and group info) taken
2543    from the cached output of a `find ARG... -ls` command.
2544
2545 ### DEVELOPER RELATED:
2546
2547  - Removed the unused function `write_int_named()`, the unused variable
2548    `io_read_phase`, and the rarely used variable `io_write_phase`. This also
2549    elides the confusing 'phase "unknown"' part of one error message.
2550
2551  - Removed two unused configure checks and two related (also unused)
2552    compatibility functions.
2553
2554  - The xattrs.diff patch received a security fix that prevents a potential
2555    buffer overflow in the `receive_xattr()` code.
2556
2557  - The acls.diff patch has been improved quite a bit, with more to come.
2558
2559  - A new patch was added: log-file.diff. This contains an early version of a
2560    future option, `--log-file=FILE`, that will allow any rsync to log its
2561    actions to a file (something that only a daemon supports at present).
2562
2563 ------------------------------------------------------------------------------
2564
2565 # NEWS for rsync 2.6.7 (11 Mar 2006)
2566
2567 ## Changes in this version:
2568
2569 ### OUTPUT CHANGES:
2570
2571  - The letter 'D' in the itemized output was being used for both devices
2572    (character or block) as well as other special files (such as fifos and named
2573    sockets). This has changed to separate non-device special files under the
2574    'S' designation (e.g. `cS+++++++ path/fifo`). See also the `--specials`
2575    option, below.
2576
2577  - The way rsync escapes unreadable characters has changed. First, rsync now
2578    has support for recognizing valid multi-byte character sequences in your
2579    current locale, allowing it to escape fewer characters than before for a
2580    locale such as UTF-8. Second, it now uses an escape idiom of `\#123`, which
2581    is the literal string `\#` followed by exactly 3 octal digits. Rsync no
2582    longer doubles a backslash character in a filename (e.g. it used to output
2583    `foo\\bar` when copying `foo\bar`) -- now it only escapes a backslash that
2584    is followed by a hash-sign and 3 digits (0-9) (e.g. it will output
2585    `foo\#134#789` when copying `foo\#789`). See also the `--8-bit-output`
2586    (`-8`) option, mentioned below.
2587
2588    Script writers: the local rsync is the one that outputs escaped names, so if
2589    you need to support unescaping of filenames for older rsyncs, I'd suggest
2590    that you parse the output of `rsync --version` and only use the old
2591    unescaping rules for 2.6.5 and 2.6.6.
2592
2593 ### BUG FIXES:
2594
2595  - Fixed a really old bug that caused `--checksum` (`-c`) to checksum all the
2596    files encountered during the delete scan (ouch).
2597
2598  - Fixed a potential hang in a remote generator: when the receiver gets a
2599    read-error on the socket, it now signals the generator about this so that
2600    the generator does not try to send any of the terminating error messages to
2601    the client (avoiding a potential hang in some setups).
2602
2603  - Made hard-links work with symlinks and devices again.
2604
2605  - If the sender gets an early EOF reading a source file, we propagate this
2606    error to the receiver so that it can discard the file and try requesting it
2607    again (which is the existing behavior for other kinds of read errors).
2608
2609  - If a device-file/special-file changes permissions, rsync now updates the
2610    permissions without recreating the file.
2611
2612  - If the user specifies a remote-host for both the source and destination, we
2613    now output a syntax error rather than trying to open the destination
2614    hostspec as a filename.
2615
2616  - When `--inplace` creates a new destination file, rsync now creates it with
2617    permissions 0600 instead of 0000 -- this makes restarting possible when the
2618    transfer gets interrupted in the middle of sending a new file.
2619
2620  - Reject the combination of `--inplace` and `--sparse` since the sparse-output
2621    algorithm doesn't work when overwriting existing data.
2622
2623  - Fixed the directory name in the error that is output when `pop_dir()` fails.
2624
2625  - Really fixed the parsing of a `!` entry in .cvsignore files this time.
2626
2627  - If the generator gets a stat() error on a file, output it (this used to
2628    require at least `-vv` for the error to be seen).
2629
2630  - If waitpid() fails or the child rsync didn't exit cleanly, we now handle the
2631    exit status properly and generate a better error.
2632
2633  - Fixed some glitches in the double-verbose output when using `--copy-dest`,
2634    `--link-dest`, or `--compare-dest`. Also improved how the verbose output
2635    handles hard-links (within the transfer) that had an up-to-date alternate
2636    `dest` file, and copied files (via `--copy-dest`).
2637
2638  - Fixed the matching of the dont-compress items (e.g. `*.gz`) against files
2639    that have a path component containing a slash.
2640
2641  - If the code reading a filter/exclude file gets an EINTR error, rsync now
2642    clears the error flag on the file handle so it can keep on reading.
2643
2644  - If `--relative` is active, the sending side cleans up trailing `/` or `/.`
2645    suffixes to avoid triggering a bug in older rsync versions. Also, we now
2646    reject a `..` dir if it would be sent as a relative dir.
2647
2648  - If a non-directory is in the way of a directory and rsync is run with
2649    `--dry-run` and `--delete`, rsync no longer complains about not being able
2650    to opendir() the not-yet present directory.
2651
2652  - When `--list-only` is used and a non-existent local destination dir was also
2653    specified as a destination, rsync no longer generates a warning about being
2654    unable to create the missing directory.
2655
2656  - Fixed some problems with `--relative --no-implied-dirs` when the destination
2657    directory did not yet exist: we can now create a symlink or device when it
2658    is the first thing in the missing dir, and `--fuzzy` no longer complains
2659    about being unable to open the missing dir.
2660
2661  - Fixed a bug where the `--copy-links` option would not affect implied
2662    directories without `--copy-unsafe-links` (see `--relative`).
2663
2664  - Got rid of the need for `--force` to be used in some circumstances with
2665    `--delete-after` (making it consistent with
2666    `--delete-before`/`--delete-during`).
2667
2668  - Rsync now ignores the SIGXFSZ signal, just in case your OS sends this when a
2669    file is too large (rsync handles the write error).
2670
2671  - Fixed a bug in the Proxy-Authorization header's base64-encoded value: it was
2672    not properly padded with trailing '=' chars. This only affects a user that
2673    need to use a password-authenticated proxy for an outgoing daemon-rsync
2674    connection.
2675
2676  - If we're transferring an empty directory to a new name, rsync no longer
2677    forces `S_IWUSR` if it wasn't already set, nor does it accidentally leave it
2678    set.
2679
2680  - Fixed a bug in the debug output (`-vvvvv`) that could mention the wrong
2681    checksum for the current file offset.
2682
2683  - Rsync no longer allows a single directory to be copied over a non-directory
2684    destination arg.
2685
2686 ### ENHANCEMENTS:
2687
2688  - Added the `--append` option that makes rsync append data onto files that are
2689    longer on the source than the destination (this includes new files).
2690
2691  - Added the `--min-size=SIZE` option to exclude small files from the transfer.
2692
2693  - Added the `--compress-level` option to allow you to set how aggressive
2694    rsync's compression should be (this option implies `--compress`).
2695
2696  - Enhanced the parsing of the SIZE value for `--min-size` and `--max-size` to
2697    allow easy entry of multiples of 1000 (instead of just multiples of 1024)
2698    and off-by-one values too (e.g. `--max-size=8mb-1`).
2699
2700  - Added the `--8-bit-output` (`-8`) option, which tells rsync to avoid
2701    escaping high-bit characters that it thinks are unreadable in the current
2702    locale.
2703
2704  - The new option `--human-readable` (`-h`) changes the output of `--progress`,
2705    `--stats`, and the end-of-run summary to be easier to read. If repeated, the
2706    units become powers of 1024 instead of powers of 1000. (The old meaning of
2707    `-h`, as a shorthand for `--help`, still works as long as you just use it on
2708    its own, as in `rsync -h`.)
2709
2710  - If lutimes() and/or lchmod() are around, use them to allow the preservation
2711    of attributes on symlinks.
2712
2713  - The `--link-dest` option now affects symlinks and devices (when possible).
2714
2715  - Added two config items to the rsyncd.conf parsing: `pre-xfer exec` and
2716    `post-xfer exec`. These allow a command to be specified on a per-module
2717    basis that will be run before and/or after a daemon-mode transfer. (See the
2718    manpage for a list of the environment variables that are set with
2719    information about the transfer.)
2720
2721  - When using the `--relative` option, you can now insert a dot dir in the
2722    source path to indicate where the replication of the source dirs should
2723    start. For example, if you specify a source path of
2724    rsync://host/module/foo/bar/./baz/dir with `-R`, rsync will now only
2725    replicate the `baz/dir` part of the source path (note: a trailing dot dir is
2726    unaffected unless it also has a trailing slash).
2727
2728  - Added some new `--no-FOO` options that make it easier to override unwanted
2729    implied or default options. For example, `-a --no-o` (aka `--archive
2730    --no-owner`) can be used to turn off the preservation of file ownership that
2731    is implied by `-a`.
2732
2733  - Added the `--chmod=MODE` option that allows the destination permissions to
2734    be changed from the source permissions. E.g. `--chmod=g+w,o-rwx`
2735
2736  - Added the `incoming chmod` and `outgoing chmod` daemon options that allow a
2737    module to specify what permissions changes should be applied to all files
2738    copied to and from the daemon.
2739
2740  - Allow the `--temp-dir` option to be specified when starting a daemon, which
2741    sets the default temporary directory for incoming files.
2742
2743  - If `--delete` is combined with `--dirs` without `--recursive`, rsync will
2744    now delete in any directory whose content is being synchronized.
2745
2746  - If `--backup` is combined with `--delete` without `--backup-dir` (and
2747    without `--delete-excluded`), we add a `protect` filter-rule to ensure that
2748    files with the backup suffix are not deleted.
2749
2750  - The file-count stats that are output by `--progress` were improved to better
2751    indicate what the numbers mean. For instance, the output: `(xfer#5,
2752    to-check=8383/9999)` indicates that this was the fifth file to be
2753    transferred, and we still need to check 8383 more files out of a total of
2754    9999.
2755
2756  - The include/exclude code now allows a `dir/***` directive (with 3 trailing
2757    stars) to match both the dir itself as well as all the content below the dir
2758    (`dir/**` would not match the dir).
2759
2760  - Added the `--prune-empty-dirs` (`-m`) option that makes the receiving rsync
2761    discard empty chains of directories from the file-list. This makes it easier
2762    to selectively copy files from a source hierarchy and end up with just the
2763    directories needed to hold the resulting files.
2764
2765  - If the `--itemize-changes` (`-i`) option is repeated, rsync now includes
2766    unchanged files in the itemized output (similar to `-vv`, but without all
2767    the other verbose messages that can get in the way). Of course, the client
2768    must be version 2.6.7 for this to work, but the remote rsync only needs to
2769    be 2.6.7 if you're pushing files.
2770
2771  - Added the `--specials` option to tell rsync to copy non-device special files
2772    (which rsync now attempts even as a normal user). The `--devices` option now
2773    requests the copying of just devices (character and block).  The `-D` option
2774    still requests both (e.g. `--devices` and `--specials`), `-a` still implies
2775    `-D`, and non-root users still get a silent downgrade that omits device
2776    copying.
2777
2778  - Added the `--super` option to make the receiver always attempt super-user
2779    activities. This is useful for systems that allow things such as devices to
2780    be created or ownership to be set without being UID 0, and is also useful
2781    for someone who wants to ensure that errors will be output if the receiving
2782    rsync isn't being run as root.
2783
2784  - Added the `--sockopts` option for those few who want to customize the TCP
2785    options used to contact a daemon rsync.
2786
2787  - Added a way for the `--temp-dir` option to be combined with a partial-dir
2788    setting that lets rsync avoid non-atomic updates (for those times when
2789    `--temp-dir` is not being used because space is tight).
2790
2791  - A new support script, files-to-excludes, will transform a list of files into
2792    a set of include/exclude directives that will copy those files.
2793
2794  - A new option, `--executability` (`-E`) can be used to preserve just the
2795    execute bit on files, for those times when using the `--perms` option is not
2796    desired.
2797
2798  - The daemon now logs each connection and also each module-list request that
2799    it receives.
2800
2801  - New log-format options: %M (modtime), %U (uid), %G (gid), and %B (permission
2802    bits, e.g. `rwxr-xrwt`).
2803
2804  - The `--dry-run` option no longer forces the enabling of `--verbose`.
2805
2806  - The `--remove-sent-files` option now does a better job of incrementally
2807    removing the sent files on the sending side (older versions tended to clump
2808    up all the removals at the end).
2809
2810  - A daemon now supersedes its minimal SIGCHLD handler with the standard
2811    PID-remembering version after forking. This ensures that the generator can
2812    get the child-exit status from the receiver.
2813
2814  - Use of the `--bwlimit` option no longer interferes with the remote rsync
2815    sending error messages about invalid/refused options.
2816
2817  - Rsync no longer returns a usage error when used with one local source arg
2818    and no destination: this now implies the `--list-only` option, just like the
2819    comparable situation with a remote source arg.
2820
2821  - Added the `--copy-dirlinks` option, a more limited version of
2822    `--copy-links`.
2823
2824  - Various documentation improvements, including: a better synopsis, some
2825    improved examples, a better discussion of the presence and absence of
2826    `--perms` (including how it interacts with the new `--executability` and
2827    `--chmod` options), an extended discussion of `--temp-dir`, an improved
2828    discussion of `--partial-dir`, a better description of rsync's pattern
2829    matching characters, an improved `--no-implied-dirs` section, and the
2830    documenting of what the `--stats` option outputs.
2831
2832  - Various new and updated diffs in the patches dir, including: acls.diff,
2833    xattrs.diff, atimes.diff, detect-renamed.diff, and slp.diff.
2834
2835 ### INTERNAL:
2836
2837  - We now use sigaction() and sigprocmask() if possible, and fall back on
2838    signal() if not. Using sigprocmask() ensures that rsync enables all the
2839    signals that it needs, just in case it was started in a masked state.
2840
2841  - Some buffer sizes were expanded a bit, particularly on systems where
2842    MAXPATHLEN is overly small (e.g. Cygwin).
2843
2844  - If `io_printf()` tries to format more data than fits in the buffer, exit
2845    with an error instead of transmitting a truncated buffer.
2846
2847  - If a `va_copy` macro is defined, lib/snprintf.c will use it when defining
2848    the `VA_COPY` macro.
2849
2850  - Reduced the amount of stack memory needed for each level of directory
2851    recursion by nearly MAXPATHLEN bytes.
2852
2853  - The wildmatch function was extended to allow an array of strings to be
2854    supplied as the string to match. This allows the exclude code to do less
2855    string copying.
2856
2857  - Got rid of the `safe_fname()` function (and all the myriad calls) and
2858    replaced it with a new function in the log.c code that filters all the
2859    output going to the terminal.
2860
2861  - Unified the `f_name()` and the `f_name_to()` functions.
2862
2863  - Improved the hash-table code the sender uses to handle checksums to make it
2864    use slightly less memory and run just a little faster.
2865
2866 ### DEVELOPER RELATED:
2867
2868  - The diffs in the patches dir now require `patch -p1 <DIFF` instead of the
2869    previous `-p0`. Also, the version included in the release tar now affect
2870    generated files (e.g. configure, rsync.1, proto.h, etc.), so it is no longer
2871    necessary to run autoconf and/or yodl unless you're applying a patch that
2872    was checked out from CVS.
2873
2874  - Several diffs in the patches dir now use the proper `--enable-FOO` configure
2875    option instead of `--with-FOO` to turn on the inclusion of the newly patched
2876    feature.
2877
2878  - There is a new script, `prepare-source` than can be used to update the
2879    various generated files (proto.h, configure, etc.) even before configure has
2880    created the Makefile (this is mainly useful when patching the source with a
2881    patch that doesn't affect generated files).
2882
2883  - The testsuite now sets HOME so that it won't be affected by a file such as
2884    ~/.popt.
2885
2886 ------------------------------------------------------------------------------
2887
2888 # NEWS for rsync 2.6.6 (28 Jul 2005)
2889
2890 ## Changes in this version:
2891
2892 ### SECURITY FIXES:
2893
2894  - The zlib code was upgraded to version 1.2.3 in order to make it more secure.
2895    While the widely-publicized security problem in zlib 1.2.2 did not affect
2896    rsync, another security problem surfaced that affects rsync's zlib 1.1.4.
2897
2898 ### BUG FIXES:
2899
2900  - The setting of `flist->high` in `clean_flist()` was wrong for an empty list.
2901    This could cause `flist_find()` to crash in certain rare circumstances (e.g.
2902    if just the right directory setup was around when `--fuzzy` was combined
2903    with `--link-dest`).
2904
2905  - The outputting of hard-linked files when verbosity was > 1 was not right:
2906    (1) Without `-i` it would output the name of each hard-linked file as though
2907    it had been changed; it now outputs a `is hard linked` message for the file.
2908    (2) With `-i` it would output all dots for the unchanged attributes of a
2909    hard-link; it now changes those dots to spaces, as is done for other totally
2910    unchanged items.
2911
2912  - When backing up a changed symlink or device, get rid of any old backup item
2913    so that we don't get an `already exists` error.
2914
2915  - A couple places that were comparing a local and a remote modification-time
2916    were not honoring the `--modify-window` option.
2917
2918  - Fixed a bug where the 'p' (permissions) itemized-changes flag might get set
2919    too often (if some non-significant mode bits differed).
2920
2921  - Fixed a really old, minor bug that could cause rsync to warn about being
2922    unable to mkdir() a path that ends in `/.` because it just created the
2923    directory (required `--relative`, `--no-implied-dirs`, a source path that
2924    ended in either a trailing slash or a trailing `/.`, and a non-existing
2925    destination dir to tickle the bug in a recent version).
2926
2927 ### ENHANCEMENTS:
2928
2929  - Made the `max verbosity` setting in the rsyncd.conf file settable on a
2930    per-module basis (which now matches the documentation).
2931
2932  - The rrsync script has been upgraded to verify the args of options that take
2933    args (instead of rejecting any such options). It was also changed to try to
2934    be more secure and to fix a problem in the parsing of a pull operation that
2935    has multiple source args. (See the support dir.)
2936
2937  - Improved the documentation that explains the difference between a normal
2938    daemon transfer and a daemon-over remote-shell transfer.
2939
2940  - Some of the diffs supplied in the patches dir were fixed and/or improved.
2941
2942 ### BUILD CHANGES:
2943
2944  - Made configure define `NOBODY_USER` (currently hard-wired to `nobody`) and
2945    `NOBODY_GROUP` (set to either `nobody` or `nogroup` depending on what we
2946    find in the /etc/group file).
2947
2948  - Added a test to the test suite, itemized.test, that tests the output of `-i`
2949    (log-format w/%i) and some double-verbose messages.
2950
2951 ------------------------------------------------------------------------------
2952
2953 # NEWS for rsync 2.6.5 (1 Jun 2005)
2954
2955 ## Changes in this version:
2956
2957 ### OUTPUT CHANGES:
2958
2959  - Non-printable chars in filenames are now output using backslash-escaped
2960    characters rather than '?'s. Any non-printable character is output using 3
2961    digits of octal (e.g. `\n` -> `\012`), and a backslash is now output as
2962    `\\`. Rsync also uses your locale setting, which can make it treat fewer
2963    high-bit characters as non-printable.
2964
2965  - If rsync received an empty file-list when pulling files, it would output a
2966    `nothing to do` message and exit with a 0 (success) exit status, even if the
2967    remote rsync returned an error (it did not do this under the same conditions
2968    when pushing files). This was changed to make the pulling behavior the same
2969    as the pushing behavior: we now do the normal end-of-run outputting
2970    (depending on options) and exit with the appropriate exit status.
2971
2972 ### BUG FIXES:
2973
2974  - A crash bug was fixed when a daemon had its `path` set to `/`, did not have
2975    chroot enabled, and used some anchored excludes in the rsyncd.conf file.
2976
2977  - Fixed a bug in the transfer of a single file when `-H` is specified (rsync
2978    would either infinite loop or perhaps crash).
2979
2980  - Fixed a case where the generator might try (and fail) to tweak the
2981    write-permissions of a read-only directory in list-only mode (this only
2982    caused an annoying warning message).
2983
2984  - If `--compare-dest` or `--link-dest` uses a locally-copied file as the basis
2985    for an updated version, log this better when `--verbose` or `-i` is in
2986    effect.
2987
2988  - Fixed the accidental disabling of `--backup` during the `--delete-after`
2989    processing.
2990
2991  - Restored the ability to use the `--address` option in client mode (in
2992    addition to its use in daemon mode).
2993
2994  - Make sure that some temporary progress information from the delete
2995    processing does not get left on the screen when it is followed by a newline.
2996
2997  - When `--existing` skips a directory with extra verbosity, refer to it as a
2998    `directory`, not a `file`.
2999
3000  - When transferring a single file to a different-named file, any generator
3001    messages that are source-file related no longer refer to the file by the
3002    destination filename.
3003
3004  - Fixed a bug where hard-linking a group of files might fail if the generator
3005    hasn't created a needed destination directory yet.
3006
3007  - Fixed a bug where a hard-linked group of files that is newly-linked to a
3008    file in a `--link-dest` dir doesn't link the files from the rest of the
3009    cluster.
3010
3011  - When deleting files with the `--one-file-system` (`-x`) option set, rsync no
3012    longer tries to remove files from inside a mount-point on the receiving
3013    side. Also, we don't complain about being unable to remove the mount-point
3014    dir.
3015
3016  - Fixed a compatibility problem when using `--cvs-ignore` (`-C`) and sending
3017    files to an older rsync without using `--delete`.
3018
3019  - Make sure that a `- !` or `+ !` include/exclude pattern does not trigger the
3020    list-clearing action that is reserved for `!`.
3021
3022  - Avoid a timeout in the generator when the sender/receiver aren't handling
3023    the generator's checksum output quickly enough.
3024
3025  - Fixed the omission of some directories in the delete processing when
3026    `--relative` (`-R`) was combined with a source path that had a trailing
3027    slash.
3028
3029  - Fixed a case where rsync would erroneously delete some files and then
3030    re-transfer them when the options `--relative` (`-R`) and `--recursive`
3031    (`-r`) were both enabled (along with `--delete`) and a source path had a
3032    trailing slash.
3033
3034  - Make sure that `--max-size` doesn't affect a device or a symlink.
3035
3036  - Make sure that a system with a really small MAXPATHLEN does not cause the
3037    buffers in `readfd_unbuffered()` to be too small to receive normal messages.
3038    (This mainly affected Cygwin.)
3039
3040  - If a source pathname ends with a filename of `..`, treat it as if `../` had
3041    been specified (so that we don't copy files to the parent dir of the
3042    destination).
3043
3044  - If `--delete` is combined with a file-listing rsync command (i.e. no
3045    transfer is happening), avoid outputting a warning that we couldn't delete
3046    anything.
3047
3048  - If `--stats` is specified with `--delete-after`, ensure that all the
3049    `deleting` messages are output before the statistics.
3050
3051  - Improved one `if` in the deletion code that was only checking errno for
3052    ENOTEMPTY when it should have also been checking for EEXIST (for
3053    compatibility with OS variations).
3054
3055 ### ENHANCEMENTS:
3056
3057  - Added the `--only-write-batch=FILE` option that may be used (instead of
3058    `--write-batch=FILE`) to create a batch file without doing any actual
3059    updating of the destination. This allows you to divert all the file-updating
3060    data away from a slow data link (as long as you are pushing the data to the
3061    remote server when creating the batch).
3062
3063  - When the generator is taking a long time to fill up its output buffer (e.g.
3064    if the transferred files are few, small, or missing), it now periodically
3065    flushes the output buffer so that the sender/receiver can get started on the
3066    files sooner rather than later.
3067
3068  - Improved the keep-alive code to handle a long silence between the sender and
3069    the receiver that can occur when the sender is receiving the checksum data
3070    for a large file.
3071
3072  - Improved the auth-errors that are logged by the daemon to include some
3073    information on why the authorization failed: wrong user, password mismatch,
3074    etc. (The client-visible message is unchanged!)
3075
3076  - Improved the client's handling of an `@ERROR` from a daemon so that it does
3077    not complain about an unexpectedly closed socket (since we really did expect
3078    the socket to close).
3079
3080  - If the daemon can't open the log-file specified in rsyncd.conf, fall back to
3081    using syslog and log an appropriate warning. This is better than what was
3082    typically a totally silent (and fatal) failure (since a daemon is not
3083    usually run with the `--no-detach` option that was necessary to see the
3084    error on stderr).
3085
3086  - The manpages now consistently refer to an rsync daemon as a `daemon`
3087    instead of a `server` (to distinguish it from the server process in a
3088    non-daemon transfer).
3089
3090  - Made a small change to the rrsync script (restricted rsync -- in the support
3091    dir) to make a read-only server reject all `--remove-*` options when sending
3092    files (to future-proof it against the possibility of other similar options
3093    being added at some point).
3094
3095 ### INTERNAL:
3096
3097  - Rsync now calls `setlocale(LC_CTYPE, "")`. This enables isprint() to better
3098    discern which filename characters need to be escaped in messages (which
3099    should result in fewer escaped characters in some locales).
3100
3101  - Improved the naming of the log-file open/reopen/close functions.
3102
3103  - Removed some protocol-compatibility code that was only needed to help
3104    someone running a pre-release of 2.6.4.
3105
3106 ### BUILD CHANGES:
3107
3108  - Added configure option `--disable-locale` to disable any use of setlocale()
3109    in the binary.
3110
3111  - Fixed a bug in the `SUPPORT{,_HARD}_LINKS` #defines which prevented rsync
3112    from being built without symlink or hard-link support.
3113
3114  - Only #define `HAVE_REMSH` if it is going to be set to 1.
3115
3116  - Configure now disables the use of mkstemp() under HP-UX (since they refuse
3117    to fix its broken handling of large files).
3118
3119  - Configure now explicitly checks for the lseek64() function so that the code
3120    can use `HAVE_LSEEK64` instead of inferring lseek64()'s presence based on
3121    the presence of the `off64_t` type.
3122
3123  - Configure no longer mentions the change in the default remote-shell (from
3124    rsh to ssh) that occurred for the 2.6.0 release.
3125
3126  - Some minor enhancements to the test scripts.
3127
3128  - Added a few new `*.diff` files to the patches dir, including a patch that
3129    enables the optional copying of extended attributes.
3130
3131 ------------------------------------------------------------------------------
3132
3133 # NEWS for rsync 2.6.4 (30 March 2005)
3134
3135 ## Changes in this version:
3136
3137 ### PROTOCOL NUMBER:
3138
3139  - The protocol number was changed to 29.
3140
3141 ### OUTPUT CHANGES:
3142
3143  - When rsync deletes a directory and outputs a verbose message about it, it
3144    now appends a trailing slash to the name instead of (only sometimes)
3145    outputting a preceding "directory " string.
3146
3147  - The `--stats` output will contain file-list time-statistics if both sides
3148    are 2.6.4, or if the local side is 2.6.4 and the files are being pushed
3149    (since the stats come from the sending side).  (Requires protocol 29 for a
3150    pull.)
3151
3152  - The `%o` (operation) log-format escape now has a third value (besides `send`
3153    and `recv`): `del.` (with trailing dot to make it 4 chars).  This changes
3154    the way deletions are logged in the daemon's log file.
3155
3156  - When the `--log-format` option is combined with `--verbose`, rsync now
3157    avoids outputting the name of the file twice in most circumstances.  As long
3158    as the `--log-format` item does not refer to any post-transfer items (such
3159    as %b or %c), the `--log-format` message is output prior to the transfer, so
3160    `--verbose` is now the equivalent of a `--log-format` of '%n%L' (which
3161    outputs the name and any link info). If the log output must occur after the
3162    transfer to be complete, the only time the name is also output prior to the
3163    transfer is when `--progress` was specified (so that the name will precede
3164    the progress stats, and the full `--log-format` output will come after).
3165
3166  - Non-printable characters in filenames are replaced with a '?' to avoid
3167    corrupting the screen or generating empty lines in the output.
3168
3169 ### BUG FIXES:
3170
3171  - Restore the list-clearing behavior of `!` in a .cvsignore file (2.6.3 was
3172    only treating it as a special token in an rsync include/exclude file).
3173
3174  - The combination of `--verbose` and `--dry-run` now mentions the full list of
3175    changes that would be output without `--dry-run`.
3176
3177  - Avoid a mkdir warning when removing a directory in the destination that
3178    already exists in the `--backup-dir`.
3179
3180  - An OS that has a binary mode for its files (such as Cygwin) needed
3181    `setmode(fd, O_BINARY)` called on the temp-file we opened with mkstemp().
3182    (Fix derived from Cygwin's 2.6.3 rsync package.)
3183
3184  - Fixed a potential hang when verbosity is high, the client side is the
3185    sender, and the file-list is large.
3186
3187  - Fixed a potential protocol-corrupting bug where the generator could merge a
3188    message from the receiver into the middle of a multiplexed packet of data if
3189    only part of that data had been written out to the socket when the message
3190    from the generator arrived.
3191
3192  - We now check if the OS doesn't support using mknod() for creating FIFOs and
3193    sockets, and compile-in some compatibility code using mkfifo() and socket()
3194    when necessary.
3195
3196  - Fixed an off-by-one error in the handling of `--max-delete=N`. Also, if the
3197    `--max-delete` limit is exceeded during a run, we now output a warning about
3198    this at the end of the run and exit with a new error code (25).
3199
3200  - One place in the code wasn't checking if fork() failed.
3201
3202  - The `ignore nonreadable` daemon parameter used to erroneously affect
3203    readable symlinks that pointed to a non-existent file.
3204
3205  - If the OS does not have lchown() and a chown() of a symlink will affect the
3206    referent of a symlink (as it should), we no longer try to set the user and
3207    group of a symlink.
3208
3209  - The generator now properly runs the hard-link loop and the dir-time
3210    rewriting loop after we're sure that the redo phase is complete.
3211
3212  - When `--backup` was specified with `--partial-dir=DIR`, where DIR is a
3213    relative path, the backup code was erroneously trying to backup a file that
3214    was put into the partial-dir.
3215
3216  - If a file gets resent in a single transfer and the `--backup` option is
3217    enabled along with `--inplace`, rsync no longer performs a duplicate backup
3218    (it used to overwrite the first backup with the failed file).
3219
3220  - One call to `flush_write_file()` was not being checked for an error.
3221
3222  - The `--no-relative` option was not being sent from the client to a server
3223    sender.
3224
3225  - If an rsync daemon specified `dont compress = ...` for a file and the client
3226    tried to specify `--compress`, the libz code was not handling a compression
3227    level of 0 properly. This could cause a transfer failure if the block-size
3228    for a file was large enough (e.g. rsync might have exited with an error for
3229    large files).
3230
3231  - Fixed a bug that would sometimes surface when using `--compress` and sending
3232    a file with a block-size larger than 64K (either manually specified, or
3233    computed due to the file being really large). Prior versions of rsync would
3234    sometimes fail to decompress the data properly, and thus the transferred
3235    file would fail its verification.
3236
3237  - If a daemon can't open the specified log file (i.e. syslog is not being
3238    used), die without crashing. We also output an error about the failure on
3239    stderr (which will only be seen if `--no-detach` was specified) and exit
3240    with a new error code (6).
3241
3242  - A local transfer no longer duplicates all its include/exclude options (since
3243    the forked process already has a copy of the exclude list, there's no need
3244    to send them a set of duplicates).
3245
3246  - The output of the items that are being updated by the generator (dirs,
3247    symlinks, devices) is now intermingled in the proper order with the output
3248    from the items that the receiver is updating (regular files) when pulling.
3249    This misordering was particularly bad when `--progress` was specified.
3250    (Requires protocol 29.)
3251
3252  - When `--timeout` is specified, lulls that occur in the transfer while the
3253    generator is doing work that does not generate socket traffic (looking for
3254    changed files, deleting files, doing directory-time touch-ups, etc.) will
3255    cause a new keep-alive packet to be sent that should keep the transfer going
3256    as long as the generator continues to make progress. (Requires protocol 29.)
3257
3258  - The stat size of a device is not added to the total file size of the items
3259    in the transfer (the size might be undefined on some OSes).
3260
3261  - Fixed a problem with refused-option messages sometimes not making it back to
3262    the client side when a remote `--files-from` was in effect and the daemon
3263    was the receiver.
3264
3265  - The `--compare-dest` option was not updating a file that differed in (the
3266    preserved) attributes from the version in the compare-dest DIR.
3267
3268  - When rsync is copying files into a write-protected directory, fixed the
3269    change-report output for the directory so that we don't report an identical
3270    directory as changed.
3271
3272 ### ENHANCEMENTS:
3273
3274  - Rsync now supports popt's option aliases, which means that you can use
3275    /etc/popt and/or ~/.popt to create your own option aliases.
3276
3277  - Added the `--delete-during` (`--del`) option which will delete files from
3278    the receiving side incrementally as each directory in the transfer is being
3279    processed. This makes it more efficient than the default,
3280    before-the-transfer behavior, which is now also available as
3281    `--delete-before` (and is still the default `--delete-WHEN` option that will
3282    be chosen if `--delete` or `--delete-excluded` is specified without a
3283    `--delete-WHEN` choice). All the `--del*` options infer `--delete`, so an
3284    rsync daemon that refuses `delete` will still refuse to allow any
3285    file-deleting options (including the new `--remove-sent-files` option).
3286
3287  - All the `--delete-WHEN` options are now more memory efficient: Previously an
3288    duplicate set of file-list objects was created on the receiving side for the
3289    entire destination hierarchy. The new algorithm only creates one directory
3290    of objects at a time (for files inside the transfer).
3291
3292  - Added the `--copy-dest` option, which works like `--link-dest` except that
3293    it locally copies identical files instead of hard-linking them.
3294
3295  - Added support for specifying multiple `--compare-dest`, `--copy-dest`, or
3296    `--link-dest` options, but only of a single type. (Promoted from the patches
3297    dir and enhanced.) (Requires protocol 29.)
3298
3299  - Added the `--max-size` option. (Promoted from the patches dir.)
3300
3301  - The daemon-mode options are now separated from the normal rsync options so
3302    that they can't be mixed together. This makes it impossible to start a
3303    daemon that has improper default option values (which could cause problems
3304    when a client connects, such as hanging or crashing).
3305
3306  - The `--bwlimit` option may now be used in combination with `--daemon` to
3307    specify both a default value for the daemon side and a value that cannot be
3308    exceeded by a user-specified `--bwlimit` option.
3309
3310  - Added the `port` parameter to the rsyncd.conf file. (Promoted from the
3311    patches dir.) Also added `address`. The command-line options take precedence
3312    over a config-file option, as expected.
3313
3314  - In `_exit_cleanup()`: when we are exiting with a partially-received file, we
3315    now flush any data in the write-cache before closing the partial file.
3316
3317  - The `--inplace` support was enhanced to work with `--compare-dest`,
3318    `--link-dest`, and (the new) `--copy-dest` options. (Requires protocol 29.)
3319
3320  - Added the `--dirs` (`-d`) option for an easier way to copy directories
3321    without recursion. Any directories that are encountered are created on the
3322    destination. Specifying a directory with a trailing slash copies its
3323    immediate contents to the destination.
3324
3325  - The `--files-from` option now implies `--dirs` (`-d`).
3326
3327  - Added the `--list-only` option, which is mainly a way for the client to put
3328    the server into listing mode without needing to resort to any internal
3329    option kluges (e.g. the age-old use of `-r --exclude='/*/*'` for a
3330    non-recursive listing). This option is used automatically (behind the
3331    scenes) when a modern rsync speaks to a modern daemon, but may also be
3332    specified manually if you want to force the use of the `--list-only` option
3333    over a remote-shell connection.
3334
3335  - Added the `--omit-dir-times` (`-O`) option, which will avoid updating the
3336    modified time for directories when `--times` was specified. This option will
3337    avoid an extra pass through the file-list at the end of the transfer (to
3338    tweak all the directory times), which may provide an appreciable speedup for
3339    a really large transfer. (Promoted from the patches dir.)
3340
3341  - Added the `--filter` (`-f`) option and its helper option, `-F`. Filter rules
3342    are an extension to the existing include/exclude handling that also supports
3343    nested filter files as well as per-directory filter files (like .cvsignore,
3344    but with full filter-rule parsing).  This new option was chosen in order to
3345    ensure that all existing include/exclude processing remained 100% compatible
3346    with older versions. Protocol 29 is needed for full filter-rule support, but
3347    backward-compatible rules work with earlier protocol versions.  (Promoted
3348    from the patches dir and enhanced.)
3349
3350  - Added the `--delay-updates` option that puts all updated files into a
3351    temporary directory (by default `.~tmp~`, but settable via the
3352    `--partial-dir=DIR` option) until the end of the transfer. This makes the
3353    updates a little more atomic for a large transfer.
3354
3355  - If rsync is put into the background, any output from `--progress` is
3356    reduced.
3357
3358  - Documented the `max verbosity` setting for rsyncd.conf. (This setting was
3359    added a couple releases ago, but left undocumented.)
3360
3361  - The sender and the generator now double-check the file-list index they are
3362    given, and refuse to try to do a file transfer on a non-file index (since
3363    that would indicate that something had gone very wrong).
3364
3365  - Added the `--itemize-changes` (`-i`) option, which is a way to output a more
3366    detailed list of what files changed and in what way. The effect is the same
3367    as specifying a `--log-format` of `%i %n%L` (see both the rsync and
3368    rsyncd.conf manpages). Works with `--dry-run` too.
3369
3370  - Added the `--fuzzy` (`-y`) option, which attempts to find a basis file for a
3371    file that is being created from scratch. The current algorithm only looks in
3372    the destination directory for the created file, but it does attempt to find
3373    a match based on size/mod-time (in case the file was renamed with no other
3374    changes) as well as based on a fuzzy name-matching algorithm. This option
3375    requires protocol 29 because it needs the new file-sorting order. (Promoted
3376    from patches dir and enhanced.) (Requires protocol 29.)
3377
3378  - Added the `--remove-sent-files` option, which lets you move files between
3379    systems.
3380
3381  - The hostname in HOST:PATH or HOST::PATH may now be an IPv6 literal enclosed
3382    in '[' and ']' (e.g. `[::1]`). (We already allowed IPv6 literals in the
3383    rsync://HOST:PORT/PATH format.)
3384
3385  - When rsync recurses to build the file list, it no longer keeps open one or
3386    more directory handles from the dir's parent dirs.
3387
3388  - When building under windows, the default for `--daemon` is now to avoid
3389    detaching, requiring the new `--detach` option to force rsync to detach.
3390
3391  - The `--dry-run` option can now be combined with either `--write-batch` or
3392    `--read-batch`, allowing you to run a do-nothing test command to see what
3393    would happen without `--dry-run`.
3394
3395  - The daemon's `read only` config item now sets an internal `read_only`
3396    variable that makes extra sure that no write/delete calls on the read-only
3397    side can succeed.
3398
3399  - The log-format % escapes can now have a numeric field width in between the %
3400    and the escape letter (e.g. `%-40n %08p`).
3401
3402  - Improved the option descriptions in the `--help` text.
3403
3404 ### SUPPORT FILES:
3405
3406  - Added atomic-rsync to the support dir: a perl script that will transfer some
3407    files using rsync, and then move the updated files into place all at once at
3408    the end of the transfer. Only works when pulling, and uses `--link-dest` and
3409    a parallel hierarchy of files to effect its update.
3410
3411  - Added mnt-excl to the support dir: a perl script that takes the /proc/mounts
3412    file and translates it into a set of excludes that will exclude all mount
3413    points (even mapped mounts to the same disk). The excludes are made relative
3414    to the specified source dir and properly anchored.
3415
3416  - Added savetransfer.c to the support dir: a C program that can make a copy of
3417    all the data that flows over the wire. This lets you test for data
3418    corruption (by saving the data on both the sending side and the receiving
3419    side) and provides one way to debug a protocol error.
3420
3421  - Added rrsync to the support dir: this is an updated version of Joe Smith's
3422    restricted rsync perl script. This helps to ensure that only certain rsync
3423    commands can be run by an ssh invocation.
3424
3425 ### INTERNAL:
3426
3427  - Added better checking of the checksum-header values that come over the
3428    socket.
3429
3430  - Merged a variety of file-deleting functions into a single function so that
3431    it is easier to maintain.
3432
3433  - Improved the type of some variables (particularly blocksize vars) for
3434    consistency and proper size.
3435
3436  - Got rid of the uint64 type (which we didn't need).
3437
3438  - Use a slightly more compatible set of core #include directives.
3439
3440  - Defined int32 in a way that ensures that the build dies if we can't find a
3441    variable with at least 32 bits.
3442
3443 ### PROTOCOL DIFFERENCES FOR VERSION 29:
3444
3445  - A 16-bit flag-word is transmitted after every file-list index. This
3446    indicates what is changing between the sender and the receiver. The
3447    generator now transmits an index and a flag-word to indicate when dirs and
3448    symlinks have changed (instead of producing a message), which makes the
3449    outputting of the information more consistent and less prone to screen
3450    corruption (because the local receiver/sender is now outputting all the
3451    file-change info messages).
3452
3453  - If a file is being hard-linked, the `ITEM_XNAME_FOLLOWS` bit is enabled in
3454    the flag-word and the name of the file that was linked immediately follows
3455    in vstring format (see below).
3456
3457  - If a file is being transferred with an alternate-basis file, the
3458    `ITEM_BASIS_TYPE_FOLLOWS` bit is enabled in the flag-word and a single byte
3459    follows, indicating what type of basis file was chosen. If that indicates
3460    that a fuzzy-match was selected, the `ITEM_XNAME_FOLLOWS` bit is set in the
3461    flag-word and the name of the match in vstring format follows the basis
3462    byte. A vstring is a variable length string that has its size written prior
3463    to the string, and no terminating null.  If the string is from 1-127 bytes,
3464    the length is a single byte. If it is from 128-32767 bytes, the length is
3465    written as ((len >> 8) | 0x80) followed by (len % 0x100).
3466
3467  - The sending of exclude names is done using filter-rule syntax. This means
3468    that all names have a prefixed rule indicator, even excludes (which used to
3469    be sent as a bare pattern, when possible). The `-C` option will include the
3470    per-dir .cvsignore merge file in the list of filter rules so it is
3471    positioned correctly (unlike in some older transfer scenarios).
3472
3473  - Rsync sorts the filename list in a different way: it sorts the subdir names
3474    after the non-subdir names for each dir's contents, and it always puts a
3475    dir's contents immediately after the dir's name in the list. (Previously an
3476    item named `foo.txt` would sort in between directory `foo/` and `foo/bar`.)
3477
3478  - When talking to a protocol 29 rsync daemon, a list-only request is able to
3479    note this before the options are sent over the wire and the new
3480    `--list-only` option is included in the options.
3481
3482  - When the `--stats` bytes are sent over the wire (or stored in a batch), they
3483    now include two elapsed-time values: one for how long it took to build the
3484    file-list, and one for how long it took to send it over the wire (each
3485    expressed in thousandths of a second).
3486
3487  - When `--delete-excluded` is specified with some filter rules (AKA excludes),
3488    a client sender will now initiate a send of the rules to the receiver (older
3489    protocols used to omit the sending of excludes in this situation since there
3490    were no receiver-specific rules that survived `--delete-excluded` back
3491    then). Note that, as with all the filter-list sending, only items that are
3492    significant to the other side will actually be sent over the wire, so the
3493    filter-rule list that is sent in this scenario is often empty.
3494
3495  - An index equal to the file-list count is sent as a keep-alive packet from
3496    the generator to the sender, which then forwards it on to the receiver. This
3497    normally invalid index is only a valid keep-alive packet if the 16-bit
3498    flag-word that follows it contains a single bit (`ITEM_IS_NEW`, which is
3499    normally an illegal flag to appear alone).
3500
3501  - A protocol-29 batch file includes a bit for the setting of the `--dirs`
3502    option and for the setting of the `--compress` option. Also, the shell
3503    script created by `--write-batch` will use the `--filter` option instead of
3504    `--exclude-from` to capture any filter rules.
3505
3506 ### BUILD CHANGES:
3507
3508  - Handle an operating system that use mkdev() in place of makedev().
3509
3510  - Improved configure to better handle cross-compiling.
3511
3512 ------------------------------------------------------------------------------
3513
3514 # NEWS for rsync 2.6.3 (30 Sep 2004)
3515
3516 ## Changes in this version:
3517
3518 ### SECURITY FIXES:
3519
3520  - A bug in the `sanitize_path` routine (which affects a non-chrooted rsync
3521    daemon) could allow a user to craft a pathname that would get transformed
3522    into an absolute path for certain options (but not for file-transfer names).
3523    If you're running an rsync daemon with chroot disabled, **please upgrade**,
3524    ESPECIALLY if the user privs you run rsync under is anything above `nobody`.
3525
3526    OUTPUT CHANGES (ATTN: those using a script to parse the verbose output):
3527
3528  - Please note that the 2-line footer (output when verbose) now uses the term
3529    `sent` instead of `wrote` and `received` instead of `read`. If you are not
3530    parsing the numeric values out of this footer, a script would be better off
3531    using the empty line prior to the footer as the indicator that the verbose
3532    output is over.
3533
3534  - The output from the `--stats` option was similarly affected to change
3535    `written` to `sent` and `read` to `received`.
3536
3537  - Rsync ensures that a filename that contains a newline gets mentioned with
3538    each newline transformed into a question mark (which prevents a filename
3539    from causing an empty line to be output).
3540
3541  - The `backed up ...` message that is output when at least 2 `--verbose`
3542    options are specified is now the same both with and without the
3543    `--backup-dir` option.
3544
3545 ### BUG FIXES:
3546
3547  - Fixed a crash bug that might appear when `--delete` was used and multiple
3548    source directories were specified.
3549
3550  - Fixed a 32-bit truncation of the file length when generating the checksums.
3551
3552  - The `--backup` code no longer attempts to create some directories over and
3553    over again (generating warnings along the way).
3554
3555  - Fixed a bug in the reading of the secrets file (by the daemon) and the
3556    password file (by the client): the files no longer need to be terminated by
3557    a newline for their content to be read in.
3558
3559  - If a file has a read error on the sending side or the reconstructed data
3560    doesn't match the expected checksum (perhaps due to the basis file changing
3561    during the transfer), the receiver will no longer retain the resulting file
3562    unless the `--partial` option was specified.  (Note: for the read-error
3563    detection to work, neither side can be older than 2.6.3 -- older receivers
3564    will always retain the file, and older senders don't tell the receiver that
3565    the file had a read error.)
3566
3567  - If a file gets resent in a single transfer and the `--backup` option is
3568    enabled, rsync no longer performs a duplicate backup (it used to overwrite
3569    the original file in the backup area).
3570
3571  - Files specified in the daemon's `exclude` or `exclude from` config items are
3572    now excluded from being uploaded (assuming that the module allows uploading
3573    at all) in addition to the old download exclusion.
3574
3575  - Got rid of a potential hang in the receiver when near the end of a phase.
3576
3577  - When using `--backup` without a `--backup-dir`, rsync no longer preserves
3578    the modify time on directories. This avoids confusing NFS.
3579
3580  - When `--copy-links` (`-L`) is specified, we now output a separate error for
3581    a symlink that has no referent instead of claiming that a file `vanished`.
3582
3583  - The `--copy-links` (`-L`) option no longer has the side-effect of telling
3584    the receiving side to follow symlinks. See the `--keep-dirlinks` option
3585    (mentioned below) for a way to specify that behavior.
3586
3587  - Error messages from the daemon server's option-parsing (such as refused
3588    options) are now successfully transferred back to the client (the server
3589    used to fail to send the message because the socket wasn't in the right
3590    state for the message to get through).
3591
3592  - Most transfer errors that occur during a daemon transfer are now returned to
3593    the user in addition to being logged (some messages are intended to be
3594    daemon-only and are not affected by this).
3595
3596  - Fixed a bug in the daemon authentication code when using one of the
3597    batch-processing options.
3598
3599  - We try to work around some buggy IPv6 implementations that fail to implement
3600    `IPV6_V6ONLY`. This should fix the `address in use` error that some daemons
3601    get when running on an OS with a buggy IPv6 implementation. Also, if the new
3602    code gets this error, we might suggest that the user specify `--ipv4` or
3603    `--ipv6` (if we think it will help).
3604
3605  - When the remote rsync dies, make a better effort to recover any error
3606    messages it may have sent before dying (the local rsync used to just die
3607    with a socket-write error).
3608
3609  - When using `--delete` and a `--backup-dir` that contains files that are
3610    hard-linked to their destination equivalents, rsync now makes sure that
3611    removed files really get removed (avoids a really weird rename() behavior).
3612
3613  - Avoid a bogus run-time complaint about a lack of 64-bit integers when the
3614    int64 type is defined as an `off_t` and it actually has 64-bits.
3615
3616  - Added a configure check for open64() without mkstemp64() so that we can
3617    avoid using mkstemp() when such a combination is encountered.  This bypasses
3618    a problem writing out large temp files on OSes such as AIX and HP-UX.
3619
3620  - Fixed an age-old crash problem with `--read-batch` on a local copy (rsync
3621    was improperly assuming `--whole-file` for the local copy).
3622
3623  - When `--dry-run` (`-n`) is used and the destination directory does not
3624    exist, rsync now produces a correct report of files that would be sent
3625    instead of dying with a chdir() error.
3626
3627  - Fixed a bug that could cause a slow-to-connect rsync daemon to die with an
3628    error instead of waiting for the connection to finish.
3629
3630  - Fixed an ssh interaction that could cause output to be lost when the user
3631    chose to combine the output of rsync's stdout and stderr (e.g.  using the
3632    `2>&1`).
3633
3634  - Fixed an option-parsing bug when `--files-from` got passed to a daemon.
3635
3636 ### ENHANCEMENTS:
3637
3638  - Added the `--partial-dir=DIR` option that lets you specify where to
3639    (temporarily) put a partially transferred file (instead of overwriting the
3640    destination file). E.g. `--partial-dir=.rsync-partial` Also added support
3641    for the `RSYNC_PARTIAL_DIR` environment variable that, when found,
3642    transforms a regular `--partial` option (such as the convenient `-P` option)
3643    into one that also specifies a directory.
3644
3645  - Added `--keep-dirlinks` (`-K`), which allows you to symlink a directory onto
3646    another partition on the receiving side and have rsync treat it as matching
3647    a normal directory from the sender.
3648
3649  - Added the `--inplace` option that tells rsync to write each destination file
3650    without using a temporary file. The matching of existing data in the
3651    destination file can be severely limited by this, but there are also cases
3652    where this is more efficient (such as appending data).  Use only when needed
3653    (see the manpage for more details).
3654
3655  - Added the `write only` option for the daemon's config file.
3656
3657  - Added long-option names for `-4` and `-6` (namely `--ipv4` and `--ipv6`) and
3658    documented all these options in the manpage.
3659
3660  - Improved the handling of the `--bwlimit` option so that it's less bursty,
3661    more accurate, and works properly over a larger range of values.
3662
3663  - The rsync daemon-over-ssh code now looks for `SSH_CONNECTION` and
3664    `SSH2_CLIENT` in addition to `SSH_CLIENT` to figure out the IP address.
3665
3666  - Added the `--checksum-seed=N` option for advanced users.
3667
3668  - Batch writing/reading has a brand-new implementation that is simpler, fixes
3669    a few weird problems with the old code (such as no longer sprinkling the
3670    batch files into different dirs or even onto different systems), and is much
3671    less intrusive into the code (making it easier to maintain for the future).
3672    The new code generates just one data file instead of three, which makes it
3673    possible to read the batch on stdin via a remote shell. Also, the old
3674    requirement of forcing the same fixed checksum-seed for all batch processing
3675    has been removed.
3676
3677  - If an rsync daemon has a module set with `list = no` (which hides its
3678    presence in the list of available modules), a user that fails to
3679    authenticate gets the same `unknown module` error that they would get if the
3680    module were actually unknown (while still logging the real error to the
3681    daemon's log file). This prevents fishing for module names.
3682
3683  - The daemon's `refuse options` config item now allows you to match option
3684    names using wildcards and/or the single-letter option names.
3685
3686  - Each transferred file now gets its permissions and modified-time updated
3687    before the temp-file gets moved into place. Previously, the finished file
3688    would have a very brief window where its permissions disallowed all group
3689    and world access.
3690
3691  - Added the ability to parse a literal IPv6 address in an `rsync:` URL (e.g.
3692    rsync://[2001:638:500:101::21]:873/module/dir).
3693
3694  - The daemon's wildcard expanding code can now handle more than 1000 filenames
3695    (it's now limited by memory instead of having a hard-wired limit).
3696
3697 ### INTERNAL:
3698
3699  - Some cleanup in the exclude code has saved some per-exclude memory and made
3700    the code easier to maintain.
3701
3702  - Improved the argv-overflow checking for a remote command that has a lot of
3703    args.
3704
3705  - Use rsyserr() in the various places that were still calling rprintf() with
3706    strerror() as an arg.
3707
3708  - If an rsync daemon is listening on multiple sockets (to handle both IPv4 and
3709    IPv6 to a single port), we now close all the unneeded file handles after we
3710    accept a connection (we used to close just one of them).
3711
3712  - Optimized the handling of larger block sizes (rsync used to slow to a crawl
3713    if the block size got too large).
3714
3715  - Optimized away a loop in `hash_search()`.
3716
3717  - Some improvements to the `sanitize_path()` and `clean_fname()` functions
3718    makes them more efficient and produce better results (while still being
3719    compatible with the file-name cleaning that gets done on both sides when
3720    sending the file-list).
3721
3722  - Got rid of `alloc_sanitize_path()` after adding a destination-buffer arg to
3723    `sanitize_path()` made it possible to put all the former's functionality
3724    into the latter.
3725
3726  - The file-list that is output when at least 4 verbose options are specified
3727    reports the uid value on the sender even when rsync is not running as root
3728    (since we might be sending to a root receiver).
3729
3730 ### BUILD CHANGES:
3731
3732  - Added a `gen` target to rebuild most of the generated files, including
3733    configure, config.h.in, the manpages, and proto.h.
3734
3735  - If `make proto` doesn't find some changes in the prototypes, the proto.h
3736    file is left untouched (its time-stamp used to always be updated).
3737
3738  - The variable `$STRIP` (that is optionally set by the install-strip target's
3739    rule) was changed to `$INSTALL_STRIP` because some systems have `$STRIP`
3740    already set in the environment.
3741
3742  - Fixed a build problem when `SUPPORT_HARD_LINKS` isn't defined.
3743
3744  - When cross-compiling, the gettimeofday() function is now assumed to be a
3745    modern version that takes two-args (since we can't test it).
3746
3747 ### DEVELOPER RELATED:
3748
3749  - The scripts in the testsuite dir were cleaned up a bit and a few new tests
3750    added.
3751
3752  - Some new diffs were added to the patches dir, and some accepted ones were
3753    removed.
3754
3755 ------------------------------------------------------------------------------
3756
3757 # NEWS for rsync 2.6.2 (30 Apr 2004)
3758
3759 ## Changes in this version:
3760
3761 ### BUG FIXES:
3762
3763  - Fixed a major bug in the sorting of the filenames when `--relative` is used
3764    for some sources (just sources such as `/` and `/*` were affected). This fix
3765    ensures that we ask for the right file-list item when requesting changes
3766    from the sender.
3767
3768  - Rsync now checks the return value of the close() function to better report
3769    disk-full problems on an NFS file system.
3770
3771  - Restored the old daemon-server behavior of logging error messages rather
3772    than returning them to the user. (A better long-term fix will be sought in
3773    the future.)
3774
3775  - An obscure uninitialized-variable bug was fixed in the uid/gid code. (This
3776    bug probably had no ill effects.)
3777
3778 ### BUILD CHANGES:
3779
3780  - Got rid of the configure check for sys/sysctl.h (it wasn't used and was
3781    causing a problem on some systems). Also improved the
3782    broken-largefile-locking test to try to avoid failure due to an NFS
3783    build-dir.
3784
3785  - Fixed a compile problem on systems that don't define `AI_NUMERICHOST`.
3786
3787  - Fixed a compile problem in the popt source for compilers that don't support
3788    `__attribute__`.
3789
3790 ### DEVELOPER RELATED:
3791
3792  - Improved the testsuite's `merge` test to work on OSF1.
3793
3794  - Two new diffs were added to the patches dir.
3795
3796 ------------------------------------------------------------------------------
3797
3798 # NEWS for rsync 2.6.1 (26 Apr 2004)
3799
3800 ## Changes in this version:
3801
3802 ### PROTOCOL NUMBER:
3803
3804  - The protocol number was changed to 28.
3805
3806 ### SECURITY FIXES:
3807
3808  - Paths sent to an rsync daemon are more thoroughly sanitized when chroot is
3809    not used. If you're running a non-read-only rsync daemon with chroot
3810    disabled, **please upgrade**, ESPECIALLY if the user privs you run rsync
3811    under is anything above `nobody`.
3812
3813 ### ENHANCEMENTS:
3814
3815  - Lower memory use, more optimal transfer of data over the socket, and lower
3816    CPU usage (see the INTERNAL section for details).
3817
3818  - The `RSYNC_PROXY` environment variable can now contain a `USER:PASS@` prefix
3819    before the `HOST:PORT` information.  (Bardur Arantsson)
3820
3821  - The `--progress` output now mentions how far along in the transfer we are,
3822    including both a count of files transferred and a percentage of the total
3823    file-count that we've processed. It also shows better
3824    current-rate-of-transfer and remaining-transfer-time values.
3825
3826  - Documentation changes now attempt to describe some often misunderstood
3827    features more clearly.
3828
3829 ### BUG FIXES:
3830
3831  - When `-x` (`--one-file-system`) is combined with `-L` (`--copy-links`) or
3832    `--copy-unsafe-links,` no symlinked files are skipped, even if the referent
3833    file is on a different filesystem.
3834
3835  - The `--link-dest` code now works properly for a non-root user when (1) the
3836    UIDs of the source and destination differ and `-o` was specified, or (2)
3837    when the group of the source can't be used on the destination and `-g` was
3838    specified.
3839
3840  - Fixed a bug in the handling of `-H` (hard-links) that might cause the
3841    expanded PATH/NAME value of the current item to get overwritten (due to an
3842    expanded-name caching bug).
3843
3844  - We now reset the `new data has been sent` flag at the start of each file we
3845    send. This makes sure that an interrupted transfer with the `--partial`
3846    option set doesn't keep a shorter temp file than the current basis file when
3847    no new data has been transferred over the wire for that file.
3848
3849  - Fixed a byte-order problem in `--batch-mode` on big-endian machines.  (Jay
3850    Fenlason)
3851
3852  - When using `--cvs-exclude`, the exclude items we get from a per-directory's
3853    .cvsignore file once again only affect that one directory (not all following
3854    directories too). The items are also now properly word-split and parsed
3855    without any +/- prefix parsing.
3856
3857  - When specifying the USER@HOST: prefix for a file, the USER part can now
3858    contain an '@', if needed (i.e. the last '@' is used to find the HOST, not
3859    the first).
3860
3861  - Fixed some bugs in the handling of group IDs for non-root users: (1) It
3862    properly handles a group that the sender didn't have a name for (it would
3863    previously skip changing the group on any files in that group). (2) If
3864    `--numeric-ids` is used, rsync no longer attempts to set groups that the
3865    user doesn't have the permission to set.
3866
3867  - Fixed the `refuse options` setting in the rsyncd.conf file.
3868
3869  - Improved the `-x` (`--one-file-system`) flag's handling of any mount-point
3870    directories we encounter. It is both more optimal (in that it no longer does
3871    a useless scan of the contents of the mount-point dirs) and also fixes a
3872    bug where a remapped mount of the original filesystem could get discovered
3873    in a subdir we should be ignoring.
3874
3875  - Rsync no longer discards a double-slash at the start of a filename when
3876    trying to open the file. It also no longer constructs names that start with
3877    a double slash (unless the user supplied them).
3878
3879  - Path-specifying options to a daemon should now work the same with or without
3880    chroot turned on. Previously, such a option (such as `--link-dest`) would
3881    get its absolute path munged into a relative one if chroot was not on,
3882    making that setting fairly useless.  Rsync now transforms the path into one
3883    that is based on the module's base dir when chroot is not enabled.
3884
3885  - Fixed a compatibility problem interacting with older rsync versions that
3886    might send us an empty `--suffix` value without telling us that
3887    `--backup-dir` was specified.
3888
3889  - The `hosts allow` option for a daemon-over-remote-shell process now has
3890    improved support for IPv6 addresses and a fix for systems that have a length
3891    field in their socket structs.
3892
3893  - Fixed the ability to request an empty backup `--suffix` when sending files
3894    to an rsync daemon.
3895
3896  - Fixed an option-parsing bug when `--files-from` was sent to a server sender.
3897
3898 ### INTERNAL:
3899
3900  - Most of the I/O is now buffered, which results in a pretty large speedup
3901    when running under MS Windows. (Craig Barratt)
3902
3903  - Optimizations to the name-handling/comparing code have made some significant
3904    reductions in user-CPU time for large file sets.
3905
3906  - Some cleanup of the variable types make the code more consistent.
3907
3908  - Reduced memory requirements of hard link preservation.  (J.W. Schultz)
3909
3910  - Implemented a new algorithm for hard-link handling that speeds up the code
3911    significantly. (J.W. Schultz and Wayne Davison)
3912
3913  - The `--hard-link` option now uses the first existing file in the group of
3914    linked files as the basis for the transfer. This prevents the sub-optimal
3915    transfer of a file's data when a new hardlink is added on the sending side
3916    and it sorts alphabetically earlier in the list than the files that are
3917    already present on the receiving side.
3918
3919  - Dropped support for protocol versions less than 20 (2.3.0 released 15 Mar
3920    1999) and activated warnings for protocols less than 25 (2.5.0 released 23
3921    Aug 2001). (Wayne Davison and J.W. Schultz, severally)
3922
3923  - More optimal data transmission for `--hard-links` (protocol 28).
3924
3925  - More optimal data transmission for `--checksum` (protocol 28).
3926
3927  - Less memory is used when `--checksum` is specified.
3928
3929  - Less memory is used in the file list (a per-file savings).
3930
3931  - The generator is now better about not modifying the file list during the
3932    transfer in order to avoid a copy-on-write memory bifurcation (on systems
3933    where fork() uses shared memory).  Previously, rsync's shared memory would
3934    slowly become unshared, resulting in real memory usage nearly doubling on
3935    the receiving side by the end of the transfer. Now, as long as permissions
3936    are being preserved, the shared memory should remain that way for the entire
3937    transfer.
3938
3939  - Changed hardlink info and `file_struct` + strings to use allocation pools.
3940    This reduces memory use for large file-sets and permits freeing memory to
3941    the OS. (J.W. Schultz)
3942
3943  - The 2 pipes used between the receiver and generator processes (which are
3944    forked on the same machine) were reduced to 1 pipe and the protocol improved
3945    so that (1) it is now impossible to have the `redo` pipe fill up and hang
3946    rsync, and (2) trailing messages from the receiver don't get lost on their
3947    way through the generator over to the sender (which mainly affected
3948    hard-link messages and verbose `--stats` output).
3949
3950  - Improved the internal uid/gid code to be more portable and a little more
3951    optimized.
3952
3953  - The device numbers sent when using `--devices` are now sent as separate
3954    major/minor values with 32-bit accuracy (protocol 28).  Previously, the
3955    copied devices were sent as a single 32-bit number. This will make
3956    inter-operation of 64-bit binaries more compatible with their 32-bit
3957    brethren (with both ends of the connection are using protocol 28). Note that
3958    optimizations in the binary protocol for sending the device numbers often
3959    results in fewer bytes being used than before, even though more precision is
3960    now available.
3961
3962  - Some cleanup of the exclude/include structures and its code made things
3963    clearer (internally), simpler, and more efficient.
3964
3965  - The reading & writing of the file-list in batch-mode is now handled by the
3966    same code that sends & receives the list over the wire. This makes it much
3967    easier to maintain. (Note that the batch code is still considered to be
3968    experimental.)
3969
3970 ### BUILD CHANGES:
3971
3972  - The configure script now accepts `--with-rsyncd-conf=PATH` to override the
3973    default value of the /etc/rsyncd.conf file.
3974
3975  - Fixed configure bug when running `./configure --disable-ipv6`.
3976
3977  - Fixed compilation problem on Tru64 Unix (having to do with `sockaddr.sa_len`
3978    and `sockaddr.sin_len`).
3979
3980 ### DEVELOPER RELATED:
3981
3982  - Fixed `make test` bug when build dir is not the source dir.
3983
3984  - Added a couple extra diffs in the `patches` dir, removed the ones that got
3985    applied, and rebuilt the rest.
3986
3987 ------------------------------------------------------------------------------
3988
3989 # NEWS for rsync 2.6.0 (1 Jan 2004)
3990
3991 ## Changes in this version:
3992
3993 ### PROTOCOL NUMBER:
3994
3995  - The protocol number was changed to 27.  The maximum accepted protocol number
3996    was increased from 30 to 40.
3997
3998 ### ENHANCEMENTS:
3999
4000  - `ssh` is now the default remote shell for rsync. If you want to change this,
4001    configure like this: `./configure --with-rsh=rsh`.
4002
4003  - Added `--files-from`, `--no-relative`, `--no-implied-dirs`, and `--from0`.
4004    Note that `--from0` affects the line-ending character for all the files read
4005    by the `--*-from` options. (Wayne Davison)
4006
4007  - Length of csum2 is now per-file starting with protocol version
4008    27. (J.W. Schultz)
4009
4010  - Per-file dynamic block size is now sqrt(file length). The per-file checksum
4011    size is determined according to an algorithm provided by Donovan Baarda
4012    which reduces the probability of rsync algorithm corrupting data and falling
4013    back using the whole md4 checksums. (J.W. Schultz, Donovan Baarda)
4014
4015  - The `--stats` option no longer includes the (debug) malloc summary unless
4016    the verbose option was specified at least twice.
4017
4018  - Added a new error/warning code for when files vanish from the sending side.
4019    Made vanished source files not interfere with the file-deletion pass when
4020    `--delete-after` was specified.
4021
4022  - Various trailing-info sections are now preceded by a newline.
4023
4024 ### BUG FIXES:
4025
4026  - Fixed several exclude/include matching bugs when using wild-cards.  This has
4027    a several user-visible effects, all of which make the matching more
4028    consistent and intuitive. This should hopefully not cause anyone problems
4029    since it makes the matching work more like what people are expecting. (Wayne
4030    Davison)
4031
4032  - A pattern with a `**` no longer causes a `*` to match slashes.  For example,
4033    with `/*/foo/**`, `foo` must be 2 levels deep.  [If your string has BOTH `*`
4034    and `**` wildcards, changing the `*` wildcards to `**` will provide the old
4035    behavior in all versions.]
4036
4037  - `**/foo` now matches at the base of the transfer (like /foo does). [Use
4038    `/**/foo` to get the old behavior in all versions.]
4039
4040  - A non-anchored wildcard term floats to match beyond the base of the
4041    transfer. E.g. `CVS/R*` matches at the end of the path, just like the
4042    non-wildcard term `CVS/Root` does. [Use `/CVS/R*` to get the old behavior in
4043    all versions.]
4044
4045  - Including a `**` in the match term causes it to be matched against the
4046    entire path, not just the name portion, even if there aren't any interior
4047    slashes in the term. E.g. `foo**bar` would exclude `/path/foo-bar` (just
4048    like before) as well as `/foo-path/baz-bar` (unlike before). [Use `foo*bar`
4049    to get the old behavior in all versions.]
4050
4051  - The exclude list specified in the daemon's config file is now properly
4052    applied to the pulled items no matter how deep the user's file-args are in
4053    the source tree. (Wayne Davison)
4054
4055  - For protocol version >= 27, `mdfour_tail()` is called when the block size
4056    (including `checksum_seed`) is a multiple of 64.  Previously it was not
4057    called, giving the wrong MD4 checksum.  (Craig Barratt)
4058
4059  - For protocol version >= 27, a 64 bit bit counter is used in mdfour.c as
4060    required by the RFC. Previously only a 32 bit bit counter was used, causing
4061    incorrect MD4 file checksums for file sizes >= 512MB - 4. (Craig Barratt)
4062
4063  - Fixed a crash bug when interacting with older rsync versions and multiple
4064    files of the same name are destined for the same dir.  (Wayne Davison)
4065
4066  - Keep tmp names from overflowing MAXPATHLEN.
4067
4068  - Make `--link-dest` honor the absence of `-p`, `-o`, and `-g`.
4069
4070  - Made rsync treat a trailing slash in the destination in a more consistent
4071    manner.
4072
4073  - Fixed file I/O error detection. (John Van Essen)
4074
4075  - Fixed bogus `malformed address {hostname}` message in rsyncd log when
4076    checking IP address against hostnames from `hosts allow` and `hosts deny`
4077    parameters in config file.
4078
4079  - Print heap statistics when verbose >= 2 instead of when >= 1.
4080
4081  - Fixed a compression (`-z`) bug when syncing a mostly-matching file that
4082    contains already-compressed data. (Yasuoka Masahiko and Wayne Davison)
4083
4084  - Fixed a bug in the `--backup` code that could cause deleted files to not get
4085    backed up.
4086
4087  - When the backup code makes new directories, create them with mode 0700
4088    instead of 0755 (since the directory permissions in the backup tree are not
4089    yet copied from the main tree).
4090
4091  - Call setgroups() in a more portable manner.
4092
4093  - Improved file-related error messages to better indicate exactly what
4094    pathname failed. (Wayne Davison)
4095
4096  - Fixed some bugs in the handling of `--delete` and `--exclude` when using the
4097    `--relative` (`-R`) option. (Wayne Davison)
4098
4099  - Fixed bug that prevented regular files from replacing special files and
4100    caused a directory in `--link-dest` or `--compare-dest` to block the
4101    creation of a file with the same path. A directory still cannot be replaced
4102    by a regular file unless `--delete` specified. (J.W. Schultz)
4103
4104  - Detect and report when open or opendir succeed but read and readdir fail
4105    caused by network filesystem issues and truncated files. (David Norwood,
4106    Michael Brown, J.W. Schultz)
4107
4108  - Added a fix that should give ssh time to restore the tty settings if the
4109    user presses Ctrl-C at an ssh password prompt.
4110
4111 ### INTERNAL:
4112
4113  - Eliminated vestigial support for old versions that we stopped supporting.
4114    (J.W. Schultz)
4115
4116  - Simplified some of the option-parsing code. (Wayne Davison)
4117
4118  - Some cleanup made to the exclude code, as well as some new defines added to
4119    enhance readability. (Wayne Davison)
4120
4121  - Changed the protocol-version code so that it can interact at a lower
4122    protocol level than the maximum supported by both sides.  Added an
4123    undocumented option, `--protocol=N`, to force the value we advertise to the
4124    other side (primarily for testing purposes).  (Wayne Davison)
4125
4126 ------------------------------------------------------------------------------
4127
4128 # NEWS for rsync 2.5.7 (4 Dec 2003)
4129
4130 ## Changes in this version:
4131
4132 ### SECURITY FIXES:
4133
4134  - Fix buffer handling bugs. (Andrew Tridgell, Martin Pool, Paul Russell,
4135    Andrea Barisani)
4136
4137 ------------------------------------------------------------------------------
4138
4139 # NEWS for rsync 2.5.6, aka "the dwd-between-jobs release" (26 Jan 2003)
4140
4141 ## Changes in this version:
4142
4143 ### ENHANCEMENTS:
4144
4145  - The `--delete-after` option now implies `--delete`. (Wayne Davison)
4146
4147  - The `--suffix` option can now be used with `--backup-dir`. (Michael
4148    Zimmerman)
4149
4150  - Combining `::` syntax with the `--rsh`/`-e` option now uses the specified
4151    remote-shell as a transport to talk to a (newly-spawned) server-daemon. This
4152    allows someone to use daemon features, such as modules, over a secure
4153    protocol, such as ssh. (JD Paul)
4154
4155  - The rsync:// syntax for daemon connections is now accepted in the
4156    destination field.
4157
4158  - If the file name given to `--include-from` or `--exclude-from` is `-`, rsync
4159    will read from standard input. (J.W. Schultz)
4160
4161  - New option `--link-dest` which is like `--compare-dest` except that
4162    unchanged files are hard-linked in to the destination directory.  (J.W.
4163    Schultz)
4164
4165  - Don't report an error if an excluded file disappears during an rsync run.
4166    (Eugene Chupriyanov and Bo Kersey)
4167
4168  - Added .svn to `--cvs-exclude` list to support subversion. (Jon Middleton)
4169
4170  - Properly support IPv6 addresses in the rsyncd.conf `hosts allow` and `hosts
4171    deny` fields. (Hideaki Yoshifuji)
4172
4173  - Changed exclude file handling to permit DOS or MAC style line terminations.
4174    (J.W. Schultz)
4175
4176  - Ignore errors from chmod when `-p`/`-a`/`--preserve-perms` is not set.
4177    (Dave Dykstra)
4178
4179 ### BUG FIXES:
4180
4181  - Fix `forward name lookup failed` errors on AIX 4.3.3. (John L. Allen, Martin
4182    Pool)
4183
4184  - Generate each file's rolling-checksum data as we send it, not in a separate
4185    (memory-eating) pass before hand. This prevents timeout errors on really
4186    large files. (Stefan Nehlsen)
4187
4188  - Fix compilation on Tru64. (Albert Chin, Zoong Pham)
4189
4190  - Better handling of some client-server errors. (Martin Pool)
4191
4192  - Fixed a crash that would occur when sending a list of files that contains a
4193    duplicate name (if it sorts to the end of the file list) and using
4194    `--delete`. (Wayne Davison)
4195
4196  - Fixed the file-name duplicate-removal code when dealing with multiple dups
4197    in a row. (Wayne Davison)
4198
4199  - Fixed a bug that caused rsync to lose the exit status of its child processes
4200    and sometimes return an exit code of 0 instead of showing an error. (David
4201    R. Staples, Dave Dykstra)
4202
4203  - Fixed bug in `--copy-unsafe-links` that caused it to be completely broken.
4204    (Dave Dykstra)
4205
4206  - Prevent infinite recursion in cleanup code under certain circumstances.
4207    (Sviatoslav Sviridov and Marc Espie)
4208
4209  - Fixed a bug that prevented rsync from creating intervening directories when
4210    `--relative-paths`/`-R` is set. (Craig Barratt)
4211
4212  - Prevent `Connection reset by peer` messages from Cygwin. (Randy O'Meara)
4213
4214 ### INTERNAL:
4215
4216  - Many code cleanups and improved internal documentation. (Martin Pool, Nelson
4217    Beebe)
4218
4219  - Portability fixes. (Dave Dykstra and Wayne Davison)
4220
4221  - More test cases. (Martin Pool)
4222
4223  - Some test-case fixes. (Brian Poole, Wayne Davison)
4224
4225  - Updated included popt to the latest vendor drop, version 1.6.4.  (Jos
4226    Backus)
4227
4228  - Updated config.guess and config.sub to latest versions; this means rsync
4229    should build on more platforms. (Paul Green)
4230
4231 ------------------------------------------------------------------------------
4232
4233 # NEWS for rsync 2.5.5, aka Snowy River (2 Apr 2002)
4234
4235 ## Changes in this version:
4236
4237 ### ENHANCEMENTS:
4238
4239  - With `--progress`, when a transfer is complete show the time taken;
4240    otherwise show expected time to complete. (Cameron Simpson)
4241
4242  - Make `make install-strip` works properly, and `make install` accepts a
4243    DESTDIR variable for help in building binary packages.  (Peter
4244    Breitenlohner, Greg Louis)
4245
4246  - If configured with `--enable-maintainer-mode`, then on receipt of a fatal
4247    signal rsync will try to open an xterm running gdb, similarly to Samba's
4248    `panic action` or GNOME's bug-buddy.  (Martin Pool)
4249
4250 ### BUG FIXES:
4251
4252  - Fix situation where failure to fork (e.g. because out of process slots)
4253    would cause rsync to kill all processes owned by the current user. Yes,
4254    really! (Paul Haas, Martin Pool)
4255
4256  - Fix test suite on Solaris. (Jos Backus, Martin Pool)
4257
4258  - Fix minor memory leak in socket code. (Dave Dykstra, Martin Pool.)
4259
4260  - Fix `--whole-file` problem that caused it to be the default even for remote
4261    connections. (Martin Pool, Frank Schulz)
4262
4263  - Work around bug in Mac OS X mkdir(2), which cannot handle trailing slashes.
4264    <http://www.opensource.apple.com/bugs/X/BSD%20Kernel/2734739.html> (Martin
4265    Pool)
4266
4267  - Improved network error handling. (Greg A. Woods)
4268
4269 ------------------------------------------------------------------------------
4270
4271 # NEWS for rsync 2.5.4, aka "Imitation lizard skin" (13 Mar 2002)
4272
4273 ## Changes in this version:
4274
4275 ### BUG FIXES:
4276
4277  - Additional fix for zlib double-free bug. (Martin Pool, Andrew Tridgell) (CVE
4278    CAN-2002-0059)
4279
4280 ### ENHANCEMENTS:
4281
4282  - Merge in changes from zlib 1.1.3 to zlib 1.1.4. (Jos Backus) (Note that
4283    rsync still uses a custom version of zlib; you can not just link against a
4284    system library. See zlib/README.rsync)
4285
4286  - Additional test cases for `--compress`. (Martin Pool)
4287
4288 ------------------------------------------------------------------------------
4289
4290 # NEWS for rsync 2.5.3, aka "Happy 26" (11 Mar 2002)
4291
4292 ## Changes in this version:
4293
4294 ### SECURITY FIXES:
4295
4296  - Make sure that supplementary groups are removed from a server
4297    process after changing uid and gid. (Ethan Benson) (Debian bug
4298    #132272, CVE CAN-2002-0080)
4299
4300 ### BUG FIXES:
4301
4302  - Fix zlib double-free bug. (Owen Taylor, Mark J Cox) (CVE CAN-2002-0059)
4303
4304  - Fixed problem that in many cases caused the error message unexpected read
4305    size of 0 in `map_ptr` and resulted in the wrong data being copied.
4306
4307  - Fixed compilation errors on some systems caused by the use of `unsigned
4308    int64` in rsync.h.
4309
4310  - Fixed problem on systems such as Sunos4 that do not support realloc on a
4311    NULL pointer; error was 'out of memory in "flist_expand"'.
4312
4313  - Fix for rsync server processes hanging around after the client unexpectedly
4314    disconnects. (Colin Walters) (Debian bug #128632)
4315
4316  - Cope with BSD systems on which mkdir() will not accept a trailing slash.
4317
4318 ### ENHANCEMENTS:
4319
4320  - Merge in changes from zlib 1.1.2 to zlib 1.1.3. (Note that rsync still uses
4321    a custom version of zlib; you can not just link against a system library.
4322    See zlib/README.rsync)
4323
4324  - Command to initiate connections is only shown with `-vv`, rather than `-v`
4325    as in 2.5.2. Output from plain `-v` is more similar to what was historically
4326    used so as not to break scripts that try to parse the output.
4327
4328  - Added `--no-whole-file` and `--no-blocking-io` options (Dave Dykstra)
4329
4330  - Made the `--write-batch` and `--read-batch` options actually work and added
4331    documentation in the manpage (Jos Backus)
4332
4333  - If the daemon is unable to fork a child to accept a connection, print an
4334    error message. (Colin Walters)
4335
4336 ------------------------------------------------------------------------------
4337
4338 # NEWS for rsync 2.5.2 (26 Jan 2002)
4339
4340 ## Changes in this version:
4341
4342 ### SECURITY FIXES:
4343
4344  - Signedness security patch from Sebastian Krahmer <krahmer@suse.de> -- in
4345    some cases we were not sufficiently careful about reading integers from the
4346    network.
4347
4348 ### PROTOCOL NUMBER:
4349
4350  - The protocol number was changed to 26.
4351
4352 ### BUG FIXES:
4353
4354  - Fix possible string mangling in log files.
4355
4356  - Fix for setting local address of outgoing sockets.
4357
4358  - Better handling of hardlinks and devices on platforms with 64-bit `dev_t` or
4359    `ino_t`.
4360
4361  - Name resolution on machines supporting IPv6 is improved.
4362
4363  - Fix for device nodes. (dann frazier) (Debian #129135)
4364
4365 ### ENHANCEMENTS:
4366
4367  - With `-v`, rsync now shows the command used to initiate an ssh/rsh
4368    connection.
4369
4370  - `--statistics` now shows memory heap usage on platforms that support
4371    mallinfo().
4372
4373  - "The Ted T'so school of program optimization": make progress visible and
4374    people will think it's faster. (With `--progress`, rsync will show you how
4375    many files it has seen as it builds the `file_list`, giving some indication
4376    that it has not hung.)
4377
4378  - Improvements to batch mode support. This is still experimental but testing
4379    would be welcome. (Jos Backus)
4380
4381  - New `--ignore-existing` option, patch previously distributed with Vipul's
4382    Razor. (Debian #124286)
4383
4384 ------------------------------------------------------------------------------
4385
4386 # NEWS for rsync 2.5.1 (3 Jan 2002)
4387
4388 ## Changes in this version:
4389
4390 ### BUG FIXES:
4391
4392  - Fix for segfault in `--daemon` mode configuration parser. (Paul Mackerras)
4393
4394  - Correct `string<->address` parsing for both IPv4 and 6.  (YOSHIFUJI Hideaki,
4395    SUMIKAWA Munechika and Jun-ichiro `itojun` Hagino)
4396
4397  - Various fixes for IPv6 support. (Dave Dykstra)
4398
4399  - rsync.1 typo fix. (Matt Kraai)
4400
4401  - Test suite typo fixes. (Tom Schmidt)
4402
4403  - rsync.1 grammar and clarity improvements. (Edward Welbourne)
4404
4405  - Correction to ./configure tests for `inet_ntop`. (Jeff Garzik)
4406
4407 ### ENHANCEMENTS:
4408
4409  - `--progress` and `-P` now show estimated data transfer rate (in a multiple
4410    of bytes/s) and estimated time to completion. (Rik Faith)
4411
4412  - `--no-detach` option, required to run as a W32 service and also useful when
4413    running on Unix under daemontools, AIX's SRC, or a debugger. (Max Bowsher,
4414    Jos Backus)
4415
4416  - Clearer error messages for some conditions.
4417
4418 ------------------------------------------------------------------------------
4419
4420 # NEWS for rsync 2.5.0 (30 Nov 2001)
4421
4422 ## Changes in this version:
4423
4424 ### PROTOCOL NUMBER:
4425
4426  - The protocol number was changed to 25.
4427
4428 ### ANNOUNCEMENTS:
4429
4430  - Martin Pool <mbp@samba.org> is now a co-maintainer.
4431
4432 ### NEW FEATURES:
4433
4434  - Support for LSB-compliant packaging <http://www.linuxbase.org/>
4435
4436  - Shell wildcards are allowed in `auth users` lines.
4437
4438  - Merged UNC rsync+ patch to support creation of standalone patch sets. By
4439    Bert J. Dempsey and Debra Weiss, updated by Jos Backus.
4440    <http://www.ils.unc.edu/i2dsi/unc_rsync+.html>
4441
4442  - IPv6 support based on a patch from KAME.net, on systems including modern
4443    versions of Linux, Solaris, and HP-UX. Also includes IPv6 compatibility
4444    functions for old OSs by the Internet Software Consortium, Paul Vixie, the
4445    OpenSSH portability project, and OpenBSD.
4446
4447 ### ENHANCEMENTS:
4448
4449  - Include/exclude cluestick: with `-vv`, print out whether files are included
4450    or excluded and why.
4451
4452  - Many error messages have more friendly explanations and more details.
4453
4454  - Manual page improvements plus scanty protocol documentation.
4455
4456  - When running as `--daemon` in the background and using a `log file`
4457    rsyncd.conf directive, close the log file every time it is open when going
4458    to sleep on the socket. This allows the log file to get cleaned out by
4459    another process.
4460
4461  - Change to using libpopt rather than getopt for processing options. This
4462    makes the code cleaner and the behaviour more consistent across platforms.
4463    popt is included and built if not installed on the platform.
4464
4465  - More details in `--version`, including note about whether 64-bit files,
4466    symlinks and hardlinks are supported.
4467
4468  - MD4 code may use less CPU cycles.
4469
4470  - Use mkstemp on systems where it is secure. If we use mktemp, explain that we
4471    do it in a secure way.
4472
4473  - `--whole-file` is the default when source and target are on the local
4474    machine.
4475
4476 ### BUG FIXES:
4477
4478  - Fix for various bugs causing rsync to hang.
4479
4480  - Attempt to fix Large File Summit support on AIX.
4481
4482  - Attempt to fix error handling lockup bug.
4483
4484  - Give a non-0 exit code if **any** of the files we have been asked to
4485    transfer fail to transfer.
4486
4487  - For log messages containing ridiculously long strings that might overflow a
4488    buffer rsync no longer aborts, but rather prints an ellipsis at the end of
4489    the string. (Patch from Ed Santiago.)
4490
4491 ### PLATFORMS:
4492
4493  - Improved support for UNICOS (tested on Cray T3E and Cray SV1)
4494
4495  - autoconf2.52 (or later) is now required to rebuild the autoconf scripts. It
4496    is not required to simply build rsync.
4497
4498  - Platforms thought to work in this release:
4499
4500    - Cray SV1 UNICOS 10.0.0.8 cc
4501    - Debian Linux 2.2 UltraSparc gcc
4502    - Debian Linux testing/unstable ARM gcc
4503    - FreeBSD 3.3-RELEASE i386 cc
4504    - FreeBSD 4.1.1-RELEASE i386 cc
4505    - FreeBSD 4.3-STABLE i386 cc
4506    - HP PA-RISC HP-UX 10.20 gcc
4507    - HP PA-RISC HP-UX 11.11 cc
4508    - IRIX 6.5 MIPS cc
4509    - IRIX 6.5 MIPS gcc
4510    - Mac OS X PPC (`--disable-ipv6`) cc
4511    - NetBSD 1.5 i386 gcc
4512    - NetBSD Current i386 cc
4513    - OpenBSD 2.5 Sparc gcc
4514    - OpenBSD 2.9 i386 cc
4515    - OpenBSD Current i386 cc
4516    - RedHat 6.2 i386 gcc
4517    - RedHat 6.2 i386 insure++
4518    - RedHat 7.0 i386 gcc
4519    - RedHat 7.1 i386 (Kernel 2.4.10) gcc
4520    - Slackware 8.0 i686 (Kernel 2.4.10)
4521    - Solaris 8 UltraSparc cc
4522    - Solaris 8 UltraSparc gcc
4523    - Solaris 8 i386 gcc
4524    - SuSE 7.1 i386 gcc2.95.2
4525    - SuSE 7.1 ppc gcc2.95.2
4526    - i386-pc-sco3.2v5.0.5 cc
4527    - i386-pc-sco3.2v5.0.5 gcc
4528    - powerpc-ibm-aix4.3.3.0 cc
4529    - i686-unknown-sysv5UnixWare7.1.0 gcc
4530    - i686-unknown-sysv5UnixWare7.1.0 cc
4531
4532 ### TESTING:
4533
4534  - The existing test.sh script by Phil Hands has been merged into a
4535    test framework that works from both `make check` and the Samba
4536    build farm.
4537
4538 ------------------------------------------------------------------------------
4539
4540 ## Partial Protocol History
4541
4542 | RELEASE DATE | VER.   | DATE OF COMMIT\* | PROTOCOL    |
4543 |--------------|--------|------------------|-------------|
4544 | ?? Aug 2022  | 3.2.5  |                  | 31          |
4545 | 15 Apr 2022  | 3.2.4  |                  | 31          |
4546 | 06 Aug 2020  | 3.2.3  |                  | 31          |
4547 | 04 Jul 2020  | 3.2.2  |                  | 31          |
4548 | 22 Jun 2020  | 3.2.1  |                  | 31          |
4549 | 19 Jun 2020  | 3.2.0  |                  | 31          |
4550 | 28 Jan 2018  | 3.1.3  |                  | 31          |
4551 | 21 Dec 2015  | 3.1.2  |                  | 31          |
4552 | 22 Jun 2014  | 3.1.1  |                  | 31          |
4553 | 28 Sep 2013  | 3.1.0  | 31 Aug 2008      | 31          |
4554 | 23 Sep 2011  | 3.0.9  |                  | 30          |
4555 | 26 Mar 2011  | 3.0.8  |                  | 30          |
4556 | 31 Dec 2009  | 3.0.7  |                  | 30          |
4557 | 08 May 2009  | 3.0.6  |                  | 30          |
4558 | 28 Dec 2008  | 3.0.5  |                  | 30          |
4559 | 06 Sep 2008  | 3.0.4  |                  | 30          |
4560 | 29 Jun 2008  | 3.0.3  |                  | 30          |
4561 | 08 Apr 2008  | 3.0.2  |                  | 30          |
4562 | 03 Apr 2008  | 3.0.1  |                  | 30          |
4563 | 01 Mar 2008  | 3.0.0  | 11 Nov 2006      | 30          |
4564 | 06 Nov 2006  | 2.6.9  |                  | 29          |
4565 | 22 Apr 2006  | 2.6.8  |                  | 29          |
4566 | 11 Mar 2006  | 2.6.7  |                  | 29          |
4567 | 28 Jul 2005  | 2.6.6  |                  | 29          |
4568 | 01 Jun 2005  | 2.6.5  |                  | 29          |
4569 | 30 Mar 2005  | 2.6.4  | 17 Jan 2005      | 29          |
4570 | 30 Sep 2004  | 2.6.3  |                  | 28          |
4571 | 30 Apr 2004  | 2.6.2  |                  | 28          |
4572 | 26 Apr 2004  | 2.6.1  | 08 Jan 2004      | 28          |
4573 | 01 Jan 2004  | 2.6.0  | 10 Apr 2003      | 27 (MAX=40) |
4574 | 04 Dec 2003  | 2.5.7  |                  | 26          |
4575 | 26 Jan 2003  | 2.5.6  |                  | 26          |
4576 | 02 Apr 2002  | 2.5.5  |                  | 26          |
4577 | 13 Mar 2002  | 2.5.4  |                  | 26          |
4578 | 11 Mar 2002  | 2.5.3  |                  | 26          |
4579 | 26 Jan 2002  | 2.5.2  | 11 Jan 2002      | 26          |
4580 | 03 Jan 2002  | 2.5.1  |                  | 25          |
4581 | 30 Nov 2001  | 2.5.0  | 23 Aug 2001      | 25          |
4582 | 06 Sep 2000  | 2.4.6  |                  | 24          |
4583 | 19 Aug 2000  | 2.4.5  |                  | 24          |
4584 | 29 Jul 2000  | 2.4.4  |                  | 24          |
4585 | 09 Apr 2000  | 2.4.3  |                  | 24          |
4586 | 30 Mar 2000  | 2.4.2  |                  | 24          |
4587 | 30 Jan 2000  | 2.4.1  | 29 Jan 2000      | 24          |
4588 | 29 Jan 2000  | 2.4.0  | 28 Jan 2000      | 23          |
4589 | 25 Jan 2000  | 2.3.3  | 23 Jan 2000      | 22          |
4590 | 08 Nov 1999  | 2.3.2  | 26 Jun 1999      | 21          |
4591 | 06 Apr 1999  | 2.3.1  |                  | 20          |
4592 | 15 Mar 1999  | 2.3.0  | 15 Mar 1999      | 20          |
4593 | 25 Nov 1998  | 2.2.1  |                  | 19          |
4594 | 03 Nov 1998  | 2.2.0  |                  | 19          |
4595 | 09 Sep 1998  | 2.1.1  |                  | 19          |
4596 | 20 Jul 1998  | 2.1.0  |                  | 19          |
4597 | 17 Jul 1998  | 2.0.19 |                  | 19          |
4598 | 18 Jun 1998  | 2.0.17 |                  | 19          |
4599 | 01 Jun 1998  | 2.0.16 |                  | 19          |
4600 | 27 May 1998  | 2.0.13 | 27 May 1998      | 19          |
4601 | 26 May 1998  | 2.0.12 |                  | 18          |
4602 | 22 May 1998  | 2.0.11 |                  | 18          |
4603 | 18 May 1998  | 2.0.9  | 18 May 1998      | 18          |
4604 | 17 May 1998  | 2.0.8  |                  | 17          |
4605 | 15 May 1998  | 2.0.1  |                  | 17          |
4606 | 14 May 1998  | 2.0.0  |                  | 17          |
4607 | 17 Apr 1998  | 1.7.4  |                  | 17          |
4608 | 13 Apr 1998  | 1.7.3  |                  | 17          |
4609 | 05 Apr 1998  | 1.7.2  |                  | 17          |
4610 | 26 Mar 1998  | 1.7.1  |                  | 17          |
4611 | 26 Mar 1998  | 1.7.0  | 26 Mar 1998      | 17 (MAX=30) |
4612 | 13 Jan 1998  | 1.6.9  | 13 Jan 1998      | 15 (MAX=20) |
4613
4614 \* DATE OF COMMIT is the date the protocol change was committed to version
4615 control.
4616
4617 @USE_GFM_PARSER@