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