Clarifications related to --dirs.
[rsync/rsync.git] / OLDNEWS
1 NEWS for rsync 2.6.4 (30 March 2005)
2 Protocol: 29 (changed)
3 Changes since 2.6.3:
4
5   OUTPUT CHANGES:
6
7     - When rsync deletes a directory and outputs a verbose message about
8       it, it now appends a trailing slash to the name instead of (only
9       sometimes) outputting a preceding "directory " string.
10
11     - The --stats output will contain file-list time-statistics if both
12       sides are 2.6.4, or if the local side is 2.6.4 and the files are
13       being pushed (since the stats come from the sending side).
14       (Requires protocol 29 for a pull.)
15
16     - The "%o" (operation) log-format escape now has a third value (besides
17       "send" and "recv"):  "del." (with trailing dot to make it 4 chars).
18       This changes the way deletions are logged in the daemon's log file.
19
20     - When the --log-format option is combined with --verbose, rsync now
21       avoids outputting the name of the file twice in most circumstances.
22       As long as the --log-format item does not refer to any post-transfer
23       items (such as %b or %c), the --log-format message is output prior to
24       the transfer, so --verbose is now the equivalent of a --log-format of
25       '%n%L' (which outputs the name and any link info).  If the log output
26       must occur after the transfer to be complete, the only time the name
27       is also output prior to the transfer is when --progress was specified
28       (so that the name will precede the progress stats, and the full
29       --log-format output will come after).
30
31     - Non-printable characters in filenames are replaced with a '?' to
32       avoid corrupting the screen or generating empty lines in the output.
33   
34   BUG FIXES:
35
36     - Restore the list-clearing behavior of "!" in a .cvsignore file (2.6.3
37       was only treating it as a special token in an rsync include/exclude
38       file).
39
40     - The combination of --verbose and --dry-run now mentions the full list
41       of changes that would be output without --dry-run.
42
43     - Avoid a mkdir warning when removing a directory in the destination
44       that already exists in the --backup-dir.
45
46     - An OS that has a binary mode for its files (such as cygwin) needed
47       setmode(fd, O_BINARY) called on the temp-file we opened with
48       mkstemp().  (Fix derived from the cygwin's 2.6.3 rsync package.)
49
50     - Fixed a potential hang when verbosity is high, the client side is
51       the sender, and the file-list is large.
52
53     - Fixed a potential protocol-corrupting bug where the generator could
54       merge a message from the receiver into the middle of a multiplexed
55       packet of data if only part of that data had been written out to the
56       socket when the message from the generator arrived.
57
58     - We now check if the OS doesn't support using mknod() for creating
59       FIFOs and sockets, and compile-in some compatibility code using
60       mkfifo() and socket() when necessary.
61
62     - Fixed an off-by-one error in the handling of --max-delete=N.  Also,
63       if the --max-delete limit is exceeded during a run, we now output a
64       warning about this at the end of the run and exit with a new error
65       code (25).
66
67     - One place in the code wasn't checking if fork() failed.
68
69     - The "ignore nonreadable" daemon parameter used to erroneously affect
70       readable symlinks that pointed to a non-existent file.
71
72     - If the OS does not have lchown() and a chown() of a symlink will
73       affect the referent of a symlink (as it should), we no longer try
74       to set the user and group of a symlink.
75
76     - The generator now properly runs the hard-link loop and the dir-time
77       rewriting loop after we're sure that the redo phase is complete.
78
79     - When --backup was specified with --partial-dir=DIR, where DIR is a
80       relative path, the backup code was erroneously trying to backup a
81       file that was put into the partial-dir.
82
83     - If a file gets resent in a single transfer and the --backup option is
84       enabled along with --inplace, rsync no longer performs a duplicate
85       backup (it used to overwrite the first backup with the failed file).
86
87     - One call to flush_write_file() was not being checked for an error.
88
89     - The --no-relative option was not being sent from the client to a
90       server sender.
91
92     - If an rsync daemon specified "dont compress = ..." for a file and the
93       client tried to specify --compress, the libz code was not handling a
94       compression level of 0 properly.  This could cause a transfer failure
95       if the block-size for a file was large enough (e.g. rsync might have
96       exited with an error for large files).
97
98     - Fixed a bug that would sometimes surface when using --compress and
99       sending a file with a block-size larger than 64K (either manually
100       specified, or computed due to the file being really large).  Prior
101       versions of rsync would sometimes fail to decompress the data
102       properly, and thus the transferred file would fail its verification.
103
104     - If a daemon can't open the specified log file (i.e. syslog is not
105       being used), die without crashing.  We also output an error about
106       the failure on stderr (which will only be seen if --no-detach was
107       specified) and exit with a new error code (6).
108
109     - A local transfer no longer duplicates all its include/exclude options
110       (since the forked process already has a copy of the exclude list,
111       there's no need to send them a set of duplicates).
112
113     - When --progress is specified, the output of items that the generator
114       is creating (e.g. dirs, symlinks) is now integrated into the progress
115       output without overlapping it.  (Requires protocol 29.)
116
117     - When --timeout is specified, lulls that occur in the transfer while
118       the generator is doing work that does not generate socket traffic
119       (looking for changed files, deleting files, doing directory-time
120       touch-ups, etc.) will cause a new keep-alive packet to be sent that
121       should keep the transfer going as long as the generator continues to
122       make progress.  (Requires protocol 29.)
123
124     - The stat size of a device is not added to the total file size of the
125       items in the transfer (the size might be undefined on some OSes).
126
127     - Fixed a problem with refused-option messages sometimes not making it
128       back to the client side when a remote --files-from was in effect and
129       the daemon was the receiver.
130
131     - The --compare-dest option was not updating a file that differed in
132       (the preserved) attributes from the version in the compare-dest DIR.
133
134     - When rsync is copying files into a write-protected directory, fixed
135       the change-report output for the directory so that we don't report
136       an identical directory as changed.
137
138   ENHANCEMENTS:
139
140     - Rsync now supports popt's option aliases, which means that you can
141       use /etc/popt and/or ~/.popt to create your own option aliases.
142
143     - Added the --delete-during (--del) option which will delete files
144       from the receiving side incrementally as each directory in the
145       transfer is being processed.  This makes it more efficient than the
146       default, before-the-transfer behavior, which is now also available as
147       --delete-before (and is still the default --delete-WHEN option that
148       will be chosen if --delete or --delete-excluded is specified without
149       a --delete-WHEN choice).  All the --del* options infer --delete, so
150       an rsync daemon that refuses "delete" will still refuse to allow any
151       file-deleting options (including the new --remove-sent-files option).
152
153     - All the --delete-WHEN options are now more memory efficient:
154       Previously an duplicate set of file-list objects was created on the
155       receiving side for the entire destination hierarchy.  The new
156       algorithm only creates one directory of objects at a time (for files
157       inside the transfer).
158
159     - Added the --copy-dest option, which works like --link-dest except
160       that it locally copies identical files instead of hard-linking them.
161
162     - Added support for specifying multiple --compare-dest, --copy-dest, or
163       --link-dest options, but only of a single type. (Promoted from the
164       patches dir and enhanced.) (Requires protocol 29.)
165
166     - Added the --max-size option. (Promoted from the patches dir.)
167
168     - The daemon-mode options are now separated from the normal rsync
169       options so that they can't be mixed together.  This makes it
170       impossible to start a daemon that has improper default option values
171       (which could cause problems when a client connects, such as hanging
172       or crashing).
173
174     - The --bwlimit option may now be used in combination with --daemon
175       to specify both a default value for the daemon side and a value
176       that cannot be exceeded by a user-specified --bwlimit option.
177
178     - Added the "port" parameter to the rsyncd.conf file. (Promoted from
179       the patches dir.)  Also added "address".  The command-line options
180       take precedence over a config-file option, as expected.
181
182     - In _exit_cleanup(): when we are exiting with a partially-received
183       file, we now flush any data in the write-cache before closing the
184       partial file.
185
186     - The --inplace support was enhanced to work with --compare-dest,
187       --link-dest, and (the new) --copy-dest options. (Requires protocol
188       29.)
189
190     - Added the --dirs (-d) option for an easier way to copy directories
191       without recursion.  Any directories that are encountered are created
192       on the destination.  Specifying a directory with a trailing slash
193       copies its immediate contents to the destination.
194
195     - The --files-from option now implies --dirs (-d).
196
197     - Added the --list-only option, which is mainly a way for the client to
198       put the server into listing mode without needing to resort to any
199       internal option kluges (e.g. the age-old use of "-r --exclude="/*/*"
200       for a non-recursive listing).  This option is used automatically
201       (behind the scenes) when a modern rsync speaks to a modern daemon,
202       but may also be specified manually if you want to force the use of
203       the --list-only option over a remote-shell connection.
204
205     - Added the --omit-dir-times (-O) option, which will avoid updating
206       the modified time for directories when --times was specified.  This
207       option will avoid an extra pass through the file-list at the end of
208       the transfer (to tweak all the directory times), which may provide
209       an appreciable speedup for a really large transfer. (Promoted from
210       the patches dir.)
211
212     - Added the --filter (-f) option and its helper option, -F.  Filter
213       rules are an extension to the existing include/exclude handling
214       that also supports nested filter files as well as per-directory
215       filter files (like .cvsignore, but with full filter-rule parsing).
216       This new option was chosen in order to ensure that all existing
217       include/exclude processing remained 100% compatible with older
218       versions.  Protocol 29 is needed for full filter-rule support, but
219       backward-compatible rules work with earlier protocol versions.
220       (Promoted from the patches dir and enhanced.)
221
222     - Added the --delay-updates option that puts all updated files into
223       a temporary directory (by default ".~tmp~", but settable via the
224       --partial-dir=DIR option) until the end of the transfer.  This
225       makes the updates a little more atomic for a large transfer.
226
227     - If rsync is put into the background, any output from --progress is
228       reduced.
229
230     - Documented the "max verbosity" setting for rsyncd.conf.  (This
231       setting was added a couple releases ago, but left undocumented.)
232
233     - The sender and the generator now double-check the file-list index
234       they are given, and refuse to try to do a file transfer on a
235       non-file index (since that would indicate that something had gone
236       very wrong).
237
238     - Added the --itemize-changes (-i) option, which is a way to output a
239       more detailed list of what files changed and in what way.  The effect
240       is the same as specifying a --log-format of "%i %n%L" (see both the
241       rsync and rsyncd.conf manpages).  Works with --dry-run too.
242
243     - Added the --fuzzy (-y) option, which attempts to find a basis file
244       for a file that is being created from scratch.  The current algorithm
245       only looks in the destination directory for the created file, but it
246       does attempt to find a match based on size/mod-time (in case the file
247       was renamed with no other changes) as well as based on a fuzzy
248       name-matching algorithm.  This option requires protocol 29 because it
249       needs the new file-sorting order.  (Promoted from patches dir and
250       enhanced.) (Requires protocol 29.)
251
252     - Added the --remove-sent-files option, which lets you move files
253       between systems.
254
255     - The hostname in HOST:PATH or HOST::PATH may now be an IPv6 literal
256       enclosed in '[' and ']' (e.g. "[::1]").  (We already allowed IPv6
257       literals in the rsync://HOST:PORT/PATH format.)
258
259     - When rsync recurses to build the file list, it no longer keeps open
260       one or more directory handles from the dir's parent dirs.
261
262     - When building under windows, the default for --daemon is now to
263       avoid detaching, requiring the new --detach option to force rsync
264       to detach.
265
266     - The --dry-run option can now be combined with either --write-batch or
267       --read-batch, allowing you to run a do-nothing test command to see
268       what would happen without --dry-run.
269
270     - The daemon's "read only" config item now sets an internal read_only
271       variable that makes extra sure that no write/delete calls on the
272       read-only side can succeed.
273
274     - The log-format % escapes can now have a numeric field width in
275       between the % and the escape letter (e.g. "%-40n %08p").
276
277     - Improved the option descriptions in the --help text.
278
279   SUPPORT FILES:
280
281     - Added atomic-rsync to the support dir: a perl script that will
282       transfer some files using rsync, and then move the updated files into
283       place all at once at the end of the transfer.  Only works when
284       pulling, and uses --link-dest and a parallel hierarchy of files to
285       effect its update.
286
287     - Added mnt-excl to the support dir: a perl script that takes the
288       /proc/mounts file and translates it into a set of excludes that will
289       exclude all mount points (even mapped mounts to the same disk).  The
290       excludes are made relative to the specified source dir and properly
291       anchored.
292
293     - Added savetransfer.c to the support dir: a C program that can make
294       a copy of all the data that flows over the wire.  This lets you test
295       for data corruption (by saving the data on both the sending side and
296       the receiving side) and provides one way to debug a protocol error.
297
298     - Added rrsync to the support dir: this is an updated version of Joe
299       Smith's restricted rsync perl script.  This helps to ensure that only
300       certain rsync commands can be run by an ssh invocation.
301
302   INTERNAL:
303
304     - Added better checking of the checksum-header values that come over
305       the socket.
306
307     - Merged a variety of file-deleting functions into a single function so
308       that it is easier to maintain.
309
310     - Improved the type of some variables (particularly blocksize vars) for
311       consistency and proper size.
312
313     - Got rid of the uint64 type (which we didn't need).
314
315     - Use a slightly more compatible set of core #include directives.
316
317     - Defined int32 in a way that ensures that the build dies if we can't
318       find a variable with at least 32 bits.
319
320   PROTOCOL DIFFERENCES FOR VERSION 29:
321
322     - A 16-bit flag-word is transmitted after every file-list index.  This
323       indicates what is changing between the sender and the receiver.  The
324       generator now transmits an index and a flag-word to indicate when
325       dirs and symlinks have changed (instead of producing a message),
326       which makes the outputting of the information more consistent and
327       less prone to screen corruption (because the local receiver/sender is
328       now outputting all the file-change info messages).
329
330     - If a file is being hard-linked, the ITEM_XNAME_FOLLOWS bit is enabled
331       in the flag-word and the name of the file that was linked immediately
332       follows in vstring format (see below).
333
334     - If a file is being transferred with an alternate-basis file, the
335       ITEM_BASIS_TYPE_FOLLOWS bit is enabled in the flag-word and a single
336       byte follows, indicating what type of basis file was chosen.  If that
337       indicates that a fuzzy-match was selected, the ITEM_XNAME_FOLLOWS bit
338       is set in the flag-word and the name of the match in vstring format
339       follows the basis byte.  A vstring is a variable length string that
340       has its size written prior to the string, and no terminating null.
341       If the string is from 1-127 bytes, the length is a single byte.  If
342       it is from 128-32767 bytes, the length is written as ((len >> 8) |
343       0x80) followed by (len % 0x100).
344
345     - The sending of exclude names is done using filter-rule syntax.  This
346       means that all names have a prefixed rule indicator, even excludes
347       (which used to be sent as a bare pattern, when possible).  The -C
348       option will include the per-dir .cvsignore merge file in the list of
349       filter rules so it is positioned correctly (unlike in some older
350       transfer scenarios).
351
352     - Rsync sorts the filename list in a different way: it sorts the subdir
353       names after the non-subdir names for each dir's contents, and it
354       always puts a dir's contents immediately after the dir's name in the
355       list.  (Previously an item named "foo.txt" would sort in between
356       directory "foo/" and "foo/bar".)
357
358     - When talking to a protocol 29 rsync daemon, a list-only request
359       is able to note this before the options are sent over the wire and
360       the new --list-only option is included in the options.
361
362     - When the --stats bytes are sent over the wire (or stored in a batch),
363       they now include two elapsed-time values: one for how long it took to
364       build the file-list, and one for how long it took to send it over the
365       wire (each expressed in thousandths of a second).
366
367     - When --delete-excluded is specified with some filter rules (AKA
368       excludes), a client sender will now initiate a send of the rules to
369       the receiver (older protocols used to omit the sending of excludes in
370       this situation since there were no receiver-specific rules that
371       survived --delete-excluded back then).  Note that, as with all the
372       filter-list sending, only items that are significant to the other
373       side will actually be sent over the wire, so the filter-rule list
374       that is sent in this scenario is often empty.
375
376     - An index equal to the file-list count is sent as a keep-alive packet
377       from the generator to the sender, which then forwards it on to the
378       receiver.  This normally invalid index is only a valid keep-alive
379       packet if the 16-bit flag-word that follows it contains a single bit
380       (ITEM_IS_NEW, which is normally an illegal flag to appear alone).
381
382     - A protocol-29 batch file includes a bit for the setting of the --dirs
383       option and for the setting of the --compress option.  Also, the shell
384       script created by --write-batch will use the --filter option instead
385       of --exclude-from to capture any filter rules.
386
387   BUILD CHANGES:
388
389     - Handle an operating system that use mkdev() in place of makedev().
390
391     - Improved configure to better handle cross-compiling.
392 NEWS for rsync 2.6.3 (30 Sep 2004)
393 Protocol: 28 (unchanged)
394 Changes since 2.6.2:
395
396   SECURITY FIXES:
397
398     - A bug in the sanitize_path routine (which affects a non-chrooted
399       rsync daemon) could allow a user to craft a pathname that would get
400       transformed into an absolute path for certain options (but not for
401       file-transfer names).  If you're running an rsync daemon with chroot
402       disabled, *please upgrade*, ESPECIALLY if the user privs you run
403       rsync under is anything above "nobody".
404
405   OUTPUT CHANGES (ATTN: those using a script to parse the verbose output):
406
407     - Please note that the 2-line footer (output when verbose) now uses the
408       term "sent" instead of "wrote" and "received" instead of "read".  If
409       you are not parsing the numeric values out of this footer, a script
410       would be better off using the empty line prior to the footer as the
411       indicator that the verbose output is over.
412       
413     - The output from the --stats option was similarly affected to change
414       "written" to "sent" and "read" to "received".
415
416     - Rsync ensures that a filename that contains a newline gets mentioned
417       with each newline transformed into a question mark (which prevents a
418       filename from causing an empty line to be output).
419
420     - The "backed up ..." message that is output when at least 2 --verbose
421       options are specified is now the same both with and without the
422       --backup-dir option.
423
424   BUG FIXES:
425
426     - Fixed a crash bug that might appear when --delete was used and
427       multiple source directories were specified.
428
429     - Fixed a 32-bit truncation of the file length when generating the
430       checksums.
431
432     - The --backup code no longer attempts to create some directories
433       over and over again (generating warnings along the way).
434
435     - Fixed a bug in the reading of the secrets file (by the daemon) and
436       the password file (by the client):  the files no longer need to be
437       terminated by a newline for their content to be read in.
438
439     - If a file has a read error on the sending side or the reconstructed
440       data doesn't match the expected checksum (perhaps due to the basis
441       file changing during the transfer), the receiver will no longer
442       retain the resulting file unless the --partial option was specified.
443       (Note: for the read-error detection to work, neither side can be
444       older than 2.6.3 -- older receivers will always retain the file, and
445       older senders don't tell the receiver that the file had a read
446       error.)
447
448     - If a file gets resent in a single transfer and the --backup option
449       is enabled, rsync no longer performs a duplicate backup (it used to
450       overwrite the original file in the backup area).
451
452     - Files specified in the daemon's "exclude" or "exclude from" config
453       items are now excluded from being uploaded (assuming that the module
454       allows uploading at all) in addition to the old download exclusion.
455
456     - Got rid of a potential hang in the receiver when near the end of a
457       phase.
458
459     - When using --backup without a --backup-dir, rsync no longer preserves
460       the modify time on directories.  This avoids confusing NFS.
461
462     - When --copy-links (-L) is specified, we now output a separate error
463       for a symlink that has no referent instead of claiming that a file
464       "vanished".
465
466     - The --copy-links (-L) option no longer has the side-effect of telling
467       the receiving side to follow symlinks.  See the --keep-dirlinks
468       option (mentioned below) for a way to specify that behavior.
469
470     - Error messages from the daemon server's option-parsing (such as
471       refused options) are now successfully transferred back to the client
472       (the server used to fail to send the message because the socket
473       wasn't in the right state for the message to get through).
474
475     - Most transfer errors that occur during a daemon transfer are now
476       returned to the user in addition to being logged (some messages are
477       intended to be daemon-only and are not affected by this).
478
479     - Fixed a bug in the daemon authentication code when using one of the
480       batch-processing options.
481
482     - We try to work around some buggy IPv6 implementations that fail to
483       implement IPV6_V6ONLY.  This should fix the "address in use" error
484       that some daemons get when running on an OS with a buggy IPv6
485       implementation.  Also, if the new code gets this error, we might
486       suggest that the user specify --ipv4 or --ipv6 (if we think it will
487       help).
488
489     - When the remote rsync dies, make a better effort to recover any error
490       messages it may have sent before dying (the local rsync used to just
491       die with a socket-write error).
492
493     - When using --delete and a --backup-dir that contains files that are
494       hard-linked to their destination equivalents, rsync now makes sure
495       that removed files really get removed (avoids a really weird rename()
496       behavior).
497
498     - Avoid a bogus run-time complaint about a lack of 64-bit integers when
499       the int64 type is defined as an off_t and it actually has 64-bits.
500
501     - Added a configure check for open64() without mkstemp64() so that we
502       can avoid using mkstemp() when such a combination is encountered.
503       This bypasses a problem writing out large temp files on OSes such as
504       AIX and HP-UX.
505
506     - Fixed an age-old crash problem with --read-batch on a local copy
507       (rsync was improperly assuming --whole-file for the local copy).
508
509     - When --dry-run (-n) is used and the destination directory does not
510       exist, rsync now produces a correct report of files that would be
511       sent instead of dying with a chdir() error.
512
513     - Fixed a bug that could cause a slow-to-connect rsync daemon to die
514       with an error instead of waiting for the connection to finish.
515
516     - Fixed an ssh interaction that could cause output to be lost when the
517       user chose to combine the output of rsync's stdout and stderr (e.g.
518       using the "2>&1").
519
520   ENHANCEMENTS:
521
522     - Added the --partial-dir=DIR option that lets you specify where to
523       (temporarily) put a partially transferred file (instead of over-
524       writing the destination file).  E.g.  --partial-dir=.rsync-partial
525       Also added support for the RSYNC_PARTIAL_DIR environment variable
526       that, when found, transforms a regular --partial option (such as
527       the convenient -P option) into one that also specifies a directory.
528
529     - Added --keep-dirlinks (-K), which allows you to symlink a directory
530       onto another partition on the receiving side and have rsync treat it
531       as matching a normal directory from the sender.
532
533     - Added the --inplace option that tells rsync to write each destination
534       file without using a temporary file.  The matching of existing data
535       in the destination file can be severely limited by this, but there
536       are also cases where this is more efficient (such as appending data).
537       Use only when needed (see the man page for more details).
538
539     - Added the "write only" option for the daemon's config file.
540
541     - Added long-option names for -4 and -6 (namely --ipv4 and --ipv6)
542       and documented all these options in the man page.
543
544     - Improved the handling of the --bwlimit option so that it's less
545       bursty, more accurate, and works properly over a larger range of
546       values.
547
548     - The rsync daemon-over-ssh code now looks for SSH_CONNECTION and
549       SSH2_CLIENT in addition to SSH_CLIENT to figure out the IP address.
550
551     - Added the --checksum-seed=N option for advanced users.
552
553     - Batch writing/reading has a brand-new implementation that is simpler,
554       fixes a few weird problems with the old code (such as no longer
555       sprinkling the batch files into different dirs or even onto different
556       systems), and is much less intrusive into the code (making it easier
557       to maintain for the future).  The new code generates just one data
558       file instead of three, which makes it possible to read the batch on
559       stdin via a remote shell.  Also, the old requirement of forcing the
560       same fixed checksum-seed for all batch processing has been removed.
561
562     - If an rsync daemon has a module set with "list = no" (which hides its
563       presence in the list of available modules), a user that fails to
564       authenticate gets the same "unknown module" error that they would get
565       if the module were actually unknown (while still logging the real
566       error to the daemon's log file).  This prevents fishing for module
567       names.
568
569     - The daemon's "refuse options" config item now allows you to match
570       option names using wildcards and/or the single-letter option names.
571
572     - Each transferred file now gets its permissions and modified-time
573       updated before the temp-file gets moved into place.  Previously, the
574       finished file would have a very brief window where its permissions
575       disallowed all group and world access.
576
577     - Added the ability to parse a literal IPv6 address in an "rsync:" URL
578       (e.g. rsync://[2001:638:500:101::21]:873/module/dir).
579
580     - The daemon's wildcard expanding code can now handle more than 1000
581       filenames (it's now limited by memory instead of having a hard-wired
582       limit).
583
584   INTERNAL:
585
586     - Some cleanup in the exclude code has saved some per-exclude memory
587       and made the code easier to maintain.
588
589     - Improved the argv-overflow checking for a remote command that has a
590       lot of args.
591
592     - Use rsyserr() in the various places that were still calling rprintf()
593       with strerror() as an arg.
594
595     - If an rsync daemon is listening on multiple sockets (to handle both
596       IPv4 and IPv6 to a single port), we now close all the unneeded file
597       handles after we accept a connection (we used to close just one of
598       them).
599
600     - Optimized the handling of larger block sizes (rsync used to slow to a
601       crawl if the block size got too large).
602
603     - Optimized away a loop in hash_search().
604
605     - Some improvements to the sanitize_path() and clean_fname() functions
606       makes them more efficient and produce better results (while still
607       being compatible with the file-name cleaning that gets done on both
608       sides when sending the file-list).
609
610     - Got rid of alloc_sanitize_path() after adding a destination-buffer
611       arg to sanitize_path() made it possible to put all the former's
612       functionality into the latter.
613
614     - The file-list that is output when at least 4 verbose options are
615       specified reports the uid value on the sender even when rsync is
616       not running as root (since we might be sending to a root receiver).
617
618   BUILD CHANGES:
619
620     - Added a "gen" target to rebuild most of the generated files,
621       including configure, config.h.in, the man pages, and proto.h.
622
623     - If "make proto" doesn't find some changes in the prototypes, the
624       proto.h file is left untouched (its time-stamp used to always be
625       updated).
626
627     - The variable $STRIP (that is optionally set by the install-strip
628       target's rule) was changed to $INSTALL_STRIP because some systems
629       have $STRIP already set in the environment.
630
631     - Fixed a build problem when SUPPORT_HARD_LINKS isn't defined.
632
633     - When cross-compiling, the gettimeofday() function is now assumed to
634       be a modern version that takes two-args (since we can't test it).
635
636   DEVELOPER RELATED:
637
638     - The scripts in the testsuite dir were cleaned up a bit and a few
639       new tests added.
640
641     - Some new diffs were added to the patches dir, and some accepted
642       ones were removed.
643
644 \f
645 NEWS for rsync 2.6.2 (30 Apr 2004)
646 Protocol: 28 (unchanged)
647 Changes since 2.6.1:
648
649   BUG FIXES:
650
651     - Fixed a major bug in the sorting of the filenames when --relative
652       is used for some sources (just sources such as "/" and "/*" were
653       affected).  This fix ensures that we ask for the right file-list
654       item when requesting changes from the sender.
655
656     - Rsync now checks the return value of the close() function to
657       better report disk-full problems on an NFS file system.
658
659     - Restored the old daemon-server behavior of logging error messages
660       rather than returning them to the user.  (A better long-term fix
661       will be sought in the future.)
662
663     - An obscure uninitialized-variable bug was fixed in the uid/gid
664       code.  (This bug probably had no ill effects.)
665
666   BUILD CHANGES:
667
668     - Got rid of the configure check for sys/sysctl.h (it wasn't used
669       and was causing a problem on some systems).  Also improved the
670       broken-largefile-locking test to try to avoid failure due to an
671       NFS build-dir.
672
673     - Fixed a compile problem on systems that don't define
674       AI_NUMERICHOST.
675
676     - Fixed a compile problem in the popt source for compilers that
677       don't support __attribute__.
678
679   DEVELOPER RELATED:
680
681     - Improved the testsuite's "merge" test to work on OSF1.
682
683     - Two new diffs were added to the patches dir.
684
685 \f
686 NEWS for rsync 2.6.1 (26 Apr 2004)
687 Protocol: 28 (changed)
688 Changes since 2.6.0:
689
690   SECURITY FIXES:
691
692     - Paths sent to an rsync daemon are more thoroughly sanitized when
693       chroot is not used.  If you're running a non-read-only rsync
694       daemon with chroot disabled, *please upgrade*, ESPECIALLY if the
695       user privs you run rsync under is anything above "nobody".
696
697   ENHANCEMENTS:
698
699     - Lower memory use, more optimal transfer of data over the socket,
700       and lower CPU usage (see the INTERNAL section for details).
701
702     - The RSYNC_PROXY environment variable can now contain a
703       "USER:PASS@" prefix before the "HOST:PORT" information.
704       (Bardur Arantsson)
705
706     - The --progress output now mentions how far along in the transfer
707       we are, including both a count of files transferred and a
708       percentage of the total file-count that we've processed.  It also
709       shows better current-rate-of-transfer and remaining-transfer-time
710       values.
711
712     - Documentation changes now attempt to describe some often mis-
713       understood features more clearly.
714
715   BUG FIXES:
716
717     - When -x (--one-file-system) is combined with -L (--copy-links) or
718       --copy-unsafe-links, no symlinked files are skipped, even if the
719       referent file is on a different filesystem.
720
721     - The --link-dest code now works properly for a non-root user when
722       (1) the UIDs of the source and destination differ and -o was
723       specified, or (2) when the group of the source can't be used on
724       the destination and -g was specified.
725
726     - Fixed a bug in the handling of -H (hard-links) that might cause
727       the expanded PATH/NAME value of the current item to get
728       overwritten (due to an expanded-name caching bug).
729       
730     - We now reset the "new data has been sent" flag at the start of
731       each file we send.  This makes sure that an interrupted transfer
732       with the --partial option set doesn't keep a shorter temp file
733       than the current basis file when no new data has been transfered
734       over the wire for that file.
735
736     - Fixed a byte-order problem in --batch-mode on big-endian machines.
737       (Jay Fenlason)
738
739     - When using --cvs-exclude, the exclude items we get from a
740       per-directory's .cvsignore file once again only affect that one
741       directory (not all following directories too).  The items are also
742       now properly word-split and parsed without any +/- prefix parsing.
743
744     - When specifying the USER@HOST: prefix for a file, the USER part
745       can now contain an '@', if needed (i.e. the last '@' is used to
746       find the HOST, not the first).
747
748     - Fixed some bugs in the handling of group IDs for non-root users:
749       (1) It properly handles a group that the sender didn't have a name
750       for (it would previously skip changing the group on any files in
751       that group).  (2) If --numeric-ids is used, rsync no longer
752       attempts to set groups that the user doesn't have the permission
753       to set.
754
755     - Fixed the "refuse options" setting in the rsyncd.conf file.
756
757     - Improved the -x (--one-file-system) flag's handling of any mount-
758       point directories we encounter.  It is both more optimal (in that
759       it no longer does a useless scan of the contents of the mount-
760       point dirs) and also fixes a bug where a remapped mount of the
761       original filesystem could get discovered in a subdir we should be
762       ignoring.
763
764     - Rsync no longer discards a double-slash at the start of a filename
765       when trying to open the file.  It also no longer constructs names
766       that start with a double slash (unless the user supplied them).
767
768     - Path-specifying options to a daemon should now work the same with
769       or without chroot turned on.  Previously, such a option (such as
770       --link-dest) would get its absolute path munged into a relative
771       one if chroot was not on, making that setting fairly useless.
772       Rsync now transforms the path into one that is based on the
773       module's base dir when chroot is not enabled.
774
775     - Fixed a compatibility problem interacting with older rsync
776       versions that might send us an empty --suffix value without
777       telling us that --backup-dir was specified.
778
779     - The "hosts allow" option for a daemon-over-remote-shell process
780       now has improved support for IPv6 addresses and a fix for systems
781       that have a length field in their socket structs.
782
783     - Fixed the ability to request an empty backup --suffix when sending
784       files to an rsync daemon.
785
786   INTERNAL:
787
788     - Most of the I/O is now buffered, which results in a pretty large
789       speedup when running under MS Windows.  (Craig Barratt)
790
791     - Optimizations to the name-handling/comparing code have made some
792       significant reductions in user-CPU time for large file sets.
793
794     - Some cleanup of the variable types make the code more consistent.
795
796     - Reduced memory requirements of hard link preservation.
797       (J.W. Schultz)
798
799     - Implemented a new algorithm for hard-link handling that speeds up
800       the code significantly.  (J.W. Schultz and Wayne Davison)
801
802     - The --hard-link option now uses the first existing file in the
803       group of linked files as the basis for the transfer.  This
804       prevents the sub-optimal transfer of a file's data when a new
805       hardlink is added on the sending side and it sorts alphabetically
806       earlier in the list than the files that are already present on the
807       receiving side.
808
809     - Dropped support for protocol versions less than 20 (2.3.0 released
810       15 Mar 1999) and activated warnings for protocols less than 25
811       (2.5.0 released 23 Aug 2001). (Wayne Davison and J.W. Schultz,
812       severally)
813
814     - More optimal data transmission for --hard-links (protocol 28).
815
816     - More optimal data transmission for --checksum (protocol 28).
817
818     - Less memory is used when --checksum is specified.
819
820     - Less memory is used in the file list (a per-file savings).
821
822     - The generator is now better about not modifying the file list
823       during the transfer in order to avoid a copy-on-write memory
824       bifurcation (on systems where fork() uses shared memory).
825       Previously, rsync's shared memory would slowly become unshared,
826       resulting in real memory usage nearly doubling on the receiving
827       side by the end of the transfer.  Now, as long as permissions
828       are being preserved, the shared memory should remain that way
829       for the entire transfer.
830
831     - Changed hardlink info and file_struct + strings to use allocation
832       pools.  This reduces memory use for large file-sets and permits
833       freeing memory to the OS.  (J.W. Schultz) 
834
835     - The 2 pipes used between the receiver and generator processes
836       (which are forked on the same machine) were reduced to 1 pipe and
837       the protocol improved so that (1) it is now impossible to have the
838       "redo" pipe fill up and hang rsync, and (2) trailing messages from
839       the receiver don't get lost on their way through the generator
840       over to the sender (which mainly affected hard-link messages and
841       verbose --stats output).
842
843     - Improved the internal uid/gid code to be more portable and a
844       little more optimized.
845
846     - The device numbers sent when using --devices are now sent as
847       separate major/minor values with 32-bit accuracy (protocol 28).
848       Previously, the copied devices were sent as a single 32-bit
849       number.  This will make inter-operation of 64-bit binaries more
850       compatible with their 32-bit brethren (with both ends of the
851       connection are using protocol 28).  Note that optimizations in the
852       binary protocol for sending the device numbers often results in
853       fewer bytes being used than before, even though more precision is
854       now available.
855
856     - Some cleanup of the exclude/include structures and its code made
857       things clearer (internally), simpler, and more efficient.
858
859     - The reading & writing of the file-list in batch-mode is now
860       handled by the same code that sends & receives the list over the
861       wire.  This makes it much easier to maintain.  (Note that the
862       batch code is still considered to be experimental.)
863
864   BUILD CHANGES:
865
866     - The configure script now accepts --with-rsyncd-conf=PATH to
867       override the default value of the /etc/rsyncd.conf file.
868
869     - Fixed configure bug when running "./configure --disable-ipv6".
870
871     - Fixed compilation problem on Tru64 Unix (having to do with
872       sockaddr.sa_len and sockaddr.sin_len).
873
874   DEVELOPER RELATED:
875
876     - Fixed "make test" bug when build dir is not the source dir.
877
878     - Added a couple extra diffs in the "patches" dir, removed the ones
879       that got applied, and rebuilt the rest.
880
881 \f
882 NEWS for rsync 2.6.0 (1 Jan 2004)
883 Protocol: 27 (changed)
884 Changes since 2.5.7:
885
886   ENHANCEMENTS:
887
888     * "ssh" is now the default remote shell for rsync.  If you want to
889       change this, configure like this:  "./configure --with-rsh=rsh".
890
891     * Added --files-from, --no-relative, --no-implied-dirs, and --from0.
892       Note that --from0 affects the line-ending character for all the
893       files read by the --*-from options. (Wayne Davison)
894
895     * Length of csum2 is now per-file starting with protocol version
896       27. (J.W. Schultz)
897
898     * Per-file dynamic block size is now sqrt(file length).  The
899       per-file checksum size is determined according to an algorithm
900       provided by Donovan Baarda which reduces the probability of rsync
901       algorithm corrupting data and falling back using the whole md4
902       checksums. (J.W. Schultz, Donovan Baarda)
903
904     * The --stats option no longer includes the (debug) malloc summary
905       unless the verbose option was specified at least twice.
906
907     * Added a new error/warning code for when files vanish from the
908       sending side.  Made vanished source files not interfere with the
909       file-deletion pass when --delete-after was specified.
910
911     * Various trailing-info sections are now preceded by a newline.
912
913   BUG FIXES:
914
915     * Fixed several exclude/include matching bugs when using wild-cards.
916       This has a several user-visible effects, all of which make the
917       matching more consistent and intuitive.  This should hopefully not
918       cause anyone problems since it makes the matching work more like
919       what people are expecting. (Wayne Davison)
920
921       - A pattern with a "**" no longer causes a "*" to match slashes.
922         For example, with "/*/foo/**", "foo" must be 2 levels deep.
923         [If your string has BOTH "*" and "**" wildcards, changing the
924         "*" wildcards to "**" will provide the old behavior in all
925         versions.]
926
927       - "**/foo" now matches at the base of the transfer (like /foo
928         does).  [Use "/**/foo" to get the old behavior in all versions.]
929
930       - A non-anchored wildcard term floats to match beyond the base of
931         the transfer.  E.g. "CVS/R*" matches at the end of the path,
932         just like the non-wildcard term "CVS/Root" does. [Use "/CVS/R*"
933         to get the old behavior in all versions.]
934
935       - Including a "**" in the match term causes it to be matched
936         against the entire path, not just the name portion, even if
937         there aren't any interior slashes in the term.  E.g. "foo**bar"
938         would exclude "/path/foo-bar" (just like before) as well as
939         "/foo-path/baz-bar" (unlike before).  [Use "foo*bar" to get the
940         old behavior in all versions.]
941
942     * The exclude list specified in the daemon's config file is now
943       properly applied to the pulled items no matter how deep the
944       user's file-args are in the source tree.  (Wayne Davison)
945
946     * For protocol version >= 27, mdfour_tail() is called when the
947       block size (including checksum_seed) is a multiple of 64.
948       Previously it was not called, giving the wrong MD4 checksum.
949       (Craig Barratt)
950
951     * For protocol version >= 27, a 64 bit bit counter is used in
952       mdfour.c as required by the RFC.  Previously only a 32 bit bit
953       counter was used, causing incorrect MD4 file checksums for
954       file sizes >= 512MB - 4.  (Craig Barratt)
955
956     * Fixed a crash bug when interacting with older rsync versions and
957       multiple files of the same name are destined for the same dir.
958       (Wayne Davison)
959
960     * Keep tmp names from overflowing MAXPATHLEN.
961
962     * Make --link-dest honor the absence of -p, -o, and -g.
963
964     * Made rsync treat a trailing slash in the destination in a more
965       consistent manner.
966
967     * Fixed file I/O error detection.  (John Van Essen)
968
969     * Fixed bogus "malformed address {hostname}" message in rsyncd log
970       when checking IP address against hostnames from "hosts allow"
971       and "hosts deny" parameters in config file.
972
973     * Print heap statistics when verbose >= 2 instead of when >= 1.
974
975     * Fixed a compression (-z) bug when syncing a mostly-matching file
976       that contains already-compressed data.  (Yasuoka Masahiko and
977       Wayne Davison)
978
979     * Fixed a bug in the --backup code that could cause deleted files
980       to not get backed up.
981
982     * When the backup code makes new directories, create them with mode
983       0700 instead of 0755 (since the directory permissions in the
984       backup tree are not yet copied from the main tree).
985
986     * Call setgroups() in a more portable manner.
987
988     * Improved file-related error messages to better indicate exactly
989       what pathname failed. (Wayne Davison)
990
991     * Fixed some bugs in the handling of --delete and --exclude when
992       using the --relative (-R) option. (Wayne Davison)
993
994     * Fixed bug that prevented regular files from replacing
995       special files and caused a directory in --link-dest or
996       --compare-dest to block the creation of a file with the
997       same path.  A directory still cannot be replaced by a
998       regular file unless --delete specified.  (J.W. Schultz)
999
1000     * Detect and report when open or opendir succeed but read and
1001       readdir fail caused by network filesystem issues and truncated
1002       files.  (David Norwood, Michael Brown, J.W. Schultz)
1003
1004     * Added a fix that should give ssh time to restore the tty settings
1005       if the user presses Ctrl-C at an ssh password prompt.
1006
1007   INTERNAL:
1008
1009     * Eliminated vestigial support for old versions that we stopped
1010       supporting. (J.W. Schultz)
1011
1012     * Simplified some of the option-parsing code. (Wayne Davison)
1013
1014     * Some cleanup made to the exclude code, as well as some new
1015       defines added to enhance readability. (Wayne Davison)
1016
1017     * Changed the protocol-version code so that it can interact at a
1018       lower protocol level than the maximum supported by both sides.
1019       Added an undocumented option, --protocol=N, to force the value
1020       we advertise to the other side (primarily for testing purposes).
1021       (Wayne Davison)
1022
1023 \f
1024 NEWS for rsync 2.5.7 (4 Dec 2003)
1025 Protocol: 26 (unchanged)
1026 Changes since 2.5.6:
1027
1028   SECURITY FIXES:
1029
1030     * Fix buffer handling bugs.  (Andrew Tridgell, Martin Pool, Paul
1031       Russell, Andrea Barisani)
1032
1033 \f
1034 NEWS for rsync 2.5.6, aka "the dwd-between-jobs release" (26 Jan 2003)
1035 Protocol: 26 (unchanged)
1036 Changes since 2.5.5:
1037
1038   ENHANCEMENTS:
1039
1040     * The --delete-after option now implies --delete.  (Wayne Davison)
1041
1042     * The --suffix option can now be used with --backup-dir.  (Michael
1043       Zimmerman)
1044
1045     * Combining "::" syntax with the -rsh/-e option now uses the
1046       specified remote-shell as a transport to talk to a (newly-spawned)
1047       server-daemon.  This allows someone to use daemon features, such
1048       as modules, over a secure protocol, such as ssh.  (JD Paul)
1049
1050     * The rsync:// syntax for daemon connections is now accepted in the
1051       destination field.
1052
1053     * If the file name given to --include-from or --exclude-from is "-",
1054       rsync will read from standard input.  (J.W. Schultz)
1055
1056     * New option --link-dest which is like --compare-dest except that
1057       unchanged files are hard-linked in to the destination directory.
1058       (J.W. Schultz)
1059
1060     * Don't report an error if an excluded file disappears during an
1061       rsync run.  (Eugene Chupriyanov and Bo Kersey)
1062
1063     * Added .svn to --cvs-exclude list to support subversion.  (Jon
1064       Middleton)
1065
1066     * Properly support IPv6 addresses in the rsyncd.conf "hosts allow"
1067       and "hosts deny" fields.  (Hideaki Yoshifuji)
1068
1069     * Changed exclude file handling to permit DOS or MAC style line
1070       terminations.  (J.W. Schultz)
1071
1072     * Ignore errors from chmod when -p/-a/--preserve-perms is not set.
1073       (Dave Dykstra)
1074
1075   BUG FIXES:
1076
1077     * Fix "forward name lookup failed" errors on AIX 4.3.3.  (John
1078       L. Allen, Martin Pool)
1079
1080     * Generate each file's rolling-checksum data as we send it, not
1081       in a separate (memory-eating) pass before hand.  This prevents
1082       timeout errors on really large files. (Stefan Nehlsen)
1083
1084     * Fix compilation on Tru64.  (Albert Chin, Zoong Pham)
1085
1086     * Better handling of some client-server errors.  (Martin Pool)
1087
1088     * Fixed a crash that would occur when sending a list of files that
1089       contains a duplicate name (if it sorts to the end of the file
1090       list) and using --delete.  (Wayne Davison)
1091
1092     * Fixed the file-name duplicate-removal code when dealing with multiple
1093       dups in a row. (Wayne Davison)
1094
1095     * Fixed a bug that caused rsync to lose the exit status of its child
1096       processes and sometimes return an exit code of 0 instead of showing
1097       an error.  (David R. Staples, Dave Dykstra)
1098
1099     * Fixed bug in --copy-unsafe-links that caused it to be completely
1100       broken.  (Dave Dykstra)
1101
1102     * Prevent infinite recursion in cleanup code under certain circumstances.
1103       (Sviatoslav Sviridov and Marc Espie)
1104
1105     * Fixed a bug that prevented rsync from creating intervening directories
1106       when --relative-paths/-R is set.  (Craig Barratt)
1107
1108     * Prevent "Connection reset by peer" messages from Cygwin. (Randy O'Meara)
1109
1110   INTERNAL:
1111
1112     * Many code cleanups and improved internal documentation.  (Martin
1113       Pool, Nelson Beebe)
1114
1115     * Portability fixes. (Dave Dykstra and Wayne Davison)
1116
1117     * More test cases.  (Martin Pool)
1118
1119     * Some test-case fixes.  (Brian Poole, Wayne Davison)
1120
1121     * Updated included popt to the latest vendor drop, version 1.6.4.
1122       (Jos Backus)
1123
1124     * Updated config.guess and config.sub to latest versions; this
1125       means rsync should build on more platforms.  (Paul Green)
1126
1127 \f
1128 NEWS for rsync 2.5.5, aka Snowy River (2 Apr 2002)
1129 Protocol: 26 (unchanged)
1130 Changes since 2.5.4:
1131
1132   ENHANCEMENTS:
1133
1134     * With --progress, when a transfer is complete show the time taken;
1135       otherwise show expected time to complete. (Cameron Simpson)
1136
1137     * Make "make install-strip" works properly, and "make install"
1138       accepts a DESTDIR variable for help in building binary packages.
1139       (Peter Breitenlohner, Greg Louis)
1140
1141     * If configured with --enable-maintainer-mode, then on receipt of
1142       a fatal signal rsync will try to open an xterm running gdb,
1143       similarly to Samba's "panic action" or GNOME's bug-buddy.
1144       (Martin Pool)
1145
1146
1147   BUG FIXES:
1148
1149     * Fix situation where failure to fork (e.g. because out of process
1150       slots) would cause rsync to kill all processes owned by the
1151       current user.  Yes, really!  (Paul Haas, Martin Pool)
1152
1153     * Fix test suite on Solaris.  (Jos Backus, Martin Pool)
1154
1155     * Fix minor memory leak in socket code.  (Dave Dykstra, Martin
1156       Pool.)
1157
1158     * Fix --whole-file problem that caused it to be the default even
1159       for remote connections.  (Martin Pool, Frank Schulz)
1160
1161     * Work around bug in Mac OS X mkdir(2), which cannot handle
1162       trailing slashes.
1163       <http://www.opensource.apple.com/bugs/X/BSD%20Kernel/2734739.html>
1164       (Martin Pool)
1165
1166     * Improved network error handling.  (Greg A. Woods)
1167
1168 \f
1169 NEWS for rsync 2.5.4, aka "Imitation lizard skin" (13 Mar 2002)
1170 Protocol: 26 (unchanged)
1171 Changes since 2.5.3:
1172
1173   BUG FIXES:
1174
1175     * Additional fix for zlib double-free bug.  (Martin Pool, Andrew
1176       Tridgell) (CVE CAN-2002-0059)
1177
1178   ENHANCEMENTS:
1179
1180     * Merge in changes from zlib 1.1.3 to zlib 1.1.4.  (Jos Backus)
1181       (Note that rsync still uses a custom version of zlib; you can
1182       not just link against a system library.  See zlib/README.rsync)
1183
1184     * Additional test cases for --compress.  (Martin Pool)
1185
1186 \f
1187 NEWS for rsync 2.5.3, aka "Happy 26" (11 Mar 2002)
1188 Protocol: 26 (unchanged)
1189 Changes since 2.5.2:
1190
1191   SECURITY FIXES:
1192
1193     * Make sure that supplementary groups are removed from a server
1194       process after changing uid and gid. (Ethan Benson) (Debian bug
1195       #132272, CVE CAN-2002-0080)
1196
1197   BUG FIXES:
1198
1199     * Fix zlib double-free bug.  (Owen Taylor, Mark J Cox) (CVE
1200       CAN-2002-0059)
1201
1202     * Fixed problem that in many cases caused the error message
1203         unexpected read size of 0 in map_ptr
1204       and resulted in the wrong data being copied.
1205
1206     * Fixed compilation errors on some systems caused by the use of
1207       "unsigned int64" in rsync.h.
1208
1209     * Fixed problem on systems such as Sunos4 that do not support realloc
1210       on a NULL pointer; error was "out of memory in flist_expand".
1211
1212     * Fix for rsync server processes hanging around after the client
1213       unexpectedly disconnects.  (Colin Walters) (Debian bug #128632)
1214
1215     * Cope with BSD systems on which mkdir() will not accept a trailing
1216       slash.
1217
1218   ENHANCEMENTS:
1219
1220     * Merge in changes from zlib 1.1.2 to zlib 1.1.3.  (Note that
1221       rsync still uses a custom version of zlib; you can not just link
1222       against a system library.  See zlib/README.rsync)
1223
1224     * Command to initiate connections is only shown with -vv, rather
1225       than -v as in 2.5.2.  Output from plain -v is more similar to
1226       what was historically used so as not to break scripts that try
1227       to parse the output.
1228
1229     * Added --no-whole-file and --no-blocking-io options (Dave Dykstra)
1230
1231     * Made the --write-batch and --read-batch options actually work
1232       and added documentation in the man page (Jos Backus)
1233
1234     * If the daemon is unable to fork a child to accept a connection,
1235       print an error message.  (Colin Walters)
1236
1237 \f
1238 NEWS for rsync 2.5.2 (26 Jan 2002)
1239 Protocol: 26 (changed)
1240 Changes since 2.5.1:
1241
1242   SECURITY FIXES:
1243
1244     * Signedness security patch from Sebastian Krahmer
1245       <krahmer@suse.de> -- in some cases we were not sufficiently
1246       careful about reading integers from the network.
1247
1248   BUG FIXES:
1249
1250     * Fix possible string mangling in log files.
1251
1252     * Fix for setting local address of outgoing sockets.
1253
1254     * Better handling of hardlinks and devices on platforms with
1255       64-bit dev_t or ino_t.
1256
1257     * Name resolution on machines supporting IPv6 is improved.
1258
1259     * Fix for device nodes.  (dann frazier)   (Debian #129135)
1260
1261   ENHANCEMENTS:
1262
1263     * With -v, rsync now shows the command used to initiate an ssh/rsh
1264       connection.
1265
1266     * --statistics now shows memory heap usage on platforms that
1267       support mallinfo().
1268
1269     * "The Ted T'so school of program optimization": make progress
1270       visible and people will think it's faster.  (With --progress,
1271       rsync will show you how many files it has seen as it builds the
1272       file_list, giving some indication that it has not hung.)
1273
1274     * Improvements to batch mode support.  This is still experimental
1275       but testing would be welcome.   (Jos Backus)
1276
1277     * New --ignore-existing option, patch previously distributed with
1278       Vipul's Razor.  (Debian #124286)
1279
1280 \f
1281 NEWS for rsync 2.5.1 (3 Jan 2002)
1282 Protocol: 25 (unchanged)
1283 Changes since 2.5.0:
1284
1285   BUG FIXES:
1286
1287     * Fix for segfault in --daemon mode configuration parser.  (Paul
1288       Mackerras)
1289
1290     * Correct string<->address parsing for both IPv4 and 6.
1291       (YOSHIFUJI Hideaki, SUMIKAWA Munechika and Jun-ichiro "itojun"
1292       Hagino)
1293
1294     * Various fixes for IPv6 support.  (Dave Dykstra)
1295
1296     * rsync.1 typo fix.  (Matt Kraai)
1297
1298     * Test suite typo fixes.  (Tom Schmidt)
1299
1300     * rsync.1 grammar and clarity improvements.  (Edward
1301       Welbourne)
1302
1303     * Correction to ./configure tests for inet_ntop.  (Jeff Garzik)
1304
1305   ENHANCEMENTS:
1306
1307     * --progress and -P now show estimated data transfer rate (in a
1308       multiple of bytes/s) and estimated time to completion.  (Rik
1309       Faith)
1310
1311     * --no-detach option, required to run as a W32 service and also
1312       useful when running on Unix under daemontools, AIX's SRC, or a
1313       debugger.  (Max Bowsher, Jos Backus)
1314
1315     * Clearer error messages for some conditions.
1316
1317 \f
1318 NEWS for rsync 2.5.0 (30 Nov 2001)
1319 Protocol: 25 (changed)
1320 Changes since 2.4.6:
1321
1322   ANNOUNCEMENTS
1323
1324     * Martin Pool <mbp@samba.org> is now a co-maintainer.
1325
1326   NEW FEATURES
1327
1328     * Support for LSB-compliant packaging <http://www.linuxbase.org/>
1329
1330     * Shell wildcards are allowed in "auth users" lines.
1331
1332     * Merged UNC rsync+ patch to support creation of standalone patch
1333       sets.  By Bert J. Dempsey and Debra Weiss, updated by Jos
1334       Backus.  <http://www.ils.unc.edu/i2dsi/unc_rsync+.html>
1335
1336     * IPv6 support based on a patch from KAME.net, on systems
1337       including modern versions of Linux, Solaris, and HP-UX.  Also
1338       includes IPv6 compatibility functions for old OSs by the
1339       Internet Software Consortium, Paul Vixie, the OpenSSH
1340       portability project, and OpenBSD.
1341
1342   ENHANCEMENTS
1343
1344     * Include/exclude cluestick: with -vv, print out whether files are
1345       included or excluded and why.
1346
1347     * Many error messages have more friendly explanations and more
1348       details.
1349
1350     * Manual page improvements plus scanty protocol documentation.
1351
1352     * When running as --daemon in the background and using a "log
1353       file" rsyncd.conf directive, close the log file every time it is
1354       open when going to sleep on the socket.  This allows the log
1355       file to get cleaned out by another process.
1356
1357     * Change to using libpopt rather than getopt for processing
1358       options.  This makes the code cleaner and the behaviour more
1359       consistent across platforms.  popt is included and built if not
1360       installed on the platform.
1361
1362     * More details in --version, including note about whether 64-bit
1363       files, symlinks and hardlinks are supported.
1364
1365     * MD4 code may use less CPU cycles.
1366
1367     * Use mkstemp on systems where it is secure.  If we use mktemp,
1368       explain that we do it in a secure way.
1369
1370     * --whole-file is the default when source and target are on the
1371         local machine.
1372
1373   BUG FIXES:
1374
1375     * Fix for various bugs causing rsync to hang.
1376
1377     * Attempt to fix Large File Summit support on AIX.
1378
1379     * Attempt to fix error handling lockup bug.
1380
1381     * Give a non-0 exit code if *any* of the files we have been asked
1382       to transfer fail to transfer.
1383
1384     * For log messages containing ridiculously long strings that might
1385       overflow a buffer rsync no longer aborts, but rather prints an
1386       ellipsis at the end of the string.  (Patch from Ed Santiago.)
1387
1388   PLATFORMS:
1389
1390     * Improved support for UNICOS (tested on Cray T3E and Cray SV1)
1391
1392     * autoconf2.52 (or later) is now required to rebuild the autoconf
1393       scripts.  It is not required to simply build rsync.
1394
1395     * Platforms thought to work in this release:
1396
1397                 Cray SV1 UNICOS 10.0.0.8 cc
1398                 Debian Linux 2.2 UltraSparc gcc
1399                 Debian Linux testing/unstable ARM gcc
1400                 FreeBSD 3.3-RELEASE i386 cc
1401                 FreeBSD 4.1.1-RELEASE i386 cc
1402                 FreeBSD 4.3-STABLE i386 cc
1403                 HP PA-RISC HP-UX 10.20 gcc
1404                 HP PA-RISC HP-UX 11.11 cc
1405                 IRIX 6.5 MIPS cc
1406                 IRIX 6.5 MIPS gcc
1407                 Mac OS X PPC (--disable-ipv6) cc
1408                 NetBSD 1.5 i386 gcc
1409                 NetBSD Current i386 cc
1410                 OpenBSD 2.5 Sparc gcc
1411                 OpenBSD 2.9 i386 cc
1412                 OpenBSD Current i386 cc
1413                 RedHat 6.2 i386 gcc
1414                 RedHat 6.2 i386 insure++
1415                 RedHat 7.0 i386 gcc
1416                 RedHat 7.1 i386 (Kernel 2.4.10) gcc
1417                 Slackware 8.0 i686 (Kernel 2.4.10)
1418                 Solaris 8 UltraSparc cc
1419                 Solaris 8 UltraSparc gcc
1420                 Solaris 8 i386 gcc
1421                 SuSE 7.1 i386 gcc2.95.2
1422                 SuSE 7.1 ppc gcc2.95.2
1423                 i386-pc-sco3.2v5.0.5 cc
1424                 i386-pc-sco3.2v5.0.5 gcc
1425                 powerpc-ibm-aix4.3.3.0 cc
1426                 i686-unknown-sysv5UnixWare7.1.0 gcc
1427                 i686-unknown-sysv5UnixWare7.1.0 cc
1428
1429   TESTING:
1430
1431     * The existing test.sh script by Phil Hands has been merged into a
1432       test framework that works from both "make check" and the Samba
1433       build farm.
1434 \f
1435 Partial Protocol History
1436         RELEASE DATE    VER.    DATE OF COMMIT* PROTOCOL
1437         ?? May 2005     2.6.5                   29
1438         30 Mar 2005     2.6.4   17 Jan 2005     29
1439         30 Sep 2004     2.6.3                   28
1440         30 Apr 2004     2.6.2                   28
1441         26 Apr 2004     2.6.1   08 Jan 2004     28
1442         01 Jan 2004     2.6.0   10 Apr 2003     27 (MAX=40)
1443         04 Dec 2003     2.5.7                   26
1444         26 Jan 2003     2.5.6                   26
1445         02 Apr 2002     2.5.5                   26
1446         13 Mar 2002     2.5.4                   26
1447         11 Mar 2002     2.5.3                   26
1448         26 Jan 2002     2.5.2   11 Jan 2002     26
1449         03 Jan 2002     2.5.1                   25
1450         30 Nov 2001     2.5.0   23 Aug 2001     25
1451         06 Sep 2000     2.4.6                   24
1452         19 Aug 2000     2.4.5                   24
1453         29 Jul 2000     2.4.4                   24
1454         09 Apr 2000     2.4.3                   24
1455         30 Mar 2000     2.4.2                   24
1456         30 Jan 2000     2.4.1   29 Jan 2000     24
1457         29 Jan 2000     2.4.0   28 Jan 2000     23
1458         25 Jan 2000     2.3.3   23 Jan 2000     22
1459         08 Nov 1999     2.3.2   26 Jun 1999     21
1460         06 Apr 1999     2.3.1                   20
1461         15 Mar 1999     2.3.0   15 Mar 1999     20
1462         25 Nov 1998     2.2.1                   19
1463         03 Nov 1998     2.2.0                   19
1464         09 Sep 1998     2.1.1                   19
1465         20 Jul 1998     2.1.0                   19
1466         17 Jul 1998     2.0.19                  19
1467         18 Jun 1998     2.0.17                  19
1468         01 Jun 1998     2.0.16                  19
1469         27 May 1998     2.0.13  27 May 1998     19
1470         26 May 1998     2.0.12                  18
1471         22 May 1998     2.0.11                  18
1472         18 May 1998     2.0.9   18 May 1998     18
1473         17 May 1998     2.0.8                   17
1474         15 May 1998     2.0.1                   17
1475         14 May 1998     2.0.0                   17
1476         17 Apr 1998     1.7.4                   17
1477         13 Apr 1998     1.7.3                   17
1478         05 Apr 1998     1.7.2                   17
1479         26 Mar 1998     1.7.1                   17
1480         26 Mar 1998     1.7.0   26 Mar 1998     17 (MAX=30)
1481         13 Jan 1998     1.6.9   13 Jan 1998     15 (MAX=20)
1482
1483 * DATE OF COMMIT is the date the protocol change was committed to CVS.