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