-NEWS for rsync 2.6.1 (UNRELEASED)
-Protocol: 27 (unchanged)
-Changes since 2.6.0:
+NEWS for rsync 2.6.3 (UNRELEASED)
+Protocol: 28 (unchanged)
+Changes since 2.6.2:
- ENHANCEMENTS:
-
- * Lower memory use and more optimal transfer of data over
- the socket (see the INTERNAL section for details).
+ OUTPUT CHANGES (ATTN: those using a script to parse the verbose output):
- * The RSYNC_PROXY environment variable can now contain a
- "USER:PASS@" prefix before the "HOST:PORT" information.
- (Bardur Arantsson)
+ - Please note that the 2-line footer (output when verbose) now uses the
+ term "sent" instead of "wrote" and "received" instead of "read". If
+ you are not parsing the numeric values out of this footer, a script
+ should be better off using the empty line prior to the footer as the
+ indicator that the verbose output is over.
+
+ - The output from the --stats option was similarly affected to change
+ "written" to "sent" and "read" to "received".
- * The --progress output now mentions how far along in the
- transfer we are, including both a count of files transferred
- and a percentage of the total file-count that we're processed.
+ - Made sure that a filename that contains a newline gets mentioned with
+ each newline transformed into a question mark (which makes sure that
+ a filename can't span multiple lines nor cause an empty line to be
+ output).
BUG FIXES:
- * The --link-dest code now works properly for a non-root user
- when the UIDs of the source and destination differ and -u was
- specified, and when the group of the source can't be used on
- the destination and -g was specified. (Wayne Davison)
+ - Fixed a crash bug that might appear when --delete was used and
+ multiple source directories were specified.
- * Fixed a bug in the handling of -H (hard-links) that might
- cause the expanded PATH/NAME value of the current item to
- get overwritten (due to an expanded-name caching bug).
- (Wayne Davison)
-
- * Keep per-file track of the sending of literal data with
- --partial so that an interrupted transfer doesn't keep a
- shorter temp file when no new data has been transfered over
- the wire. (Wayne Davison)
-
- * Fixed a byte-order problem in --batch-mode on big-endian
- machines. (Jay Fenlason)
+ - Fixed the 32-bit truncation of the file length when generating the
+ checksums.
- * Fixed configure bug when running "./configure --disable-ipv6".
- (Wayne Davison)
+ - The --backup code no longer attempts to create some directories
+ over and over again (generating warnings along the way).
- * Fixed "make test" bug when build dir is not the source dir.
+ - Fixed a bug in the reading of the secrets file (by the daemon) and
+ the password file (by the client): the files no longer need to be
+ terminated by a newline for their content to be read in.
- * When using --cvs-exclude, the exclude items we get from a
- directory's .cvsignore file once again only affect that one
- directory (and not all following directories too).
+ - If a file has a read error on the sending side or the reconstructed
+ data doesn't match the expected checksum (perhaps due to the basis
+ file changing during the transfer), the receiver will no longer
+ retain the resulting file unless the --partial option was specified.
+ (Note: for the read-error detection to work, neither side can be
+ older than 2.6.3 -- older receivers will always retain the file, and
+ older senders don't tell the receiver that the file had a read
+ error.)
- * When transferring a file that has group 0 with -g specified
- (typically via -a) and not enough privs to retain the group,
- rsync no longer complains about chown failing.
+ - If a file gets resent in a single transfer and the --backup option
+ is enabled, rsync no longer performs a duplicate backup (losing the
+ original file in the process).
- * When specifying the USER@HOST: prefix for a file, the USER
- part can now contain an '@', if needed (i.e. the last '@'
- is used to find the HOST, not the first).
+ - Fixed an age-old crash problem with --read-batch on a local copy
+ (rsync was improperly assuming --whole-file for the local copy).
- INTERNAL:
+ - Files specified in the daemon's "exclude" or "exclude from" config
+ items are now excluded from being uploaded (assuming that the module
+ allows uploading at all) in addition to the old download exclusion.
- * Most of the I/O is now buffered, which results in a pretty
- large speedup when running under MS Windows. (Craig Barratt)
+ - Got rid of a potential hang in the receiver when near the end of a
+ phase.
- * Optimizations to the name-handling/comparing code have made
- some significant reductions in user-CPU time for large file
- sets. (Wayne Davison)
+ - When using --backup without a --backup-dir, rsync no longer preserves
+ the modify time on directories. This avoids confusing NFS.
- * Some variable-type cleanup that makes the code more consistent.
- (Wayne Davison)
+ - When --copy-links (-L) is specified, we now output a separate error
+ for a symlink that has no referent instead of claiming that a file
+ "vanished".
- * Reduced memory requirements of hard link preservation.
- (J.W. Schultz)
+ - The --copy-links (-L) option no longer has the side-effect of telling
+ the receiving side to follow symlinks. See the --keep-dirlinks
+ option (mentioned below) for a way to specify that behavior.
- * Implemented a new algorithm for hard-link handling that speeds
- up the code significantly. (J.W. Schultz and Wayne Davison)
+ - Error messages from the daemon server's option-parsing (such as
+ refused options) now get sent back to the client (the server used
+ to just exit because the socket wasn't in the right state to send
+ the message).
- * The --hard-link option now uses the first existing file in the
- group of linked files as the basis for the transfer. This
- prevents the sub-optimal transfer of a file's data when a new
- hardlink is added on the sending side and it sorts alphabetically
- earlier in the list than the files that are already present on the
- receiving side.
+ - Most errors that occur during a daemon transfer are now returned to
+ the user in addition to being logged (some messages are intended to
+ be daemon-only).
- * Got rid of support for protocol versions 17 and 18 (which are
- both over 6 years old). (Wayne Davison)
+ - Fixed a bug in the daemon authentication code when using one of the
+ batch-processing options.
- * More optimal data transmission for --hard-links (protocol 28).
+ - We try to work around some buggy IPv6 implementations that fail to
+ implement IPV6_V6ONLY. This should fix the "address in use" error
+ that some daemons get when running on an OS with a buggy IPv6
+ implementation. Also, if the new code gets this error, we might
+ suggest that the user specify --ipv4 or --ipv6 (if we think it will
+ help).
- * More optimal data transmission for --checksum (protocol 28).
+ - When the remote rsync dies, make a better effort to recover any error
+ messages it may have sent before dying (the local rsync used to just
+ die with a socket-write error).
- * Less memory is used when --checksum is specified.
+ - When using --delete and a --backup-dir that contains files that are
+ hard-linked to their destination equivalents, rsync now makes sure
+ that removed files really get removed (works around a really weird
+ rename() behavior).
- * Less memory is used in the file list (a per-file savings).
+ - Avoid a bogus run-time complaint about a lack of 64-bit integers when
+ the int64 type is defined as an off_t and it actually has 64-bits.
- * The 2 pipes used between the receiver and generator processes
- (which are forked on the same machine) were reduced to 1 pipe
- and the protocol improved so that (1) it is now impossible to
- have the "redo" pipe fill up and hang rsync, and (2) trailing
- messages from the receiver don't get lost on their way through
- the generator over to the sender (the latter mainly affected
- hard-link messages). (Wayne Davison)
-
- * The reading & writing of the file list in batch-mode is now
- handled by the same code that sends & receives the list over
- the wire. This makes it much easier to maintain.
-
-\f
-NEWS for rsync 2.6.0 (1 Jan 2004)
-Protocol: 27 (changed)
-Changes since 2.5.7:
+ - Added a configure check for open64() without mkstemp64() so that we
+ can avoid using mkstemp() when such a combination is encountered.
+ This bypasses a problem writing out large temp files on OSes such as
+ AIX and HP-UX.
ENHANCEMENTS:
- * "ssh" is now the default remote shell for rsync. If you want to
- change this, configure like this: "./configure --with-rsh=rsh".
-
- * Added --files-from, --no-relative, --no-implied-dirs, and --from0.
- Note that --from0 affects the line-ending character for all the
- files read by the --*-from options. (Wayne Davison)
+ - Added the --partial-dir=DIR option that lets you specify where to
+ (temporarily) put a partially transferred file (instead of over-
+ writing the destination file). E.g. --partial-dir=.rsync-partial
- * Length of csum2 is now per-file starting with protocol version
- 27. (J.W. Schultz)
+ - Added --keep-dirlinks (-K), which allows you to symlink a directory
+ onto another partition on the receiving side and have rsync treat it
+ as matching a normal directory from the sender.
- * Per-file dynamic block size is now sqrt(file length). The
- per-file checksum size is determined according to an algorithm
- provided by Donovan Baarda which reduces the probability of rsync
- algorithm corrupting data and falling back using the whole md4
- checksums. (J.W. Schultz, Donovan Baarda)
+ - Added the --inplace option that tells rsync to write each destination
+ file without using a temporary file. The matching of existing data
+ in the destination file can be severely limited by this, but there
+ are also cases where this is more efficient (such as appending data).
+ Use only when needed (see the man page for more details).
- * The --stats option no longer includes the (debug) malloc summary
- unless the verbose option was specified at least twice.
+ - Added the "write only" option for the daemon's config file.
- * Added a new error/warning code for when files vanish from the
- sending side. Made vanished source files not interfere with the
- file-deletion pass when --delete-after was specified.
+ - Added long-option names for -4 and -6 (namely --ipv4 and --ipv6)
+ and documented all these options in the man page.
- * Various trailing-info sections are now preceded by a newline.
-
- BUG FIXES:
+ - Improved the handling of the --bwlimit option so that it's less
+ bursty, more accurate, and works properly over a larger range of
+ values.
- * Fixed several exclude/include matching bugs when using wild-cards.
- This has a several user-visible effects, all of which make the
- matching more consistent and intuitive. This should hopefully not
- cause anyone problems since it makes the matching work more like
- what people are expecting. (Wayne Davison)
+ - The rsync daemon-over-ssh code now looks for SSH_CONNECTION and
+ SSH2_CLIENT in addition to SSH_CLIENT to figure out the IP address.
- - A pattern with a "**" no longer causes a "*" to match slashes.
- For example, with "/*/foo/**", "foo" must be 2 levels deep.
- [If your string has BOTH "*" and "**" wildcards, changing the
- "*" wildcards to "**" will provide the old behavior in all
- versions.]
+ - Added the --checksum-seed=N option for advanced users.
- - "**/foo" now matches at the base of the transfer (like /foo
- does). [Use "/**/foo" to get the old behavior in all versions.]
+ - Batch writing/reading has a brand-new implementation that is simpler,
+ fixes a few weird problems with the old code (such as no longer
+ sprinkling the batch files into different dirs or even onto different
+ systems), and is much less intrusive into the code (making it easier
+ to maintain for the future). The new code generates just one data
+ file instead of three, which makes it possible to read the batch via
+ stdin. Also, the old requirement of using the same fixed checksum-
+ seed for all batch processing has been removed.
- - A non-anchored wildcard term floats to match beyond the base of
- the transfer. E.g. "CVS/R*" matches at the end of the path,
- just like the non-wildcard term "CVS/Root" does. [Use "/CVS/R*"
- to get the old behavior in all versions.]
+ - If an rsync daemon has a module set with "list = no" (which hides its
+ presence in the list of available modules), a user that fails to
+ authenticate gets the same "unknown module" error that they would get
+ if the module were actually unknown (while still logging the real
+ error to the daemon's log file). This prevents fishing for module
+ names.
- - Including a "**" in the match term causes it to be matched
- against the entire path, not just the name portion, even if
- there aren't any interior slashes in the term. E.g. "foo**bar"
- would exclude "/path/foo-bar" (just like before) as well as
- "/foo-path/baz-bar" (unlike before). [Use "foo*bar" to get the
- old behavior in all versions.]
+ - The daemon's "refuse options" config item now allows you to match
+ option names using wildcards and/or the single-letter option names.
- * The exclude list specified in the daemon's config file is now
- properly applied to the pulled items no matter how deep the
- user's file-args are in the source tree. (Wayne Davison)
-
- * For protocol version >= 27, mdfour_tail() is called when the
- block size (including checksum_seed) is a multiple of 64.
- Previously it was not called, giving the wrong MD4 checksum.
- (Craig Barratt)
-
- * For protocol version >= 27, a 64 bit bit counter is used in
- mdfour.c as required by the RFC. Previously only a 32 bit bit
- counter was used, causing incorrect MD4 file checksums for
- file sizes >= 512MB - 4. (Craig Barratt)
-
- * Fixed a crash bug when interacting with older rsync versions and
- multiple files of the same name are destined for the same dir.
- (Wayne Davison)
-
- * Keep tmp names from overflowing MAXPATHLEN.
-
- * Make --link-dest honor the absence of -p, -o, and -g.
-
- * Made rsync treat a trailing slash in the destination in a more
- consistent manner.
-
- * Fixed file I/O error detection. (John Van Essen)
-
- * Fixed bogus "malformed address {hostname}" message in rsyncd log
- when checking IP address against hostnames from "hosts allow"
- and "hosts deny" parameters in config file.
+ INTERNAL:
- * Print heap statistics when verbose >= 2 instead of when >= 1.
+ - Some cleanup in the exclude code has saved some per-exclude memory
+ and made the code easier to maintain.
- * Fixed a compression (-z) bug when syncing a mostly-matching file
- that contains already-compressed data. (Yasuoka Masahiko and
- Wayne Davison)
+ - Improved the argv-overflow checking for a remote command that has
+ a lot of args.
- * Fixed a bug in the --backup code that could cause deleted files
- to not get backed up.
+ - Use rsyserr() in the various places that were still calling
+ rprintf() with strerror() as an arg.
- * When the backup code makes new directories, create them with mode
- 0700 instead of 0755 (since the directory permissions in the
- backup tree are not yet copied from the main tree).
+ - If an rsync daemon is listening on multiple sockets (to handle both
+ IPv4 and IPv6 to a single port), we now close all the unneeded file
+ handles after we accept a connection (we used to close just one of
+ them).
- * Call setgroups() in a more portable manner.
+ - Optimized the handling of larger block sizes (rsync used to slow to
+ a crawl if the block size got too large). Also cap the block size.
- * Improved file-related error messages to better indicate exactly
- what pathname failed. (Wayne Davison)
+ - Optimized away a loop in hash_search().
- * Fixed some bugs in the handling of --delete and --exclude when
- using the --relative (-R) option. (Wayne Davison)
+ BUILD CHANGES:
- * Fixed bug that prevented regular files from replacing
- special files and caused a directory in --link-dest or
- --compare-dest to block the creation of a file with the
- same path. A directory still cannot be replaced by a
- regular file unless --delete specified. (J.W. Schultz)
+ - Added a "gen" target to rebuild most of the generated files,
+ including configure, config.h.in, the man pages, and proto.h.
- * Detect and report when open or opendir succeed but read and
- readdir fail caused by network filesystem issues and truncated
- files. (David Norwood, Michael Brown, J.W. Schultz)
+ - If "make proto" doesn't find some changes in the prototypes, the
+ proto.h file is left untouched (its time-stamp used to always be
+ updated).
- * Added a fix that should give ssh time to restore the tty settings
- if the user presses Ctrl-C at an ssh password prompt.
+ - The variable $STRIP (that is optionally set by the install-strip
+ target's rule) was changed to $INSTALL_STRIP because some systems
+ have $STRIP set in the environment.
- INTERNAL:
+ - Fixed a build problem when SUPPORT_HARD_LINKS isn't defined.
- * Eliminated vestigial support for old versions that we stopped
- supporting. (J.W. Schultz)
+ DEVELOPER RELATED:
- * Simplified some of the option-parsing code. (Wayne Davison)
+ - The scripts in the testsuite dir were cleaned up a bit.
- * Some cleanup made to the exclude code, as well as some new
- defines added to enhance readability. (Wayne Davison)
+ - Some new diffs were added to the patches dir, and some accepted
+ ones were removed.
- * Changed the protocol-version code so that it can interact at a
- lower protocol level than the maximum supported by both sides.
- Added an undocumented option, --protocol=N, to force the value
- we advertise to the other side (primarily for testing purposes).
- (Wayne Davison)