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