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