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