+NEWS for rsync 3.0.7 (31 Dec 2009)
+Protocol: 30 (unchanged)
+Changes since 3.0.6:
+
+ BUG FIXES:
+
+ - Fixed a bogus free when using --xattrs with --backup.
+
+ - Avoid an error when --dry-run was trying to stat a prior hard-link file
+ that hasn't really been created.
+
+ - Fixed a problem with --compress (-z) where the receiving side could
+ return the error "inflate (token) returned -5".
+
+ - Fixed a bug where --delete-during could delete in a directory before it
+ noticed that the sending side sent an I/O error for that directory (both
+ sides of the transfer must be at least 3.0.7).
+
+ - Improved --skip-compress's error handling of bad character-sets and got
+ rid of a lingering debug fprintf().
+
+ - Fixed the daemon's conveyance of io_error value from the sender.
+
+ - An rsync daemon use seteuid() (when available) if it used setuid().
+
+ - Get the permissions right on a --fake-super transferred directory that
+ needs more owner permissions to emulate root behavior.
+
+ - An absolute-path filter rule (i.e. with a '/' modifier) no longer loses
+ its modifier when sending the filter rules to the remote rsync.
+
+ - Improved the "--delete does not work without -r or -d" message.
+
+ - Improved rsync's handling of --timeout to avoid a weird timeout case
+ where the sender could timeout even though it has recently written data
+ to the socket (but hasn't read data recently, due to the writing).
+
+ - Some misc manpage improvements.
+
+ - Fixed the chmod-temp-dir testsuite on a system without /var/tmp.
+
+ - Make sure that a timeout specified in the daemon's config is used as a
+ maximum timeout value when the user also specifies a timeout.
+
+ - Improved the error-exit reporting when rsync gets an error trying to
+ cleanup after an error: the initial error is reported.
+
+ - Improved configure's detection of IPv6 for solaris and cygwin.
+
+ - The AIX sysacls routines will now return ENOSYS if ENOTSUP is missing.
+
+ - Made our (only used if missing) getaddrinfo() routine use inet_pton()
+ (which we also provide) instead of inet_aton().
+
+ - The exit-related debug messages now mention the program's role so it is
+ clear who output what message.
+
+ DEVELOPER RELATED:
+
+ - Got rid of type-punned compiler warnings output by newer gcc versions.
+
+ - The Makefile now ensures that proto.h will be rebuilt if config.h changes.
+
+ - The testsuite no longer uses "id -u", so it works better on solaris.
+
+\f
+NEWS for rsync 3.0.6 (8 May 2009)
+Protocol: 30 (unchanged)
+Changes since 3.0.5:
+
+ BUG FIXES:
+
+ - Fixed a --read-batch hang when rsync is reading a batch file that was
+ created from an incremental-recursion transfer.
+
+ - Fixed the daemon's socket code to handle the simultaneous arrival of
+ multiple connections.
+
+ - Fix --safe-links/--copy-unsafe-links to properly handle symlinks that
+ have consecutive slashes in the value.
+
+ - Fixed the parsing of an [IPv6_LITERAL_ADDR] when a USER@ is prefixed.
+
+ - The sender now skips a (bogus) symlink that has a 0-length value, which
+ avoids a transfer error in the receiver.
+
+ - Fixed a case where the sender could die with a tag-0 error if there was
+ an I/O during the sending of the file list.
+
+ - Fixed the rrsync script to avoid a server-side problem when -e is at the
+ start of the short options.
+
+ - Fixed a problem where a vanished directory could turn into an exit code
+ 23 instead of the proper exit code 24.
+
+ - Fixed the --iconv conversion of symlinks when doing a local copy.
+
+ - Fixed a problem where --one-file-system was not stopping deletions on the
+ receiving side when a mount-point directory did not match a directory in
+ the transfer.
+
+ - Fixed the dropping of an ACL mask when no named ACL values were present.
+
+ - Fixed an ACL/xattr corruption issue where the --backup option could cause
+ rsync to associate the wrong ACL/xattr information with received files.
+
+ - Fixed the use of --xattrs with --only-write-batch.
+
+ - Fixed the use of --dry-run with --read-batch.
+
+ - Fixed configure's erroneous use of target.
+
+ - Fixed configure's --disable-debug option.
+
+ - Fixed a run-time issue for systems that can't find iconv_open() by adding
+ the --disable-iconv-open configure option.
+
+ - Complain and die if the user tries to combine --remove-source-files (or
+ the deprecated --remove-sent-files) with --read-batch.
+
+ - Fixed an failure transferring special files from Solaris to Linux.
+
+\f
+NEWS for rsync 3.0.5 (28 Dec 2008)
+Protocol: 30 (unchanged)
+Changes since 3.0.4:
+
+ BUG FIXES:
+
+ - Initialize xattr data in a couple spots in the hlink code, which avoids a
+ crash when the xattr pointer's memory happens to start out non-zero.
+ Also fixed the itemizing of an alt-dest file's xattrs when hard-linking.
+
+ - Don't send a bogus "-" option to an older server if there were no short
+ options specified.
+
+ - Fixed skipping of unneeded updates in a batch file when incremental
+ recursion is active. Added a test for this. Made batch-mode handle
+ "redo" files properly (and without hanging).
+
+ - Fix the %P logfile escape when the daemon logs from inside a chroot.
+
+ - Fixed the use of -s (--protect-args) when used with a remote source or
+ destination that had an empty path (e.g. "host:"). Also fixed a problem
+ when -s was used when accessing a daemon via a remote-shell.
+
+ - Fixed the use of a dot-dir path (e.g. foo/./bar) inside a --files-from
+ file when the root of the transfer isn't the current directory.
+
+ - Fixed a bug with "-K --delete" removing symlinks to directories when
+ incremental recursion is active.
+
+ - Fixed a hard to trigger hang when using --remove-source-files.
+
+ - Got rid of an annoying delay when accessing a daemon via a remote-shell.
+
+ - Properly ignore (superfluous) source args on a --read-batch command.
+
+ - Improved the manpage's description of the '*' wildcard to remove the
+ confusing "non-empty" qualifier.
+
+ - Fixed reverse lookups in the compatibility-library version of
+ getnameinfo().
+
+ - Fixed a bug when using --sparse on a sparse file that has over 2GB of
+ consecutive sparse data.
+
+ - Avoid a hang when using at least 3 --verbose options on a transfer with a
+ client sender (which includes local copying).
+
+ - Fixed a problem with --delete-delay reporting an error when it was ready
+ to remove a directory that was now gone.
+
+ - Got rid of a bunch of "warn_unused_result" compiler warnings.
+
+ - If an ftruncate() on a received file fails, it now causes a partial-
+ transfer warning.
+
+ - Allow a path with a leading "//" to be preserved (CYGWIN only).
+
+ ENHANCEMENTS:
+
+ - Made the support/atomic-rsync script able to perform a fully atomic
+ update of the copied hierarchy when the destination is setup using a
+ particular symlink idiom.
+
+\f
+NEWS for rsync 3.0.4 (6 Sep 2008)
+Protocol: 30 (unchanged)
+Changes since 3.0.3:
+
+ BUG FIXES:
+
+ - Fixed a bug in the hard-linking code where it would sometimes try to
+ allocate 0 bytes of memory (which fails on some OSes, such as AIX).
+
+ - Fixed the hard-linking of files from a device that has a device number
+ of 0 (which seems to be a common device number on NetBSD).
+
+ - Fixed the handling of a --partial-dir that cannot be created. This
+ particularly impacts the --delay-updates option (since the files cannot
+ be delayed without a partial-dir), and was potentially destructive if
+ the --remove-source-files was also specified.
+
+ - Fixed a couple issues in the --fake-super handling of xattrs when the
+ destination files have root-level attributes (e.g. selinux values) that
+ a non-root copy can't affect.
+
+ - Improved the keep-alive check in the generator to fire consistently in
+ incremental-recursion mode when --timeout is enabled.
+
+ - The --iconv option now converts the content of a symlink too, instead
+ of leaving it in the wrong character-set (requires 3.0.4 on both sides
+ of the transfer).
+
+ - When using --iconv, if a filename fails to convert on the receiving side,
+ this no longer makes deletions in the root-dir of the transfer fail
+ silently (the user now gets a warning about deletions being disabled
+ due to IO error as long as --ignore-errors was not specified).
+
+ - When using --iconv, if a server-side receiver can't convert a filename,
+ the error message sent back to the client no longer mangles the name
+ with the wrong charset conversion.
+
+ - Fixed a potential alignment issue in the IRIX ACL code when allocating
+ the initial "struct acl" object. Also, cast mallocs to avoid warnings.
+
+ - Changed some errors that were going to stdout to go to stderr.
+
+ - Made human_num() and human_dnum() able to output a negative number
+ (rather than outputting a cryptic string of punctuation).
+
+ ENHANCEMENTS:
+
+ - Rsync will avoid sending an -e option to the server if an older protocol
+ is requested (and thus the option would not be useful). This lets the
+ user specify the --protocol=29 option to access an overly-restrictive
+ server that is rejecting the protocol-30 use of -e to the server.
+
+ - Improved the message output for an RERR_PARTIAL exit.
+
+ DEVELOPER RELATED:
+
+ - The Makefile will not halt for just a timestamp change on the Makefile
+ or the configure files, only for actual changes in content.
+
+ - Changed some commands in the testsuite's xattrs.test that called "rsync"
+ instead of "$RSYNC".
+
+ - Enhanced the release scripts to be able to handle a branch release and
+ to do even more consistency checks on the files.
+
+\f
+NEWS for rsync 3.0.3 (29 Jun 2008)
+Protocol: 30 (unchanged)
+Changes since 3.0.2:
+
+ BUG FIXES:
+
+ - Fixed a wildcard matching problem in the daemon when a module has
+ "use chroot" enabled.
+
+ - Fixed a crash bug in the hard-link code.
+
+ - Fixed the sending of xattr directory information when the code finds a
+ --link-dest or --copy-dest directory with unchanged xattrs -- the
+ destination directory now gets these unchanged xattrs properly applied.
+
+ - Fixed an xattr-sending glitch that could cause an "Internal abbrev"
+ error.
+
+ - Fixed the combination of --xattrs and --backup.
+
+ - The generator no longer allows a '.' dir to be excluded by a daemon-
+ exclude rule.
+
+ - Fixed deletion handling when copying a single, empty directory (with no
+ files) to a differently named, non-existent directory.
+
+ - Fixed the conversion of spaces into dashes in the %M log escape.
+
+ - Fixed several places in the code that were not returning the right
+ errno when a function failed.
+
+ - Fixed the backing up of a device or special file into a backup dir.
+
+ - Moved the setting of the socket options prior to the connect().
+
+ - If rsync exits in the middle of a --progress output, it now outputs a
+ newline to help prevent the progress line from being overwritten.
+
+ - Fixed a problem with how a destination path with a trailing slash or
+ a trailing dot-dir was compared against the daemon excludes.
+
+ - Fixed the sending of large (size > 16GB) files when talking to an older
+ rsync (protocols < 30): we now use a compatible block size limit.
+
+ - If a file's length is so huge that we overflow a checksum buffer count
+ (i.e. several hundred TB), warn the user and avoid sending an invalid
+ checksum struct over the wire.
+
+ - If a source arg is excluded, --relative no longer adds the excluded
+ arg's implied dirs to the transfer. This fix also made the exclude
+ check happen in the better place in the sending code.
+
+ - Use the overflow_exit() function for overflows, not out_of_memory().
+
+ - Improved the code to better handle a system that has only 32-bit file
+ offsets.
+
+ ENHANCEMENTS:
+
+ - The rsyncd.conf manpage now consistently refers to the parameters in
+ the daemon config file as "parameters".
+
+ - The description of the --inplace option was improved.
+
+ EXTRAS:
+
+ - Added a new script in the support directory, deny-rsync, which allows
+ an admin to (temporarily) replace the rsync command with a script that
+ sends an error message to the remote client via the rsync protocol.
+
+ DEVELOPER RELATED:
+
+ - Fixed a testcase failure if the tests are run as root and made some
+ compatibility improvements.
+
+ - Improved the daemon tests, including checking module comments, the
+ listing of files, and the ensuring that daemon excludes can't affect
+ a dot-dir arg.
+
+ - Improved some build rules for those that build in a separate directory
+ from the source, including better install rules for the man pages, and
+ the fixing of a proto.h-tstamp rule that could make the binaries get
+ rebuild without cause.
+
+ - Improved the testsuite to work around a problem with some utilities
+ (e.g. cp -p & touch -r) rounding sub-second timestamps.
+
+ - Ensure that the early patches don't cause any generated-file hunks to
+ bleed-over into patches that follow.
+
+\f
+NEWS for rsync 3.0.2 (8 Apr 2008)
+Protocol: 30 (unchanged)
+Changes since 3.0.1:
+
+ BUG FIXES:
+
+ - Fixed a potential buffer overflow in the xattr code.
+
+ ENHANCEMENTS:
+
+ - None.
+
+ DEVELOPER RELATED:
+
+ - The RPM spec file was improved to install more useful files.
+
+ - A few developer-oriented scripts were moved from the support dir
+ to the packaging dir.
+
+\f
+NEWS for rsync 3.0.1 (3 Apr 2008)
+Protocol: 30 (unchanged)
+Changes since 3.0.0:
+
+ NOTABLE CHANGES IN BEHAVIOR:
+
+ - Added the 'c'-flag to the itemizing of non-regular files so that the
+ itemized output doesn't get hidden if there were no attribute changes,
+ and also so that the itemizing of a --copy-links run will distinguish
+ between copying an identical non-regular file and the creation of a
+ revised version with a new value (e.g. a changed symlink referent, a
+ new device number, etc.).
+
+ BUG FIXES:
+
+ - Fixed a crash bug when a single-use rsync daemon (via remote shell) was
+ run without specifying a --config=FILE option.
+
+ - Fixed a crash when backing up a directory that has a default ACL.
+
+ - Fixed a bug in the handling of xattr values that could cause rsync to
+ not think that a file's extended attributes are up-to-date.
+
+ - Fixed the working of --fake-super with --link-dest and --xattrs.
+
+ - Fixed a hang when combining --dry-run with --remove-source-files.
+
+ - Fixed a bug with --iconv's handling of files that cannot be converted:
+ a failed name can no longer cause a transfer failure.
+
+ - Fixed the building of the rounding.h file on systems that need custom
+ CPPFLAGS to be used. Also improved the error reporting if the building
+ of rounding.h fails.
+
+ - Fixed the use of the --protect-args (-s) option when talking to a daemon.
+
+ - Fixed the --ignore-existing option's protection of files on the receiver
+ that are non-regular files on the sender (e.g. if a symlink or a dir on
+ the sender is trying to replace a file on the receiver). The reverse
+ protection (protecting a dir/symlink/device from being replaced by a
+ file) was already working.
+
+ - Fixed an assert failure if --hard-links is combined with an option that
+ can skip a file in a set of hard-linked files (i.e. --ignore-existing,
+ --append, etc.), without skipping all the files in the set.
+
+ - Avoid setting the modify time on a directory that already has the right
+ modify time set. This avoids tweaking the dir's ctime.
+
+ - Improved the daemon-exclude handling to do a better job of applying the
+ exclude rules to path entries. It also sends the user an error just as
+ if the files were actually missing (instead of silently ignoring the
+ user's args), and avoids sending the user the filter-action messages
+ for these non-user-initiated rules.
+
+ - Fixed some glitches with the dry-run code's missing-directory
+ handling, including a problem when combined with --fuzzy.
+
+ - Fixed some glitches with the skipped-directory handling.
+
+ - Fixed the 'T'-flag itemizing of symlinks when --time isn't preserved.
+
+ - Fixed a glitch in the itemizing of permissions with the -E option.
+
+ - The --append option's restricting of transfers to those that add data no
+ longer prevents the updating of non-content changes to otherwise up-to-
+ date files (i.e. those with the same content but differing permissions,
+ ownership, xattrs, etc.).
+
+ - Don't allow --fake-super to be specified with -XX (double --xattrs)
+ because the options conflict. If a daemon has "fake super" enabled,
+ it automatically downgrades a -XX request to -X.
+
+ - Fixed a couple bugs in the parsing of daemon-config excludes that could
+ make a floating exclude rule get treated as matching an absolute path.
+
+ - A daemon doesn't try to auto-refuse the "iconv" option if iconv-support
+ wasn't compiled in to the daemon (avoiding a warning in the logs).
+
+ - Fixed the inclusion of per-dir merge files from implied dirs.
+
+ - Fixed the support/rrsync script to work with the latest options that
+ rsync sends (including its flag-specifying use of -e to the server).
+
+ ENHANCEMENTS:
+
+ - Added the --old-dirs (--old-d) option to make it easier for a user to
+ ask for file-listings with older rsync versions (this is easier than
+ having to type "-r --exclude='/*/*'" manually).
+
+ - When getting an error while asking an older rsync daemon for a file
+ listing, rsync will try to notice if the error is a rejection of the
+ --dirs (-d) option and let the user know how to work around the issue.
+
+ - Added a few more --no-OPTION overrides.
+
+ - Improved the documentation of the --append option.
+
+ - Improved the documentation of the filter/exclude/include daemon
+ parameters.
+
+ INTERNAL:
+
+ - Fixed a couple minor bugs in the included popt library (ones which I
+ sent to the official popt project for inclusion in the 1.14 release).
+
+ - Fixed a stat() call that should have been do_stat() so that the proper
+ normal/64-bit stat() function gets called. (Was in an area that should
+ not have caused problems, though.)
+
+ - Changed the file-glob code to do a directory scan without using the
+ "glob" and "glob.h". This lets us do the globbing with less memory
+ churn, and also avoid adding daemon-excluded items to the returned
+ args.
+
+ DEVELOPER RELATED:
+
+ - The configure script tries to get the user's compiler to not warn about
+ unused function parameters if the build is not including one or more of
+ the ACL/xattrs/iconv features.
+
+ - The configure script now has better checks for figuring out if the
+ included popt code should be used or not.
+
+ - Fixed two testsuite glitches: avoid a failure if someone's "cd" command
+ outputs the current directory when cd-ing to a relative path, and made
+ the itemized test query how rsync was built to determine if it should
+ expect hard-linked symlinks or not.
+
+ - Updated the testsuite to verify that various bug fixes remain fixed.
+
+ - The RPM spec file was updated to have: (1) comments for how to use the
+ rsync-patch tar file, and (2) an /etc/xinetd.d/rsync file.
+
+ - Updated the build scripts to work with a revised FTP directory
+ structure.
+
+\f
+NEWS for rsync 3.0.0 (1 Mar 2008)
+Protocol: 30 (changed)
+Changes since 2.6.9:
+
+ NOTABLE CHANGES IN BEHAVIOR:
+
+ - The handling of implied directories when using --relative has changed to
+ send them as directories (e.g. no implied dir is ever sent as a symlink).
+ This avoids unexpected behavior and should not adversely affect most
+ people. If you're one of those rare individuals who relied upon having
+ an implied dir be duplicated as a symlink, you should specify the
+ transfer of the symlink and the transfer of the referent directory as
+ separate args. (See also --keep-dirlinks and --no-implied-dirs.)
+ Also, exclude rules no longer have a partial effect on implied dirs.
+
+ - Requesting a remote file-listing without specifying -r (--recursive) now
+ sends the -d (--dirs) option to the remote rsync rather than sending -r
+ along with an extra exclude of /*/*. If the remote rsync does not
+ understand the -d option (i.e. it is 2.6.3 or older), you will need to
+ either turn off -d (--no-d), or specify -r --exclude='/*/*' manually.
+
+ - In --dry-run mode, the last line of the verbose summary text is output
+ with a "(DRY RUN)" suffix to help remind you that no updates were made.
+ Similarly, --only-write-batch outputs "(BATCH ONLY)".
+
+ - A writable rsync daemon with "use chroot" disabled now defaults to a
+ symlink-munging behavior designed to make symlinks safer while also
+ allowing absolute symlinks to be stored and retrieved. This also has
+ the effect of making symlinks unusable while they're in the daemon's
+ hierarchy. See the daemon's "munge symlinks" parameter for details.
+
+ - Starting up an extra copy of an rsync daemon will not clobber the pidfile
+ for the running daemon -- if the pidfile exists, the new daemon will exit
+ with an error. This means that your wrapper script that starts the rsync
+ daemon should be made to handle lock-breaking (if you want any automatic
+ breaking of locks to be done).
+
+ BUG FIXES:
+
+ - A daemon with "use chroot = no" and excluded items listed in the daemon
+ config file now properly checks an absolute-path arg specified for these
+ options: --compare-dest, --link-dest, --copy-dest, --partial-dir,
+ --backup-dir, --temp-dir, and --files-from.
+
+ - A daemon can now be told to disable all user- and group-name translation
+ on a per-module basis. This avoids a potential problem with a writable
+ daemon module that has "use chroot" enabled -- if precautions weren't
+ taken, a user could try to add a missing library and get rsync to use
+ it. This makes rsync safer by default, and more configurable when id-
+ translation is not desired. See the daemon's "numeric ids" parameter
+ for full details.
+
+ - A chroot daemon can now indicate which part of its path should affect the
+ chroot call, and which part should become an inside-chroot path for the
+ module. This allows you to have outside-the-transfer paths (such as for
+ libraries) even when you enable chroot protection. The idiom used in the
+ rsyncd.conf file is: path = /chroot/dirs/./dirs/inside
+
+ - If a file's data arrived successfully on the receiving side but the
+ rename of the temporary file to the destination file failed AND the
+ --remove-source-files (or the deprecated --remove-sent-files) option
+ was specified, rsync no longer erroneously removes the associated
+ source file.
+
+ - Fixed the output of -ii when combined with one of the --*-dest options:
+ it now itemizes all the items, not just the changed ones.
+
+ - Made the output of all file types consistent when using a --*-dest
+ option. Prior versions would output too many creation events for
+ matching items.
+
+ - The code that waits for a child pid now handles being interrupted by a
+ signal. This fixes a problem with the pre-xfer exec function not being
+ able to get the exit status from the script.
+
+ - A negated filter rule (i.e. with a '!' modifier) no longer loses the
+ negation when sending the filter rules to the remote rsync.
+
+ - Fixed a problem with the --out-format (aka --log-format) option %f: it
+ no longer outputs superfluous directory info for a non-daemon rsync.
+
+ - Fixed a problem with -vv (double --verbose) and --stats when "pushing"
+ files (which includes local copies). Version 2.6.9 would complete the
+ copy, but exit with an error when the receiver output its memory stats.
+
+ - If --password-file is used on a non-daemon transfer, rsync now complains
+ and exits. This should help users figure out that they can't use this
+ option to control a remote shell's password prompt.
+
+ - Make sure that directory permissions of a newly-created destination
+ directory are handled right when --perms is left off.
+
+ - The itemized output of a newly-created destination directory is now
+ output as a creation event, not a change event.
+
+ - Improved --hard-link so that more corner cases are handled correctly
+ when combined with options such as --link-dest and/or --ignore-existing.
+
+ - The --append option no longer updates a file that has the same size.
+
+ - Fixed a bug when combining --backup and --backup-dir with --inplace:
+ any missing backup directories are now created.
+
+ - Fixed a bug when using --backup and --inplace with --whole-file or
+ --read-batch: backup files are actually created now.
+
+ - The daemon pidfile is checked and created sooner in the startup sequence.
+
+ - If a daemon module's "path" value is not an absolute pathname, the code
+ now makes it absolute internally (making it work properly).
+
+ - Ensure that a temporary file always has owner-write permission while we
+ are writing to it. This avoids problems with some network filesystems
+ when transfering read-only files.
+
+ - Any errors output about password-file reading no longer cause an error at
+ the end of the run about a partial transfer.
+
+ - The --read-batch option for protocol 30 now ensures that several more
+ options are set correctly for the current batch file: --iconv, --acls,
+ --xattrs, --inplace, --append, and --append-verify.
+
+ - Using --only-write-batch to a daemon receiver now works properly (older
+ versions would update some files while writing the batch).
+
+ - Avoid outputting a "file has vanished" message when the file is a broken
+ symlink and --copy-unsafe-links or --copy-dirlinks is used (the code
+ already handled this for --copy-links).
+
+ - Fixed the combination of --only-write-batch and --dry-run.
+
+ - Fixed rsync's ability to remove files that are not writable by the file's
+ owner when rsync is running as the same user.
+
+ - When transferring large files, the sender's hashtable of checksums is
+ kept at a more reasonable state of fullness (no more than 80% full) so
+ that the scanning of the hashtable will not bog down as the number of
+ blocks increases.
+
+ ENHANCEMENTS:
+
+ - A new incremental-recursion algorithm is now used when rsync is talking
+ to another 3.x version. This starts the transfer going more quickly
+ (before all the files have been found), and requires much less memory.
+ See the --recursive option in the manpage for some restrictions.
+
+ - Lowered memory use in the non-incremental-recursion algorithm for typical
+ option values (usually saving from 21-29 bytes per file).
+
+ - The default --delete algorithm is now --delete-during when talking to a
+ 3.x rsync. This is a faster scan than using --delete-before (which is
+ the default when talking to older rsync versions), and is compatible with
+ the new incremental recursion mode.
+
+ - Rsync now allows multiple remote-source args to be specified rather than
+ having to rely on a special space-splitting side-effect of the remote-
+ shell. Additional remote args must specify the same host or an empty one
+ (e.g. empty: :file1 or ::module/file2). For example, this means that
+ local use of brace expansion now works: rsync -av host:dir/{f1,f2} .
+
+ - Added the --protect-args (-s) option, that tells rsync to send most of
+ the command-line args at the start of the transfer rather than as args
+ to the remote-shell command. This protects them from space-splitting,
+ and only interprets basic wildcard special shell characters (*?[).
+
+ - Added the --delete-delay option, which is a more efficient way to delete
+ files at the end of the transfer without needing a separate delete pass.
+
+ - Added the --acls (-A) option to preserve Access Control Lists. This is
+ an improved version of the prior patch that was available, and it even
+ supports OS X ACLs. If you need to have backward compatibility with old,
+ ACL-patched versions of rsync, apply the acls.diff file from the patches
+ dir.
+
+ - Added the --xattrs (-X) option to preserve extended attributes. This is
+ an improved version of the prior patch that was available, and it even
+ supports OS X xattrs (which includes their resource fork data). If you
+ need to have backward compatibility with old, xattr-patched versions of
+ rsync, apply the xattrs.diff file from the patches dir.
+
+ - Added the --fake-super option that allows a non-super user to preserve
+ all attributes of a file by using a special extended-attribute idiom.
+ It even supports the storing of foreign ACL data on your backup server.
+ There is also an analogous "fake super" parameter for an rsync daemon.
+
+ - Added the --iconv option, which allows rsync to convert filenames from
+ one character-set to another during the transfer. The default is to
+ make this feature available as long as your system has iconv_open().
+ If compilation fails, specify --disable-iconv to configure, and then
+ rebuild. If you want rsync to perform character-set conversions by
+ default, you can specify --enable-iconv=CONVERT_STRING with the default
+ value for the --iconv option that you wish to use. For example,
+ "--enable-iconv=." is a good choice. See the rsync manpage for an
+ explanation of the --iconv option's settings.
+
+ - A new daemon config parameter, "charset", lets you control the character-
+ set that is used during an --iconv transfer to/from a daemon module. You
+ can also set your daemon to refuse "no-iconv" if you want to force the
+ client to use an --iconv transfer (requiring an rsync 3.x client).
+
+ - Added the --skip-compress=LIST option to override the default list of
+ file suffixes that will not be compressed when using --compress (-z).
+
+ - The daemon's default for "dont compress" was extended to include:
+ *.7z *.mp[34] *.mov *.avi *.ogg *.jpg *.jpeg
+ The name-matching routine was also optimized to run more quickly.
+
+ - The --max-delete option now outputs a warning if it skipped any file
+ deletions, including a count of how many deletions were skipped. (Older
+ versions just silently stopped deleting things.)
+
+ - You may specify --max-delete=0 to a 3.0.0 client to request that it warn
+ about extraneous files without deleting anything. If you're not sure
+ what version the client is, you can use the less-obvious --max-delete=-1,
+ as both old and new versions will treat that as the same request (though
+ older versions don't warn).
+
+ - The --hard-link option now uses less memory on both the sending and
+ receiving side for all protocol versions. For protocol 30, the use of a
+ hashtable on the sending side allows us to more efficiently convey to the
+ receiver what files are linked together. This reduces the amount of data
+ sent over the socket by a considerable margin (rather than adding more
+ data), and limits the in-memory storage of the device+inode information
+ to just the sending side for the new protocol 30, or to the receiving
+ side when speaking an older protocol (note that older rsync versions kept
+ the device+inode information on both sides).
+
+ - The filter rules now support a perishable ("p") modifier that marks rules
+ that should not have an effect in a directory that is being deleted. e.g.
+ -f '-p .svn/' would only affect "live" .svn directories.
+
+ - Rsync checks all the alternate-destination args for validity (e.g.
+ --link-dest). This lets the user know when they specified a directory
+ that does not exist.
+
+ - If we get an ENOSYS error setting the time on a symlink, we don't
+ complain about it anymore (for those systems that even support the
+ setting of the modify-time on a symlink).
+
+ - Protocol 30 now uses MD5 checksums instead of MD4.
+
+ - Changed the --append option to not checksum the existing data in the
+ destination file, which speeds up file appending.
+
+ - Added the --append-verify option, which works like the older --append
+ option (verifying the existing data in the destination file). For
+ compatibility with older rsync versions, any use of --append that is
+ talking protocol 29 or older will revert to the --append-verify method.
+
+ - Added the --contimeout=SECONDS option that lets the user specify a
+ connection timeout for rsync daemon access.
+
+ - Documented and extended the support for the RSYNC_CONNECT_PROG variable
+ that can be used to enhance the client side of a daemon connection.
+
+ - Improved the dashes and double-quotes in the nroff manpage output.
+
+ - Rsync now supports a lot more --no-OPTION override options.
+
+ INTERNAL:
+
+ - The file-list sorting algorithm now uses a sort that keeps any same-
+ named items in the same order as they were specified. This allows
+ rsync to always ensure that the first of the duplicates is the one
+ that will be included in the copy. The new sort is also faster
+ than the glibc version of qsort() and mergesort().
+
+ - Rsync now supports the transfer of 64-bit timestamps (time_t values).
+
+ - Made the file-deletion code use a little less stack when recursing
+ through a directory hierarchy of extraneous files.
+
+ - Fixed a build problem with older (2.x) versions of gcc.
+
+ - Added some isType() functions that make dealing with signed characters
+ easier without forcing variables via casts.
+
+ - Changed strcat/strcpy/sprintf function calls to use safer versions.
+
+ - Upgraded the included popt version to 1.10.2 and improved its use of
+ string-handling functions.
+
+ - Added missing prototypes for compatibility functions from the lib dir.
+
+ - Configure determines if iconv() has a const arg, allowing us to avoid a
+ compiler warning.
+
+ - Made the sending of some numbers more efficient for protocol 30.
+
+ - Make sure that a daemon process doesn't mind if the client was weird and
+ omitted the --server option.
+
+ - There are more internal logging categories available in protocol 30 than
+ the age-old FINFO and FERROR, including FERROR_XFER and FWARN. These new
+ categories allow some errors and warnings to go to stderr without causing
+ an erroneous end-of-run warning about some files not being able to be
+ transferred.
+
+ - Improved the use of "const" on pointers.
+
+ - Improved J.W.'s pool_alloc routines to add a way of incrementally freeing
+ older sections of a pool's memory.
+
+ - The getaddrinfo.c compatibility code in the "lib" dir was replaced with
+ some new code (derived from samba, derived from PostgreSQL) that has a
+ better license than the old code.
+
+ DEVELOPER RELATED:
+
+ - Rsync is now licensed under the GPLv3 or later.
+
+ - Rsync is now being maintained in a "git" repository instead of CVS
+ (though the old CVS repository still exists for historical access).
+ Several maintenance scripts were updated to work with git.
+
+ - Generated files are no longer committed into the source repository. The
+ autoconf and autoheader commands are now automatically run during the
+ normal use of "configure" and "make". The latest dev versions of all
+ generated files can also be copied from the samba.org web site (see the
+ prepare-source script's fetch option).
+
+ - The "patches" directory of diff files is now built from branches in the
+ rsync git repository (branch patch/FOO creates file patches/FOO.diff).
+ This directory is now distributed in a separate separate tar file named
+ rsync-patches-VERSION.tar.gz instead of the main rsync-VERSION.tar.gz.
+
+ - The proto.h file is now built using a simple perl script rather than a
+ complex awk script, which proved to be more widely compatible.
+
+ - When running the tests, we now put our per-test temp dirs into a sub-
+ directory named testtmp (which is created, if missing). This allows
+ someone to symlink the testtmp directory to another filesystem (which is
+ useful if the build dir's filesystem does not support ACLs and xattrs,
+ but another filesystem does).
+
+ - Rsync now has a way of handling protocol-version changes during the
+ development of a new protocol version. This causes any out-of-sync
+ versions to speak an older protocol rather than fail in a cryptic manner.
+ This addition makes it safer to deploy a pre-release version that may
+ interact with the public. This new exchange of sub-version info does not
+ interfere with the {MIN,MAX}_PROTOCOL_VERSION checking algorithm (which
+ does not have enough range to allow the main protocol number to be
+ incremented for every minor tweak in that happens during development).
+
+ - The csprotocol.txt file was updated to mention the daemon protocol change
+ in the 3.0.0 release.
+
+\f
+NEWS for rsync 2.6.9 (6 Nov 2006)
+Protocol: 29 (unchanged)
+Changes since 2.6.8:
+
+ BUG FIXES:
+
+ - If rsync is interrupted via a handled signal (such as SIGINT), it will
+ once again clean-up its temp file from the destination dir.
+
+ - Fixed an overzealous sanitizing bug in the handling of the --link-dest,
+ --copy-dest, and --compare-dest options to a daemon without chroot: if
+ the copy's destination dir is deeper than the top of the module's path,
+ these options now accept a safe number of parent-dir (../) references
+ (since these options are relative to the destination dir). The old code
+ incorrectly chopped off all "../" prefixes for these options, no matter
+ how deep the destination directory was in the module's hierarchy.
+
+ - Fixed a bug where a deferred info/error/log message could get sent
+ directly to the sender instead of being handled by rwrite() in the
+ generator. This fixes an "unexpected tag 3" fatal error, and should
+ also fix a potential problem where a deferred info/error message from
+ the receiver might bypass the log file and get sent only to the client
+ process. (These problems could only affect an rsync daemon that was
+ receiving files.)
+
+ - Fixed a bug when --inplace was combined with a --*-dest option and we
+ update a file's data using an alternate basis file. The code now
+ notices that it needs to copy the matching data from the basis file
+ instead of (wrongly) assuming that it was already present in the file.
+
+ - Fixed a bug where using --dry-run with a --*-dest option with a path
+ relative to a directory that does not yet exist: the affected option
+ gets its proper path value so that the output of the dry-run is right.
+
+ - Fixed a bug in the %f logfile escape when receiving files: the
+ destination path is now included in the output (e.g. you can now tell
+ when a user specifies a subdir inside a module).
+
+ - If the receiving side fails to create a directory, it will now skip
+ trying to update everything that is inside that directory.
+
+ - If --link-dest is specified with --checksum but without --times, rsync
+ will now allow a hard-link to be created to a matching link-dest file
+ even when the file's modify-time doesn't match the server's file.
+
+ - The daemon now calls more timezone-using functions prior to doing a
+ chroot. This should help some C libraries to generate proper timestamps
+ from inside a chrooted daemon (and to not try to access /etc/timezone
+ over and over again).
+
+ - Fixed a bug in the handling of an absolute --partial-dir=ABS_PATH option:
+ it now deletes an alternate basis file from the partial-dir that was used
+ to successfully update a destination file.
+
+ - Fixed a bug in the handling of --delete-excluded when using a per-dir
+ merge file: the merge file is now honored on the receiving side, and
+ only its unqualified include/exclude commands are ignored (just as is
+ done for global include/excludes).
+
+ - Fixed a recent bug where --delete was not working when transferring from
+ the root (/) of the filesystem with --relative enabled.
+
+ - Fixed a recent bug where an --exclude='*' could affect the root (/) of
+ the filesystem with --relative enabled.
+
+ - When --inplace creates a file, it is now created with owner read/write
+ permissions (0600) instead of no permissions at all. This avoids a
+ problem continuing a transfer that was interrupted (since --inplace
+ will not update a file that has no write permissions).
+
+ - If either --remove-source-files or --remove-sent-files is enabled and we
+ are unable to remove the source file, rsync now outputs an error.
+
+ - Fixed a bug in the daemon's "incoming chmod" rule: newly-created
+ directories no longer get the 'F' (file) rules applied to them.
+
+ - Fixed an infinite loop bug when a filter rule was rejected due to being
+ overly long.
+
+ - When the server receives a --partial-dir option from the client, it no
+ longer runs the client-side code that adds an assumed filter rule (since
+ the client will be sending us the rules in the usual manner, and they
+ may have chosen to override the auto-added rule).
+
+ ENHANCEMENTS:
+
+ - Added the --log-file=FILE and --log-file-format=FORMAT options. These
+ can be used to tell any rsync to output what it is doing to a log file.
+ They work with a client rsync, a non-daemon server rsync (see the man
+ page for instructions), and also allows the overriding of rsyncd.conf
+ settings when starting a daemon.
+
+ - The --log-format option was renamed to be --out-format to avoid confusing
+ it with affecting the log-file output. (The old option remains as an
+ alias for the new to preserve backward compatibility.)
+
+ - Made "log file" and "syslog facility" settable on a per-module basis in
+ the daemon's config file.
+
+ - Added the --remove-source-files option as a replacement for the (now
+ deprecated) --remove-sent-files option. This new option removes all
+ non-dirs from the source directories, even if the file was already
+ up-to-date. This fixes a problem where interrupting an rsync that
+ was using --remove-sent-files and restarting it could leave behind
+ a file that the earlier rsync synchronized, but didn't get to remove.
+ (The deprecated --remove-sent-files is still understood for now, and
+ still behaves in the same way as before.)
+
+ - Added the option --no-motd to suppress the message-of-the-day output
+ from a daemon when doing a copy. (See the manpage for a caveat.)
+
+ - Added a new environment variable to the pre-/post-xfer exec commands (in
+ the daemon's config file): RSYNC_PID. This value will be the same in
+ both the pre- and post-xfer commands, so it can be used as a unique ID
+ if the pre-xfer command wants to cache some arg/request info for the
+ post-xfer command.
+
+ INTERNAL:
+
+ - Did a code audit using IBM's code-checker program and made several
+ changes, including: replacing most of the strcpy() and sprintf()
+ calls with strlcpy(), snprintf(), and memcpy(), adding a 0-value to
+ an enum that had been intermingling a literal 0 with the defined enum
+ values, silencing some uninitialized memory checks, marking some
+ functions with a "noreturn" attribute, and changing an "if" that
+ could never succeed on some platforms into a pre-processor directive
+ that conditionally compiles the code.
+
+ - Fixed a potential bug in f_name_cmp() when both the args are a
+ top-level "." dir (which doesn't happen in normal operations).
+
+ - Changed exit_cleanup() so that it can never return instead of exit.
+ The old code might return if it found the exit_cleanup() function
+ was being called recursively. The new code is segmented so that
+ any recursive calls move on to the next step of the exit-processing.
+
+ - The macro WIFEXITED(stat) will now be defined if the OS didn't already
+ define it.
+
+ DEVELOPER RELATED:
+
+ - The acls.diff and xattrs.diff patches have received a bunch of work to
+ make them much closer to being acceptable in the main distribution.
+ The xattrs patch also has some preliminary Mac OS X and FreeBSD
+ compatibility code that various system types to exchange extended
+ file-attributes.
+
+ - A new diff in the patches dir, fake-root.diff, allows rsync to
+ maintain a backup hierarchy with full owner, group, and device info
+ without actually running as root. It does this using a special
+ extended attribute, so it depends on xattrs.diff (which depends on
+ acls.diff).
+
+ - The rsync.yo and rsyncd.conf.yo files have been updated to work
+ better with the latest yodl 2.x releases.
+
+ - Updated config.guess and config.sub to their 2006-07-02 versions.
+
+ - Updated various files to include the latest FSF address and to have
+ consistent opening comments.
+
+\f
+NEWS for rsync 2.6.8 (22 Apr 2006)
+Protocol: 29 (unchanged)
+Changes since 2.6.7:
+
+ BUG FIXES:
+
+ - Fixed a bug in the exclude code where an anchored exclude without any
+ wildcards fails to match an absolute source arg, but only when --relative
+ is in effect.
+
+ - Improved the I/O code for the generator to fix a potential hang when the
+ receiver gets an EOF on the socket but the generator's select() call
+ never indicates that the socket is writable for it to be notified about
+ the EOF. (This can happen when using stunnel).
+
+ - Fixed a problem with the file-reading code where a failed read (such as
+ that caused by a bad sector) would not advance the file's read-position
+ beyond the failed read's data.
+
+ - Fixed a logging bug where the "log file" directive was not being honored
+ in a single-use daemon (one spawned by a remote-shell connection or by
+ init).
+
+ - If rsync cannot honor the --delete option, we output an error and exit
+ instead of silently ignoring the option.
+
+ - Fixed a bug in the --link-dest code that prevented special files (such as
+ fifos) from being linked.
+
+ - The ability to hard-link symlinks and special files is now determined at
+ configure time instead of at runtime. This fixes a bug with --link-dest
+ creating a hard-link to a symlink's referent on a BSD system.
+
+ ENHANCEMENTS:
+
+ - In daemon mode, if rsync fails to bind to the requested port, the
+ error(s) returned by socket() and/or bind() are now logged.
+
+ - When we output a fatal error, we now output the version of rsync in the
+ message.
+
+ - Improved the documentation for the --owner and --group options.
+
+ - The rsyncstats script in "support" has an improved line-parsing regex
+ that is easier to read and also makes it to parse syslog-generated lines.
+
+ - A new script in "support": file-attr-restore, can be used to restore the
+ attributes of a file-set (the permissions, ownership, and group info)
+ taken from the cached output of a "find ARG... -ls" command.
+
+ DEVELOPER RELATED:
+
+ - Removed the unused function write_int_named(), the unused variable
+ io_read_phase, and the rarely used variable io_write_phase. This also
+ elides the confusing 'phase "unknown"' part of one error message.
+
+ - Removed two unused configure checks and two related (also unused)
+ compatibility functions.
+
+ - The xattrs.diff patch received a security fix that prevents a potential
+ buffer overflow in the receive_xattr() code.
+
+ - The acls.diff patch has been improved quite a bit, with more to come.
+
+ - A new patch was added: log-file.diff. This contains an early version of
+ a future option, --log-file=FILE, that will allow any rsync to log its
+ actions to a file (something that only a daemon supports at present).
+
+\f
+NEWS for rsync 2.6.7 (11 Mar 2006)
+Protocol: 29 (unchanged)
+Changes since 2.6.6:
+
+ OUTPUT CHANGES:
+
+ - The letter 'D' in the itemized output was being used for both devices
+ (character or block) as well as other special files (such as fifos and
+ named sockets). This has changed to separate non-device special files
+ under the 'S' designation (e.g. "cS+++++++ path/fifo"). See also the
+ "--specials" option, below.
+
+ - The way rsync escapes unreadable characters has changed. First, rsync
+ now has support for recognizing valid multibyte character sequences in
+ your current locale, allowing it to escape fewer characters than before
+ for a locale such as UTF-8. Second, it now uses an escape idiom of
+ "\#123", which is the literal string "\#" followed by exactly 3 octal
+ digits. Rsync no longer doubles a backslash character in a filename
+ (e.g. it used to output "foo\\bar" when copying "foo\bar") -- now it only
+ escapes a backslash that is followed by a hash-sign and 3 digits (0-9)
+ (e.g. it will output "foo\#134#789" when copying "foo\#789"). See also
+ the --8-bit-output (-8) option, mentioned below.
+
+ Script writers: the local rsync is the one that outputs escaped names,
+ so if you need to support unescaping of filenames for older rsyncs, I'd
+ suggest that you parse the output of "rsync --version" and only use the
+ old unescaping rules for 2.6.5 and 2.6.6.
+
+ BUG FIXES:
+
+ - Fixed a really old bug that caused --checksum (-c) to checksum all the
+ files encountered during the delete scan (ouch).
+
+ - Fixed a potential hang in a remote generator: when the receiver gets a
+ read-error on the socket, it now signals the generator about this so that
+ the generator does not try to send any of the terminating error messages
+ to the client (avoiding a potential hang in some setups).
+
+ - Made hard-links work with symlinks and devices again.
+
+ - If the sender gets an early EOF reading a source file, we propagate this
+ error to the receiver so that it can discard the file and try requesting
+ it again (which is the existing behavior for other kinds of read errors).
+
+ - If a device-file/special-file changes permissions, rsync now updates the
+ permissions without recreating the file.
+
+ - If the user specifies a remote-host for both the source and destination,
+ we now output a syntax error rather than trying to open the destination
+ hostspec as a filename.
+
+ - When --inplace creates a new destination file, rsync now creates it with
+ permissions 0600 instead of 0000 -- this makes restarting possible when
+ the transfer gets interrupted in the middle of sending a new file.
+
+ - Reject the combination of --inplace and --sparse since the sparse-output
+ algorithm doesn't work when overwriting existing data.
+
+ - Fixed the directory name in the error that is output when pop_dir()
+ fails.
+
+ - Really fixed the parsing of a "!" entry in .cvsignore files this time.
+
+ - If the generator gets a stat() error on a file, output it (this used to
+ require at least -vv for the error to be seen).
+
+ - If waitpid() fails or the child rsync didn't exit cleanly, we now handle
+ the exit status properly and generate a better error.
+
+ - Fixed some glitches in the double-verbose output when using --copy-dest,
+ --link-dest, or --compare-dest. Also improved how the verbose output
+ handles hard-links (within the transfer) that had an up-to-date alternate
+ "dest" file, and copied files (via --copy-dest).
+
+ - Fixed the matching of the dont-compress items (e.g. *.gz) against files
+ that have a path component containing a slash.
+
+ - If the code reading a filter/exclude file gets an EINTR error, rsync now
+ clears the error flag on the file handle so it can keep on reading.
+
+ - If --relative is active, the sending side cleans up trailing "/" or "/."
+ suffixes to avoid triggering a bug in older rsync versions. Also, we now
+ reject a ".." dir if it would be sent as a relative dir.
+
+ - If a non-directory is in the way of a directory and rsync is run with
+ --dry-run and --delete, rsync no longer complains about not being able
+ to opendir() the not-yet present directory.
+
+ - When --list-only is used and a non-existent local destination dir was
+ also specified as a destination, rsync no longer generates a warning
+ about being unable to create the missing directory.
+
+ - Fixed some problems with --relative --no-implied-dirs when the
+ destination directory did not yet exist: we can now create a symlink or
+ device when it is the first thing in the missing dir, and --fuzzy no
+ longer complains about being unable to open the missing dir.
+
+ - Fixed a bug where the --copy-links option would not affect implied
+ directories without --copy-unsafe-links (see --relative).
+
+ - Got rid of the need for --force to be used in some circumstances with
+ --delete-after (making it consistent with --delete-before/-during).
+
+ - Rsync now ignores the SIGXFSZ signal, just in case your OS sends this
+ when a file is too large (rsync handles the write error).
+
+ - Fixed a bug in the Proxy-Authorization header's base64-encoded value: it
+ was not properly padded with trailing '=' chars. This only affects a
+ user that need to use a password-authenticated proxy for an outgoing
+ daemon-rsync connection.
+
+ - If we're transferring an empty directory to a new name, rsync no longer
+ forces S_IWUSR if it wasn't already set, nor does it accidentally leave
+ it set.
+
+ - Fixed a bug in the debug output (-vvvvv) that could mention the wrong
+ checksum for the current file offset.
+
+ - Rsync no longer allows a single directory to be copied over a non-
+ directory destination arg.
+
+ ENHANCEMENTS:
+
+ - Added the --append option that makes rsync append data onto files that
+ are longer on the source than the destination (this includes new files).
+
+ - Added the --min-size=SIZE option to exclude small files from the
+ transfer.
+
+ - Added the --compress-level option to allow you to set how aggressive
+ rsync's compression should be (this option implies --compress).
+
+ - Enhanced the parsing of the SIZE value for --min-size and --max-size to
+ allow easy entry of multiples of 1000 (instead of just multiples of 1024)
+ and off-by-one values too (e.g. --max-size=8mb-1).
+
+ - Added the --8-bit-output (-8) option, which tells rsync to avoid escaping
+ high-bit characters that it thinks are unreadable in the current locale.
+
+ - The new option --human-readable (-h) changes the output of --progress,
+ --stats, and the end-of-run summary to be easier to read. If repeated,
+ the units become powers of 1024 instead of powers of 1000. (The old
+ meaning of -h, as a shorthand for --help, still works as long as you
+ just use it on its own, as in "rsync -h".)
+
+ - If lutimes() and/or lchmod() are around, use them to allow the
+ preservation of attributes on symlinks.
+
+ - The --link-dest option now affects symlinks and devices (when possible).
+
+ - Added two config items to the rsyncd.conf parsing: "pre-xfer exec" and
+ "post-xfer exec". These allow a command to be specified on a per-module
+ basis that will be run before and/or after a daemon-mode transfer. (See
+ the man page for a list of the environment variables that are set with
+ information about the transfer.)
+
+ - When using the --relative option, you can now insert a dot dir in
+ the source path to indicate where the replication of the source dirs
+ should start. For example, if you specify a source path of
+ rsync://host/module/foo/bar/./baz/dir with -R, rsync will now only
+ replicate the "baz/dir" part of the source path (note: a trailing
+ dot dir is unaffected unless it also has a trailing slash).
+
+ - Added some new --no-FOO options that make it easier to override unwanted
+ implied or default options. For example, "-a --no-o" (aka "--archive
+ --no-owner") can be used to turn off the preservation of file ownership
+ that is implied by -a.
+
+ - Added the --chmod=MODE option that allows the destination permissions to
+ be changed from the source permissions. E.g. --chmod=g+w,o-rwx
+
+ - Added the "incoming chmod" and "outgoing chmod" daemon options that allow
+ a module to specify what permissions changes should be applied to all
+ files copied to and from the daemon.
+
+ - Allow the --temp-dir option to be specified when starting a daemon, which
+ sets the default temporary directory for incoming files.
+
+ - If --delete is combined with --dirs without --recursive, rsync will now
+ delete in any directory whose content is being synchronized.
+
+ - If --backup is combined with --delete without --backup-dir (and without
+ --delete-excluded), we add a "protect" filter-rule to ensure that files
+ with the backup suffix are not deleted.
+
+ - The file-count stats that are output by --progress were improved to
+ better indicate what the numbers mean. For instance, the output:
+ "(xfer#5, to-check=8383/9999)" indicates that this was the fifth file
+ to be transferred, and we still need to check 8383 more files out of
+ a total of 9999.
+
+ - The include/exclude code now allows a dir/*** directive (with 3 trailing
+ stars) to match both the dir itself as well as all the content below the
+ dir (dir/** would not match the dir).
+
+ - Added the --prune-empty-dirs (-m) option that makes the receiving rsync
+ discard empty chains of directories from the file-list. This makes it
+ easier to selectively copy files from a source hierarchy and end up with
+ just the directories needed to hold the resulting files.
+
+ - If the --itemize-changes (-i) option is repeated, rsync now includes
+ unchanged files in the itemized output (similar to -vv, but without all
+ the other verbose messages that can get in the way). Of course, the
+ client must be version 2.6.7 for this to work, but the remote rsync only
+ needs to be 2.6.7 if you're pushing files.
+
+ - Added the --specials option to tell rsync to copy non-device special
+ files (which rsync now attempts even as a normal user). The --devices
+ option now requests the copying of just devices (character and block).
+ The -D option still requests both (e.g. --devices and --specials), -a
+ still implies -D, and non-root users still get a silent downgrade that
+ omits device copying.
+
+ - Added the --super option to make the receiver always attempt super-user
+ activities. This is useful for systems that allow things such as devices
+ to be created or ownership to be set without being UID 0, and is also
+ useful for someone who wants to ensure that errors will be output if the
+ receiving rsync isn't being run as root.
+
+ - Added the --sockopts option for those few who want to customize the TCP
+ options used to contact a daemon rsync.
+
+ - Added a way for the --temp-dir option to be combined with a partial-dir
+ setting that lets rsync avoid non-atomic updates (for those times when
+ --temp-dir is not being used because space is tight).
+
+ - A new support script, files-to-excludes, will transform a list of files
+ into a set of include/exclude directives that will copy those files.
+
+ - A new option, --executability (-E) can be used to preserve just the
+ execute bit on files, for those times when using the --perms option is
+ not desired.
+
+ - The daemon now logs each connection and also each module-list request
+ that it receives.
+
+ - New log-format options: %M (modtime), %U (uid), %G (gid), and %B
+ (permission bits, e.g. "rwxr-xrwt").
+
+ - The --dry-run option no longer forces the enabling of --verbose.
+
+ - The --remove-sent-files option now does a better job of incrementally
+ removing the sent files on the sending side (older versions tended to
+ clump up all the removals at the end).
+
+ - A daemon now supersedes its minimal SIGCHLD handler with the standard
+ PID-remembering version after forking. This ensures that the generator
+ can get the child-exit status from the receiver.
+
+ - Use of the --bwlimit option no longer interferes with the remote rsync
+ sending error messages about invalid/refused options.
+
+ - Rsync no longer returns a usage error when used with one local source arg
+ and no destination: this now implies the --list-only option, just like
+ the comparable situation with a remote source arg.
+
+ - Added the --copy-dirlinks option, a more limited version of --copy-links.
+
+ - Various documentation improvements, including: a better synopsis, some
+ improved examples, a better discussion of the presence and absence of
+ --perms (including how it interacts with the new --executability and
+ --chmod options), an extended discussion of --temp-dir, an improved
+ discussion of --partial-dir, a better description of rsync's pattern
+ matching characters, an improved --no-implied-dirs section, and the
+ documenting of what the --stats option outputs.
+
+ - Various new and updated diffs in the patches dir, including: acls.diff,
+ xattrs.diff, atimes.diff, detect-renamed.diff, and slp.diff.
+
+ INTERNAL:
+
+ - We now use sigaction() and sigprocmask() if possible, and fall back on
+ signal() if not. Using sigprocmask() ensures that rsync enables all the
+ signals that it needs, just in case it was started in a masked state.
+
+ - Some buffer sizes were expanded a bit, particularly on systems where
+ MAXPATHLEN is overly small (e.g. cygwin).
+
+ - If io_printf() tries to format more data than fits in the buffer, exit
+ with an error instead of transmitting a truncated buffer.
+
+ - If a va_copy macro is defined, lib/snprintf.c will use it when defining
+ the VA_COPY macro.
+
+ - Reduced the amount of stack memory needed for each level of directory
+ recursion by nearly MAXPATHLEN bytes.
+
+ - The wildmatch function was extended to allow an array of strings to be
+ supplied as the string to match. This allows the exclude code to do less
+ string copying.
+
+ - Got rid of the safe_fname() function (and all the myriad calls) and
+ replaced it with a new function in the log.c code that filters all the
+ output going to the terminal.
+
+ - Unified the f_name() and the f_name_to() functions.
+
+ - Improved the hash-table code the sender uses to handle checksums to make
+ it use slightly less memory and run just a little faster.
+
+ DEVELOPER RELATED:
+
+ - The diffs in the patches dir now require "patch -p1 <DIFF" instead of
+ the previous -p0. Also, the version included in the release tar now
+ affect generated files (e.g. configure, rsync.1, proto.h, etc.), so
+ it is no longer necessary to run autoconf and/or yodl unless you're
+ applying a patch that was checked out from CVS.
+
+ - Several diffs in the patches dir now use the proper --enable-FOO
+ configure option instead of --with-FOO to turn on the inclusion of
+ the newly patched feature.
+
+ - There is a new script, "prepare-source" than can be used to update the
+ various generated files (proto.h, configure, etc.) even before configure
+ has created the Makefile (this is mainly useful when patching the source
+ with a patch that doesn't affect generated files).
+
+ - The testsuite now sets HOME so that it won't be affected by a file such
+ as ~/.popt.
+
+\f
+NEWS for rsync 2.6.6 (28 Jul 2005)
+Protocol: 29 (unchanged)
+Changes since 2.6.5:
+
+ SECURITY FIXES:
+
+ - The zlib code was upgraded to version 1.2.3 in order to make it more
+ secure. While the widely-publicized security problem in zlib 1.2.2 did
+ not affect rsync, another security problem surfaced that affects rsync's
+ zlib 1.1.4.
+
+ BUG FIXES:
+
+ - The setting of flist->high in clean_flist() was wrong for an empty list.
+ This could cause flist_find() to crash in certain rare circumstances
+ (e.g. if just the right directory setup was around when --fuzzy was
+ combined with --link-dest).
+
+ - The outputting of hard-linked files when verbosity was > 1 was not right:
+ (1) Without -i it would output the name of each hard-linked file as
+ though it had been changed; it now outputs a "is hard linked" message for
+ the file. (2) With -i it would output all dots for the unchanged
+ attributes of a hard-link; it now changes those dots to spaces, as is
+ done for other totally unchanged items.
+
+ - When backing up a changed symlink or device, get rid of any old backup
+ item so that we don't get an "already exists" error.
+
+ - A couple places that were comparing a local and a remote modification-
+ time were not honoring the --modify-window option.
+
+ - Fixed a bug where the 'p' (permissions) itemized-changes flag might get
+ set too often (if some non-significant mode bits differed).
+
+ - Fixed a really old, minor bug that could cause rsync to warn about being
+ unable to mkdir() a path that ends in "/." because it just created the
+ directory (required --relative, --no-implied-dirs, a source path that
+ ended in either a trailing slash or a trailing "/.", and a non-existing
+ destination dir to tickle the bug in a recent version).
+
+ ENHANCEMENTS:
+
+ - Made the "max verbosity" setting in the rsyncd.conf file settable on a
+ per-module basis (which now matches the documentation).
+
+ - The support/rrsync script has been upgraded to verify the args of options
+ that take args (instead of rejecting any such options). The script was
+ also changed to try to be more secure and to fix a problem in the parsing
+ of a pull operation that has multiple sources.
+
+ - Improved the documentation that explains the difference between a
+ normal daemon transfer and a daemon-over remote-shell transfer.
+
+ - Some of the diffs supplied in the patches dir were fixed and/or
+ improved.
+
+ BUILD CHANGES:
+
+ - Made configure define NOBODY_USER (currently hard-wired to "nobody") and
+ NOBODY_GROUP (set to either "nobody" or "nogroup" depending on what we
+ find in the /etc/group file).
+
+ - Added a test to the test suite, itemized.test, that tests the output of
+ -i (log-format w/%i) and some double-verbose messages.
+
+\f
+NEWS for rsync 2.6.5 (1 Jun 2005)
+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:
+
+ - 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 a bug in the transfer of a single file when -H is specified
+ (rsync would either infinite loop or perhaps crash).
+
+ - Fixed a case where the generator might try (and fail) to tweak the
+ write-permissions of a read-only directory in list-only mode (this
+ only caused an annoying warning message).
+
+ - 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.
+
+ - Fixed the accidental disabling of --backup during the --delete-after
+ processing.
+
+ - Restored the ability to use the --address option in client mode (in
+ addition to its use in daemon mode).
+
+ - 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.
+
+ - When --existing skips a directory with extra verbosity, refer to it
+ as a "directory", not a "file".
+
+ - 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.
+
+ - Fixed a bug where hard-linking a group of files might fail if the
+ generator hasn't created a needed destination directory yet.
+
+ - 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.
+
+ - 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. Also, we don't complain about being unable to remove
+ the mount-point dir.
+
+ - Fixed a compatibility problem when using --cvs-ignore (-C) and
+ sending files to an older rsync without using --delete.
+
+ - Make sure that a "- !" or "+ !" include/exclude pattern does not
+ trigger the list-clearing action that is reserved for "!".
+
+ - Avoid a timeout in the generator when the sender/receiver aren't
+ handling the generator's checksum output quickly enough.
+
+ - Fixed the omission of some directories in the delete processing when
+ --relative (-R) was combined with a source path that had a trailing
+ slash.
+
+ - Fixed a case where rsync would erroneously delete some files and then
+ re-transfer them when the options --relative (-R) and --recursive
+ (-r) were both enabled (along with --delete) and a source path had a
+ trailing slash.
+
+ - Make sure that --max-size doesn't affect a device or a symlink.
+
+ - 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.)
+
+ - If a source pathname ends with a filename of "..", treat it as if
+ "../" had been specified (so that we don't copy files to the parent
+ dir of the destination).
+
+ - 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.
+
+ - If --stats is specified with --delete-after, ensure that all the
+ "deleting" messages are output before the statistics.
+
+ - Improved one "if" in the deletion code that was only checking errno
+ for ENOTEMPTY when it should have also been checking for EEXIST (for
+ compatibility with OS variations).
+
+ ENHANCEMENTS:
+
+ - 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).
+
+ - 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.
+
+ - 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.
+
+ - 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!)
+
+ - 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 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 (and fatal) failure (since a
+ daemon is not usually run with the --no-detach option that was
+ necessary to see the error on stderr).
+
+ - The man pages now consistently refer to an rsync daemon as a "daemon"
+ instead of a "server" (to distinguish it from the server process in a
+ non-daemon transfer).
+
+ - 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:
+
+ - Rsync now calls setlocale(LC_CTYPE, ""). This enables isprint() to
+ better discern which filename characters need to be escaped in
+ messages (which should result in fewer escaped characters in some
+ locales).
+
+ - Improved the naming of the log-file open/reopen/close functions.
+
+ - Removed some protocol-compatibility code that was only needed to help
+ someone running a pre-release of 2.6.4.
+
+ BUILD CHANGES:
+
+ - Added configure option "--disable-locale" to disable any use of
+ setlocale() in the binary.
+
+ - Fixed a bug in the SUPPORT{,_HARD}_LINKS #defines which prevented
+ rsync from being built without symlink or hard-link support.
+
+ - Only #define HAVE_REMSH if it is going to be set to 1.
+
+ - Configure now disables the use of mkstemp() under HP-UX (since they
+ refuse to fix its broken handling of large files).
+
+ - 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.
+
+ - Configure no longer mentions the change in the default remote-shell
+ (from rsh to ssh) that occurred for the 2.6.0 release.
+
+ - Some minor enhancements to the test scripts.
+
+ - Added a few new *.diff files to the patches dir, including a patch
+ that enables the optional copying of extended attributes.
+
+\f
NEWS for rsync 2.6.4 (30 March 2005)
Protocol: 29 (changed)
Changes since 2.6.3:
(so that the name will precede the progress stats, and the full
--log-format output will come after).
- - Filenames have non-printable characters replaced with a '?' to avoid
- corrupting the screen or generating empty lines in the output.
+ - Non-printable characters in filenames are replaced with a '?' to
+ avoid corrupting the screen or generating empty lines in the output.
BUG FIXES:
- An OS that has a binary mode for its files (such as cygwin) needed
setmode(fd, O_BINARY) called on the temp-file we opened with
- mkstemp(). (Fix derived from the cygwin's 2.6.3 rsync package.)
+ mkstemp(). (Fix derived from cygwin's 2.6.3 rsync package.)
- Fixed a potential hang when verbosity is high, the client side is
the sender, and the file-list is large.
(since the forked process already has a copy of the exclude list,
there's no need to send them a set of duplicates).
- - When --progress is specified, the output of items that the generator
- is creating (e.g. dirs, symlinks) is now integrated into the progress
- output without overlapping it. (Requires protocol 29.)
+ - The output of the items that are being updated by the generator (dirs,
+ symlinks, devices) is now intermingled in the proper order with the
+ output from the items that the receiver is updating (regular files)
+ when pulling. This misordering was particularly bad when --progress
+ was specified. (Requires protocol 29.)
- When --timeout is specified, lulls that occur in the transfer while
the generator is doing work that does not generate socket traffic
back to the client side when a remote --files-from was in effect and
the daemon was the receiver.
- - The --compare-dest option was not updating a file that differred in
+ - The --compare-dest option was not updating a file that differed in
(the preserved) attributes from the version in the compare-dest DIR.
- When rsync is copying files into a write-protected directory, fixed
29.)
- Added the --dirs (-d) option for an easier way to copy directories
- without recursion.
+ without recursion. Any directories that are encountered are created
+ on the destination. Specifying a directory with a trailing slash
+ copies its immediate contents to the destination.
+
+ - The --files-from option now implies --dirs (-d).
- Added the --list-only option, which is mainly a way for the client to
put the server into listing mode without needing to resort to any
- Handle an operating system that use mkdev() in place of makedev().
- Improved configure to better handle cross-compiling.
+
+\f
NEWS for rsync 2.6.3 (30 Sep 2004)
Protocol: 28 (unchanged)
Changes since 2.6.2:
user chose to combine the output of rsync's stdout and stderr (e.g.
using the "2>&1").
+ - Fixed an option-parsing bug when --files-from got passed to a daemon.
+
ENHANCEMENTS:
- Added the --partial-dir=DIR option that lets you specify where to
- We now reset the "new data has been sent" flag at the start of
each file we send. This makes sure that an interrupted transfer
with the --partial option set doesn't keep a shorter temp file
- than the current basis file when no new data has been transfered
+ than the current basis file when no new data has been transferred
over the wire for that file.
- Fixed a byte-order problem in --batch-mode on big-endian machines.
- Fixed the ability to request an empty backup --suffix when sending
files to an rsync daemon.
+ - Fixed an option-parsing bug when --files-from was sent to a server
+ sender.
+
INTERNAL:
- Most of the I/O is now buffered, which results in a pretty large
* The --suffix option can now be used with --backup-dir. (Michael
Zimmerman)
- * Combining "::" syntax with the -rsh/-e option now uses the
+ * Combining "::" syntax with the --rsh/-e option now uses the
specified remote-shell as a transport to talk to a (newly-spawned)
server-daemon. This allows someone to use daemon features, such
as modules, over a secure protocol, such as ssh. (JD Paul)
\f
Partial Protocol History
RELEASE DATE VER. DATE OF COMMIT* PROTOCOL
- ?? May 2005 2.6.5 29
+ ?? ??? 2011 3.1.0 31 Aug 2008 31
+ 31 Dec 2009 3.0.7 30
+ 08 May 2009 3.0.6 30
+ 28 Dec 2008 3.0.5 30
+ 06 Sep 2008 3.0.4 30
+ 29 Jun 2008 3.0.3 30
+ 08 Apr 2008 3.0.2 30
+ 03 Apr 2008 3.0.1 30
+ 01 Mar 2008 3.0.0 11 Nov 2006 30
+ 06 Nov 2006 2.6.9 29
+ 22 Apr 2006 2.6.8 29
+ 11 Mar 2006 2.6.7 29
+ 28 Jul 2005 2.6.6 29
+ 01 Jun 2005 2.6.5 29
30 Mar 2005 2.6.4 17 Jan 2005 29
30 Sep 2004 2.6.3 28
30 Apr 2004 2.6.2 28