Move var declaration for older C compilers.
[rsync.git] / OLDNEWS
1 NEWS for rsync 3.0.8 (26 Mar 2011)
2 Protocol: 30 (unchanged)
3 Changes since 3.0.7:
4
5   BUG FIXES:
6
7     - Fixed two buffer-overflow issues: one where a directory path that is
8       exactly MAXPATHLEN was not handled correctly, and one handling a
9       --backup-dir that is extra extra large.
10
11     - Fixed a data-corruption issue when preserving hard-links without
12       preserving file ownership, and doing deletions either before or during
13       the transfer (CVE-2011-1097).  This fixes some assert errors in the
14       hard-linking code, and some potential failed checksums (via -c) that
15       should have matched.
16
17     - Fixed a potential crash when an rsync daemon has a filter/exclude list
18       and the transfer is using ACLs or xattrs.
19
20     - Fixed a hang if a really large file is being processed by an rsync that
21       can't handle 64-bit numbers.  Rsync will now complain about the file
22       being too big and skip it.
23
24     - For devices and special files, we now avoid gathering useless ACL and/or
25       xattr information for files that aren't being copied.  (The un-copied
26       files are still put into the file list, but there's no need to gather
27       data that is not going to be used.)  This ensures that if the user uses
28       --no-D, that rsync can't possibly complain about being unable to gather
29       extended information from special files that are in the file list (but
30       not in the transfer).
31
32     - Properly handle requesting remote filenames that start with a dash.  This
33       avoids a potential error where a filename could be interpreted as a
34       (usually invalid) option.
35
36     - Fixed a bug in the comparing of upper-case letters in file suffixes for
37       --skip-compress.
38
39     - If an rsync daemon has a module configured without a path setting, rsync
40       will now disallow access to that module.
41
42     - If the destination arg is an empty string, it will be treated as a
43       reference to the current directory (as 2.x used to do).
44
45     - If rsync was compiled with a newer time-setting function (such as
46       lutimes), rsync will fall-back to an older function (such as utimes) on a
47       system where the newer function is not around.  This helps to make the
48       rsync binary more portable in mixed-OS-release situations.
49
50     - Fixed a batch-file writing bug that would not write out the full set of
51       compatibility flags that the transfer was using.  This fixes a potential
52       protocol problem for a batch file that contains a sender-side I/O error:
53       it would have been sent in a way that the batch-reader wasn't expecting.
54
55     - Some improvements to the hard-linking code to ensure that device-number
56       hashing is working right, and to supply more information if the hard-link
57       code fails.
58
59     - The --inplace code was improved to not search for an impossible checksum
60       position.  The quadruple-verbose chunk[N] message will now mention when
61       an inplace chunk was handled by a seek rather than a read+write.
62
63     - Improved ACL mask handling, e.g. for Solaris.
64
65     - Fixed a bug that prevented --numeric-ids from disabling the translation
66       of user/group IDs for ACLs.
67
68     - Fixed an issue where an xattr and/or ACL transfer that used an alt-dest
69       option (e.g. --link-dest) could output an error trying to itemize the
70       changes against the alt-dest directory's xattr/ACL info but was instead
71       trying to access the not-yet-existing new destination directory.
72
73     - Improved xattr system-error messages to mention the full path to the
74       file.
75
76     - The --link-dest checking for identical symlinks now avoids considering
77       attribute differences that cannot be changed on the receiver.
78
79     - Avoid trying to read/write xattrs on certain file types for certain OSes.
80       Improved configure to set NO_SYMLINK_XATTRS, NO_DEVICE_XATTRS, and/or
81       NO_SPECIAL_XATTRS defines in config.h.
82
83     - Improved the unsafe-symlink errors messages.
84
85     - Fixed a bug setting xattrs on new files that aren't user writable.
86
87     - Avoid re-setting xattrs on a hard-linked file w/the same xattrs.
88
89     - Fixed a bug with --fake-super when copying files and dirs that aren't
90       user writable.
91
92     - Fixed a bug where a sparse file could have its last sparse block turned
93       into a real block when rsync sets the file size (requires ftruncate).
94
95     - If a temp-file name is too long, rsync now avoids truncating the name in
96       the middle of adjacent high-bit characters.  This prevents a potential
97       filename error if the filesystem doesn't allow a name to contain an
98       invalid multi-byte sequence.
99
100     - If a muli-protocol socket connection fails (i.e., when contacting a
101       daemon), we now report all the failures, not just the last one.  This
102       avoids losing a relevant error (e.g. an IPv4 connection-refused error)
103       that happened before the final error (e.g. an IPv6 protocol-not-supported
104       error).
105
106     - Generate a transfer error if we try to call chown with a -1 for a uid or
107       a gid (which is not settable).
108
109     - Fixed the working of --force when used with --one-file-system.
110
111     - Fix the popt arg parsing so that an option that doesn't take an arg will
112       reject an attempt to supply one (can configure --with-included-popt if
113       your system's popt library doesn't yet have this fix).
114
115     - A couple minor option tweaks to the support/rrsync script, and also some
116       regex changes that make vim highlighting happier.
117
118     - Fixed some issues in the support/mnt-excl script.
119
120     - Various manpage improvements.
121
122   ENHANCEMENTS:
123
124     - Added ".hg/" to the default cvs excludes (see -C & --cvs-exclude).
125
126   DEVELOPER RELATED:
127
128     - Use lchmod() whenever it is available (not just on symlinks).
129
130     - A couple fixes to the socketpair_tcp() routine.
131
132     - Updated the helper scripts in the packaging subdirectory.
133
134     - Renamed configure.in to configure.ac.
135
136     - Fixed configure's checking for iconv routines for newer OS X versions.
137
138     - Fixed the testsuite/xattrs.test script on OS X.
139 \f
140 NEWS for rsync 3.0.7 (31 Dec 2009)
141 Protocol: 30 (unchanged)
142 Changes since 3.0.6:
143
144   BUG FIXES:
145
146     - Fixed a bogus free when using --xattrs with --backup.
147
148     - Avoid an error when --dry-run  was trying to stat a prior hard-link file
149       that hasn't really been created.
150
151     - Fixed a problem with --compress (-z) where the receiving side could
152       return the error "inflate (token) returned -5".
153
154     - Fixed a bug where --delete-during could delete in a directory before it
155       noticed that the sending side sent an I/O error for that directory (both
156       sides of the transfer must be at least 3.0.7).
157
158     - Improved --skip-compress's error handling of bad character-sets and got
159       rid of a lingering debug fprintf().
160
161     - Fixed the daemon's conveyance of io_error value from the sender.
162
163     - An rsync daemon use seteuid() (when available) if it used setuid().
164
165     - Get the permissions right on a --fake-super transferred directory that
166       needs more owner permissions to emulate root behavior.
167
168     - An absolute-path filter rule (i.e. with a '/' modifier) no longer loses
169       its modifier when sending the filter rules to the remote rsync.
170
171     - Improved the "--delete does not work without -r or -d" message.
172
173     - Improved rsync's handling of --timeout to avoid a weird timeout case
174       where the sender could timeout even though it has recently written data
175       to the socket (but hasn't read data recently, due to the writing).
176
177     - Some misc manpage improvements.
178
179     - Fixed the chmod-temp-dir testsuite on a system without /var/tmp.
180
181     - Make sure that a timeout specified in the daemon's config is used as a
182       maximum timeout value when the user also specifies a timeout.
183
184     - Improved the error-exit reporting when rsync gets an error trying to
185       cleanup after an error:  the initial error is reported.
186
187     - Improved configure's detection of IPv6 for solaris and cygwin.
188
189     - The AIX sysacls routines will now return ENOSYS if ENOTSUP is missing.
190
191     - Made our (only used if missing) getaddrinfo() routine use inet_pton()
192       (which we also provide) instead of inet_aton().
193
194     - The exit-related debug messages now mention the program's role so it is
195       clear who output what message.
196
197   DEVELOPER RELATED:
198
199     - Got rid of type-punned compiler warnings output by newer gcc versions.
200
201     - The Makefile now ensures that proto.h will be rebuilt if config.h changes.
202
203     - The testsuite no longer uses "id -u", so it works better on solaris.
204
205 \f
206 NEWS for rsync 3.0.6 (8 May 2009)
207 Protocol: 30 (unchanged)
208 Changes since 3.0.5:
209
210   BUG FIXES:
211
212     - Fixed a --read-batch hang when rsync is reading a batch file that was
213       created from an incremental-recursion transfer.
214
215     - Fixed the daemon's socket code to handle the simultaneous arrival of
216       multiple connections.
217
218     - Fix --safe-links/--copy-unsafe-links to properly handle symlinks that
219       have consecutive slashes in the value.
220
221     - Fixed the parsing of an [IPv6_LITERAL_ADDR] when a USER@ is prefixed.
222
223     - The sender now skips a (bogus) symlink that has a 0-length value, which
224       avoids a transfer error in the receiver.
225
226     - Fixed a case where the sender could die with a tag-0 error if there was
227       an I/O during the sending of the file list.
228
229     - Fixed the rrsync script to avoid a server-side problem when -e is at the
230       start of the short options.
231
232     - Fixed a problem where a vanished directory could turn into an exit code
233       23 instead of the proper exit code 24.
234
235     - Fixed the --iconv conversion of symlinks when doing a local copy.
236
237     - Fixed a problem where --one-file-system was not stopping deletions on the
238       receiving side when a mount-point directory did not match a directory in
239       the transfer.
240
241     - Fixed the dropping of an ACL mask when no named ACL values were present.
242
243     - Fixed an ACL/xattr corruption issue where the --backup option could cause
244       rsync to associate the wrong ACL/xattr information with received files.
245
246     - Fixed the use of --xattrs with --only-write-batch.
247
248     - Fixed the use of --dry-run with --read-batch.
249
250     - Fixed configure's erroneous use of target.
251
252     - Fixed configure's --disable-debug option.
253
254     - Fixed a run-time issue for systems that can't find iconv_open() by adding
255       the --disable-iconv-open configure option.
256
257     - Complain and die if the user tries to combine --remove-source-files (or
258       the deprecated --remove-sent-files) with --read-batch.
259
260     - Fixed an failure transferring special files from Solaris to Linux.
261
262 \f
263 NEWS for rsync 3.0.5 (28 Dec 2008)
264 Protocol: 30 (unchanged)
265 Changes since 3.0.4:
266
267   BUG FIXES:
268
269     - Initialize xattr data in a couple spots in the hlink code, which avoids a
270       crash when the xattr pointer's memory happens to start out non-zero.
271       Also fixed the itemizing of an alt-dest file's xattrs when hard-linking.
272
273     - Don't send a bogus "-" option to an older server if there were no short
274       options specified.
275
276     - Fixed skipping of unneeded updates in a batch file when incremental
277       recursion is active.  Added a test for this.  Made batch-mode handle
278       "redo" files properly (and without hanging).
279
280     - Fix the %P logfile escape when the daemon logs from inside a chroot.
281
282     - Fixed the use of -s (--protect-args) when used with a remote source or
283       destination that had an empty path (e.g. "host:").  Also fixed a problem
284       when -s was used when accessing a daemon via a remote-shell.
285
286     - Fixed the use of a dot-dir path (e.g. foo/./bar) inside a --files-from
287       file when the root of the transfer isn't the current directory.
288
289     - Fixed a bug with "-K --delete" removing symlinks to directories when
290       incremental recursion is active.
291
292     - Fixed a hard to trigger hang when using --remove-source-files.
293
294     - Got rid of an annoying delay when accessing a daemon via a remote-shell.
295
296     - Properly ignore (superfluous) source args on a --read-batch command.
297
298     - Improved the manpage's description of the '*' wildcard to remove the
299       confusing "non-empty" qualifier.
300
301     - Fixed reverse lookups in the compatibility-library version of
302       getnameinfo().
303
304     - Fixed a bug when using --sparse on a sparse file that has over 2GB of
305       consecutive sparse data.
306
307     - Avoid a hang when using at least 3 --verbose options on a transfer with a
308       client sender (which includes local copying).
309
310     - Fixed a problem with --delete-delay reporting an error when it was ready
311       to remove a directory that was now gone.
312
313     - Got rid of a bunch of "warn_unused_result" compiler warnings.
314
315     - If an ftruncate() on a received file fails, it now causes a partial-
316       transfer warning.
317
318     - Allow a path with a leading "//" to be preserved (CYGWIN only).
319
320   ENHANCEMENTS:
321
322     - Made the support/atomic-rsync script able to perform a fully atomic
323       update of the copied hierarchy when the destination is setup using a
324       particular symlink idiom.
325
326 \f
327 NEWS for rsync 3.0.4 (6 Sep 2008)
328 Protocol: 30 (unchanged)
329 Changes since 3.0.3:
330
331   BUG FIXES:
332
333     - Fixed a bug in the hard-linking code where it would sometimes try to
334       allocate 0 bytes of memory (which fails on some OSes, such as AIX).
335
336     - Fixed the hard-linking of files from a device that has a device number
337       of 0 (which seems to be a common device number on NetBSD).
338
339     - Fixed the handling of a --partial-dir that cannot be created.  This
340       particularly impacts the --delay-updates option (since the files cannot
341       be delayed without a partial-dir), and was potentially destructive if
342       the --remove-source-files was also specified.
343
344     - Fixed a couple issues in the --fake-super handling of xattrs when the
345       destination files have root-level attributes (e.g. selinux values) that
346       a non-root copy can't affect.
347
348     - Improved the keep-alive check in the generator to fire consistently in
349       incremental-recursion mode when --timeout is enabled.
350
351     - The --iconv option now converts the content of a symlink too, instead
352       of leaving it in the wrong character-set (requires 3.0.4 on both sides
353       of the transfer).
354
355     - When using --iconv, if a filename fails to convert on the receiving side,
356       this no longer makes deletions in the root-dir of the transfer fail
357       silently (the user now gets a warning about deletions being disabled
358       due to IO error as long as --ignore-errors was not specified).
359
360     - When using --iconv, if a server-side receiver can't convert a filename,
361       the error message sent back to the client no longer mangles the name
362       with the wrong charset conversion.
363
364     - Fixed a potential alignment issue in the IRIX ACL code when allocating
365       the initial "struct acl" object.  Also, cast mallocs to avoid warnings.
366
367     - Changed some errors that were going to stdout to go to stderr.
368
369     - Made human_num() and human_dnum() able to output a negative number
370       (rather than outputting a cryptic string of punctuation).
371
372   ENHANCEMENTS:
373
374     - Rsync will avoid sending an -e option to the server if an older protocol
375       is requested (and thus the option would not be useful).  This lets the
376       user specify the --protocol=29 option to access an overly-restrictive
377       server that is rejecting the protocol-30 use of -e to the server.
378
379     - Improved the message output for an RERR_PARTIAL exit.
380
381   DEVELOPER RELATED:
382
383     - The Makefile will not halt for just a timestamp change on the Makefile
384       or the configure files, only for actual changes in content.
385
386     - Changed some commands in the testsuite's xattrs.test that called "rsync"
387       instead of "$RSYNC".
388
389     - Enhanced the release scripts to be able to handle a branch release and
390       to do even more consistency checks on the files.
391
392 \f
393 NEWS for rsync 3.0.3 (29 Jun 2008)
394 Protocol: 30 (unchanged)
395 Changes since 3.0.2:
396
397   BUG FIXES:
398
399     - Fixed a wildcard matching problem in the daemon when a module has
400       "use chroot" enabled.
401
402     - Fixed a crash bug in the hard-link code.
403
404     - Fixed the sending of xattr directory information when the code finds a
405       --link-dest or --copy-dest directory with unchanged xattrs -- the
406       destination directory now gets these unchanged xattrs properly applied.
407
408     - Fixed an xattr-sending glitch that could cause an "Internal abbrev"
409       error.
410
411     - Fixed the combination of --xattrs and --backup.
412
413     - The generator no longer allows a '.' dir to be excluded by a daemon-
414       exclude rule.
415
416     - Fixed deletion handling when copying a single, empty directory (with no
417       files) to a differently named, non-existent directory.
418
419     - Fixed the conversion of spaces into dashes in the %M log escape.
420
421     - Fixed several places in the code that were not returning the right
422       errno when a function failed.
423
424     - Fixed the backing up of a device or special file into a backup dir.
425
426     - Moved the setting of the socket options prior to the connect().
427
428     - If rsync exits in the middle of a --progress output, it now outputs a
429       newline to help prevent the progress line from being overwritten.
430
431     - Fixed a problem with how a destination path with a trailing slash or
432       a trailing dot-dir was compared against the daemon excludes.
433
434     - Fixed the sending of large (size > 16GB) files when talking to an older
435       rsync (protocols < 30):  we now use a compatible block size limit.
436
437     - If a file's length is so huge that we overflow a checksum buffer count
438       (i.e. several hundred TB), warn the user and avoid sending an invalid
439       checksum struct over the wire.
440
441     - If a source arg is excluded, --relative no longer adds the excluded
442       arg's implied dirs to the transfer.  This fix also made the exclude
443       check happen in the better place in the sending code.
444
445     - Use the overflow_exit() function for overflows, not out_of_memory().
446
447     - Improved the code to better handle a system that has only 32-bit file
448       offsets.
449
450   ENHANCEMENTS:
451
452     - The rsyncd.conf manpage now consistently refers to the parameters in
453       the daemon config file as "parameters".
454
455     - The description of the --inplace option was improved.
456
457   EXTRAS:
458
459     - Added a new script in the support directory, deny-rsync, which allows
460       an admin to (temporarily) replace the rsync command with a script that
461       sends an error message to the remote client via the rsync protocol.
462
463   DEVELOPER RELATED:
464
465     - Fixed a testcase failure if the tests are run as root and made some
466       compatibility improvements.
467
468     - Improved the daemon tests, including checking module comments, the
469       listing of files, and the ensuring that daemon excludes can't affect
470       a dot-dir arg.
471
472     - Improved some build rules for those that build in a separate directory
473       from the source, including better install rules for the man pages, and
474       the fixing of a proto.h-tstamp rule that could make the binaries get
475       rebuild without cause.
476
477     - Improved the testsuite to work around a problem with some utilities
478       (e.g. cp -p & touch -r) rounding sub-second timestamps.
479
480     - Ensure that the early patches don't cause any generated-file hunks to
481       bleed-over into patches that follow.
482
483 \f
484 NEWS for rsync 3.0.2 (8 Apr 2008)
485 Protocol: 30 (unchanged)
486 Changes since 3.0.1:
487
488   BUG FIXES:
489
490     - Fixed a potential buffer overflow in the xattr code.
491
492   ENHANCEMENTS:
493
494     - None.
495
496   DEVELOPER RELATED:
497
498     - The RPM spec file was improved to install more useful files.
499
500     - A few developer-oriented scripts were moved from the support dir
501       to the packaging dir.
502
503 \f
504 NEWS for rsync 3.0.1 (3 Apr 2008)
505 Protocol: 30 (unchanged)
506 Changes since 3.0.0:
507
508   NOTABLE CHANGES IN BEHAVIOR:
509
510     - Added the 'c'-flag to the itemizing of non-regular files so that the
511       itemized output doesn't get hidden if there were no attribute changes,
512       and also so that the itemizing of a --copy-links run will distinguish
513       between copying an identical non-regular file and the creation of a
514       revised version with a new value (e.g. a changed symlink referent, a
515       new device number, etc.).
516
517   BUG FIXES:
518
519     - Fixed a crash bug when a single-use rsync daemon (via remote shell) was
520       run without specifying a --config=FILE option.
521
522     - Fixed a crash when backing up a directory that has a default ACL.
523
524     - Fixed a bug in the handling of xattr values that could cause rsync to
525       not think that a file's extended attributes are up-to-date.
526
527     - Fixed the working of --fake-super with --link-dest and --xattrs.
528
529     - Fixed a hang when combining --dry-run with --remove-source-files.
530
531     - Fixed a bug with --iconv's handling of files that cannot be converted:
532       a failed name can no longer cause a transfer failure.
533
534     - Fixed the building of the rounding.h file on systems that need custom
535       CPPFLAGS to be used.  Also improved the error reporting if the building
536       of rounding.h fails.
537
538     - Fixed the use of the --protect-args (-s) option when talking to a daemon.
539
540     - Fixed the --ignore-existing option's protection of files on the receiver
541       that are non-regular files on the sender (e.g. if a symlink or a dir on
542       the sender is trying to replace a file on the receiver).  The reverse
543       protection (protecting a dir/symlink/device from being replaced by a
544       file) was already working.
545
546     - Fixed an assert failure if --hard-links is combined with an option that
547       can skip a file in a set of hard-linked files (i.e. --ignore-existing,
548       --append, etc.), without skipping all the files in the set.
549
550     - Avoid setting the modify time on a directory that already has the right
551       modify time set.  This avoids tweaking the dir's ctime.
552
553     - Improved the daemon-exclude handling to do a better job of applying the
554       exclude rules to path entries.  It also sends the user an error just as
555       if the files were actually missing (instead of silently ignoring the
556       user's args), and avoids sending the user the filter-action messages
557       for these non-user-initiated rules.
558
559     - Fixed some glitches with the dry-run code's missing-directory
560       handling, including a problem when combined with --fuzzy.
561
562     - Fixed some glitches with the skipped-directory handling.
563
564     - Fixed the 'T'-flag itemizing of symlinks when --time isn't preserved.
565
566     - Fixed a glitch in the itemizing of permissions with the -E option.
567
568     - The --append option's restricting of transfers to those that add data no
569       longer prevents the updating of non-content changes to otherwise up-to-
570       date files (i.e. those with the same content but differing permissions,
571       ownership, xattrs, etc.).
572
573     - Don't allow --fake-super to be specified with -XX (double --xattrs)
574       because the options conflict.  If a daemon has "fake super" enabled,
575       it automatically downgrades a -XX request to -X.
576
577     - Fixed a couple bugs in the parsing of daemon-config excludes that could
578       make a floating exclude rule get treated as matching an absolute path.
579
580     - A daemon doesn't try to auto-refuse the "iconv" option if iconv-support
581       wasn't compiled in to the daemon (avoiding a warning in the logs).
582
583     - Fixed the inclusion of per-dir merge files from implied dirs.
584
585     - Fixed the support/rrsync script to work with the latest options that
586       rsync sends (including its flag-specifying use of -e to the server).
587
588   ENHANCEMENTS:
589
590     - Added the --old-dirs (--old-d) option to make it easier for a user to
591       ask for file-listings with older rsync versions (this is easier than
592       having to type "-r --exclude='/*/*'" manually).
593
594     - When getting an error while asking an older rsync daemon for a file
595       listing, rsync will try to notice if the error is a rejection of the
596       --dirs (-d) option and let the user know how to work around the issue.
597
598     - Added a few more --no-OPTION overrides.
599
600     - Improved the documentation of the --append option.
601
602     - Improved the documentation of the filter/exclude/include daemon
603       parameters.
604
605   INTERNAL:
606
607     - Fixed a couple minor bugs in the included popt library (ones which I
608       sent to the official popt project for inclusion in the 1.14 release).
609
610     - Fixed a stat() call that should have been do_stat() so that the proper
611       normal/64-bit stat() function gets called.  (Was in an area that should
612       not have caused problems, though.)
613
614     - Changed the file-glob code to do a directory scan without using the
615       "glob" and "glob.h".  This lets us do the globbing with less memory
616       churn, and also avoid adding daemon-excluded items to the returned
617       args.
618
619   DEVELOPER RELATED:
620
621     - The configure script tries to get the user's compiler to not warn about
622       unused function parameters if the build is not including one or more of
623       the ACL/xattrs/iconv features.
624
625     - The configure script now has better checks for figuring out if the
626       included popt code should be used or not.
627
628     - Fixed two testsuite glitches: avoid a failure if someone's "cd" command
629       outputs the current directory when cd-ing to a relative path, and made
630       the itemized test query how rsync was built to determine if it should
631       expect hard-linked symlinks or not.
632
633     - Updated the testsuite to verify that various bug fixes remain fixed.
634
635     - The RPM spec file was updated to have: (1) comments for how to use the
636       rsync-patch tar file, and (2) an /etc/xinetd.d/rsync file.
637
638     - Updated the build scripts to work with a revised FTP directory
639       structure.
640
641 \f
642 NEWS for rsync 3.0.0 (1 Mar 2008)
643 Protocol: 30 (changed)
644 Changes since 2.6.9:
645
646   NOTABLE CHANGES IN BEHAVIOR:
647
648     - The handling of implied directories when using --relative has changed to
649       send them as directories (e.g. no implied dir is ever sent as a symlink).
650       This avoids unexpected behavior and should not adversely affect most
651       people.  If you're one of those rare individuals who relied upon having
652       an implied dir be duplicated as a symlink, you should specify the
653       transfer of the symlink and the transfer of the referent directory as
654       separate args.  (See also --keep-dirlinks and --no-implied-dirs.)
655       Also, exclude rules no longer have a partial effect on implied dirs.
656
657     - Requesting a remote file-listing without specifying -r (--recursive) now
658       sends the -d (--dirs) option to the remote rsync rather than sending -r
659       along with an extra exclude of /*/*.  If the remote rsync does not
660       understand the -d option (i.e. it is 2.6.3 or older), you will need to
661       either turn off -d (--no-d), or specify  -r --exclude='/*/*'  manually.
662
663     - In --dry-run mode, the last line of the verbose summary text is output
664       with a "(DRY RUN)" suffix to help remind you that no updates were made.
665       Similarly, --only-write-batch outputs "(BATCH ONLY)".
666
667     - A writable rsync daemon with "use chroot" disabled now defaults to a
668       symlink-munging behavior designed to make symlinks safer while also
669       allowing absolute symlinks to be stored and retrieved.  This also has
670       the effect of making symlinks unusable while they're in the daemon's
671       hierarchy.  See the daemon's "munge symlinks" parameter for details.
672
673     - Starting up an extra copy of an rsync daemon will not clobber the pidfile
674       for the running daemon -- if the pidfile exists, the new daemon will exit
675       with an error.  This means that your wrapper script that starts the rsync
676       daemon should be made to handle lock-breaking (if you want any automatic
677       breaking of locks to be done).
678
679   BUG FIXES:
680
681     - A daemon with "use chroot = no" and excluded items listed in the daemon
682       config file now properly checks an absolute-path arg specified for these
683       options:  --compare-dest, --link-dest, --copy-dest, --partial-dir,
684       --backup-dir, --temp-dir, and --files-from.
685
686     - A daemon can now be told to disable all user- and group-name translation
687       on a per-module basis.  This avoids a potential problem with a writable
688       daemon module that has "use chroot" enabled -- if precautions weren't
689       taken, a user could try to add a missing library and get rsync to use
690       it.  This makes rsync safer by default, and more configurable when id-
691       translation is not desired.  See the daemon's "numeric ids" parameter
692       for full details.
693
694     - A chroot daemon can now indicate which part of its path should affect the
695       chroot call, and which part should become an inside-chroot path for the
696       module.  This allows you to have outside-the-transfer paths (such as for
697       libraries) even when you enable chroot protection.  The idiom used in the
698       rsyncd.conf file is:  path = /chroot/dirs/./dirs/inside
699
700     - If a file's data arrived successfully on the receiving side but the
701       rename of the temporary file to the destination file failed AND the
702       --remove-source-files (or the deprecated --remove-sent-files) option
703       was specified, rsync no longer erroneously removes the associated
704       source file.
705
706     - Fixed the output of -ii when combined with one of the --*-dest options:
707       it now itemizes all the items, not just the changed ones.
708
709     - Made the output of all file types consistent when using a --*-dest
710       option.  Prior versions would output too many creation events for
711       matching items.
712
713     - The code that waits for a child pid now handles being interrupted by a
714       signal.  This fixes a problem with the pre-xfer exec function not being
715       able to get the exit status from the script.
716
717     - A negated filter rule (i.e. with a '!' modifier) no longer loses the
718       negation when sending the filter rules to the remote rsync.
719
720     - Fixed a problem with the --out-format (aka --log-format) option %f:  it
721       no longer outputs superfluous directory info for a non-daemon rsync.
722
723     - Fixed a problem with -vv (double --verbose) and --stats when "pushing"
724       files (which includes local copies).  Version 2.6.9 would complete the
725       copy, but exit with an error when the receiver output its memory stats.
726
727     - If --password-file is used on a non-daemon transfer, rsync now complains
728       and exits.  This should help users figure out that they can't use this
729       option to control a remote shell's password prompt.
730
731     - Make sure that directory permissions of a newly-created destination
732       directory are handled right when --perms is left off.
733
734     - The itemized output of a newly-created destination directory is now
735       output as a creation event, not a change event.
736
737     - Improved --hard-link so that more corner cases are handled correctly
738       when combined with options such as --link-dest and/or --ignore-existing.
739
740     - The --append option no longer updates a file that has the same size.
741
742     - Fixed a bug when combining --backup and --backup-dir with --inplace:
743       any missing backup directories are now created.
744
745     - Fixed a bug when using --backup and --inplace with --whole-file or
746       --read-batch: backup files are actually created now.
747
748     - The daemon pidfile is checked and created sooner in the startup sequence.
749
750     - If a daemon module's "path" value is not an absolute pathname, the code
751       now makes it absolute internally (making it work properly).
752
753     - Ensure that a temporary file always has owner-write permission while we
754       are writing to it.  This avoids problems with some network filesystems
755       when transfering read-only files.
756
757     - Any errors output about password-file reading no longer cause an error at
758       the end of the run about a partial transfer.
759
760     - The --read-batch option for protocol 30 now ensures that several more
761       options are set correctly for the current batch file:  --iconv, --acls,
762       --xattrs, --inplace, --append, and --append-verify.
763
764     - Using --only-write-batch to a daemon receiver now works properly (older
765       versions would update some files while writing the batch).
766
767     - Avoid outputting a "file has vanished" message when the file is a broken
768       symlink and --copy-unsafe-links or --copy-dirlinks is used (the code
769       already handled this for --copy-links).
770
771     - Fixed the combination of --only-write-batch and --dry-run.
772
773     - Fixed rsync's ability to remove files that are not writable by the file's
774       owner when rsync is running as the same user.
775
776     - When transferring large files, the sender's hashtable of checksums is
777       kept at a more reasonable state of fullness (no more than 80% full) so
778       that the scanning of the hashtable will not bog down as the number of
779       blocks increases.
780
781   ENHANCEMENTS:
782
783     - A new incremental-recursion algorithm is now used when rsync is talking
784       to another 3.x version.  This starts the transfer going more quickly
785       (before all the files have been found), and requires much less memory.
786       See the --recursive option in the manpage for some restrictions.
787
788     - Lowered memory use in the non-incremental-recursion algorithm for typical
789       option values (usually saving from 21-29 bytes per file).
790
791     - The default --delete algorithm is now --delete-during when talking to a
792       3.x rsync.  This is a faster scan than using --delete-before (which is
793       the default when talking to older rsync versions), and is compatible with
794       the new incremental recursion mode.
795
796     - Rsync now allows multiple remote-source args to be specified rather than
797       having to rely on a special space-splitting side-effect of the remote-
798       shell.  Additional remote args must specify the same host or an empty one
799       (e.g. empty:  :file1  or  ::module/file2).  For example, this means that
800       local use of brace expansion now works:  rsync -av host:dir/{f1,f2} .
801
802     - Added the --protect-args (-s) option, that tells rsync to send most of
803       the command-line args at the start of the transfer rather than as args
804       to the remote-shell command.  This protects them from space-splitting,
805       and only interprets basic wildcard special shell characters (*?[).
806
807     - Added the --delete-delay option, which is a more efficient way to delete
808       files at the end of the transfer without needing a separate delete pass.
809
810     - Added the --acls (-A) option to preserve Access Control Lists.  This is
811       an improved version of the prior patch that was available, and it even
812       supports OS X ACLs.  If you need to have backward compatibility with old,
813       ACL-patched versions of rsync, apply the acls.diff file from the patches
814       dir.
815
816     - Added the --xattrs (-X) option to preserve extended attributes.  This is
817       an improved version of the prior patch that was available, and it even
818       supports OS X xattrs (which includes their resource fork data).  If you
819       need to have backward compatibility with old, xattr-patched versions of
820       rsync, apply the xattrs.diff file from the patches dir.
821
822     - Added the --fake-super option that allows a non-super user to preserve
823       all attributes of a file by using a special extended-attribute idiom.
824       It even supports the storing of foreign ACL data on your backup server.
825       There is also an analogous "fake super" parameter for an rsync daemon.
826
827     - Added the --iconv option, which allows rsync to convert filenames from
828       one character-set to another during the transfer.  The default is to
829       make this feature available as long as your system has iconv_open().
830       If compilation fails, specify --disable-iconv to configure, and then
831       rebuild.  If you want rsync to perform character-set conversions by
832       default, you can specify --enable-iconv=CONVERT_STRING with the default
833       value for the --iconv option that you wish to use.  For example,
834       "--enable-iconv=." is a good choice.  See the rsync manpage for an
835       explanation of the --iconv option's settings.
836
837     - A new daemon config parameter, "charset", lets you control the character-
838       set that is used during an --iconv transfer to/from a daemon module.  You
839       can also set your daemon to refuse "no-iconv" if you want to force the
840       client to use an --iconv transfer (requiring an rsync 3.x client).
841
842     - Added the --skip-compress=LIST option to override the default list of
843       file suffixes that will not be compressed when using --compress (-z).
844
845     - The daemon's default for "dont compress" was extended to include:
846           *.7z *.mp[34] *.mov *.avi *.ogg *.jpg *.jpeg
847       The name-matching routine was also optimized to run more quickly.
848
849     - The --max-delete option now outputs a warning if it skipped any file
850       deletions, including a count of how many deletions were skipped.  (Older
851       versions just silently stopped deleting things.)
852
853     - You may specify --max-delete=0 to a 3.0.0 client to request that it warn
854       about extraneous files without deleting anything.  If you're not sure
855       what version the client is, you can use the less-obvious --max-delete=-1,
856       as both old and new versions will treat that as the same request (though
857       older versions don't warn).
858
859     - The --hard-link option now uses less memory on both the sending and
860       receiving side for all protocol versions.  For protocol 30, the use of a
861       hashtable on the sending side allows us to more efficiently convey to the
862       receiver what files are linked together.  This reduces the amount of data
863       sent over the socket by a considerable margin (rather than adding more
864       data), and limits the in-memory storage of the device+inode information
865       to just the sending side for the new protocol 30, or to the receiving
866       side when speaking an older protocol (note that older rsync versions kept
867       the device+inode information on both sides).
868
869     - The filter rules now support a perishable ("p") modifier that marks rules
870       that should not have an effect in a directory that is being deleted.  e.g.
871       -f '-p .svn/' would only affect "live" .svn directories.
872
873     - Rsync checks all the alternate-destination args for validity (e.g.
874       --link-dest).  This lets the user know when they specified a directory
875       that does not exist.
876
877     - If we get an ENOSYS error setting the time on a symlink, we don't
878       complain about it anymore (for those systems that even support the
879       setting of the modify-time on a symlink).
880
881     - Protocol 30 now uses MD5 checksums instead of MD4.
882
883     - Changed the --append option to not checksum the existing data in the
884       destination file, which speeds up file appending.
885
886     - Added the --append-verify option, which works like the older --append
887       option (verifying the existing data in the destination file).  For
888       compatibility with older rsync versions, any use of --append that is
889       talking protocol 29 or older will revert to the --append-verify method.
890
891     - Added the --contimeout=SECONDS option that lets the user specify a
892       connection timeout for rsync daemon access.
893
894     - Documented and extended the support for the RSYNC_CONNECT_PROG variable
895       that can be used to enhance the client side of a daemon connection.
896
897     - Improved the dashes and double-quotes in the nroff manpage output.
898
899     - Rsync now supports a lot more --no-OPTION override options.
900
901   INTERNAL:
902
903     - The file-list sorting algorithm now uses a sort that keeps any same-
904       named items in the same order as they were specified.  This allows
905       rsync to always ensure that the first of the duplicates is the one
906       that will be included in the copy.  The new sort is also faster
907       than the glibc version of qsort() and mergesort().
908
909     - Rsync now supports the transfer of 64-bit timestamps (time_t values).
910
911     - Made the file-deletion code use a little less stack when recursing
912       through a directory hierarchy of extraneous files.
913
914     - Fixed a build problem with older (2.x) versions of gcc.
915
916     - Added some isType() functions that make dealing with signed characters
917       easier without forcing variables via casts.
918
919     - Changed strcat/strcpy/sprintf function calls to use safer versions.
920
921     - Upgraded the included popt version to 1.10.2 and improved its use of
922       string-handling functions.
923
924     - Added missing prototypes for compatibility functions from the lib dir.
925
926     - Configure determines if iconv() has a const arg, allowing us to avoid a
927       compiler warning.
928
929     - Made the sending of some numbers more efficient for protocol 30.
930
931     - Make sure that a daemon process doesn't mind if the client was weird and
932       omitted the --server option.
933
934     - There are more internal logging categories available in protocol 30 than
935       the age-old FINFO and FERROR, including FERROR_XFER and FWARN.  These new
936       categories allow some errors and warnings to go to stderr without causing
937       an erroneous end-of-run warning about some files not being able to be
938       transferred.
939
940     - Improved the use of "const" on pointers.
941
942     - Improved J.W.'s pool_alloc routines to add a way of incrementally freeing
943       older sections of a pool's memory.
944
945     - The getaddrinfo.c compatibility code in the "lib" dir was replaced with
946       some new code (derived from samba, derived from PostgreSQL) that has a
947       better license than the old code.
948
949   DEVELOPER RELATED:
950
951     - Rsync is now licensed under the GPLv3 or later.
952
953     - Rsync is now being maintained in a "git" repository instead of CVS
954       (though the old CVS repository still exists for historical access).
955       Several maintenance scripts were updated to work with git.
956
957     - Generated files are no longer committed into the source repository.  The
958       autoconf and autoheader commands are now automatically run during the
959       normal use of "configure" and "make".  The latest dev versions of all
960       generated files can also be copied from the samba.org web site (see the
961       prepare-source script's fetch option).
962
963     - The "patches" directory of diff files is now built from branches in the
964       rsync git repository (branch patch/FOO creates file patches/FOO.diff).
965       This directory is now distributed in a separate separate tar file named
966       rsync-patches-VERSION.tar.gz instead of the main rsync-VERSION.tar.gz.
967
968     - The proto.h file is now built using a simple perl script rather than a
969       complex awk script, which proved to be more widely compatible.
970
971     - When running the tests, we now put our per-test temp dirs into a sub-
972       directory named testtmp (which is created, if missing).  This allows
973       someone to symlink the testtmp directory to another filesystem (which is
974       useful if the build dir's filesystem does not support ACLs and xattrs,
975       but another filesystem does).
976
977     - Rsync now has a way of handling protocol-version changes during the
978       development of a new protocol version.  This causes any out-of-sync
979       versions to speak an older protocol rather than fail in a cryptic manner.
980       This addition makes it safer to deploy a pre-release version that may
981       interact with the public.  This new exchange of sub-version info does not
982       interfere with the {MIN,MAX}_PROTOCOL_VERSION checking algorithm (which
983       does not have enough range to allow the main protocol number to be
984       incremented for every minor tweak in that happens during development).
985
986     - The csprotocol.txt file was updated to mention the daemon protocol change
987       in the 3.0.0 release.
988
989 \f
990 NEWS for rsync 2.6.9 (6 Nov 2006)
991 Protocol: 29 (unchanged)
992 Changes since 2.6.8:
993
994   BUG FIXES:
995
996     - If rsync is interrupted via a handled signal (such as SIGINT), it will
997       once again clean-up its temp file from the destination dir.
998
999     - Fixed an overzealous sanitizing bug in the handling of the --link-dest,
1000       --copy-dest, and --compare-dest options to a daemon without chroot: if
1001       the copy's destination dir is deeper than the top of the module's path,
1002       these options now accept a safe number of parent-dir (../) references
1003       (since these options are relative to the destination dir).  The old code
1004       incorrectly chopped off all "../" prefixes for these options, no matter
1005       how deep the destination directory was in the module's hierarchy.
1006
1007     - Fixed a bug where a deferred info/error/log message could get sent
1008       directly to the sender instead of being handled by rwrite() in the
1009       generator.  This fixes an "unexpected tag 3" fatal error, and should
1010       also fix a potential problem where a deferred info/error message from
1011       the receiver might bypass the log file and get sent only to the client
1012       process.  (These problems could only affect an rsync daemon that was
1013       receiving files.)
1014
1015     - Fixed a bug when --inplace was combined with a --*-dest option and we
1016       update a file's data using an alternate basis file.  The code now
1017       notices that it needs to copy the matching data from the basis file
1018       instead of (wrongly) assuming that it was already present in the file.
1019
1020     - Fixed a bug where using --dry-run with a --*-dest option with a path
1021       relative to a directory that does not yet exist:  the affected option
1022       gets its proper path value so that the output of the dry-run is right.
1023
1024     - Fixed a bug in the %f logfile escape when receiving files: the
1025       destination path is now included in the output (e.g. you can now tell
1026       when a user specifies a subdir inside a module).
1027
1028     - If the receiving side fails to create a directory, it will now skip
1029       trying to update everything that is inside that directory.
1030
1031     - If --link-dest is specified with --checksum but without --times, rsync
1032       will now allow a hard-link to be created to a matching link-dest file
1033       even when the file's modify-time doesn't match the server's file.
1034
1035     - The daemon now calls more timezone-using functions prior to doing a
1036       chroot.  This should help some C libraries to generate proper timestamps
1037       from inside a chrooted daemon (and to not try to access /etc/timezone
1038       over and over again).
1039
1040     - Fixed a bug in the handling of an absolute --partial-dir=ABS_PATH option:
1041       it now deletes an alternate basis file from the partial-dir that was used
1042       to successfully update a destination file.
1043
1044     - Fixed a bug in the handling of --delete-excluded when using a per-dir
1045       merge file:  the merge file is now honored on the receiving side, and
1046       only its unqualified include/exclude commands are ignored (just as is
1047       done for global include/excludes).
1048
1049     - Fixed a recent bug where --delete was not working when transferring from
1050       the root (/) of the filesystem with --relative enabled.
1051
1052     - Fixed a recent bug where an --exclude='*' could affect the root (/) of
1053       the filesystem with --relative enabled.
1054
1055     - When --inplace creates a file, it is now created with owner read/write
1056       permissions (0600) instead of no permissions at all.  This avoids a
1057       problem continuing a transfer that was interrupted (since --inplace
1058       will not update a file that has no write permissions).
1059
1060     - If either --remove-source-files or --remove-sent-files is enabled and we
1061       are unable to remove the source file, rsync now outputs an error.
1062
1063     - Fixed a bug in the daemon's "incoming chmod" rule:  newly-created
1064       directories no longer get the 'F' (file) rules applied to them.
1065
1066     - Fixed an infinite loop bug when a filter rule was rejected due to being
1067       overly long.
1068
1069     - When the server receives a --partial-dir option from the client, it no
1070       longer runs the client-side code that adds an assumed filter rule (since
1071       the client will be sending us the rules in the usual manner, and they
1072       may have chosen to override the auto-added rule).
1073
1074   ENHANCEMENTS:
1075
1076     - Added the --log-file=FILE and --log-file-format=FORMAT options.  These
1077       can be used to tell any rsync to output what it is doing to a log file.
1078       They work with a client rsync, a non-daemon server rsync (see the man
1079       page for instructions), and also allows the overriding of rsyncd.conf
1080       settings when starting a daemon.
1081
1082     - The --log-format option was renamed to be --out-format to avoid confusing
1083       it with affecting the log-file output.  (The old option remains as an
1084       alias for the new to preserve backward compatibility.)
1085
1086     - Made "log file" and "syslog facility" settable on a per-module basis in
1087       the daemon's config file.
1088
1089     - Added the --remove-source-files option as a replacement for the (now
1090       deprecated) --remove-sent-files option.  This new option removes all
1091       non-dirs from the source directories, even if the file was already
1092       up-to-date.  This fixes a problem where interrupting an rsync that
1093       was using --remove-sent-files and restarting it could leave behind
1094       a file that the earlier rsync synchronized, but didn't get to remove.
1095       (The deprecated --remove-sent-files is still understood for now, and
1096       still behaves in the same way as before.)
1097
1098     - Added the option --no-motd to suppress the message-of-the-day output
1099       from a daemon when doing a copy.  (See the manpage for a caveat.)
1100
1101     - Added a new environment variable to the pre-/post-xfer exec commands (in
1102       the daemon's config file):  RSYNC_PID.  This value will be the same in
1103       both the pre- and post-xfer commands, so it can be used as a unique ID
1104       if the pre-xfer command wants to cache some arg/request info for the
1105       post-xfer command.
1106
1107   INTERNAL:
1108
1109     - Did a code audit using IBM's code-checker program and made several
1110       changes, including: replacing most of the strcpy() and sprintf()
1111       calls with strlcpy(), snprintf(), and memcpy(), adding a 0-value to
1112       an enum that had been intermingling a literal 0 with the defined enum
1113       values, silencing some uninitialized memory checks, marking some
1114       functions with a "noreturn" attribute, and changing an "if" that
1115       could never succeed on some platforms into a pre-processor directive
1116       that conditionally compiles the code.
1117
1118     - Fixed a potential bug in f_name_cmp() when both the args are a
1119       top-level "." dir (which doesn't happen in normal operations).
1120
1121     - Changed exit_cleanup() so that it can never return instead of exit.
1122       The old code might return if it found the exit_cleanup() function
1123       was being called recursively.  The new code is segmented so that
1124       any recursive calls move on to the next step of the exit-processing.
1125
1126     - The macro WIFEXITED(stat) will now be defined if the OS didn't already
1127       define it.
1128
1129   DEVELOPER RELATED:
1130
1131     - The acls.diff and xattrs.diff patches have received a bunch of work to
1132       make them much closer to being acceptable in the main distribution.
1133       The xattrs patch also has some preliminary Mac OS X and FreeBSD
1134       compatibility code that various system types to exchange extended
1135       file-attributes.
1136
1137     - A new diff in the patches dir, fake-root.diff, allows rsync to
1138       maintain a backup hierarchy with full owner, group, and device info
1139       without actually running as root.  It does this using a special
1140       extended attribute, so it depends on xattrs.diff (which depends on
1141       acls.diff).
1142
1143     - The rsync.yo and rsyncd.conf.yo files have been updated to work
1144       better with the latest yodl 2.x releases.
1145
1146     - Updated config.guess and config.sub to their 2006-07-02 versions.
1147
1148     - Updated various files to include the latest FSF address and to have
1149       consistent opening comments.
1150
1151 \f
1152 NEWS for rsync 2.6.8 (22 Apr 2006)
1153 Protocol: 29 (unchanged)
1154 Changes since 2.6.7:
1155
1156   BUG FIXES:
1157
1158     - Fixed a bug in the exclude code where an anchored exclude without any
1159       wildcards fails to match an absolute source arg, but only when --relative
1160       is in effect.
1161
1162     - Improved the I/O code for the generator to fix a potential hang when the
1163       receiver gets an EOF on the socket but the generator's select() call
1164       never indicates that the socket is writable for it to be notified about
1165       the EOF.  (This can happen when using stunnel).
1166
1167     - Fixed a problem with the file-reading code where a failed read (such as
1168       that caused by a bad sector) would not advance the file's read-position
1169       beyond the failed read's data.
1170
1171     - Fixed a logging bug where the "log file" directive was not being honored
1172       in a single-use daemon (one spawned by a remote-shell connection or by
1173       init).
1174
1175     - If rsync cannot honor the --delete option, we output an error and exit
1176       instead of silently ignoring the option.
1177
1178     - Fixed a bug in the --link-dest code that prevented special files (such as
1179       fifos) from being linked.
1180
1181     - The ability to hard-link symlinks and special files is now determined at
1182       configure time instead of at runtime.  This fixes a bug with --link-dest
1183       creating a hard-link to a symlink's referent on a BSD system.
1184
1185   ENHANCEMENTS:
1186
1187     - In daemon mode, if rsync fails to bind to the requested port, the
1188       error(s) returned by socket() and/or bind() are now logged.
1189
1190     - When we output a fatal error, we now output the version of rsync in the
1191       message.
1192
1193     - Improved the documentation for the --owner and --group options.
1194
1195     - The rsyncstats script in "support" has an improved line-parsing regex
1196       that is easier to read and also makes it to parse syslog-generated lines.
1197
1198     - A new script in "support": file-attr-restore, can be used to restore the
1199       attributes of a file-set (the permissions, ownership, and group info)
1200       taken from the cached output of a "find ARG... -ls" command.
1201
1202   DEVELOPER RELATED:
1203
1204     - Removed the unused function write_int_named(), the unused variable
1205       io_read_phase, and the rarely used variable io_write_phase.  This also
1206       elides the confusing 'phase "unknown"' part of one error message.
1207
1208     - Removed two unused configure checks and two related (also unused)
1209       compatibility functions.
1210
1211     - The xattrs.diff patch received a security fix that prevents a potential
1212       buffer overflow in the receive_xattr() code.
1213
1214     - The acls.diff patch has been improved quite a bit, with more to come.
1215
1216     - A new patch was added: log-file.diff.  This contains an early version of
1217       a future option, --log-file=FILE, that will allow any rsync to log its
1218       actions to a file (something that only a daemon supports at present).
1219
1220 \f
1221 NEWS for rsync 2.6.7 (11 Mar 2006)
1222 Protocol: 29 (unchanged)
1223 Changes since 2.6.6:
1224
1225   OUTPUT CHANGES:
1226
1227     - The letter 'D' in the itemized output was being used for both devices
1228       (character or block) as well as other special files (such as fifos and
1229       named sockets).  This has changed to separate non-device special files
1230       under the 'S' designation (e.g. "cS+++++++ path/fifo").  See also the
1231       "--specials" option, below.
1232
1233     - The way rsync escapes unreadable characters has changed.  First, rsync
1234       now has support for recognizing valid multibyte character sequences in
1235       your current locale, allowing it to escape fewer characters than before
1236       for a locale such as UTF-8.  Second, it now uses an escape idiom of
1237       "\#123", which is the literal string "\#" followed by exactly 3 octal
1238       digits.  Rsync no longer doubles a backslash character in a filename
1239       (e.g. it used to output "foo\\bar" when copying "foo\bar") -- now it only
1240       escapes a backslash that is followed by a hash-sign and 3 digits (0-9)
1241       (e.g. it will output "foo\#134#789" when copying "foo\#789").  See also
1242       the --8-bit-output (-8) option, mentioned below.
1243
1244       Script writers: the local rsync is the one that outputs escaped names,
1245       so if you need to support unescaping of filenames for older rsyncs, I'd
1246       suggest that you parse the output of "rsync --version" and only use the
1247       old unescaping rules for 2.6.5 and 2.6.6.
1248
1249   BUG FIXES:
1250
1251     - Fixed a really old bug that caused --checksum (-c) to checksum all the
1252       files encountered during the delete scan (ouch).
1253
1254     - Fixed a potential hang in a remote generator:  when the receiver gets a
1255       read-error on the socket, it now signals the generator about this so that
1256       the generator does not try to send any of the terminating error messages
1257       to the client (avoiding a potential hang in some setups).
1258
1259     - Made hard-links work with symlinks and devices again.
1260
1261     - If the sender gets an early EOF reading a source file, we propagate this
1262       error to the receiver so that it can discard the file and try requesting
1263       it again (which is the existing behavior for other kinds of read errors).
1264
1265     - If a device-file/special-file changes permissions, rsync now updates the
1266       permissions without recreating the file.
1267
1268     - If the user specifies a remote-host for both the source and destination,
1269       we now output a syntax error rather than trying to open the destination
1270       hostspec as a filename.
1271
1272     - When --inplace creates a new destination file, rsync now creates it with
1273       permissions 0600 instead of 0000 -- this makes restarting possible when
1274       the transfer gets interrupted in the middle of sending a new file.
1275
1276     - Reject the combination of --inplace and --sparse since the sparse-output
1277       algorithm doesn't work when overwriting existing data.
1278
1279     - Fixed the directory name in the error that is output when pop_dir()
1280       fails.
1281
1282     - Really fixed the parsing of a "!" entry in .cvsignore files this time.
1283
1284     - If the generator gets a stat() error on a file, output it (this used to
1285       require at least -vv for the error to be seen).
1286
1287     - If waitpid() fails or the child rsync didn't exit cleanly, we now handle
1288       the exit status properly and generate a better error.
1289
1290     - Fixed some glitches in the double-verbose output when using --copy-dest,
1291       --link-dest, or --compare-dest.  Also improved how the verbose output
1292       handles hard-links (within the transfer) that had an up-to-date alternate
1293       "dest" file, and copied files (via --copy-dest).
1294
1295     - Fixed the matching of the dont-compress items (e.g. *.gz) against files
1296       that have a path component containing a slash.
1297
1298     - If the code reading a filter/exclude file gets an EINTR error, rsync now
1299       clears the error flag on the file handle so it can keep on reading.
1300
1301     - If --relative is active, the sending side cleans up trailing "/" or "/."
1302       suffixes to avoid triggering a bug in older rsync versions.  Also, we now
1303       reject a ".." dir if it would be sent as a relative dir.
1304
1305     - If a non-directory is in the way of a directory and rsync is run with
1306       --dry-run and --delete, rsync no longer complains about not being able
1307       to opendir() the not-yet present directory.
1308
1309     - When --list-only is used and a non-existent local destination dir was
1310       also specified as a destination, rsync no longer generates a warning
1311       about being unable to create the missing directory.
1312
1313     - Fixed some problems with --relative --no-implied-dirs when the
1314       destination directory did not yet exist:  we can now create a symlink or
1315       device when it is the first thing in the missing dir, and --fuzzy no
1316       longer complains about being unable to open the missing dir.
1317
1318     - Fixed a bug where the --copy-links option would not affect implied
1319       directories without --copy-unsafe-links (see --relative).
1320
1321     - Got rid of the need for --force to be used in some circumstances with
1322       --delete-after (making it consistent with --delete-before/-during).
1323
1324     - Rsync now ignores the SIGXFSZ signal, just in case your OS sends this
1325       when a file is too large (rsync handles the write error).
1326
1327     - Fixed a bug in the Proxy-Authorization header's base64-encoded value: it
1328       was not properly padded with trailing '=' chars.  This only affects a
1329       user that need to use a password-authenticated proxy for an outgoing
1330       daemon-rsync connection.
1331
1332     - If we're transferring an empty directory to a new name, rsync no longer
1333       forces S_IWUSR if it wasn't already set, nor does it accidentally leave
1334       it set.
1335
1336     - Fixed a bug in the debug output (-vvvvv) that could mention the wrong
1337       checksum for the current file offset.
1338
1339     - Rsync no longer allows a single directory to be copied over a non-
1340       directory destination arg.
1341
1342   ENHANCEMENTS:
1343
1344     - Added the --append option that makes rsync append data onto files that
1345       are longer on the source than the destination (this includes new files).
1346
1347     - Added the --min-size=SIZE option to exclude small files from the
1348       transfer.
1349
1350     - Added the --compress-level option to allow you to set how aggressive
1351       rsync's compression should be (this option implies --compress).
1352
1353     - Enhanced the parsing of the SIZE value for --min-size and --max-size to
1354       allow easy entry of multiples of 1000 (instead of just multiples of 1024)
1355       and off-by-one values too (e.g. --max-size=8mb-1).
1356
1357     - Added the --8-bit-output (-8) option, which tells rsync to avoid escaping
1358       high-bit characters that it thinks are unreadable in the current locale.
1359
1360     - The new option --human-readable (-h) changes the output of --progress,
1361       --stats, and the end-of-run summary to be easier to read.  If repeated,
1362       the units become powers of 1024 instead of powers of 1000.  (The old
1363       meaning of -h, as a shorthand for --help, still works as long as you
1364       just use it on its own, as in "rsync -h".)
1365
1366     - If lutimes() and/or lchmod() are around, use them to allow the
1367       preservation of attributes on symlinks.
1368
1369     - The --link-dest option now affects symlinks and devices (when possible).
1370
1371     - Added two config items to the rsyncd.conf parsing:  "pre-xfer exec" and
1372       "post-xfer exec".  These allow a command to be specified on a per-module
1373       basis that will be run before and/or after a daemon-mode transfer.  (See
1374       the man page for a list of the environment variables that are set with
1375       information about the transfer.)
1376
1377     - When using the --relative option, you can now insert a dot dir in
1378       the source path to indicate where the replication of the source dirs
1379       should start.  For example, if you specify a source path of
1380       rsync://host/module/foo/bar/./baz/dir with -R, rsync will now only
1381       replicate the "baz/dir" part of the source path (note: a trailing
1382       dot dir is unaffected unless it also has a trailing slash).
1383
1384     - Added some new --no-FOO options that make it easier to override unwanted
1385       implied or default options.  For example, "-a --no-o" (aka "--archive
1386       --no-owner") can be used to turn off the preservation of file ownership
1387       that is implied by -a.
1388
1389     - Added the --chmod=MODE option that allows the destination permissions to
1390       be changed from the source permissions.  E.g. --chmod=g+w,o-rwx
1391
1392     - Added the "incoming chmod" and "outgoing chmod" daemon options that allow
1393       a module to specify what permissions changes should be applied to all
1394       files copied to and from the daemon.
1395
1396     - Allow the --temp-dir option to be specified when starting a daemon, which
1397       sets the default temporary directory for incoming files.
1398
1399     - If --delete is combined with --dirs without --recursive, rsync will now
1400       delete in any directory whose content is being synchronized.
1401
1402     - If --backup is combined with --delete without --backup-dir (and without
1403       --delete-excluded), we add a "protect" filter-rule to ensure that files
1404       with the backup suffix are not deleted.
1405
1406     - The file-count stats that are output by --progress were improved to
1407       better indicate what the numbers mean.  For instance, the output:
1408       "(xfer#5, to-check=8383/9999)" indicates that this was the fifth file
1409       to be transferred, and we still need to check 8383 more files out of
1410       a total of 9999.
1411
1412     - The include/exclude code now allows a dir/*** directive (with 3 trailing
1413       stars) to match both the dir itself as well as all the content below the
1414       dir (dir/** would not match the dir).
1415
1416     - Added the --prune-empty-dirs (-m) option that makes the receiving rsync
1417       discard empty chains of directories from the file-list.  This makes it
1418       easier to selectively copy files from a source hierarchy and end up with
1419       just the directories needed to hold the resulting files.
1420
1421     - If the --itemize-changes (-i) option is repeated, rsync now includes
1422       unchanged files in the itemized output (similar to -vv, but without all
1423       the other verbose messages that can get in the way).  Of course, the
1424       client must be version 2.6.7 for this to work, but the remote rsync only
1425       needs to be 2.6.7 if you're pushing files.
1426
1427     - Added the --specials option to tell rsync to copy non-device special
1428       files (which rsync now attempts even as a normal user).  The --devices
1429       option now requests the copying of just devices (character and block).
1430       The -D option still requests both (e.g. --devices and --specials), -a
1431       still implies -D, and non-root users still get a silent downgrade that
1432       omits device copying.
1433
1434     - Added the --super option to make the receiver always attempt super-user
1435       activities.  This is useful for systems that allow things such as devices
1436       to be created or ownership to be set without being UID 0, and is also
1437       useful for someone who wants to ensure that errors will be output if the
1438       receiving rsync isn't being run as root.
1439
1440     - Added the --sockopts option for those few who want to customize the TCP
1441       options used to contact a daemon rsync.
1442
1443     - Added a way for the --temp-dir option to be combined with a partial-dir
1444       setting that lets rsync avoid non-atomic updates (for those times when
1445       --temp-dir is not being used because space is tight).
1446
1447     - A new support script, files-to-excludes, will transform a list of files
1448       into a set of include/exclude directives that will copy those files.
1449
1450     - A new option, --executability (-E) can be used to preserve just the
1451       execute bit on files, for those times when using the --perms option is
1452       not desired.
1453
1454     - The daemon now logs each connection and also each module-list request
1455       that it receives.
1456
1457     - New log-format options: %M (modtime), %U (uid), %G (gid), and %B
1458       (permission bits, e.g. "rwxr-xrwt").
1459
1460     - The --dry-run option no longer forces the enabling of --verbose.
1461
1462     - The --remove-sent-files option now does a better job of incrementally
1463       removing the sent files on the sending side (older versions tended to
1464       clump up all the removals at the end).
1465
1466     - A daemon now supersedes its minimal SIGCHLD handler with the standard
1467       PID-remembering version after forking.  This ensures that the generator
1468       can get the child-exit status from the receiver.
1469
1470     - Use of the --bwlimit option no longer interferes with the remote rsync
1471       sending error messages about invalid/refused options.
1472
1473     - Rsync no longer returns a usage error when used with one local source arg
1474       and no destination: this now implies the --list-only option, just like
1475       the comparable situation with a remote source arg.
1476
1477     - Added the --copy-dirlinks option, a more limited version of --copy-links.
1478
1479     - Various documentation improvements, including: a better synopsis, some
1480       improved examples, a better discussion of the presence and absence of
1481       --perms (including how it interacts with the new --executability and
1482       --chmod options), an extended discussion of --temp-dir, an improved
1483       discussion of --partial-dir, a better description of rsync's pattern
1484       matching characters, an improved --no-implied-dirs section, and the
1485       documenting of what the --stats option outputs.
1486
1487     - Various new and updated diffs in the patches dir, including: acls.diff,
1488       xattrs.diff, atimes.diff, detect-renamed.diff, and slp.diff.
1489
1490   INTERNAL:
1491
1492     - We now use sigaction() and sigprocmask() if possible, and fall back on
1493       signal() if not.  Using sigprocmask() ensures that rsync enables all the
1494       signals that it needs, just in case it was started in a masked state.
1495
1496     - Some buffer sizes were expanded a bit, particularly on systems where
1497       MAXPATHLEN is overly small (e.g. cygwin).
1498
1499     - If io_printf() tries to format more data than fits in the buffer, exit
1500       with an error instead of transmitting a truncated buffer.
1501
1502     - If a va_copy macro is defined, lib/snprintf.c will use it when defining
1503       the VA_COPY macro.
1504
1505     - Reduced the amount of stack memory needed for each level of directory
1506       recursion by nearly MAXPATHLEN bytes.
1507
1508     - The wildmatch function was extended to allow an array of strings to be
1509       supplied as the string to match.  This allows the exclude code to do less
1510       string copying.
1511
1512     - Got rid of the safe_fname() function (and all the myriad calls) and
1513       replaced it with a new function in the log.c code that filters all the
1514       output going to the terminal.
1515
1516     - Unified the f_name() and the f_name_to() functions.
1517
1518     - Improved the hash-table code the sender uses to handle checksums to make
1519       it use slightly less memory and run just a little faster.
1520
1521   DEVELOPER RELATED:
1522
1523     - The diffs in the patches dir now require "patch -p1 <DIFF" instead of
1524       the previous -p0.  Also, the version included in the release tar now
1525       affect generated files (e.g. configure, rsync.1, proto.h, etc.), so
1526       it is no longer necessary to run autoconf and/or yodl unless you're
1527       applying a patch that was checked out from CVS.
1528
1529     - Several diffs in the patches dir now use the proper --enable-FOO
1530       configure option instead of --with-FOO to turn on the inclusion of
1531       the newly patched feature.
1532
1533     - There is a new script, "prepare-source" than can be used to update the
1534       various generated files (proto.h, configure, etc.) even before configure
1535       has created the Makefile (this is mainly useful when patching the source
1536       with a patch that doesn't affect generated files).
1537
1538     - The testsuite now sets HOME so that it won't be affected by a file such
1539       as ~/.popt.
1540
1541 \f
1542 NEWS for rsync 2.6.6 (28 Jul 2005)
1543 Protocol: 29 (unchanged)
1544 Changes since 2.6.5:
1545
1546   SECURITY FIXES:
1547
1548     - The zlib code was upgraded to version 1.2.3 in order to make it more
1549       secure.  While the widely-publicized security problem in zlib 1.2.2 did
1550       not affect rsync, another security problem surfaced that affects rsync's
1551       zlib 1.1.4.
1552
1553   BUG FIXES:
1554
1555     - The setting of flist->high in clean_flist() was wrong for an empty list.
1556       This could cause flist_find() to crash in certain rare circumstances
1557       (e.g. if just the right directory setup was around when --fuzzy was
1558       combined with --link-dest).
1559
1560     - The outputting of hard-linked files when verbosity was > 1 was not right:
1561       (1) Without -i it would output the name of each hard-linked file as
1562       though it had been changed; it now outputs a "is hard linked" message for
1563       the file. (2) With -i it would output all dots for the unchanged
1564       attributes of a hard-link; it now changes those dots to spaces, as is
1565       done for other totally unchanged items.
1566
1567     - When backing up a changed symlink or device, get rid of any old backup
1568       item so that we don't get an "already exists" error.
1569
1570     - A couple places that were comparing a local and a remote modification-
1571       time were not honoring the --modify-window option.
1572
1573     - Fixed a bug where the 'p' (permissions) itemized-changes flag might get
1574       set too often (if some non-significant mode bits differed).
1575
1576     - Fixed a really old, minor bug that could cause rsync to warn about being
1577       unable to mkdir() a path that ends in "/." because it just created the
1578       directory (required --relative, --no-implied-dirs, a source path that
1579       ended in either a trailing slash or a trailing "/.", and a non-existing
1580       destination dir to tickle the bug in a recent version).
1581
1582   ENHANCEMENTS:
1583
1584     - Made the "max verbosity" setting in the rsyncd.conf file settable on a
1585       per-module basis (which now matches the documentation).
1586
1587     - The support/rrsync script has been upgraded to verify the args of options
1588       that take args (instead of rejecting any such options).  The script was
1589       also changed to try to be more secure and to fix a problem in the parsing
1590       of a pull operation that has multiple sources.
1591
1592     - Improved the documentation that explains the difference between a
1593       normal daemon transfer and a daemon-over remote-shell transfer.
1594
1595     - Some of the diffs supplied in the patches dir were fixed and/or
1596       improved.
1597
1598   BUILD CHANGES:
1599
1600     - Made configure define NOBODY_USER (currently hard-wired to "nobody") and
1601       NOBODY_GROUP (set to either "nobody" or "nogroup" depending on what we
1602       find in the /etc/group file).
1603
1604     - Added a test to the test suite, itemized.test, that tests the output of
1605       -i (log-format w/%i) and some double-verbose messages.
1606
1607 \f
1608 NEWS for rsync 2.6.5 (1 Jun 2005)
1609 Protocol: 29 (unchanged)
1610 Changes since 2.6.4:
1611
1612   OUTPUT CHANGES:
1613
1614     - Non-printable chars in filenames are now output using backslash-
1615       escaped characters rather than '?'s.  Any non-printable character is
1616       output using 3 digits of octal (e.g. "\n" -> "\012"), and a backslash
1617       is now output as "\\".  Rsync also uses your locale setting, which
1618       can make it treat fewer high-bit characters as non-printable.
1619
1620     - If rsync received an empty file-list when pulling files, it would
1621       output a "nothing to do" message and exit with a 0 (success) exit
1622       status, even if the remote rsync returned an error (it did not do
1623       this under the same conditions when pushing files).  This was changed
1624       to make the pulling behavior the same as the pushing behavior:  we
1625       now do the normal end-of-run outputting (depending on options) and
1626       exit with the appropriate exit status.
1627
1628   BUG FIXES:
1629
1630     - A crash bug was fixed when a daemon had its "path" set to "/", did
1631       not have chroot enabled, and used some anchored excludes in the
1632       rsyncd.conf file.
1633
1634     - Fixed a bug in the transfer of a single file when -H is specified
1635       (rsync would either infinite loop or perhaps crash).
1636
1637     - Fixed a case where the generator might try (and fail) to tweak the
1638       write-permissions of a read-only directory in list-only mode (this
1639       only caused an annoying warning message).
1640
1641     - If --compare-dest or --link-dest uses a locally-copied file as the
1642       basis for an updated version, log this better when --verbose or -i
1643       is in effect.
1644
1645     - Fixed the accidental disabling of --backup during the --delete-after
1646       processing.
1647
1648     - Restored the ability to use the --address option in client mode (in
1649       addition to its use in daemon mode).
1650
1651     - Make sure that some temporary progress information from the delete
1652       processing does not get left on the screen when it is followed by a
1653       newline.
1654
1655     - When --existing skips a directory with extra verbosity, refer to it
1656       as a "directory", not a "file".
1657
1658     - When transferring a single file to a different-named file, any
1659       generator messages that are source-file related no longer refer to
1660       the file by the destination filename.
1661
1662     - Fixed a bug where hard-linking a group of files might fail if the
1663       generator hasn't created a needed destination directory yet.
1664
1665     - Fixed a bug where a hard-linked group of files that is newly-linked
1666       to a file in a --link-dest dir doesn't link the files from the rest
1667       of the cluster.
1668
1669     - When deleting files with the --one-file-system (-x) option set, rsync
1670       no longer tries to remove files from inside a mount-point on the
1671       receiving side.  Also, we don't complain about being unable to remove
1672       the mount-point dir.
1673
1674     - Fixed a compatibility problem when using --cvs-ignore (-C) and
1675       sending files to an older rsync without using --delete.
1676
1677     - Make sure that a "- !" or "+ !" include/exclude pattern does not
1678       trigger the list-clearing action that is reserved for "!".
1679
1680     - Avoid a timeout in the generator when the sender/receiver aren't
1681       handling the generator's checksum output quickly enough.
1682
1683     - Fixed the omission of some directories in the delete processing when
1684       --relative (-R) was combined with a source path that had a trailing
1685       slash.
1686
1687     - Fixed a case where rsync would erroneously delete some files and then
1688       re-transfer them when the options --relative (-R) and --recursive
1689       (-r) were both enabled (along with --delete) and a source path had a
1690       trailing slash.
1691
1692     - Make sure that --max-size doesn't affect a device or a symlink.
1693
1694     - Make sure that a system with a really small MAXPATHLEN does not cause
1695       the buffers in readfd_unbuffered() to be too small to receive normal
1696       messages.  (This mainly affected Cygwin.)
1697
1698     - If a source pathname ends with a filename of "..", treat it as if
1699       "../" had been specified (so that we don't copy files to the parent
1700       dir of the destination).
1701
1702     - If --delete is combined with a file-listing rsync command (i.e. no
1703       transfer is happening), avoid outputting a warning that we couldn't
1704       delete anything.
1705
1706     - If --stats is specified with --delete-after, ensure that all the
1707       "deleting" messages are output before the statistics.
1708
1709     - Improved one "if" in the deletion code that was only checking errno
1710       for ENOTEMPTY when it should have also been checking for EEXIST (for
1711       compatibility with OS variations).
1712
1713   ENHANCEMENTS:
1714
1715     - Added the --only-write-batch=FILE option that may be used (instead
1716       of --write-batch=FILE) to create a batch file without doing any
1717       actual updating of the destination.  This allows you to divert all
1718       the file-updating data away from a slow data link (as long as you
1719       are pushing the data to the remote server when creating the batch).
1720
1721     - When the generator is taking a long time to fill up its output buffer
1722       (e.g. if the transferred files are few, small, or missing), it now
1723       periodically flushes the output buffer so that the sender/receiver
1724       can get started on the files sooner rather than later.
1725
1726     - Improved the keep-alive code to handle a long silence between the
1727       sender and the receiver that can occur when the sender is receiving
1728       the checksum data for a large file.
1729
1730     - Improved the auth-errors that are logged by the daemon to include
1731       some information on why the authorization failed:  wrong user,
1732       password mismatch, etc.  (The client-visible message is unchanged!)
1733
1734     - Improved the client's handling of an "@ERROR" from a daemon so that
1735       it does not complain about an unexpectedly closed socket (since we
1736       really did expect the socket to close).
1737
1738     - If the daemon can't open the log-file specified in rsyncd.conf, fall
1739       back to using syslog and log an appropriate warning.  This is better
1740       than what was typically a totally silent (and fatal) failure (since a
1741       daemon is not usually run with the --no-detach option that was
1742       necessary to see the error on stderr).
1743
1744     - The man pages now consistently refer to an rsync daemon as a "daemon"
1745       instead of a "server" (to distinguish it from the server process in a
1746       non-daemon transfer).
1747
1748     - Made a small change to the rrsync script (restricted rsync -- in the
1749       support dir) to make a read-only server reject all --remove-* options
1750       when sending files (to future-proof it against the possibility of
1751       other similar options being added at some point).
1752
1753   INTERNAL:
1754
1755     - Rsync now calls setlocale(LC_CTYPE, "").  This enables isprint() to
1756       better discern which filename characters need to be escaped in
1757       messages (which should result in fewer escaped characters in some
1758       locales).
1759
1760     - Improved the naming of the log-file open/reopen/close functions.
1761
1762     - Removed some protocol-compatibility code that was only needed to help
1763       someone running a pre-release of 2.6.4.
1764
1765   BUILD CHANGES:
1766
1767     - Added configure option "--disable-locale" to disable any use of
1768       setlocale() in the binary.
1769
1770     - Fixed a bug in the SUPPORT{,_HARD}_LINKS #defines which prevented
1771       rsync from being built without symlink or hard-link support.
1772
1773     - Only #define HAVE_REMSH if it is going to be set to 1.
1774
1775     - Configure now disables the use of mkstemp() under HP-UX (since they
1776       refuse to fix its broken handling of large files).
1777
1778     - Configure now explicitly checks for the lseek64() function so that
1779       the code can use HAVE_LSEEK64 instead of inferring lseek64()'s
1780       presence based on the presence of the off64_t type.
1781
1782     - Configure no longer mentions the change in the default remote-shell
1783       (from rsh to ssh) that occurred for the 2.6.0 release.
1784
1785     - Some minor enhancements to the test scripts.
1786
1787     - Added a few new *.diff files to the patches dir, including a patch
1788       that enables the optional copying of extended attributes.
1789
1790 \f
1791 NEWS for rsync 2.6.4 (30 March 2005)
1792 Protocol: 29 (changed)
1793 Changes since 2.6.3:
1794
1795   OUTPUT CHANGES:
1796
1797     - When rsync deletes a directory and outputs a verbose message about
1798       it, it now appends a trailing slash to the name instead of (only
1799       sometimes) outputting a preceding "directory " string.
1800
1801     - The --stats output will contain file-list time-statistics if both
1802       sides are 2.6.4, or if the local side is 2.6.4 and the files are
1803       being pushed (since the stats come from the sending side).
1804       (Requires protocol 29 for a pull.)
1805
1806     - The "%o" (operation) log-format escape now has a third value (besides
1807       "send" and "recv"):  "del." (with trailing dot to make it 4 chars).
1808       This changes the way deletions are logged in the daemon's log file.
1809
1810     - When the --log-format option is combined with --verbose, rsync now
1811       avoids outputting the name of the file twice in most circumstances.
1812       As long as the --log-format item does not refer to any post-transfer
1813       items (such as %b or %c), the --log-format message is output prior to
1814       the transfer, so --verbose is now the equivalent of a --log-format of
1815       '%n%L' (which outputs the name and any link info).  If the log output
1816       must occur after the transfer to be complete, the only time the name
1817       is also output prior to the transfer is when --progress was specified
1818       (so that the name will precede the progress stats, and the full
1819       --log-format output will come after).
1820
1821     - Non-printable characters in filenames are replaced with a '?' to
1822       avoid corrupting the screen or generating empty lines in the output.
1823   
1824   BUG FIXES:
1825
1826     - Restore the list-clearing behavior of "!" in a .cvsignore file (2.6.3
1827       was only treating it as a special token in an rsync include/exclude
1828       file).
1829
1830     - The combination of --verbose and --dry-run now mentions the full list
1831       of changes that would be output without --dry-run.
1832
1833     - Avoid a mkdir warning when removing a directory in the destination
1834       that already exists in the --backup-dir.
1835
1836     - An OS that has a binary mode for its files (such as cygwin) needed
1837       setmode(fd, O_BINARY) called on the temp-file we opened with
1838       mkstemp().  (Fix derived from cygwin's 2.6.3 rsync package.)
1839
1840     - Fixed a potential hang when verbosity is high, the client side is
1841       the sender, and the file-list is large.
1842
1843     - Fixed a potential protocol-corrupting bug where the generator could
1844       merge a message from the receiver into the middle of a multiplexed
1845       packet of data if only part of that data had been written out to the
1846       socket when the message from the generator arrived.
1847
1848     - We now check if the OS doesn't support using mknod() for creating
1849       FIFOs and sockets, and compile-in some compatibility code using
1850       mkfifo() and socket() when necessary.
1851
1852     - Fixed an off-by-one error in the handling of --max-delete=N.  Also,
1853       if the --max-delete limit is exceeded during a run, we now output a
1854       warning about this at the end of the run and exit with a new error
1855       code (25).
1856
1857     - One place in the code wasn't checking if fork() failed.
1858
1859     - The "ignore nonreadable" daemon parameter used to erroneously affect
1860       readable symlinks that pointed to a non-existent file.
1861
1862     - If the OS does not have lchown() and a chown() of a symlink will
1863       affect the referent of a symlink (as it should), we no longer try
1864       to set the user and group of a symlink.
1865
1866     - The generator now properly runs the hard-link loop and the dir-time
1867       rewriting loop after we're sure that the redo phase is complete.
1868
1869     - When --backup was specified with --partial-dir=DIR, where DIR is a
1870       relative path, the backup code was erroneously trying to backup a
1871       file that was put into the partial-dir.
1872
1873     - If a file gets resent in a single transfer and the --backup option is
1874       enabled along with --inplace, rsync no longer performs a duplicate
1875       backup (it used to overwrite the first backup with the failed file).
1876
1877     - One call to flush_write_file() was not being checked for an error.
1878
1879     - The --no-relative option was not being sent from the client to a
1880       server sender.
1881
1882     - If an rsync daemon specified "dont compress = ..." for a file and the
1883       client tried to specify --compress, the libz code was not handling a
1884       compression level of 0 properly.  This could cause a transfer failure
1885       if the block-size for a file was large enough (e.g. rsync might have
1886       exited with an error for large files).
1887
1888     - Fixed a bug that would sometimes surface when using --compress and
1889       sending a file with a block-size larger than 64K (either manually
1890       specified, or computed due to the file being really large).  Prior
1891       versions of rsync would sometimes fail to decompress the data
1892       properly, and thus the transferred file would fail its verification.
1893
1894     - If a daemon can't open the specified log file (i.e. syslog is not
1895       being used), die without crashing.  We also output an error about
1896       the failure on stderr (which will only be seen if --no-detach was
1897       specified) and exit with a new error code (6).
1898
1899     - A local transfer no longer duplicates all its include/exclude options
1900       (since the forked process already has a copy of the exclude list,
1901       there's no need to send them a set of duplicates).
1902
1903     - The output of the items that are being updated by the generator (dirs,
1904       symlinks, devices) is now intermingled in the proper order with the
1905       output from the items that the receiver is updating (regular files)
1906       when pulling.  This misordering was particularly bad when --progress
1907       was specified.  (Requires protocol 29.)
1908
1909     - When --timeout is specified, lulls that occur in the transfer while
1910       the generator is doing work that does not generate socket traffic
1911       (looking for changed files, deleting files, doing directory-time
1912       touch-ups, etc.) will cause a new keep-alive packet to be sent that
1913       should keep the transfer going as long as the generator continues to
1914       make progress.  (Requires protocol 29.)
1915
1916     - The stat size of a device is not added to the total file size of the
1917       items in the transfer (the size might be undefined on some OSes).
1918
1919     - Fixed a problem with refused-option messages sometimes not making it
1920       back to the client side when a remote --files-from was in effect and
1921       the daemon was the receiver.
1922
1923     - The --compare-dest option was not updating a file that differed in
1924       (the preserved) attributes from the version in the compare-dest DIR.
1925
1926     - When rsync is copying files into a write-protected directory, fixed
1927       the change-report output for the directory so that we don't report
1928       an identical directory as changed.
1929
1930   ENHANCEMENTS:
1931
1932     - Rsync now supports popt's option aliases, which means that you can
1933       use /etc/popt and/or ~/.popt to create your own option aliases.
1934
1935     - Added the --delete-during (--del) option which will delete files
1936       from the receiving side incrementally as each directory in the
1937       transfer is being processed.  This makes it more efficient than the
1938       default, before-the-transfer behavior, which is now also available as
1939       --delete-before (and is still the default --delete-WHEN option that
1940       will be chosen if --delete or --delete-excluded is specified without
1941       a --delete-WHEN choice).  All the --del* options infer --delete, so
1942       an rsync daemon that refuses "delete" will still refuse to allow any
1943       file-deleting options (including the new --remove-sent-files option).
1944
1945     - All the --delete-WHEN options are now more memory efficient:
1946       Previously an duplicate set of file-list objects was created on the
1947       receiving side for the entire destination hierarchy.  The new
1948       algorithm only creates one directory of objects at a time (for files
1949       inside the transfer).
1950
1951     - Added the --copy-dest option, which works like --link-dest except
1952       that it locally copies identical files instead of hard-linking them.
1953
1954     - Added support for specifying multiple --compare-dest, --copy-dest, or
1955       --link-dest options, but only of a single type. (Promoted from the
1956       patches dir and enhanced.) (Requires protocol 29.)
1957
1958     - Added the --max-size option. (Promoted from the patches dir.)
1959
1960     - The daemon-mode options are now separated from the normal rsync
1961       options so that they can't be mixed together.  This makes it
1962       impossible to start a daemon that has improper default option values
1963       (which could cause problems when a client connects, such as hanging
1964       or crashing).
1965
1966     - The --bwlimit option may now be used in combination with --daemon
1967       to specify both a default value for the daemon side and a value
1968       that cannot be exceeded by a user-specified --bwlimit option.
1969
1970     - Added the "port" parameter to the rsyncd.conf file. (Promoted from
1971       the patches dir.)  Also added "address".  The command-line options
1972       take precedence over a config-file option, as expected.
1973
1974     - In _exit_cleanup(): when we are exiting with a partially-received
1975       file, we now flush any data in the write-cache before closing the
1976       partial file.
1977
1978     - The --inplace support was enhanced to work with --compare-dest,
1979       --link-dest, and (the new) --copy-dest options. (Requires protocol
1980       29.)
1981
1982     - Added the --dirs (-d) option for an easier way to copy directories
1983       without recursion.  Any directories that are encountered are created
1984       on the destination.  Specifying a directory with a trailing slash
1985       copies its immediate contents to the destination.
1986
1987     - The --files-from option now implies --dirs (-d).
1988
1989     - Added the --list-only option, which is mainly a way for the client to
1990       put the server into listing mode without needing to resort to any
1991       internal option kluges (e.g. the age-old use of "-r --exclude="/*/*"
1992       for a non-recursive listing).  This option is used automatically
1993       (behind the scenes) when a modern rsync speaks to a modern daemon,
1994       but may also be specified manually if you want to force the use of
1995       the --list-only option over a remote-shell connection.
1996
1997     - Added the --omit-dir-times (-O) option, which will avoid updating
1998       the modified time for directories when --times was specified.  This
1999       option will avoid an extra pass through the file-list at the end of
2000       the transfer (to tweak all the directory times), which may provide
2001       an appreciable speedup for a really large transfer. (Promoted from
2002       the patches dir.)
2003
2004     - Added the --filter (-f) option and its helper option, -F.  Filter
2005       rules are an extension to the existing include/exclude handling
2006       that also supports nested filter files as well as per-directory
2007       filter files (like .cvsignore, but with full filter-rule parsing).
2008       This new option was chosen in order to ensure that all existing
2009       include/exclude processing remained 100% compatible with older
2010       versions.  Protocol 29 is needed for full filter-rule support, but
2011       backward-compatible rules work with earlier protocol versions.
2012       (Promoted from the patches dir and enhanced.)
2013
2014     - Added the --delay-updates option that puts all updated files into
2015       a temporary directory (by default ".~tmp~", but settable via the
2016       --partial-dir=DIR option) until the end of the transfer.  This
2017       makes the updates a little more atomic for a large transfer.
2018
2019     - If rsync is put into the background, any output from --progress is
2020       reduced.
2021
2022     - Documented the "max verbosity" setting for rsyncd.conf.  (This
2023       setting was added a couple releases ago, but left undocumented.)
2024
2025     - The sender and the generator now double-check the file-list index
2026       they are given, and refuse to try to do a file transfer on a
2027       non-file index (since that would indicate that something had gone
2028       very wrong).
2029
2030     - Added the --itemize-changes (-i) option, which is a way to output a
2031       more detailed list of what files changed and in what way.  The effect
2032       is the same as specifying a --log-format of "%i %n%L" (see both the
2033       rsync and rsyncd.conf manpages).  Works with --dry-run too.
2034
2035     - Added the --fuzzy (-y) option, which attempts to find a basis file
2036       for a file that is being created from scratch.  The current algorithm
2037       only looks in the destination directory for the created file, but it
2038       does attempt to find a match based on size/mod-time (in case the file
2039       was renamed with no other changes) as well as based on a fuzzy
2040       name-matching algorithm.  This option requires protocol 29 because it
2041       needs the new file-sorting order.  (Promoted from patches dir and
2042       enhanced.) (Requires protocol 29.)
2043
2044     - Added the --remove-sent-files option, which lets you move files
2045       between systems.
2046
2047     - The hostname in HOST:PATH or HOST::PATH may now be an IPv6 literal
2048       enclosed in '[' and ']' (e.g. "[::1]").  (We already allowed IPv6
2049       literals in the rsync://HOST:PORT/PATH format.)
2050
2051     - When rsync recurses to build the file list, it no longer keeps open
2052       one or more directory handles from the dir's parent dirs.
2053
2054     - When building under windows, the default for --daemon is now to
2055       avoid detaching, requiring the new --detach option to force rsync
2056       to detach.
2057
2058     - The --dry-run option can now be combined with either --write-batch or
2059       --read-batch, allowing you to run a do-nothing test command to see
2060       what would happen without --dry-run.
2061
2062     - The daemon's "read only" config item now sets an internal read_only
2063       variable that makes extra sure that no write/delete calls on the
2064       read-only side can succeed.
2065
2066     - The log-format % escapes can now have a numeric field width in
2067       between the % and the escape letter (e.g. "%-40n %08p").
2068
2069     - Improved the option descriptions in the --help text.
2070
2071   SUPPORT FILES:
2072
2073     - Added atomic-rsync to the support dir: a perl script that will
2074       transfer some files using rsync, and then move the updated files into
2075       place all at once at the end of the transfer.  Only works when
2076       pulling, and uses --link-dest and a parallel hierarchy of files to
2077       effect its update.
2078
2079     - Added mnt-excl to the support dir: a perl script that takes the
2080       /proc/mounts file and translates it into a set of excludes that will
2081       exclude all mount points (even mapped mounts to the same disk).  The
2082       excludes are made relative to the specified source dir and properly
2083       anchored.
2084
2085     - Added savetransfer.c to the support dir: a C program that can make
2086       a copy of all the data that flows over the wire.  This lets you test
2087       for data corruption (by saving the data on both the sending side and
2088       the receiving side) and provides one way to debug a protocol error.
2089
2090     - Added rrsync to the support dir: this is an updated version of Joe
2091       Smith's restricted rsync perl script.  This helps to ensure that only
2092       certain rsync commands can be run by an ssh invocation.
2093
2094   INTERNAL:
2095
2096     - Added better checking of the checksum-header values that come over
2097       the socket.
2098
2099     - Merged a variety of file-deleting functions into a single function so
2100       that it is easier to maintain.
2101
2102     - Improved the type of some variables (particularly blocksize vars) for
2103       consistency and proper size.
2104
2105     - Got rid of the uint64 type (which we didn't need).
2106
2107     - Use a slightly more compatible set of core #include directives.
2108
2109     - Defined int32 in a way that ensures that the build dies if we can't
2110       find a variable with at least 32 bits.
2111
2112   PROTOCOL DIFFERENCES FOR VERSION 29:
2113
2114     - A 16-bit flag-word is transmitted after every file-list index.  This
2115       indicates what is changing between the sender and the receiver.  The
2116       generator now transmits an index and a flag-word to indicate when
2117       dirs and symlinks have changed (instead of producing a message),
2118       which makes the outputting of the information more consistent and
2119       less prone to screen corruption (because the local receiver/sender is
2120       now outputting all the file-change info messages).
2121
2122     - If a file is being hard-linked, the ITEM_XNAME_FOLLOWS bit is enabled
2123       in the flag-word and the name of the file that was linked immediately
2124       follows in vstring format (see below).
2125
2126     - If a file is being transferred with an alternate-basis file, the
2127       ITEM_BASIS_TYPE_FOLLOWS bit is enabled in the flag-word and a single
2128       byte follows, indicating what type of basis file was chosen.  If that
2129       indicates that a fuzzy-match was selected, the ITEM_XNAME_FOLLOWS bit
2130       is set in the flag-word and the name of the match in vstring format
2131       follows the basis byte.  A vstring is a variable length string that
2132       has its size written prior to the string, and no terminating null.
2133       If the string is from 1-127 bytes, the length is a single byte.  If
2134       it is from 128-32767 bytes, the length is written as ((len >> 8) |
2135       0x80) followed by (len % 0x100).
2136
2137     - The sending of exclude names is done using filter-rule syntax.  This
2138       means that all names have a prefixed rule indicator, even excludes
2139       (which used to be sent as a bare pattern, when possible).  The -C
2140       option will include the per-dir .cvsignore merge file in the list of
2141       filter rules so it is positioned correctly (unlike in some older
2142       transfer scenarios).
2143
2144     - Rsync sorts the filename list in a different way: it sorts the subdir
2145       names after the non-subdir names for each dir's contents, and it
2146       always puts a dir's contents immediately after the dir's name in the
2147       list.  (Previously an item named "foo.txt" would sort in between
2148       directory "foo/" and "foo/bar".)
2149
2150     - When talking to a protocol 29 rsync daemon, a list-only request
2151       is able to note this before the options are sent over the wire and
2152       the new --list-only option is included in the options.
2153
2154     - When the --stats bytes are sent over the wire (or stored in a batch),
2155       they now include two elapsed-time values: one for how long it took to
2156       build the file-list, and one for how long it took to send it over the
2157       wire (each expressed in thousandths of a second).
2158
2159     - When --delete-excluded is specified with some filter rules (AKA
2160       excludes), a client sender will now initiate a send of the rules to
2161       the receiver (older protocols used to omit the sending of excludes in
2162       this situation since there were no receiver-specific rules that
2163       survived --delete-excluded back then).  Note that, as with all the
2164       filter-list sending, only items that are significant to the other
2165       side will actually be sent over the wire, so the filter-rule list
2166       that is sent in this scenario is often empty.
2167
2168     - An index equal to the file-list count is sent as a keep-alive packet
2169       from the generator to the sender, which then forwards it on to the
2170       receiver.  This normally invalid index is only a valid keep-alive
2171       packet if the 16-bit flag-word that follows it contains a single bit
2172       (ITEM_IS_NEW, which is normally an illegal flag to appear alone).
2173
2174     - A protocol-29 batch file includes a bit for the setting of the --dirs
2175       option and for the setting of the --compress option.  Also, the shell
2176       script created by --write-batch will use the --filter option instead
2177       of --exclude-from to capture any filter rules.
2178
2179   BUILD CHANGES:
2180
2181     - Handle an operating system that use mkdev() in place of makedev().
2182
2183     - Improved configure to better handle cross-compiling.
2184
2185 \f
2186 NEWS for rsync 2.6.3 (30 Sep 2004)
2187 Protocol: 28 (unchanged)
2188 Changes since 2.6.2:
2189
2190   SECURITY FIXES:
2191
2192     - A bug in the sanitize_path routine (which affects a non-chrooted
2193       rsync daemon) could allow a user to craft a pathname that would get
2194       transformed into an absolute path for certain options (but not for
2195       file-transfer names).  If you're running an rsync daemon with chroot
2196       disabled, *please upgrade*, ESPECIALLY if the user privs you run
2197       rsync under is anything above "nobody".
2198
2199   OUTPUT CHANGES (ATTN: those using a script to parse the verbose output):
2200
2201     - Please note that the 2-line footer (output when verbose) now uses the
2202       term "sent" instead of "wrote" and "received" instead of "read".  If
2203       you are not parsing the numeric values out of this footer, a script
2204       would be better off using the empty line prior to the footer as the
2205       indicator that the verbose output is over.
2206       
2207     - The output from the --stats option was similarly affected to change
2208       "written" to "sent" and "read" to "received".
2209
2210     - Rsync ensures that a filename that contains a newline gets mentioned
2211       with each newline transformed into a question mark (which prevents a
2212       filename from causing an empty line to be output).
2213
2214     - The "backed up ..." message that is output when at least 2 --verbose
2215       options are specified is now the same both with and without the
2216       --backup-dir option.
2217
2218   BUG FIXES:
2219
2220     - Fixed a crash bug that might appear when --delete was used and
2221       multiple source directories were specified.
2222
2223     - Fixed a 32-bit truncation of the file length when generating the
2224       checksums.
2225
2226     - The --backup code no longer attempts to create some directories
2227       over and over again (generating warnings along the way).
2228
2229     - Fixed a bug in the reading of the secrets file (by the daemon) and
2230       the password file (by the client):  the files no longer need to be
2231       terminated by a newline for their content to be read in.
2232
2233     - If a file has a read error on the sending side or the reconstructed
2234       data doesn't match the expected checksum (perhaps due to the basis
2235       file changing during the transfer), the receiver will no longer
2236       retain the resulting file unless the --partial option was specified.
2237       (Note: for the read-error detection to work, neither side can be
2238       older than 2.6.3 -- older receivers will always retain the file, and
2239       older senders don't tell the receiver that the file had a read
2240       error.)
2241
2242     - If a file gets resent in a single transfer and the --backup option
2243       is enabled, rsync no longer performs a duplicate backup (it used to
2244       overwrite the original file in the backup area).
2245
2246     - Files specified in the daemon's "exclude" or "exclude from" config
2247       items are now excluded from being uploaded (assuming that the module
2248       allows uploading at all) in addition to the old download exclusion.
2249
2250     - Got rid of a potential hang in the receiver when near the end of a
2251       phase.
2252
2253     - When using --backup without a --backup-dir, rsync no longer preserves
2254       the modify time on directories.  This avoids confusing NFS.
2255
2256     - When --copy-links (-L) is specified, we now output a separate error
2257       for a symlink that has no referent instead of claiming that a file
2258       "vanished".
2259
2260     - The --copy-links (-L) option no longer has the side-effect of telling
2261       the receiving side to follow symlinks.  See the --keep-dirlinks
2262       option (mentioned below) for a way to specify that behavior.
2263
2264     - Error messages from the daemon server's option-parsing (such as
2265       refused options) are now successfully transferred back to the client
2266       (the server used to fail to send the message because the socket
2267       wasn't in the right state for the message to get through).
2268
2269     - Most transfer errors that occur during a daemon transfer are now
2270       returned to the user in addition to being logged (some messages are
2271       intended to be daemon-only and are not affected by this).
2272
2273     - Fixed a bug in the daemon authentication code when using one of the
2274       batch-processing options.
2275
2276     - We try to work around some buggy IPv6 implementations that fail to
2277       implement IPV6_V6ONLY.  This should fix the "address in use" error
2278       that some daemons get when running on an OS with a buggy IPv6
2279       implementation.  Also, if the new code gets this error, we might
2280       suggest that the user specify --ipv4 or --ipv6 (if we think it will
2281       help).
2282
2283     - When the remote rsync dies, make a better effort to recover any error
2284       messages it may have sent before dying (the local rsync used to just
2285       die with a socket-write error).
2286
2287     - When using --delete and a --backup-dir that contains files that are
2288       hard-linked to their destination equivalents, rsync now makes sure
2289       that removed files really get removed (avoids a really weird rename()
2290       behavior).
2291
2292     - Avoid a bogus run-time complaint about a lack of 64-bit integers when
2293       the int64 type is defined as an off_t and it actually has 64-bits.
2294
2295     - Added a configure check for open64() without mkstemp64() so that we
2296       can avoid using mkstemp() when such a combination is encountered.
2297       This bypasses a problem writing out large temp files on OSes such as
2298       AIX and HP-UX.
2299
2300     - Fixed an age-old crash problem with --read-batch on a local copy
2301       (rsync was improperly assuming --whole-file for the local copy).
2302
2303     - When --dry-run (-n) is used and the destination directory does not
2304       exist, rsync now produces a correct report of files that would be
2305       sent instead of dying with a chdir() error.
2306
2307     - Fixed a bug that could cause a slow-to-connect rsync daemon to die
2308       with an error instead of waiting for the connection to finish.
2309
2310     - Fixed an ssh interaction that could cause output to be lost when the
2311       user chose to combine the output of rsync's stdout and stderr (e.g.
2312       using the "2>&1").
2313
2314     - Fixed an option-parsing bug when --files-from got passed to a daemon.
2315
2316   ENHANCEMENTS:
2317
2318     - Added the --partial-dir=DIR option that lets you specify where to
2319       (temporarily) put a partially transferred file (instead of over-
2320       writing the destination file).  E.g.  --partial-dir=.rsync-partial
2321       Also added support for the RSYNC_PARTIAL_DIR environment variable
2322       that, when found, transforms a regular --partial option (such as
2323       the convenient -P option) into one that also specifies a directory.
2324
2325     - Added --keep-dirlinks (-K), which allows you to symlink a directory
2326       onto another partition on the receiving side and have rsync treat it
2327       as matching a normal directory from the sender.
2328
2329     - Added the --inplace option that tells rsync to write each destination
2330       file without using a temporary file.  The matching of existing data
2331       in the destination file can be severely limited by this, but there
2332       are also cases where this is more efficient (such as appending data).
2333       Use only when needed (see the man page for more details).
2334
2335     - Added the "write only" option for the daemon's config file.
2336
2337     - Added long-option names for -4 and -6 (namely --ipv4 and --ipv6)
2338       and documented all these options in the man page.
2339
2340     - Improved the handling of the --bwlimit option so that it's less
2341       bursty, more accurate, and works properly over a larger range of
2342       values.
2343
2344     - The rsync daemon-over-ssh code now looks for SSH_CONNECTION and
2345       SSH2_CLIENT in addition to SSH_CLIENT to figure out the IP address.
2346
2347     - Added the --checksum-seed=N option for advanced users.
2348
2349     - Batch writing/reading has a brand-new implementation that is simpler,
2350       fixes a few weird problems with the old code (such as no longer
2351       sprinkling the batch files into different dirs or even onto different
2352       systems), and is much less intrusive into the code (making it easier
2353       to maintain for the future).  The new code generates just one data
2354       file instead of three, which makes it possible to read the batch on
2355       stdin via a remote shell.  Also, the old requirement of forcing the
2356       same fixed checksum-seed for all batch processing has been removed.
2357
2358     - If an rsync daemon has a module set with "list = no" (which hides its
2359       presence in the list of available modules), a user that fails to
2360       authenticate gets the same "unknown module" error that they would get
2361       if the module were actually unknown (while still logging the real
2362       error to the daemon's log file).  This prevents fishing for module
2363       names.
2364
2365     - The daemon's "refuse options" config item now allows you to match
2366       option names using wildcards and/or the single-letter option names.
2367
2368     - Each transferred file now gets its permissions and modified-time
2369       updated before the temp-file gets moved into place.  Previously, the
2370       finished file would have a very brief window where its permissions
2371       disallowed all group and world access.
2372
2373     - Added the ability to parse a literal IPv6 address in an "rsync:" URL
2374       (e.g. rsync://[2001:638:500:101::21]:873/module/dir).
2375
2376     - The daemon's wildcard expanding code can now handle more than 1000
2377       filenames (it's now limited by memory instead of having a hard-wired
2378       limit).
2379
2380   INTERNAL:
2381
2382     - Some cleanup in the exclude code has saved some per-exclude memory
2383       and made the code easier to maintain.
2384
2385     - Improved the argv-overflow checking for a remote command that has a
2386       lot of args.
2387
2388     - Use rsyserr() in the various places that were still calling rprintf()
2389       with strerror() as an arg.
2390
2391     - If an rsync daemon is listening on multiple sockets (to handle both
2392       IPv4 and IPv6 to a single port), we now close all the unneeded file
2393       handles after we accept a connection (we used to close just one of
2394       them).
2395
2396     - Optimized the handling of larger block sizes (rsync used to slow to a
2397       crawl if the block size got too large).
2398
2399     - Optimized away a loop in hash_search().
2400
2401     - Some improvements to the sanitize_path() and clean_fname() functions
2402       makes them more efficient and produce better results (while still
2403       being compatible with the file-name cleaning that gets done on both
2404       sides when sending the file-list).
2405
2406     - Got rid of alloc_sanitize_path() after adding a destination-buffer
2407       arg to sanitize_path() made it possible to put all the former's
2408       functionality into the latter.
2409
2410     - The file-list that is output when at least 4 verbose options are
2411       specified reports the uid value on the sender even when rsync is
2412       not running as root (since we might be sending to a root receiver).
2413
2414   BUILD CHANGES:
2415
2416     - Added a "gen" target to rebuild most of the generated files,
2417       including configure, config.h.in, the man pages, and proto.h.
2418
2419     - If "make proto" doesn't find some changes in the prototypes, the
2420       proto.h file is left untouched (its time-stamp used to always be
2421       updated).
2422
2423     - The variable $STRIP (that is optionally set by the install-strip
2424       target's rule) was changed to $INSTALL_STRIP because some systems
2425       have $STRIP already set in the environment.
2426
2427     - Fixed a build problem when SUPPORT_HARD_LINKS isn't defined.
2428
2429     - When cross-compiling, the gettimeofday() function is now assumed to
2430       be a modern version that takes two-args (since we can't test it).
2431
2432   DEVELOPER RELATED:
2433
2434     - The scripts in the testsuite dir were cleaned up a bit and a few
2435       new tests added.
2436
2437     - Some new diffs were added to the patches dir, and some accepted
2438       ones were removed.
2439
2440 \f
2441 NEWS for rsync 2.6.2 (30 Apr 2004)
2442 Protocol: 28 (unchanged)
2443 Changes since 2.6.1:
2444
2445   BUG FIXES:
2446
2447     - Fixed a major bug in the sorting of the filenames when --relative
2448       is used for some sources (just sources such as "/" and "/*" were
2449       affected).  This fix ensures that we ask for the right file-list
2450       item when requesting changes from the sender.
2451
2452     - Rsync now checks the return value of the close() function to
2453       better report disk-full problems on an NFS file system.
2454
2455     - Restored the old daemon-server behavior of logging error messages
2456       rather than returning them to the user.  (A better long-term fix
2457       will be sought in the future.)
2458
2459     - An obscure uninitialized-variable bug was fixed in the uid/gid
2460       code.  (This bug probably had no ill effects.)
2461
2462   BUILD CHANGES:
2463
2464     - Got rid of the configure check for sys/sysctl.h (it wasn't used
2465       and was causing a problem on some systems).  Also improved the
2466       broken-largefile-locking test to try to avoid failure due to an
2467       NFS build-dir.
2468
2469     - Fixed a compile problem on systems that don't define
2470       AI_NUMERICHOST.
2471
2472     - Fixed a compile problem in the popt source for compilers that
2473       don't support __attribute__.
2474
2475   DEVELOPER RELATED:
2476
2477     - Improved the testsuite's "merge" test to work on OSF1.
2478
2479     - Two new diffs were added to the patches dir.
2480
2481 \f
2482 NEWS for rsync 2.6.1 (26 Apr 2004)
2483 Protocol: 28 (changed)
2484 Changes since 2.6.0:
2485
2486   SECURITY FIXES:
2487
2488     - Paths sent to an rsync daemon are more thoroughly sanitized when
2489       chroot is not used.  If you're running a non-read-only rsync
2490       daemon with chroot disabled, *please upgrade*, ESPECIALLY if the
2491       user privs you run rsync under is anything above "nobody".
2492
2493   ENHANCEMENTS:
2494
2495     - Lower memory use, more optimal transfer of data over the socket,
2496       and lower CPU usage (see the INTERNAL section for details).
2497
2498     - The RSYNC_PROXY environment variable can now contain a
2499       "USER:PASS@" prefix before the "HOST:PORT" information.
2500       (Bardur Arantsson)
2501
2502     - The --progress output now mentions how far along in the transfer
2503       we are, including both a count of files transferred and a
2504       percentage of the total file-count that we've processed.  It also
2505       shows better current-rate-of-transfer and remaining-transfer-time
2506       values.
2507
2508     - Documentation changes now attempt to describe some often mis-
2509       understood features more clearly.
2510
2511   BUG FIXES:
2512
2513     - When -x (--one-file-system) is combined with -L (--copy-links) or
2514       --copy-unsafe-links, no symlinked files are skipped, even if the
2515       referent file is on a different filesystem.
2516
2517     - The --link-dest code now works properly for a non-root user when
2518       (1) the UIDs of the source and destination differ and -o was
2519       specified, or (2) when the group of the source can't be used on
2520       the destination and -g was specified.
2521
2522     - Fixed a bug in the handling of -H (hard-links) that might cause
2523       the expanded PATH/NAME value of the current item to get
2524       overwritten (due to an expanded-name caching bug).
2525       
2526     - We now reset the "new data has been sent" flag at the start of
2527       each file we send.  This makes sure that an interrupted transfer
2528       with the --partial option set doesn't keep a shorter temp file
2529       than the current basis file when no new data has been transferred
2530       over the wire for that file.
2531
2532     - Fixed a byte-order problem in --batch-mode on big-endian machines.
2533       (Jay Fenlason)
2534
2535     - When using --cvs-exclude, the exclude items we get from a
2536       per-directory's .cvsignore file once again only affect that one
2537       directory (not all following directories too).  The items are also
2538       now properly word-split and parsed without any +/- prefix parsing.
2539
2540     - When specifying the USER@HOST: prefix for a file, the USER part
2541       can now contain an '@', if needed (i.e. the last '@' is used to
2542       find the HOST, not the first).
2543
2544     - Fixed some bugs in the handling of group IDs for non-root users:
2545       (1) It properly handles a group that the sender didn't have a name
2546       for (it would previously skip changing the group on any files in
2547       that group).  (2) If --numeric-ids is used, rsync no longer
2548       attempts to set groups that the user doesn't have the permission
2549       to set.
2550
2551     - Fixed the "refuse options" setting in the rsyncd.conf file.
2552
2553     - Improved the -x (--one-file-system) flag's handling of any mount-
2554       point directories we encounter.  It is both more optimal (in that
2555       it no longer does a useless scan of the contents of the mount-
2556       point dirs) and also fixes a bug where a remapped mount of the
2557       original filesystem could get discovered in a subdir we should be
2558       ignoring.
2559
2560     - Rsync no longer discards a double-slash at the start of a filename
2561       when trying to open the file.  It also no longer constructs names
2562       that start with a double slash (unless the user supplied them).
2563
2564     - Path-specifying options to a daemon should now work the same with
2565       or without chroot turned on.  Previously, such a option (such as
2566       --link-dest) would get its absolute path munged into a relative
2567       one if chroot was not on, making that setting fairly useless.
2568       Rsync now transforms the path into one that is based on the
2569       module's base dir when chroot is not enabled.
2570
2571     - Fixed a compatibility problem interacting with older rsync
2572       versions that might send us an empty --suffix value without
2573       telling us that --backup-dir was specified.
2574
2575     - The "hosts allow" option for a daemon-over-remote-shell process
2576       now has improved support for IPv6 addresses and a fix for systems
2577       that have a length field in their socket structs.
2578
2579     - Fixed the ability to request an empty backup --suffix when sending
2580       files to an rsync daemon.
2581
2582     - Fixed an option-parsing bug when --files-from was sent to a server
2583       sender.
2584
2585   INTERNAL:
2586
2587     - Most of the I/O is now buffered, which results in a pretty large
2588       speedup when running under MS Windows.  (Craig Barratt)
2589
2590     - Optimizations to the name-handling/comparing code have made some
2591       significant reductions in user-CPU time for large file sets.
2592
2593     - Some cleanup of the variable types make the code more consistent.
2594
2595     - Reduced memory requirements of hard link preservation.
2596       (J.W. Schultz)
2597
2598     - Implemented a new algorithm for hard-link handling that speeds up
2599       the code significantly.  (J.W. Schultz and Wayne Davison)
2600
2601     - The --hard-link option now uses the first existing file in the
2602       group of linked files as the basis for the transfer.  This
2603       prevents the sub-optimal transfer of a file's data when a new
2604       hardlink is added on the sending side and it sorts alphabetically
2605       earlier in the list than the files that are already present on the
2606       receiving side.
2607
2608     - Dropped support for protocol versions less than 20 (2.3.0 released
2609       15 Mar 1999) and activated warnings for protocols less than 25
2610       (2.5.0 released 23 Aug 2001). (Wayne Davison and J.W. Schultz,
2611       severally)
2612
2613     - More optimal data transmission for --hard-links (protocol 28).
2614
2615     - More optimal data transmission for --checksum (protocol 28).
2616
2617     - Less memory is used when --checksum is specified.
2618
2619     - Less memory is used in the file list (a per-file savings).
2620
2621     - The generator is now better about not modifying the file list
2622       during the transfer in order to avoid a copy-on-write memory
2623       bifurcation (on systems where fork() uses shared memory).
2624       Previously, rsync's shared memory would slowly become unshared,
2625       resulting in real memory usage nearly doubling on the receiving
2626       side by the end of the transfer.  Now, as long as permissions
2627       are being preserved, the shared memory should remain that way
2628       for the entire transfer.
2629
2630     - Changed hardlink info and file_struct + strings to use allocation
2631       pools.  This reduces memory use for large file-sets and permits
2632       freeing memory to the OS.  (J.W. Schultz) 
2633
2634     - The 2 pipes used between the receiver and generator processes
2635       (which are forked on the same machine) were reduced to 1 pipe and
2636       the protocol improved so that (1) it is now impossible to have the
2637       "redo" pipe fill up and hang rsync, and (2) trailing messages from
2638       the receiver don't get lost on their way through the generator
2639       over to the sender (which mainly affected hard-link messages and
2640       verbose --stats output).
2641
2642     - Improved the internal uid/gid code to be more portable and a
2643       little more optimized.
2644
2645     - The device numbers sent when using --devices are now sent as
2646       separate major/minor values with 32-bit accuracy (protocol 28).
2647       Previously, the copied devices were sent as a single 32-bit
2648       number.  This will make inter-operation of 64-bit binaries more
2649       compatible with their 32-bit brethren (with both ends of the
2650       connection are using protocol 28).  Note that optimizations in the
2651       binary protocol for sending the device numbers often results in
2652       fewer bytes being used than before, even though more precision is
2653       now available.
2654
2655     - Some cleanup of the exclude/include structures and its code made
2656       things clearer (internally), simpler, and more efficient.
2657
2658     - The reading & writing of the file-list in batch-mode is now
2659       handled by the same code that sends & receives the list over the
2660       wire.  This makes it much easier to maintain.  (Note that the
2661       batch code is still considered to be experimental.)
2662
2663   BUILD CHANGES:
2664
2665     - The configure script now accepts --with-rsyncd-conf=PATH to
2666       override the default value of the /etc/rsyncd.conf file.
2667
2668     - Fixed configure bug when running "./configure --disable-ipv6".
2669
2670     - Fixed compilation problem on Tru64 Unix (having to do with
2671       sockaddr.sa_len and sockaddr.sin_len).
2672
2673   DEVELOPER RELATED:
2674
2675     - Fixed "make test" bug when build dir is not the source dir.
2676
2677     - Added a couple extra diffs in the "patches" dir, removed the ones
2678       that got applied, and rebuilt the rest.
2679
2680 \f
2681 NEWS for rsync 2.6.0 (1 Jan 2004)
2682 Protocol: 27 (changed)
2683 Changes since 2.5.7:
2684
2685   ENHANCEMENTS:
2686
2687     * "ssh" is now the default remote shell for rsync.  If you want to
2688       change this, configure like this:  "./configure --with-rsh=rsh".
2689
2690     * Added --files-from, --no-relative, --no-implied-dirs, and --from0.
2691       Note that --from0 affects the line-ending character for all the
2692       files read by the --*-from options. (Wayne Davison)
2693
2694     * Length of csum2 is now per-file starting with protocol version
2695       27. (J.W. Schultz)
2696
2697     * Per-file dynamic block size is now sqrt(file length).  The
2698       per-file checksum size is determined according to an algorithm
2699       provided by Donovan Baarda which reduces the probability of rsync
2700       algorithm corrupting data and falling back using the whole md4
2701       checksums. (J.W. Schultz, Donovan Baarda)
2702
2703     * The --stats option no longer includes the (debug) malloc summary
2704       unless the verbose option was specified at least twice.
2705
2706     * Added a new error/warning code for when files vanish from the
2707       sending side.  Made vanished source files not interfere with the
2708       file-deletion pass when --delete-after was specified.
2709
2710     * Various trailing-info sections are now preceded by a newline.
2711
2712   BUG FIXES:
2713
2714     * Fixed several exclude/include matching bugs when using wild-cards.
2715       This has a several user-visible effects, all of which make the
2716       matching more consistent and intuitive.  This should hopefully not
2717       cause anyone problems since it makes the matching work more like
2718       what people are expecting. (Wayne Davison)
2719
2720       - A pattern with a "**" no longer causes a "*" to match slashes.
2721         For example, with "/*/foo/**", "foo" must be 2 levels deep.
2722         [If your string has BOTH "*" and "**" wildcards, changing the
2723         "*" wildcards to "**" will provide the old behavior in all
2724         versions.]
2725
2726       - "**/foo" now matches at the base of the transfer (like /foo
2727         does).  [Use "/**/foo" to get the old behavior in all versions.]
2728
2729       - A non-anchored wildcard term floats to match beyond the base of
2730         the transfer.  E.g. "CVS/R*" matches at the end of the path,
2731         just like the non-wildcard term "CVS/Root" does. [Use "/CVS/R*"
2732         to get the old behavior in all versions.]
2733
2734       - Including a "**" in the match term causes it to be matched
2735         against the entire path, not just the name portion, even if
2736         there aren't any interior slashes in the term.  E.g. "foo**bar"
2737         would exclude "/path/foo-bar" (just like before) as well as
2738         "/foo-path/baz-bar" (unlike before).  [Use "foo*bar" to get the
2739         old behavior in all versions.]
2740
2741     * The exclude list specified in the daemon's config file is now
2742       properly applied to the pulled items no matter how deep the
2743       user's file-args are in the source tree.  (Wayne Davison)
2744
2745     * For protocol version >= 27, mdfour_tail() is called when the
2746       block size (including checksum_seed) is a multiple of 64.
2747       Previously it was not called, giving the wrong MD4 checksum.
2748       (Craig Barratt)
2749
2750     * For protocol version >= 27, a 64 bit bit counter is used in
2751       mdfour.c as required by the RFC.  Previously only a 32 bit bit
2752       counter was used, causing incorrect MD4 file checksums for
2753       file sizes >= 512MB - 4.  (Craig Barratt)
2754
2755     * Fixed a crash bug when interacting with older rsync versions and
2756       multiple files of the same name are destined for the same dir.
2757       (Wayne Davison)
2758
2759     * Keep tmp names from overflowing MAXPATHLEN.
2760
2761     * Make --link-dest honor the absence of -p, -o, and -g.
2762
2763     * Made rsync treat a trailing slash in the destination in a more
2764       consistent manner.
2765
2766     * Fixed file I/O error detection.  (John Van Essen)
2767
2768     * Fixed bogus "malformed address {hostname}" message in rsyncd log
2769       when checking IP address against hostnames from "hosts allow"
2770       and "hosts deny" parameters in config file.
2771
2772     * Print heap statistics when verbose >= 2 instead of when >= 1.
2773
2774     * Fixed a compression (-z) bug when syncing a mostly-matching file
2775       that contains already-compressed data.  (Yasuoka Masahiko and
2776       Wayne Davison)
2777
2778     * Fixed a bug in the --backup code that could cause deleted files
2779       to not get backed up.
2780
2781     * When the backup code makes new directories, create them with mode
2782       0700 instead of 0755 (since the directory permissions in the
2783       backup tree are not yet copied from the main tree).
2784
2785     * Call setgroups() in a more portable manner.
2786
2787     * Improved file-related error messages to better indicate exactly
2788       what pathname failed. (Wayne Davison)
2789
2790     * Fixed some bugs in the handling of --delete and --exclude when
2791       using the --relative (-R) option. (Wayne Davison)
2792
2793     * Fixed bug that prevented regular files from replacing
2794       special files and caused a directory in --link-dest or
2795       --compare-dest to block the creation of a file with the
2796       same path.  A directory still cannot be replaced by a
2797       regular file unless --delete specified.  (J.W. Schultz)
2798
2799     * Detect and report when open or opendir succeed but read and
2800       readdir fail caused by network filesystem issues and truncated
2801       files.  (David Norwood, Michael Brown, J.W. Schultz)
2802
2803     * Added a fix that should give ssh time to restore the tty settings
2804       if the user presses Ctrl-C at an ssh password prompt.
2805
2806   INTERNAL:
2807
2808     * Eliminated vestigial support for old versions that we stopped
2809       supporting. (J.W. Schultz)
2810
2811     * Simplified some of the option-parsing code. (Wayne Davison)
2812
2813     * Some cleanup made to the exclude code, as well as some new
2814       defines added to enhance readability. (Wayne Davison)
2815
2816     * Changed the protocol-version code so that it can interact at a
2817       lower protocol level than the maximum supported by both sides.
2818       Added an undocumented option, --protocol=N, to force the value
2819       we advertise to the other side (primarily for testing purposes).
2820       (Wayne Davison)
2821
2822 \f
2823 NEWS for rsync 2.5.7 (4 Dec 2003)
2824 Protocol: 26 (unchanged)
2825 Changes since 2.5.6:
2826
2827   SECURITY FIXES:
2828
2829     * Fix buffer handling bugs.  (Andrew Tridgell, Martin Pool, Paul
2830       Russell, Andrea Barisani)
2831
2832 \f
2833 NEWS for rsync 2.5.6, aka "the dwd-between-jobs release" (26 Jan 2003)
2834 Protocol: 26 (unchanged)
2835 Changes since 2.5.5:
2836
2837   ENHANCEMENTS:
2838
2839     * The --delete-after option now implies --delete.  (Wayne Davison)
2840
2841     * The --suffix option can now be used with --backup-dir.  (Michael
2842       Zimmerman)
2843
2844     * Combining "::" syntax with the --rsh/-e option now uses the
2845       specified remote-shell as a transport to talk to a (newly-spawned)
2846       server-daemon.  This allows someone to use daemon features, such
2847       as modules, over a secure protocol, such as ssh.  (JD Paul)
2848
2849     * The rsync:// syntax for daemon connections is now accepted in the
2850       destination field.
2851
2852     * If the file name given to --include-from or --exclude-from is "-",
2853       rsync will read from standard input.  (J.W. Schultz)
2854
2855     * New option --link-dest which is like --compare-dest except that
2856       unchanged files are hard-linked in to the destination directory.
2857       (J.W. Schultz)
2858
2859     * Don't report an error if an excluded file disappears during an
2860       rsync run.  (Eugene Chupriyanov and Bo Kersey)
2861
2862     * Added .svn to --cvs-exclude list to support subversion.  (Jon
2863       Middleton)
2864
2865     * Properly support IPv6 addresses in the rsyncd.conf "hosts allow"
2866       and "hosts deny" fields.  (Hideaki Yoshifuji)
2867
2868     * Changed exclude file handling to permit DOS or MAC style line
2869       terminations.  (J.W. Schultz)
2870
2871     * Ignore errors from chmod when -p/-a/--preserve-perms is not set.
2872       (Dave Dykstra)
2873
2874   BUG FIXES:
2875
2876     * Fix "forward name lookup failed" errors on AIX 4.3.3.  (John
2877       L. Allen, Martin Pool)
2878
2879     * Generate each file's rolling-checksum data as we send it, not
2880       in a separate (memory-eating) pass before hand.  This prevents
2881       timeout errors on really large files. (Stefan Nehlsen)
2882
2883     * Fix compilation on Tru64.  (Albert Chin, Zoong Pham)
2884
2885     * Better handling of some client-server errors.  (Martin Pool)
2886
2887     * Fixed a crash that would occur when sending a list of files that
2888       contains a duplicate name (if it sorts to the end of the file
2889       list) and using --delete.  (Wayne Davison)
2890
2891     * Fixed the file-name duplicate-removal code when dealing with multiple
2892       dups in a row. (Wayne Davison)
2893
2894     * Fixed a bug that caused rsync to lose the exit status of its child
2895       processes and sometimes return an exit code of 0 instead of showing
2896       an error.  (David R. Staples, Dave Dykstra)
2897
2898     * Fixed bug in --copy-unsafe-links that caused it to be completely
2899       broken.  (Dave Dykstra)
2900
2901     * Prevent infinite recursion in cleanup code under certain circumstances.
2902       (Sviatoslav Sviridov and Marc Espie)
2903
2904     * Fixed a bug that prevented rsync from creating intervening directories
2905       when --relative-paths/-R is set.  (Craig Barratt)
2906
2907     * Prevent "Connection reset by peer" messages from Cygwin. (Randy O'Meara)
2908
2909   INTERNAL:
2910
2911     * Many code cleanups and improved internal documentation.  (Martin
2912       Pool, Nelson Beebe)
2913
2914     * Portability fixes. (Dave Dykstra and Wayne Davison)
2915
2916     * More test cases.  (Martin Pool)
2917
2918     * Some test-case fixes.  (Brian Poole, Wayne Davison)
2919
2920     * Updated included popt to the latest vendor drop, version 1.6.4.
2921       (Jos Backus)
2922
2923     * Updated config.guess and config.sub to latest versions; this
2924       means rsync should build on more platforms.  (Paul Green)
2925
2926 \f
2927 NEWS for rsync 2.5.5, aka Snowy River (2 Apr 2002)
2928 Protocol: 26 (unchanged)
2929 Changes since 2.5.4:
2930
2931   ENHANCEMENTS:
2932
2933     * With --progress, when a transfer is complete show the time taken;
2934       otherwise show expected time to complete. (Cameron Simpson)
2935
2936     * Make "make install-strip" works properly, and "make install"
2937       accepts a DESTDIR variable for help in building binary packages.
2938       (Peter Breitenlohner, Greg Louis)
2939
2940     * If configured with --enable-maintainer-mode, then on receipt of
2941       a fatal signal rsync will try to open an xterm running gdb,
2942       similarly to Samba's "panic action" or GNOME's bug-buddy.
2943       (Martin Pool)
2944
2945
2946   BUG FIXES:
2947
2948     * Fix situation where failure to fork (e.g. because out of process
2949       slots) would cause rsync to kill all processes owned by the
2950       current user.  Yes, really!  (Paul Haas, Martin Pool)
2951
2952     * Fix test suite on Solaris.  (Jos Backus, Martin Pool)
2953
2954     * Fix minor memory leak in socket code.  (Dave Dykstra, Martin
2955       Pool.)
2956
2957     * Fix --whole-file problem that caused it to be the default even
2958       for remote connections.  (Martin Pool, Frank Schulz)
2959
2960     * Work around bug in Mac OS X mkdir(2), which cannot handle
2961       trailing slashes.
2962       <http://www.opensource.apple.com/bugs/X/BSD%20Kernel/2734739.html>
2963       (Martin Pool)
2964
2965     * Improved network error handling.  (Greg A. Woods)
2966
2967 \f
2968 NEWS for rsync 2.5.4, aka "Imitation lizard skin" (13 Mar 2002)
2969 Protocol: 26 (unchanged)
2970 Changes since 2.5.3:
2971
2972   BUG FIXES:
2973
2974     * Additional fix for zlib double-free bug.  (Martin Pool, Andrew
2975       Tridgell) (CVE CAN-2002-0059)
2976
2977   ENHANCEMENTS:
2978
2979     * Merge in changes from zlib 1.1.3 to zlib 1.1.4.  (Jos Backus)
2980       (Note that rsync still uses a custom version of zlib; you can
2981       not just link against a system library.  See zlib/README.rsync)
2982
2983     * Additional test cases for --compress.  (Martin Pool)
2984
2985 \f
2986 NEWS for rsync 2.5.3, aka "Happy 26" (11 Mar 2002)
2987 Protocol: 26 (unchanged)
2988 Changes since 2.5.2:
2989
2990   SECURITY FIXES:
2991
2992     * Make sure that supplementary groups are removed from a server
2993       process after changing uid and gid. (Ethan Benson) (Debian bug
2994       #132272, CVE CAN-2002-0080)
2995
2996   BUG FIXES:
2997
2998     * Fix zlib double-free bug.  (Owen Taylor, Mark J Cox) (CVE
2999       CAN-2002-0059)
3000
3001     * Fixed problem that in many cases caused the error message
3002         unexpected read size of 0 in map_ptr
3003       and resulted in the wrong data being copied.
3004
3005     * Fixed compilation errors on some systems caused by the use of
3006       "unsigned int64" in rsync.h.
3007
3008     * Fixed problem on systems such as Sunos4 that do not support realloc
3009       on a NULL pointer; error was "out of memory in flist_expand".
3010
3011     * Fix for rsync server processes hanging around after the client
3012       unexpectedly disconnects.  (Colin Walters) (Debian bug #128632)
3013
3014     * Cope with BSD systems on which mkdir() will not accept a trailing
3015       slash.
3016
3017   ENHANCEMENTS:
3018
3019     * Merge in changes from zlib 1.1.2 to zlib 1.1.3.  (Note that
3020       rsync still uses a custom version of zlib; you can not just link
3021       against a system library.  See zlib/README.rsync)
3022
3023     * Command to initiate connections is only shown with -vv, rather
3024       than -v as in 2.5.2.  Output from plain -v is more similar to
3025       what was historically used so as not to break scripts that try
3026       to parse the output.
3027
3028     * Added --no-whole-file and --no-blocking-io options (Dave Dykstra)
3029
3030     * Made the --write-batch and --read-batch options actually work
3031       and added documentation in the man page (Jos Backus)
3032
3033     * If the daemon is unable to fork a child to accept a connection,
3034       print an error message.  (Colin Walters)
3035
3036 \f
3037 NEWS for rsync 2.5.2 (26 Jan 2002)
3038 Protocol: 26 (changed)
3039 Changes since 2.5.1:
3040
3041   SECURITY FIXES:
3042
3043     * Signedness security patch from Sebastian Krahmer
3044       <krahmer@suse.de> -- in some cases we were not sufficiently
3045       careful about reading integers from the network.
3046
3047   BUG FIXES:
3048
3049     * Fix possible string mangling in log files.
3050
3051     * Fix for setting local address of outgoing sockets.
3052
3053     * Better handling of hardlinks and devices on platforms with
3054       64-bit dev_t or ino_t.
3055
3056     * Name resolution on machines supporting IPv6 is improved.
3057
3058     * Fix for device nodes.  (dann frazier)   (Debian #129135)
3059
3060   ENHANCEMENTS:
3061
3062     * With -v, rsync now shows the command used to initiate an ssh/rsh
3063       connection.
3064
3065     * --statistics now shows memory heap usage on platforms that
3066       support mallinfo().
3067
3068     * "The Ted T'so school of program optimization": make progress
3069       visible and people will think it's faster.  (With --progress,
3070       rsync will show you how many files it has seen as it builds the
3071       file_list, giving some indication that it has not hung.)
3072
3073     * Improvements to batch mode support.  This is still experimental
3074       but testing would be welcome.   (Jos Backus)
3075
3076     * New --ignore-existing option, patch previously distributed with
3077       Vipul's Razor.  (Debian #124286)
3078
3079 \f
3080 NEWS for rsync 2.5.1 (3 Jan 2002)
3081 Protocol: 25 (unchanged)
3082 Changes since 2.5.0:
3083
3084   BUG FIXES:
3085
3086     * Fix for segfault in --daemon mode configuration parser.  (Paul
3087       Mackerras)
3088
3089     * Correct string<->address parsing for both IPv4 and 6.
3090       (YOSHIFUJI Hideaki, SUMIKAWA Munechika and Jun-ichiro "itojun"
3091       Hagino)
3092
3093     * Various fixes for IPv6 support.  (Dave Dykstra)
3094
3095     * rsync.1 typo fix.  (Matt Kraai)
3096
3097     * Test suite typo fixes.  (Tom Schmidt)
3098
3099     * rsync.1 grammar and clarity improvements.  (Edward
3100       Welbourne)
3101
3102     * Correction to ./configure tests for inet_ntop.  (Jeff Garzik)
3103
3104   ENHANCEMENTS:
3105
3106     * --progress and -P now show estimated data transfer rate (in a
3107       multiple of bytes/s) and estimated time to completion.  (Rik
3108       Faith)
3109
3110     * --no-detach option, required to run as a W32 service and also
3111       useful when running on Unix under daemontools, AIX's SRC, or a
3112       debugger.  (Max Bowsher, Jos Backus)
3113
3114     * Clearer error messages for some conditions.
3115
3116 \f
3117 NEWS for rsync 2.5.0 (30 Nov 2001)
3118 Protocol: 25 (changed)
3119 Changes since 2.4.6:
3120
3121   ANNOUNCEMENTS
3122
3123     * Martin Pool <mbp@samba.org> is now a co-maintainer.
3124
3125   NEW FEATURES
3126
3127     * Support for LSB-compliant packaging <http://www.linuxbase.org/>
3128
3129     * Shell wildcards are allowed in "auth users" lines.
3130
3131     * Merged UNC rsync+ patch to support creation of standalone patch
3132       sets.  By Bert J. Dempsey and Debra Weiss, updated by Jos
3133       Backus.  <http://www.ils.unc.edu/i2dsi/unc_rsync+.html>
3134
3135     * IPv6 support based on a patch from KAME.net, on systems
3136       including modern versions of Linux, Solaris, and HP-UX.  Also
3137       includes IPv6 compatibility functions for old OSs by the
3138       Internet Software Consortium, Paul Vixie, the OpenSSH
3139       portability project, and OpenBSD.
3140
3141   ENHANCEMENTS
3142
3143     * Include/exclude cluestick: with -vv, print out whether files are
3144       included or excluded and why.
3145
3146     * Many error messages have more friendly explanations and more
3147       details.
3148
3149     * Manual page improvements plus scanty protocol documentation.
3150
3151     * When running as --daemon in the background and using a "log
3152       file" rsyncd.conf directive, close the log file every time it is
3153       open when going to sleep on the socket.  This allows the log
3154       file to get cleaned out by another process.
3155
3156     * Change to using libpopt rather than getopt for processing
3157       options.  This makes the code cleaner and the behaviour more
3158       consistent across platforms.  popt is included and built if not
3159       installed on the platform.
3160
3161     * More details in --version, including note about whether 64-bit
3162       files, symlinks and hardlinks are supported.
3163
3164     * MD4 code may use less CPU cycles.
3165
3166     * Use mkstemp on systems where it is secure.  If we use mktemp,
3167       explain that we do it in a secure way.
3168
3169     * --whole-file is the default when source and target are on the
3170         local machine.
3171
3172   BUG FIXES:
3173
3174     * Fix for various bugs causing rsync to hang.
3175
3176     * Attempt to fix Large File Summit support on AIX.
3177
3178     * Attempt to fix error handling lockup bug.
3179
3180     * Give a non-0 exit code if *any* of the files we have been asked
3181       to transfer fail to transfer.
3182
3183     * For log messages containing ridiculously long strings that might
3184       overflow a buffer rsync no longer aborts, but rather prints an
3185       ellipsis at the end of the string.  (Patch from Ed Santiago.)
3186
3187   PLATFORMS:
3188
3189     * Improved support for UNICOS (tested on Cray T3E and Cray SV1)
3190
3191     * autoconf2.52 (or later) is now required to rebuild the autoconf
3192       scripts.  It is not required to simply build rsync.
3193
3194     * Platforms thought to work in this release:
3195
3196                 Cray SV1 UNICOS 10.0.0.8 cc
3197                 Debian Linux 2.2 UltraSparc gcc
3198                 Debian Linux testing/unstable ARM gcc
3199                 FreeBSD 3.3-RELEASE i386 cc
3200                 FreeBSD 4.1.1-RELEASE i386 cc
3201                 FreeBSD 4.3-STABLE i386 cc
3202                 HP PA-RISC HP-UX 10.20 gcc
3203                 HP PA-RISC HP-UX 11.11 cc
3204                 IRIX 6.5 MIPS cc
3205                 IRIX 6.5 MIPS gcc
3206                 Mac OS X PPC (--disable-ipv6) cc
3207                 NetBSD 1.5 i386 gcc
3208                 NetBSD Current i386 cc
3209                 OpenBSD 2.5 Sparc gcc
3210                 OpenBSD 2.9 i386 cc
3211                 OpenBSD Current i386 cc
3212                 RedHat 6.2 i386 gcc
3213                 RedHat 6.2 i386 insure++
3214                 RedHat 7.0 i386 gcc
3215                 RedHat 7.1 i386 (Kernel 2.4.10) gcc
3216                 Slackware 8.0 i686 (Kernel 2.4.10)
3217                 Solaris 8 UltraSparc cc
3218                 Solaris 8 UltraSparc gcc
3219                 Solaris 8 i386 gcc
3220                 SuSE 7.1 i386 gcc2.95.2
3221                 SuSE 7.1 ppc gcc2.95.2
3222                 i386-pc-sco3.2v5.0.5 cc
3223                 i386-pc-sco3.2v5.0.5 gcc
3224                 powerpc-ibm-aix4.3.3.0 cc
3225                 i686-unknown-sysv5UnixWare7.1.0 gcc
3226                 i686-unknown-sysv5UnixWare7.1.0 cc
3227
3228   TESTING:
3229
3230     * The existing test.sh script by Phil Hands has been merged into a
3231       test framework that works from both "make check" and the Samba
3232       build farm.
3233 \f
3234 Partial Protocol History
3235         RELEASE DATE    VER.    DATE OF COMMIT* PROTOCOL
3236         ?? ??? 2011     3.1.0   31 Aug 2008     31
3237         26 Mar 2011     3.0.8                   30
3238         31 Dec 2009     3.0.7                   30
3239         08 May 2009     3.0.6                   30
3240         28 Dec 2008     3.0.5                   30
3241         06 Sep 2008     3.0.4                   30
3242         29 Jun 2008     3.0.3                   30
3243         08 Apr 2008     3.0.2                   30
3244         03 Apr 2008     3.0.1                   30
3245         01 Mar 2008     3.0.0   11 Nov 2006     30
3246         06 Nov 2006     2.6.9                   29
3247         22 Apr 2006     2.6.8                   29
3248         11 Mar 2006     2.6.7                   29
3249         28 Jul 2005     2.6.6                   29
3250         01 Jun 2005     2.6.5                   29
3251         30 Mar 2005     2.6.4   17 Jan 2005     29
3252         30 Sep 2004     2.6.3                   28
3253         30 Apr 2004     2.6.2                   28
3254         26 Apr 2004     2.6.1   08 Jan 2004     28
3255         01 Jan 2004     2.6.0   10 Apr 2003     27 (MAX=40)
3256         04 Dec 2003     2.5.7                   26
3257         26 Jan 2003     2.5.6                   26
3258         02 Apr 2002     2.5.5                   26
3259         13 Mar 2002     2.5.4                   26
3260         11 Mar 2002     2.5.3                   26
3261         26 Jan 2002     2.5.2   11 Jan 2002     26
3262         03 Jan 2002     2.5.1                   25
3263         30 Nov 2001     2.5.0   23 Aug 2001     25
3264         06 Sep 2000     2.4.6                   24
3265         19 Aug 2000     2.4.5                   24
3266         29 Jul 2000     2.4.4                   24
3267         09 Apr 2000     2.4.3                   24
3268         30 Mar 2000     2.4.2                   24
3269         30 Jan 2000     2.4.1   29 Jan 2000     24
3270         29 Jan 2000     2.4.0   28 Jan 2000     23
3271         25 Jan 2000     2.3.3   23 Jan 2000     22
3272         08 Nov 1999     2.3.2   26 Jun 1999     21
3273         06 Apr 1999     2.3.1                   20
3274         15 Mar 1999     2.3.0   15 Mar 1999     20
3275         25 Nov 1998     2.2.1                   19
3276         03 Nov 1998     2.2.0                   19
3277         09 Sep 1998     2.1.1                   19
3278         20 Jul 1998     2.1.0                   19
3279         17 Jul 1998     2.0.19                  19
3280         18 Jun 1998     2.0.17                  19
3281         01 Jun 1998     2.0.16                  19
3282         27 May 1998     2.0.13  27 May 1998     19
3283         26 May 1998     2.0.12                  18
3284         22 May 1998     2.0.11                  18
3285         18 May 1998     2.0.9   18 May 1998     18
3286         17 May 1998     2.0.8                   17
3287         15 May 1998     2.0.1                   17
3288         14 May 1998     2.0.0                   17
3289         17 Apr 1998     1.7.4                   17
3290         13 Apr 1998     1.7.3                   17
3291         05 Apr 1998     1.7.2                   17
3292         26 Mar 1998     1.7.1                   17
3293         26 Mar 1998     1.7.0   26 Mar 1998     17 (MAX=30)
3294         13 Jan 1998     1.6.9   13 Jan 1998     15 (MAX=20)
3295
3296 * DATE OF COMMIT is the date the protocol change was committed to CVS.