X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/blobdiff_plain/c16d69b2920711d687de4eacb4d38ece3af95973..bdedced84b7f446f818efd4d25b8985285a50009:/NEWS diff --git a/NEWS b/NEWS index 6540a9cf..debed383 100644 --- a/NEWS +++ b/NEWS @@ -1,200 +1,164 @@ -NEWS for rsync 2.6.3 (UNRELEASED) -Protocol: 28 (unchanged) -Changes since 2.6.2: - - OUTPUT CHANGES (ATTN: those using a script to parse the verbose output): - - - 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". - - - 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). +NEWS for rsync 2.6.5 (UNRELEASED) +Protocol: 29 (unchanged) +Changes since 2.6.4: + + OUTPUT CHANGES: + + - Non-printable chars in filenames are now output using backslash- + escaped characters rather than '?'s. Any non-printable character is + output using 3 digits of octal (e.g. "\n" -> "\012"), and a backslash + is now output as "\\". Rsync also uses your locale setting, which + can make it treat fewer high-bit characters as non-printable. + + - If rsync received an empty file list when pulling files, it would + output a "nothing to do" message and exit with a 0 (success) exit + status, even if the remote rsync returned an error (it did not do + this under the same conditions when pushing files). This was changed + to make the pulling behavior the same as the pushing behavior: we + now do the normal end-of-run outputting (depending on options) and + exit with the appropriate exit status. BUG FIXES: - - Fixed a crash bug that might appear when --delete was used and - multiple source directories were specified. + - A crash bug was fixed when a daemon had its "path" set to "/", did + not have chroot enabled, and used some anchored excludes in the + rsyncd.conf file. - - Fixed the 32-bit truncation of the file length when generating the - checksums. + - Fixed a bug in the transfer of a single file when -H is specified + that might have caused an infinite loop or perhaps a crash. - - The --backup code no longer attempts to create some directories - over and over again (generating warnings along the way). + - Fixed a case where the generator might try to tweak the write + permissions of a read-only directory in list-only mode. - - 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. + - If --compare-dest or --link-dest uses a locally-copied file as the + basis for an updated version, log this better when --verbose or -i + is in effect. - - 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.) + - Fixed the accidental disabling of --backup during the --delete-after + processing. - - 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). + - Restored the ability to use the --address option in client mode (in + addition to its use in daemon mode). - - Fixed an age-old crash problem with --read-batch on a local copy - (rsync was improperly assuming --whole-file for the local copy). + - Make sure that some temporary progress information from the delete + processing does not get left on the screen when it is followed by a + newline. - - 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. + - When --existing skips a directory with extra verbosity, refer to it + as a "directory", not a "file". - - Got rid of a potential hang in the receiver when near the end of a - phase. + - When transferring a single file to a different-named file, any + generator messages that are source-file related no longer refer to + the file by the destination filename. - - When using --backup without a --backup-dir, rsync no longer preserves - the modify time on directories. This avoids confusing NFS. + - Fixed a bug where hard-linking a group of files might fail if the + generator hasn't created a needed destination directory yet. - - 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". + - Fixed a bug where a hard-linked group of files that is newly-linked + to a file in a --link-dest dir doesn't link the files from the rest + of the cluster. - - 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. + - When deleting files with the --one-file-system (-x) option set, rsync + no longer tries to remove files from inside a mount-point on the + receiving side. - - 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). + - Fixed a compatibility problem when using --cvs-ignore (-C) and + sending files to an older rsync without using --delete. - - 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). + - Make sure that a "- !" or "+ !" include/exclude pattern does not + trigger the list-clearing action that is reserved for "!". - - Fixed a bug in the daemon authentication code when using one of the - batch-processing options. + - Avoid a timeout in the generator when the sender/receiver aren't + handling the generator's checksum output quickly enough. - - 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). + - Fixed the ommission of some directories in the delete processing when + --relative (-R) was combined with a source path that had a trailing + slash. - - 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). + - Make sure that --max-size doesn't affect a device or a symlink. - - 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). + - Make sure that a system with a really small MAXPATHLEN does not cause + the buffers in readfd_unbuffered() to be too small to receive normal + messages. (This mainly affected Cygwin.) - - 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. + - If a source filename ends with "..", treat it as if "../" had been + specified (so that we don't copy files to the parent dir of the + destination). - - 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. + - If --delete is combined with a file-listing rsync command (i.e. no + transfer is happening), avoid outputting a warning that we couldn't + delete anything. - ENHANCEMENTS: - - - 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 - - - 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. + - If --stats is specified with --delete-after, ensure that all the + "deleting" messages are output before the statistics. - - 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). + - Improved one "if" in the deletion code that was only checking errno + for ENOTEMPTY when it should have also been checking for EEXIST. - - Added the "write only" option for the daemon's config file. + ENHANCEMENTS: - - Added long-option names for -4 and -6 (namely --ipv4 and --ipv6) - and documented all these options in the man page. + - Added the --only-write-batch=FILE option that may be used (instead + of --write-batch=FILE) to create a batch file without doing any + actual updating of the destination. This allows you to divert all + the file-updating data away from a slow data link (as long as you + are pushing the data to the remote server when creating the batch). - - Improved the handling of the --bwlimit option so that it's less - bursty, more accurate, and works properly over a larger range of - values. + - When the generator is taking a long time to fill up its output buffer + (e.g. if the transferred files are few, small, or missing), it now + periodically flushes the output buffer so that the sender/receiver + can get started on the files sooner rather than later. - - 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. + - Improved the keep-alive code to handle a long silence between the + sender and the receiver that can occur when the sender is receiving + the checksum data for a large file. - - Added the --checksum-seed=N option for advanced users. + - Improved the auth-errors that are logged by the daemon to include + some information on why the authorization failed (wrong user, + password mismatch, etc.). (The client-visible message is unchanged.) - - 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. + - Improved the client's handling of an "@ERROR" from a daemon so that + it does not complain about an unexpectedly closed socket (since we + really did expect the socket to close). - - 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. + - If the daemon can't open the log-file specified in rsyncd.conf, fall + back to using syslog (and log an appropriate warning). This is + better than what was typically a totally silent failure (since a + daemon is not usually run with the --no-detach option that was + necessary to see the error on stderr). - - The daemon's "refuse options" config item now allows you to match - option names using wildcards and/or the single-letter option names. + - The man pages now consistently refer to an rsync daemon as a "daemon" + to distinguish it from a server in a non-daemon transfer. - - The finished file now gets its permissions and modified-time updated - before it gets movied into place. + - Made a small change to the rrsync script (restricted rsync -- in the + support dir) to make a read-only server reject all --remove-* options + when sending files (to future-proof it against the possibility of + other similar options being added at some point). INTERNAL: - - Some cleanup in the exclude code has saved some per-exclude memory - and made the code easier to maintain. - - - Improved the argv-overflow checking for a remote command that has - a lot of args. + - Rsync now calls setlocale(LC_CTYPE, "") to enable isprint() to better + discern which filename characters need to be escaped in messages. - - Use rsyserr() in the various places that were still calling - rprintf() with strerror() as an arg. + - Improved the naming of the log-file open/reopen/close functions. - - 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). - - - 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. - - - Optimized away a loop in hash_search(). + - Removed some protocol compatibility code that was only needed to help + someone running a pre-release of 2.6.4. BUILD CHANGES: - - Added a "gen" target to rebuild most of the generated files, - including configure, config.h.in, the man pages, and proto.h. - - - 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). - - - 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. + - Fixed a bug in the SUPPORT{,_HARD}_LINKS defines which prevented + rsync from being built without symlink or hard-link support. - - Fixed a build problem when SUPPORT_HARD_LINKS isn't defined. + - You can use --disable-locale to turn off any use of setlocale(). - DEVELOPER RELATED: + - Configure now disables the use of mkstemp() under HP-UX (since they + refuse to fix its broken handling of large files). - - The scripts in the testsuite dir were cleaned up a bit. + - Configure now explicitly checks for the lseek64() function so that + the code can use HAVE_LSEEK64 instead of inferring lseek64()'s + presence based on the presence of the off64_t type. - - Some new diffs were added to the patches dir, and some accepted - ones were removed. + - Some minor enhancements to the test scripts. + - Added a few new diffs to the patches dir, including a patch that + enables the optional copying of extended attributes.