Annotation of embedaddon/rsync/NEWS.md, revision 1.1
1.1 ! misho 1: <a name="3.2.3"></a>
! 2:
! 3: # NEWS for rsync 3.2.3 (6 Aug 2020)
! 4:
! 5: ## Changes in this version:
! 6:
! 7: ### BUG FIXES:
! 8:
! 9: - Fixed a bug in the xattr code that was freeing the wrong object when trying
! 10: to cleanup the xattr list.
! 11:
! 12: - Fixed a bug in the xattr code that was not leaving room for the "rsync."
! 13: prefix in some instances where it needed to be added.
! 14:
! 15: - Restored the ability to use `--bwlimit=0` to specify no bandwidth limit. (It
! 16: was accidentally broken in 3.2.2.)
! 17:
! 18: - Fix a bug when combining `--delete-missing-args` with `--no-implied-dirs` &
! 19: `-R` where rsync might create the destination path of a missing arg. The
! 20: code also avoids some superfluous warnings for nested paths of removed args.
! 21:
! 22: - Fixed an issue where hard-linked devices could cause the rdev_major value to
! 23: get out of sync between the sender and the receiver, which could cause a
! 24: device to get created with the wrong major value in its major,minor pair.
! 25:
! 26: - Rsync now complains about a missing `--temp-dir` before starting any file
! 27: transfers.
! 28:
! 29: - A completely empty source arg is now a fatal error. This doesn't change
! 30: the handling of implied dot-dir args such as "localhost:" and such.
! 31:
! 32: ### ENHANCEMENTS:
! 33:
! 34: - Allow `--max-alloc=0` to specify no limit to the alloc sanity check.
! 35:
! 36: - Allow `--block-size=SIZE` to specify the size using units (e.g. "100K").
! 37:
! 38: - The name of the id-0 user & group are now sent to the receiver along with
! 39: the other user/group names in the transfer (instead of assuming that both
! 40: sides have the same id-0 names).
! 41:
! 42: - Added the `--stop-after=MINS` and `--stop-at=DATE_TIME` options (with the
! 43: `--time-limit=MINS` option accepted as an alias for `--stop-after`). This
! 44: is an enhanced version of the time-limit patch from the patches repo.
! 45:
! 46: - Added the `name converter` daemon parameter to make it easier to convert
! 47: user & group names inside a chrooted daemon module. This is based on the
! 48: nameconverter patch with some improvements, including a tweak to the request
! 49: protocol (so if you used this patch in the past, be sure to update your
! 50: converter script to use newlines instead of null chars).
! 51:
! 52: - Added `--crtimes` (`-N`) option for preserving the file's create time (I
! 53: believe that this is macOS only at the moment).
! 54:
! 55: - Added `--mkpath` option to tell rsync that it should create a non-existing
! 56: path component of the destination arg.
! 57:
! 58: - Added `--stderr=errors|all|client` to replace the `--msgs2stderr` and
! 59: `--no-msgs2stderr` options (which are still accepted). The default use of
! 60: stderr was changed to be `--stderr=errors` where all the processes that have
! 61: stderr available output directly to stderr, which should help error messages
! 62: get to the user more quickly, especially when doing a push (which includes
! 63: local copying). This also allows rsync to exit quickly when a receiver
! 64: failure occurs, since rsync doesn't need to try to keep the connection alive
! 65: long enough for the fatal error to go from the receiver to the generator to
! 66: the sender. The old default can be requested via `--stderr=client`. Also
! 67: changed is that a non-default stderr mode is conveyed to the remote rsync
! 68: (using the older option names) instead of requiring the user to use
! 69: `--remote-option` (`-M`) to tell the remote rsync what to do.
! 70:
! 71: - Added the ability to specify "@netgroup" names to the `hosts allow` and
! 72: `hosts deny` daemon parameters. This is a finalized version of the
! 73: netgroup-auth patch from the patches repo.
! 74:
! 75: - Rsync can now hard-link symlinks on FreeBSD due to it making ues of the
! 76: linkat() function when it is available.
! 77:
! 78: - Output file+line info on out-of-memory & overflow errors while also avoiding
! 79: the output of alternate build-dir path info that is not useful to the user.
! 80:
! 81: - Change configure to know that Cygwin supports Linux xattrs.
! 82:
! 83: - Improved the testsuite on FreeBSD & Cygwin.
! 84:
! 85: - Added some compatibility code for HPE NonStop platforms.
! 86:
! 87: - Improved the INSTALL.md info.
! 88:
! 89: - Added a few more suffixes to the default skip-compress list.
! 90:
! 91: - Improved configure's error handling to notify about several issues at once
! 92: instead of one by one (for the newest optional features).
! 93:
! 94: ### INTERNAL:
! 95:
! 96: - Use a simpler overflow check idiom in a few spots.
! 97:
! 98: - Use a C99 Flexible Array for a trailing variable-size filename in a struct
! 99: (with a fallback to the old 1-char string kluge for older compilers).
! 100:
! 101: ------------------------------------------------------------------------------
! 102: <a name="3.2.2"></a>
! 103:
! 104: # NEWS for rsync 3.2.2 (4 Jul 2020)
! 105:
! 106: ## Changes in this version:
! 107:
! 108: ### BUG FIXES:
! 109:
! 110: - Avoid a crash when a daemon module enables `transfer logging` without
! 111: setting a `log format` value.
! 112:
! 113: - Fixed installing rsync-ssl script from an alternate build dir.
! 114:
! 115: - Fixed the updating of configure.sh from an alternate build dir.
! 116:
! 117: - Apple requires the asm function name to begin with an underscore.
! 118:
! 119: - Avoid a test failure in the daemon test when `--atimes` is disabled.
! 120:
! 121: ### ENHANCEMENTS:
! 122:
! 123: - Allow the server side to restrict checksum & compression choices via the
! 124: same environment variables the client uses. The env vars can be divided
! 125: into "client list & server list" by the "`&`" char or the same list can
! 126: apply to both.
! 127:
! 128: - Simplify how the negotiation environment variables apply when interacting
! 129: with an older rsync and also when a list contains only invalid names.
! 130:
! 131: - Do not allow a negotiated checksum or compression choice of "none" unless
! 132: the user authorized it via an environment variable or command-line option.
! 133:
! 134: - Added the `--max-alloc=SIZE` option to be able to override the memory
! 135: allocator's sanity-check limit. It defaults to 1G (as before) but the error
! 136: message when exceeding it specifically mentions the new option so that you
! 137: can differentiate an out-of-memory error from a failure of this limit. It
! 138: also allows you to specify the value via the RSYNC_MAX_ALLOC environment
! 139: variable.
! 140:
! 141: - Add the "open atime" daemon parameter to allow a daemon to always enable or
! 142: disable the use of O_NOATIME (the default is to let the user control it).
! 143:
! 144: - The default systemd config was changed to remove the `ProtectHome=on`
! 145: setting since rsync is often used to serve files in /home and /root and this
! 146: seemed a bit too strict. Feel free to use `systemctl edit rsync` to add
! 147: that restriction (or maybe `ProtectHome=read-only`), if you like. See the
! 148: 3.2.0 NEWS for the other restrictions that were added compared to 3.1.3.
! 149:
! 150: - The memory allocation functions now automatically check for a failure and
! 151: die when out of memory. This eliminated some caller-side check-and-die
! 152: code and added some missing sanity-checking of allocations.
! 153:
! 154: - Put optimizations into their own list in the `--version` output.
! 155:
! 156: - Improved the man page a bit more.
! 157:
! 158: ### PACKAGING RELATED:
! 159:
! 160: - Prepared the checksum code for an upcoming xxHash release that provides new
! 161: XXH3 (64-bit) & XXH128 (128-bit) checksum routines. These will not be
! 162: compiled into rsync until the xxhash v0.8.0 include files are installed on
! 163: the build host, and that release is a few weeks away at the time this was
! 164: written. So, if it's now the future and you have packaged and installed
! 165: xxhash-0.8.0-devel, a fresh rebuild of rsync 3.2.2 will give you the new
! 166: checksum routines. Just make sure that the new rsync package depends on
! 167: xxhash >= 0.8.0.
! 168:
! 169: ### DEVELOPER RELATED:
! 170:
! 171: - Moved the version number out of configure.ac into its own version.h file so
! 172: that we don't need to reconfigure just because the version number changes.
! 173:
! 174: - Moved the daemon parameter list into daemon-parm.txt so that an awk script
! 175: can create the interrelated structs and accessors that loadparm.c needs.
! 176:
! 177: ------------------------------------------------------------------------------
! 178: <a name="3.2.1"></a>
! 179:
! 180: # NEWS for rsync 3.2.1 (22 Jun 2020)
! 181:
! 182: ## Changes in this version:
! 183:
! 184: ### BUG FIXES:
! 185:
! 186: - Fixed a potential build issue with the MD5 assembly-language code by
! 187: removing some non-portable directives.
! 188:
! 189: - Use the preprocessor with the asm file to ensure that if the code is
! 190: unneeded, it doesn't get built.
! 191:
! 192: - Avoid the stack getting set to executable when including the asm code.
! 193:
! 194: - Some improvements in the SIMD configure testing to try to avoid build
! 195: issues, such as avoiding a clang++ core dump when `-g` is combined with
! 196: `-O2`. Note that clang++ is quite buggy in this area, and it does still
! 197: crash for some folks, so just use `--disable-simd` if you need to avoid
! 198: their buggy compiler (since the configure test is apparently not finding
! 199: all the compilers that will to crash and burn).
! 200:
! 201: - Fixed an issue in the md2man script when building from an alternate dir.
! 202:
! 203: - Disable `--atimes` on macOS (it apparently just ignores the atime change).
! 204:
! 205: ### ENHANCEMENTS:
! 206:
! 207: - The use of `--backup-dir=STR` now implies `--backup`.
! 208:
! 209: - Added `--zl=NUM` as a short-hand for `--compress-level=NUM`.
! 210:
! 211: - Added `--early-input=FILE` option that allows the client to send some
! 212: data to a daemon's (optional) "early exec" script on its stdin.
! 213:
! 214: - Mention atimes in the capabilities list that `--version` outputs.
! 215:
! 216: - Mention either "default protect-args" or "optional protect-args" in the
! 217: `--version` capabilities depending on how rsync was configured.
! 218:
! 219: - Some info on optimizations is now elided from the `--version` capabilities
! 220: since they aren't really user-facing capabilities. You can still see the
! 221: info (plus the status of a couple extra optimizations) by repeating the
! 222: `--version` option (e.g. `-VV`).
! 223:
! 224: - Updated various URLs to be https instead of http.
! 225:
! 226: - Some documentation improvements.
! 227:
! 228: ### PACKAGING RELATED:
! 229:
! 230: - If you had to use `--disable-simd` for 3.2.0, you might want to try removing
! 231: that and see if it will succeed or auto-disable. Some buggy clang++
! 232: compilers are still not auto disabled, though.
! 233:
! 234: - The MD5 asm code is now under its own configure flag (not shared with the
! 235: SIMD setting), so if you have any issues compiling it, re-run configure with
! 236: `--disable-asm`.
! 237:
! 238: - Merged the OLDNEWS.md file into NEWS.md.
! 239:
! 240: ------------------------------------------------------------------------------
! 241: <a name="3.2.0"></a>
! 242:
! 243: # NEWS for rsync 3.2.0 (19 Jun 2020)
! 244:
! 245: ## Changes in this version:
! 246:
! 247: ### BUG FIXES:
! 248:
! 249: - Avoid a potential out-of-bounds read in daemon mode if argc can be made to
! 250: become 0.
! 251:
! 252: - Fix the default list of skip-compress files for non-daemon transfers.
! 253:
! 254: - Fix xattr filter rules losing an 'x' attribute in a non-local transfer.
! 255:
! 256: - Avoid an error when a check for a potential fuzzy file happens to reference
! 257: a directory.
! 258:
! 259: - Make the atomic-rsync helper script have a more consistent error-exit.
! 260:
! 261: - Make sure that a signal handler's use of exit_cleanup() calls `_exit()`
! 262: instead of exit().
! 263:
! 264: - Various zlib fixes, including security fixes for CVE-2016-9843,
! 265: CVE-2016-9842, CVE-2016-9841, and CVE-2016-9840.
! 266:
! 267: - Fixed an issue with `--remove-source-files` not removing a source symlink
! 268: when combined with `--copy-links`.
! 269:
! 270: - Fixed a bug where the daemon would fail to write early fatal error messages
! 271: to the client, such as refused or unknown command-line options.
! 272:
! 273: - Fixed the block-size validation logic when dealing with older protocols.
! 274:
! 275: - Some rrsync fixes and enhancements to handle the latest options.
! 276:
! 277: - Fixed a problem with the `--link-dest`|`--copy-dest` code when `--xattrs`
! 278: was specified along with multiple alternate-destination directories (it
! 279: could possibly choose a bad file match while trying to find a better xattr
! 280: match).
! 281:
! 282: - Fixed a couple bugs in the handling of files with the `--sparse` option.
! 283:
! 284: - Fixed a bug in the writing of the batch.sh file (w/`--write-batch`) when the
! 285: source & destination args were not last on the command-line.
! 286:
! 287: - Avoid a hang when an overabundance of messages clogs up all the I/O buffers.
! 288:
! 289: - Fixed a mismatch in the RSYNC_PID values put into the environment of
! 290: `pre-xfer exec` and a `post-xfer exec`.
! 291:
! 292: - Fixed a crash in the `--iconv` code.
! 293:
! 294: - Fixed a rare crash in the popt_unalias() code.
! 295:
! 296: ### ENHANCEMENTS:
! 297:
! 298: - The default systemd config was made stricter by default. For instance,
! 299: `ProtectHome=on` (which hides content in /root and /home/USER dirs),
! 300: `ProtectSystem=full` (which makes /usr, /boot, & /etc dirs read-only), and
! 301: `PrivateDevices=on` (which hides devices). You can override any of these
! 302: using the standard `systemctl edit rsync` and add one or more directives
! 303: under a `[Service]` heading (and restart the rsync service).
! 304:
! 305: - Various checksum enhancements, including the optional use of openssl's MD4 &
! 306: MD5 checksum algorithms, some x86-64 optimizations for the rolling checksum,
! 307: some x86-64 optimizations for the (non-openssl) MD5 checksum, the addition
! 308: of xxHash checksum support, and a negotiation heuristic that ensures that it
! 309: is easier to add new checksum algorithms in the future. The environment
! 310: variable `RSYNC_CHECKSUM_LIST` can be used to customize the preference order
! 311: of the negotiation, or use `--checksum-choice` (`--cc`) to force a choice.
! 312:
! 313: - Various compression enhancements, including the addition of zstd and lz4
! 314: compression algorithms and a negotiation heuristic that picks the best
! 315: compression option supported by both sides. The environment variable
! 316: `RSYNC_COMPRESS_LIST` can be used to customize the preference order of the
! 317: negotiation, or use `--compress-choice` (`--zc`) to force a choice.
! 318:
! 319: - Added a `--debug=NSTR` option that outputs details of the new negotiation
! 320: strings (for checksums and compression). The first level just outputs the
! 321: result of each negotiation on the client, level 2 outputs the values of the
! 322: strings that were sent to and received from the server, and level 3 outputs
! 323: all those values on the server side too (when the server was given the debug
! 324: option).
! 325:
! 326: - The `--debug=OPTS` command-line option is no longer auto-forwarded to the
! 327: remote rsync which allows for the client and server to have different levels
! 328: of debug specified. This also allows for newer debug options to be
! 329: specified, such as using `--debug=NSTR` to see the negotiated hash result,
! 330: without having the command fail if the server version is too old to handle
! 331: that debug item. Use `-M--debug=OPTS` to send the options to the remote side.
! 332:
! 333: - Added the `--atimes` option based on the long-standing patch (just with some
! 334: fixes that the patch has been needing).
! 335:
! 336: - Added `--open-noatime` option to open files using `O_NOATIME`.
! 337:
! 338: - Added the `--write-devices` option based on the long-standing patch.
! 339:
! 340: - Added openssl & preliminary gnutls support to the rsync-ssl script, which is
! 341: now installed by default. This was unified with the old stunnel-rsync
! 342: helper script to simplify packaging. Note that the script accepts the use
! 343: of `--type=gnutls` for gnutls testing, but does not look for gnutls-cli on
! 344: the path yet. The use of `--type=gnutls` will not work right until
! 345: gnutls-cli no longer drops data.
! 346:
! 347: - Rsync was enhanced to set the `RSYNC_PORT` environment variable when running
! 348: a daemon-over-rsh script. Its value is the user-specified port number (set
! 349: via `--port` or an rsync:// URL) or 0 if the user didn't override the port.
! 350:
! 351: - Added the `proxy protocol` daemon parameter that allows your rsyncd to know
! 352: the real remote IP when it is setup behind a proxy.
! 353:
! 354: - Added negated matching to the daemon's `refuse options` setting by using
! 355: match strings that start with a `!` (such as `!compress*`). This lets you
! 356: refuse all options except for a particular approved list, for example. It
! 357: also lets rsync refuse certain options by default (such as `write-devices`)
! 358: while allowing the config to override that, as desired.
! 359:
! 360: - Added the `early exec` daemon parameter that runs a script before the
! 361: transfer parameters are known, allowing some early setup based on module
! 362: name.
! 363:
! 364: - Added status output in response to a signal (via both SIGINFO & SIGVTALRM).
! 365:
! 366: - Added `--copy-as=USER` option to give some extra security to root-run rsync
! 367: commands into/from untrusted directories (such as backups and restores).
! 368:
! 369: - When resuming the transfer of a file in the `--partial-dir`, rsync will now
! 370: update that partial file in-place instead of creating yet another tmp file
! 371: copy. This requires both sender & receiver to be at least v3.2.0.
! 372:
! 373: - Added support for `RSYNC_SHELL` & `RSYNC_NO_XFER_EXEC` environment variables
! 374: that affect the early, pre-xfer, and post-xfer exec rsync daemon parameters.
! 375:
! 376: - Optimize the `--fuzzy --fuzzy` heuristic to avoid the fuzzy directory scan
! 377: until all other basis-file options are exhausted (such as `--link-dest`).
! 378:
! 379: - Have the daemon log include the normal-exit sent/received stats when the
! 380: transfer exited with an error when possible (i.e. if it is the sender).
! 381:
! 382: - The daemon now locks its pid file (when configured to use one) so that it
! 383: will not fail to start when the file exists but no daemon is running.
! 384:
! 385: - Various man page improvements, including some html representations (that
! 386: aren't installed by default).
! 387:
! 388: - Made `-V` the short option for `--version` and improved its information.
! 389:
! 390: - Pass the `-4` or `-6` option to the ssh command, making it easier to type
! 391: than `--rsh='ssh -4'` (or the `-6` equivalent).
! 392:
! 393: - Added example config for rsyncd SSL proxy configs to rsyncd.conf.
! 394:
! 395: - More errors messages now mention if the error is coming from the sender or
! 396: the receiver.
! 397:
! 398: ### PACKAGING RELATED:
! 399:
! 400: - Add installed bash script: /usr/bin/rsync-ssl
! 401:
! 402: - Add installed man page: /usr/man/man1/rsync-ssl.1
! 403:
! 404: - Tweak auxiliary doc file names, such as: README.md, INSTALL.md, & NEWS.md.
! 405:
! 406: - The rsync-ssl script wants to run openssl or stunnel4, so consider adding a
! 407: dependency for one of those options (though it's probably fine to just let
! 408: it complain about being unable to find the program and let the user decide
! 409: if they want to install one or the other).
! 410:
! 411: - If you packaged rsync + rsync-ssl + rsync-ssl-daemon as separate packages,
! 412: the rsync-ssl package is now gone (rsync-ssl should be considered to be
! 413: mainstream now that Samba requires SSL for its rsync daemon).
! 414:
! 415: - Add _build_ dependency for liblz4-dev, libxxhash-dev, libzstd-dev, and
! 416: libssl-dev. These development libraries will give rsync extra compression
! 417: algorithms, extra checksum algorithms, and allow use of openssl's crypto
! 418: lib for (potentially) faster MD4/MD5 checksums.
! 419:
! 420: - Add _build_ dependency for g++ or clang++ on x86_64 systems to enable the
! 421: SIMD checksum optimizations.
! 422:
! 423: - Add _build_ dependency for _either_ python3-cmarkcfm or python3-commonmark
! 424: to allow for patching of man pages or building a git release. This is not
! 425: required for a release-tar build, since it comes with pre-built man pages.
! 426: Note that cmarkcfm is faster than commonmark, but they generate the same
! 427: data. The commonmark dependency is easiest to install since it's native
! 428: python, and can even be installed via `pip3 install --user commonmark` if
! 429: you want to just install it for the build user.
! 430:
! 431: - Remove yodl _build_ dependency (if it was even listed before).
! 432:
! 433: ### DEVELOPER RELATED:
! 434:
! 435: - Silenced some annoying warnings about major() & minor() by improving an
! 436: autoconf include-file check.
! 437:
! 438: - Converted the man pages from yodl to markdown. They are now processed via a
! 439: simple python3 script using the cmarkgfm **or** commonmark library. This
! 440: should make it easier to package rsync, since yodl is rather obscure.
! 441:
! 442: - Improved some configure checks to work better with strict C99 compilers.
! 443:
! 444: - Some perl building/packaging scripts were recoded into awk and python3.
! 445:
! 446: - Some defines in byteorder.h were changed into static inline functions that
! 447: will help to ensure that the args don't get evaluated multiple times on
! 448: "careful alignment" hosts.
! 449:
! 450: - Some code typos were fixed (as pointed out by a Fossies run).
! 451:
! 452: ------------------------------------------------------------------------------
! 453: <a name="3.1.3"></a>
! 454:
! 455: # NEWS for rsync 3.1.3 (28 Jan 2018)
! 456:
! 457: ## Changes in this version:
! 458:
! 459: ### SECURITY FIXES:
! 460:
! 461: - Fixed a buffer overrun in the protocol's handling of xattr names and ensure
! 462: that the received name is null terminated.
! 463:
! 464: - Fix an issue with `--protect-args` where the user could specify the arg in the
! 465: protected-arg list and short-circuit some of the arg-sanitizing code.
! 466:
! 467: ### BUG FIXES:
! 468:
! 469: - Don't output about a new backup dir without appropriate info verbosity.
! 470:
! 471: - Fixed some issues with the sort functions in support/rsyncstats script.
! 472:
! 473: - Added a way to specify daemon config lists (e.g. users, groups, etc) that
! 474: contain spaces (see `auth users` in the latest rsyncd.conf manpage).
! 475:
! 476: - If a backup fails (e.g. full disk) rsync exits with an error.
! 477:
! 478: - Fixed a problem with a doubled `--fuzzy` option combined with `--link-dest`.
! 479:
! 480: - Avoid invalid output in the summary if either the start or end time had an
! 481: error.
! 482:
! 483: - We don't allow a popt alias to affect the `--daemon` or `--server` options.
! 484:
! 485: - Fix daemon exclude code to disallow attribute changes in addition to
! 486: disallowing transfers.
! 487:
! 488: - Don't force nanoseconds to match if a non-transferred, non-checksummed file
! 489: only passed the quick-check w/o comparing nanoseconds.
! 490:
! 491: ### ENHANCEMENTS:
! 492:
! 493: - Added the ability for rsync to compare nanosecond times in its file-check
! 494: comparisons, and added support nanosecond times on Mac OS X.
! 495:
! 496: - Added a short-option (`-@`) for `--modify-window`.
! 497:
! 498: - Added the `--checksum-choice=NAME[,NAME]` option to choose the checksum
! 499: algorithms.
! 500:
! 501: - Added hashing of xattr names (with using `-X`) to improve the handling of
! 502: files with large numbers of xattrs.
! 503:
! 504: - Added a way to filter xattr names using include/exclude/filter rules (see
! 505: the `--xattrs` option in the manpage for details).
! 506:
! 507: - Added `daemon chroot|uid|gid` to the daemon config (in addition to the old
! 508: chroot|uid|gid settings that affect the daemon's transfer process).
! 509:
! 510: - Added `syslog tag` to the daemon configuration.
! 511:
! 512: - Some manpage improvements.
! 513:
! 514: ### DEVELOPER RELATED:
! 515:
! 516: - Tweak the `make` output when yodl isn't around to create the man pages.
! 517:
! 518: - Changed an obsolete autoconf compile macro.
! 519:
! 520: - Support newer yodl versions when converting man pages.
! 521:
! 522: ------------------------------------------------------------------------------
! 523: <a name="3.1.2"></a>
! 524:
! 525: # NEWS for rsync 3.1.2 (21 Dec 2015)
! 526:
! 527: ## Changes in this version:
! 528:
! 529: ### SECURITY FIXES:
! 530:
! 531: - Make sure that all transferred files use only path names from inside the
! 532: transfer. This makes it impossible for a malicious sender to try to make the
! 533: receiver use an unsafe destination path for a transferred file, such as a
! 534: just-sent symlink.
! 535:
! 536: ### BUG FIXES:
! 537:
! 538: - Change the checksum seed order in the per-block checksums. This prevents
! 539: someone from trying to create checksum blocks that match in sum but not
! 540: content.
! 541:
! 542: - Fixed a with the per-dir filter files (using `-FF`) that could trigger an
! 543: assert failure.
! 544:
! 545: - Only skip `set_modtime()` on a transferred file if the time is exactly
! 546: right.
! 547:
! 548: - Don't create an empty backup dir for a transferred file that doesn't exist
! 549: yet.
! 550:
! 551: - Fixed a bug where `--link-dest` and `--xattrs` could cause rsync to exit if
! 552: a filename had a matching dir of the same name in the alt-dest area.
! 553:
! 554: - Allow more than 32 group IDs per user in the daemon's gid=LIST config.
! 555:
! 556: - Fix the logging of %b & %c via `--log-file` (daemon logging was already
! 557: correct, as was `--out-format='%b/%c'`).
! 558:
! 559: - Fix erroneous acceptance of `--info=5` & `--debug=5` (an empty flag name is
! 560: not valid).
! 561:
! 562: ### ENHANCEMENTS:
! 563:
! 564: - Added `(DRY RUN)` info to the `--debug=exit` output line.
! 565:
! 566: - Use usleep() for our msleep() function if it is available.
! 567:
! 568: - Added a few extra long-option names to rrsync script, which will make
! 569: BackupPC happier.
! 570:
! 571: - Made configure choose to use Linux xattrs on NetBSD (rather than not
! 572: supporting xattrs).
! 573:
! 574: - Added `-wo` (write-only) option to rrsync support script.
! 575:
! 576: - Misc. manpage tweaks.
! 577:
! 578: ### DEVELOPER RELATED:
! 579:
! 580: - Fixed a bug with the Makefile's use of `INSTALL_STRIP`.
! 581:
! 582: - Improve a test in the suite that could get an erroneous timestamp error.
! 583:
! 584: - Tweaks for newer versions of git in the packaging tools.
! 585:
! 586: - Improved the m4 generation rules and some autoconf idioms.
! 587:
! 588: ------------------------------------------------------------------------------
! 589: <a name="3.1.1"></a>
! 590:
! 591: # NEWS for rsync 3.1.1 (22 Jun 2014)
! 592:
! 593: ## Changes in this version:
! 594:
! 595: ### BUG FIXES:
! 596:
! 597: - If the receiver gets bogus filenames from the sender (an unexpected leading
! 598: slash or a `..` infix dir), exit with an error. This prevents a malicious
! 599: sender from trying to inject filenames that would affect an area outside the
! 600: destination directories.
! 601:
! 602: - Fixed a failure to remove the partial-transfer temp file when interrupted
! 603: (and rsync is not saving the partial files).
! 604:
! 605: - Changed the chown/group/xattr-set order to avoid losing some security-
! 606: related xattr info (that would get cleared by a chown).
! 607:
! 608: - Fixed a bug in the xattr-finding code that could make a non-root-run
! 609: receiver not able to find some xattr numbers.
! 610:
! 611: - Fixed a bug in the early daemon protocol where a timeout failed to be
! 612: honored (e.g. if the remote side fails to send us the initial protocol
! 613: greeting).
! 614:
! 615: - Fixed unintended inclusion of commas in file numbers in the daemon log.
! 616:
! 617: - We once again send the 'f' sub-flag (of `-e`) to the server side so it knows
! 618: that we can handle incremental-recursion directory errors properly in older
! 619: protocols.
! 620:
! 621: - Fixed an issue with too-aggressive keep-alive messages causing a problem for
! 622: older rsync versions early in the transfer.
! 623:
! 624: - Fixed an incorrect message about backup-directory-creation when using
! 625: `--dry-run` and the backup dir is not an absolute path.
! 626:
! 627: - Fixed a bug where a failed deletion and/or a failed sender-side removal
! 628: would not affect the exit code.
! 629:
! 630: - Fixed a bug that caused a failure when combining `--delete-missing-args`
! 631: with `--xattrs` and/or `--acls`.
! 632:
! 633: - Fixed a strange `dir_depth` assertion error that was caused by empty-dir
! 634: removals and/or duplicate files in the transfer.
! 635:
! 636: - Fixed a problem with `--info=progress2`'s output stats where rsync would
! 637: only update the stats at the end of each file's transfer. It now uses the
! 638: data that is flowing for the current file, making the stats more accurate
! 639: and less jumpy.
! 640:
! 641: - Fixed an itemize bug that affected the combo of `--link-dest`, `-X`, and
! 642: `-n`.
! 643:
! 644: - Fixed a problem with delete messages not appearing in the log file when the
! 645: user didn't use `--verbose`.
! 646:
! 647: - Improve chunked xattr reading for OS X.
! 648:
! 649: - Removed an attempted hard-link xattr optimization that was causing a
! 650: transfer failure. This removal is flagged in the compatibility code, so if a
! 651: better fix can be discovered, we have a way to flip it on again.
! 652:
! 653: - Fixed a bug when the receiver is not configured to be able to hard link
! 654: symlimks/devices/special-file items but the sender sent some of these items
! 655: flagged as hard-linked.
! 656:
! 657: - We now generate a better error if the buffer overflows in `do_mknod()`.
! 658:
! 659: - Fixed a problem reading more than 16 ACLs on some OSes.
! 660:
! 661: - Fixed the reading of the secrets file to avoid an infinite wait when the
! 662: username is missing.
! 663:
! 664: - Fixed a parsing problem in the `--usermap`/`--groupmap` options when using
! 665: MIN-MAX numbers.
! 666:
! 667: - Switched Cygwin back to using socketpair `pipes` to try to speed it up.
! 668:
! 669: - Added knowledge of a few new options to rrsync.
! 670:
! 671: ### ENHANCEMENTS:
! 672:
! 673: - Tweaked the temp-file naming when `--temp-dir=DIR` is used: the temp-file
! 674: names will not get a '.' prepended.
! 675:
! 676: - Added support for a new-compression idiom that does not compress all the
! 677: matching data in a transfer. This can help rsync to use less cpu when a
! 678: transfer has a lot of matching data, and also makes rsync compatible with a
! 679: non-bundled zlib. See the `--new-compress` and `--old-compress` options in
! 680: the manpage.
! 681:
! 682: - Added the support/rsync-no-vanished wrapper script.
! 683:
! 684: - Made configure more prominently mention when we failed to find yodl (in case
! 685: the user wants to be able to generate manpages from `*.yo` files).
! 686:
! 687: - Have manpage mention how a daemon's max-verbosity setting affects info and
! 688: debug options. Also added more clarification on backslash removals for
! 689: excludes that contain wildcards.
! 690:
! 691: - Have configure check if for the attr lib (for getxattr) for those systems
! 692: that need to link against it explicitly.
! 693:
! 694: - Change the early dir-creation logic to only use that idiom in an
! 695: inc-recursive copy that is preserving directory times. e.g. using
! 696: `--omit-dir-times` will avoid these early directories being created.
! 697:
! 698: - Fix a bug in `cmp_time()` that would return a wrong result if the 2 times
! 699: differed by an amount greater than what a `time_t` can hold.
! 700:
! 701: ### DEVELOPER RELATED:
! 702:
! 703: - We now include an example systemd file (in packaging/systemd).
! 704:
! 705: - Tweaked configure to make sure that any intended use of the included popt
! 706: and/or zlib code is put early in the CFLAGS.
! 707:
! 708: ------------------------------------------------------------------------------
! 709: <a name="3.1.0"></a>
! 710:
! 711: # NEWS for rsync 3.1.0 (28 Sep 2013)
! 712:
! 713: ## Changes in this version:
! 714:
! 715: ### PROTOCOL NUMBER:
! 716:
! 717: - The protocol number was changed to 31.
! 718:
! 719: ### OUTPUT CHANGES:
! 720:
! 721: - Output numbers in 3-digit groups by default (e.g. 1,234,567). See the
! 722: `--human-readable` option for a way to turn it off. See also the daemon's
! 723: `log format` parameter and related command-line options (including
! 724: `--out-format`) for a modifier that can be used to request digit-grouping or
! 725: human-readable output in log escapes. (Note that log output is unchanged by
! 726: default.)
! 727:
! 728: - The `--list-only` option is now affected by the `--human-readable` setting.
! 729: It will display digit groupings by default, and unit suffixes if higher
! 730: levels of readability are requested. Also, the column width for the size
! 731: output has increased from 11 to 14 characters when human readability is
! 732: enabled. Use `--no-h` to get the old-style output and column size.
! 733:
! 734: - The output of the `--progress` option has changed: the string `xfer` was
! 735: shortened to `xfr`, and the string `to-check` was shortened to `to-chk`,
! 736: both designed to make room for the (by default) wider display of file size
! 737: numbers without making the total line-length longer. Also, when incremental
! 738: recursion is enabled, the string `ir-chk` will be used instead of `to-chk`
! 739: up until the incremental-recursion scan is done, letting you know that the
! 740: value to check and the total value will still be increasing as new files are
! 741: found.
! 742:
! 743: - Enhanced the `--stats` output: 1) to mention how many files were created
! 744: (protocol >= 28), 2) to mention how many files were deleted (a new line for
! 745: protocol 31, but only output when `--delete` is in effect), and 3) to follow
! 746: the file-count, created-count, and deleted-count with a subcount list that
! 747: shows the counts by type. The wording of the transferred count has also
! 748: changed so that it is clearer that it is only a count of regular files.
! 749:
! 750: ### BUG FIXES:
! 751:
! 752: - Fixed a bug in the iconv code when EINVAL or EILSEQ is returned with a full
! 753: output buffer.
! 754:
! 755: - Fixed some rare bugs in `--iconv` processing that might cause a multibyte
! 756: character to get translated incorrectly.
! 757:
! 758: - Fixed a bogus `vanished file` error if some files were specified with `./`
! 759: prefixes and others were not.
! 760:
! 761: - Fixed a bug in `--sparse` where an extra gap could get inserted after a
! 762: partial write.
! 763:
! 764: - Changed the way `--progress` overwrites its prior output in order to make it
! 765: nearly impossible for the progress to get overwritten by an error.
! 766:
! 767: - Improved the propagation of abnormal-exit error messages. This should help
! 768: the client side to receive errors from the server when it is exiting
! 769: abnormally, and should also avoid dying with an `connection unexpectedly
! 770: closed` exit when the closed connection is really expected.
! 771:
! 772: - The sender now checks each file it plans to remove to ensure that it hasn't
! 773: changed from the first stat's info. This helps to avoid losing file data
! 774: when the user is not using the option in a safe manner.
! 775:
! 776: - Fixed a data-duplication bug in the compress option that made compression
! 777: less efficient. This improves protocol 31 onward, while behaving in a
! 778: compatible (buggy) manner with older rsync protocols.
! 779:
! 780: - When creating a temp-file, rsync is now a bit smarter about it dot-char
! 781: choices, which can fix a problem on OS X with names that start with `..`.
! 782:
! 783: - Rsync now sets a cleanup flag for `--inplace` and `--append` transfers that
! 784: will flush the write buffer if the transfer aborts. This ensures that more
! 785: received data gets written out to the disk on an aborted transfer (which is
! 786: quite helpful on a slow, flaky connection).
! 787:
! 788: - The reads that `map_ptr()` now does are aligned on 1K boundaries. This helps
! 789: some filesystems and/or files that don't like unaligned reads.
! 790:
! 791: - Fix an issue in the msleep() function if time jumps backwards.
! 792:
! 793: - Fix daemon-server module-name splitting bug where an arg would get split
! 794: even if `--protect-args` was used.
! 795:
! 796: ### ENHANCEMENTS:
! 797:
! 798: - Added the `--remote-option=OPT` (`-M OPT`) command-line option that is
! 799: useful for things like sending a remote `--log-file=FILE` or `--fake-super`
! 800: option.
! 801:
! 802: - Added the `--info=FLAGS` and `--debug=FLAGS` options to allow finer-grained
! 803: control over what is output. Added an extra type of `--progress` output
! 804: using `--info=progress2`.
! 805:
! 806: - The `--msgs2stderr` option can help with debugging rsync by allowing the
! 807: debug messages to get output to stderr rather than travel via the socket
! 808: protocol.
! 809:
! 810: - Added the `--delete-missing-args` and `--ignore-missing-args` options to
! 811: either delete or ignore user-specified files on the receiver that are
! 812: missing on the sender (normally the absence of user-specified files
! 813: generates an error).
! 814:
! 815: - Added a `T` (terabyte) category to the `--human-readable` size suffixes.
! 816:
! 817: - Added the `--usermap`/`--groupmap`/`--chown` options for manipulating file
! 818: ownership during the copy.
! 819:
! 820: - Added the `%C` escape to the log-output handling, which will output the MD5
! 821: checksum of any transferred file, or all files if `--checksum` was specified
! 822: (when protocol 30 or above is in effect).
! 823:
! 824: - Added the `reverse lookup` parameter to the rsync daemon config file to
! 825: allow reverse-DNS lookups to be disabled.
! 826:
! 827: - Added a forward-DNS lookup for the daemon's hosts allow/deny config. Can be
! 828: disabled via `forward lookup` parameter (defaults to enabled).
! 829:
! 830: - Added a way for more than one group to be specified in the daemon's config
! 831: file, including a way to specify that you want all of the specified user's
! 832: groups without having to name them. Also changed the daemon to complain
! 833: about an inability to set explicitly-specified uid/gid values, even when not
! 834: run by a super-user.
! 835:
! 836: - The daemon now tries to send the user the error messages from the pre-xfer
! 837: exec script when it fails.
! 838:
! 839: - Improved the use of alt-dest options into an existing hierarchy of files: If
! 840: a match is found in an alt-dir, it takes precedence over an existing file.
! 841: (We'll need to wait for a future version before attribute-changes on
! 842: otherwise unchanged files are safe when using an existing hierarchy.)
! 843:
! 844: - Added per-user authorization options and group-authorization support to the
! 845: daemon's `auth users` parameter.
! 846:
! 847: - Added a way to reference environment variables in a daemon's config file
! 848: (using %VAR% references).
! 849:
! 850: - When replacing a non-dir with a symlink/hard-link/device/special-file, the
! 851: update should now be done in an atomic manner.
! 852:
! 853: - Avoid re-sending xattr info for hard-linked files w/the same xattrs
! 854: (protocol 31).
! 855:
! 856: - The backup code was improved to use better logic maintaining the backup
! 857: directory hierarchy. Also, when a file is being backed up, rsync tries to
! 858: hard-link it into place so that the upcoming replacement of the destination
! 859: file will be atomic (for the normal, non-inplace logic).
! 860:
! 861: - Added the ability to synchronize nano-second modified times.
! 862:
! 863: - Added a few more default suffixes for the `dont compress` settings.
! 864:
! 865: - Added the checking of the `RSYNC_PROTECT_ARGS` environment variable to allow
! 866: the default for the `--protect-args` command-line option to be overridden.
! 867:
! 868: - Added the `--preallocate` command-line option.
! 869:
! 870: - Allow `--password-file=-` to read the password from stdin (filename `-`).
! 871:
! 872: - Rsync now comes packaged with an rsync-ssl helper script that can be used to
! 873: contact a remote rsync daemon using a piped-stunnel command. It also
! 874: includes an stunnel config file to run the server side to support ssl daemon
! 875: connections. See the packaging/lsb/rsync.spec file for one way to package
! 876: the resulting files. (Suggestions for how to make this even easier to
! 877: install & use are welcomed.)
! 878:
! 879: - Improved the speed of some `--inplace` updates when there are lots of
! 880: identical checksum blocks that end up being unusable.
! 881:
! 882: - Added the `--outbuf=N|L|B` option for choosing the output buffering.
! 883:
! 884: - Repeating the `--fuzzy` option now causes the code to look for fuzzy matches
! 885: inside alt-dest directories too.
! 886:
! 887: - The `--chmod` option now supports numeric modes, e.g. `--chmod=644,D755`
! 888:
! 889: - Added some Solaris xattr code.
! 890:
! 891: - Made an rsync daemon (the listening process) exit with a 0 status when it
! 892: was signaled to die. This helps launchd.
! 893:
! 894: - Improved the `RSYNC_*` environment variables for the pre-xfer exec script:
! 895: when a daemon is sent multiple request args, they are now joined into a
! 896: single return value (separated by spaces) so that the `RSYNC_REQUEST`
! 897: environment variable is accurate for any `pre-xfer exec`. The values in
! 898: `RSYNC_ARG#` vars are no longer truncated at the `.` arg (prior to the
! 899: request dirs/files), so that all the requested values are also listed
! 900: (separately) in `RSYNC_ARG#` variables.
! 901:
! 902: ### EXTRAS:
! 903:
! 904: - Added an `instant-rsyncd` script to the support directory, which makes it
! 905: easy to configure a simple rsync daemon in the current directory.
! 906:
! 907: - Added the `mapfrom` and `mapto` scripts to the support directory, which
! 908: makes it easier to do user/group mapping in a local transfer based on
! 909: passwd/group files from another machine.
! 910:
! 911: - There's a new, improved version of the lsh script in the support dir: it's
! 912: written in perl and supports `-u` without resorting to using sudo (when run
! 913: as root). The old shell version is now named lsh.sh.
! 914:
! 915: - There is a helper script named rsync-slash-strip in the support directory
! 916: for anyone that wants to change the way rsync handles args with trailing
! 917: slashes. (e.g. arg/ would get stripped to arg while arg/. would turn into
! 918: arg/).
! 919:
! 920: ### INTERNAL:
! 921:
! 922: - The I/O code was rewritten to be simpler and do bigger buffered reads over
! 923: the socket. The I/O between the receiver and the generator was changed to be
! 924: standard multiplexed-I/O (like that over the socket).
! 925:
! 926: - The sender tries to use any dead time while the generator is looking for
! 927: files to transfer in order to do sender-side directory scanning in a more
! 928: parallel manner.
! 929:
! 930: - A daemon can now inform a client about a daemon-configured timeout value so
! 931: that the client can assist in the keep-alive activity (protocol 31).
! 932:
! 933: - The filter code received some refactoring to make it more extendable, to
! 934: read better, and do better sanity checking.
! 935:
! 936: - Really big numbers are now output using our own big-num routine rather than
! 937: casting them to a double and using a %.0f conversion.
! 938:
! 939: - The `pool_alloc` library has received some minor improvements in alignment
! 940: handling.
! 941:
! 942: - Added `init_stat_x()` function to avoid duplication of acl/xattr init code.
! 943:
! 944: - The included zlib was upgraded from 1.2.3 to 1.2.8.
! 945:
! 946: - Rsync can now be compiled to use an unmodified zlib library instead of the
! 947: tweaked one that is included with rsync. This will eventually become the
! 948: default, at which point we'll start the countdown to removing the included
! 949: zlib. Until then, feel free to configure using:
! 950:
! 951: ./configure `--with-included-zlib=no`
! 952:
! 953: ### DEVELOPER RELATED:
! 954:
! 955: - Added more conditional debug output.
! 956:
! 957: - Fixed some build issues for Android and Minix.
! 958:
! 959: ------------------------------------------------------------------------------
! 960: <a name="3.0.9"></a>
! 961:
! 962: # NEWS for rsync 3.0.9 (23 Sep 2011)
! 963:
! 964: ## Changes in this version:
! 965:
! 966: ### BUG FIXES:
! 967:
! 968: - Fix a crash bug in checksum scanning when `--inplace` is used.
! 969:
! 970: - Fix a hang if a hard-linked file cannot be opened by the sender (e.g. if it
! 971: has no read permission).
! 972:
! 973: - Fix preservation of a symlink's system xattrs (e.g. selinux) on Linux.
! 974:
! 975: - Fix a memory leak in the xattr code.
! 976:
! 977: - Fixed a bug with `--delete-excluded` when a filter merge file has a rule
! 978: that specifies a receiver-only side restriction.
! 979:
! 980: - Fix a bug with the modifying of unwritable directories.
! 981:
! 982: - Fix `--fake-super`'s interaction with `--link-dest` same-file comparisons.
! 983:
! 984: - Fix the updating of the `curr_dir` buffer to avoid a duplicate slash.
! 985:
! 986: - Fix the directory permissions on an implied dot-dir when using `--relative`
! 987: (e.g. /outside/path/././send/path).
! 988:
! 989: - Fixed some too-long sleeping instances when using `--bwlimit`.
! 990:
! 991: - Fixed when symlink ownership difference-checking gets compiled into
! 992: `unchanged_attrs()`.
! 993:
! 994: - Improved the socket-error reporting when multiple protocols fail.
! 995:
! 996: - Fixed a case where a socket error could reference just-freed memory.
! 997:
! 998: - Failing to use a password file that was specified on the command-line is now
! 999: a fatal error.
! 1000:
! 1001: - Fix the non-root updating of directories that don't have the read and/or
! 1002: execute permission.
! 1003:
! 1004: - Make daemon-excluded file errors more error-like.
! 1005:
! 1006: - Fix a compilation issue on older C compilers (due to a misplaced var
! 1007: declaration).
! 1008:
! 1009: - Make configure avoid finding socketpair on Cygwin.
! 1010:
! 1011: - Avoid trying to reference `SO_BROADCAST` if the OS doesn't support it.
! 1012:
! 1013: - Fix some issues with the post-processing of the man pages.
! 1014:
! 1015: - Fixed the user home-dir handling in the support/lsh script.
! 1016:
! 1017: - Some minor manpage improvements.
! 1018:
! 1019: ------------------------------------------------------------------------------
! 1020: <a name="3.0.8"></a>
! 1021:
! 1022: # NEWS for rsync 3.0.8 (26 Mar 2011)
! 1023:
! 1024: ## Changes in this version:
! 1025:
! 1026: ### BUG FIXES:
! 1027:
! 1028: - Fixed two buffer-overflow issues: one where a directory path that is exactly
! 1029: MAXPATHLEN was not handled correctly, and one handling a `--backup-dir` that
! 1030: is extra extra large.
! 1031:
! 1032: - Fixed a data-corruption issue when preserving hard-links without preserving
! 1033: file ownership, and doing deletions either before or during the transfer
! 1034: (CVE-2011-1097). This fixes some assert errors in the hard-linking code, and
! 1035: some potential failed checksums (via `-c`) that should have matched.
! 1036:
! 1037: - Fixed a potential crash when an rsync daemon has a filter/exclude list and
! 1038: the transfer is using ACLs or xattrs.
! 1039:
! 1040: - Fixed a hang if a really large file is being processed by an rsync that
! 1041: can't handle 64-bit numbers. Rsync will now complain about the file being
! 1042: too big and skip it.
! 1043:
! 1044: - For devices and special files, we now avoid gathering useless ACL and/or
! 1045: xattr information for files that aren't being copied. (The un-copied files
! 1046: are still put into the file list, but there's no need to gather data that is
! 1047: not going to be used.) This ensures that if the user uses `--no-D`, that
! 1048: rsync can't possibly complain about being unable to gather extended
! 1049: information from special files that are in the file list (but not in the
! 1050: transfer).
! 1051:
! 1052: - Properly handle requesting remote filenames that start with a dash. This
! 1053: avoids a potential error where a filename could be interpreted as a (usually
! 1054: invalid) option.
! 1055:
! 1056: - Fixed a bug in the comparing of upper-case letters in file suffixes for
! 1057: `--skip-compress`.
! 1058:
! 1059: - If an rsync daemon has a module configured without a path setting, rsync
! 1060: will now disallow access to that module.
! 1061:
! 1062: - If the destination arg is an empty string, it will be treated as a reference
! 1063: to the current directory (as 2.x used to do).
! 1064:
! 1065: - If rsync was compiled with a newer time-setting function (such as lutimes),
! 1066: rsync will fall-back to an older function (such as utimes) on a system where
! 1067: the newer function is not around. This helps to make the rsync binary more
! 1068: portable in mixed-OS-release situations.
! 1069:
! 1070: - Fixed a batch-file writing bug that would not write out the full set of
! 1071: compatibility flags that the transfer was using. This fixes a potential
! 1072: protocol problem for a batch file that contains a sender-side I/O error: it
! 1073: would have been sent in a way that the batch-reader wasn't expecting.
! 1074:
! 1075: - Some improvements to the hard-linking code to ensure that device-number
! 1076: hashing is working right, and to supply more information if the hard-link
! 1077: code fails.
! 1078:
! 1079: - The `--inplace` code was improved to not search for an impossible checksum
! 1080: position. The quadruple-verbose chunk[N] message will now mention when an
! 1081: inplace chunk was handled by a seek rather than a read+write.
! 1082:
! 1083: - Improved ACL mask handling, e.g. for Solaris.
! 1084:
! 1085: - Fixed a bug that prevented `--numeric-ids` from disabling the translation of
! 1086: user/group IDs for ACLs.
! 1087:
! 1088: - Fixed an issue where an xattr and/or ACL transfer that used an alt-dest
! 1089: option (e.g. `--link-dest`) could output an error trying to itemize the
! 1090: changes against the alt-dest directory's xattr/ACL info but was instead
! 1091: trying to access the not-yet-existing new destination directory.
! 1092:
! 1093: - Improved xattr system-error messages to mention the full path to the file.
! 1094:
! 1095: - The `--link-dest` checking for identical symlinks now avoids considering
! 1096: attribute differences that cannot be changed on the receiver.
! 1097:
! 1098: - Avoid trying to read/write xattrs on certain file types for certain OSes.
! 1099: Improved configure to set `NO_SYMLINK_XATTRS`, `NO_DEVICE_XATTRS`, and/or
! 1100: `NO_SPECIAL_XATTRS` defines in config.h.
! 1101:
! 1102: - Improved the unsafe-symlink errors messages.
! 1103:
! 1104: - Fixed a bug setting xattrs on new files that aren't user writable.
! 1105:
! 1106: - Avoid re-setting xattrs on a hard-linked file w/the same xattrs.
! 1107:
! 1108: - Fixed a bug with `--fake-super` when copying files and dirs that aren't user
! 1109: writable.
! 1110:
! 1111: - Fixed a bug where a sparse file could have its last sparse block turned into
! 1112: a real block when rsync sets the file size (requires ftruncate).
! 1113:
! 1114: - If a temp-file name is too long, rsync now avoids truncating the name in the
! 1115: middle of adjacent high-bit characters. This prevents a potential filename
! 1116: error if the filesystem doesn't allow a name to contain an invalid
! 1117: multi-byte sequence.
! 1118:
! 1119: - If a muli-protocol socket connection fails (i.e., when contacting a daemon),
! 1120: we now report all the failures, not just the last one. This avoids losing a
! 1121: relevant error (e.g. an IPv4 connection-refused error) that happened before
! 1122: the final error (e.g. an IPv6 protocol-not-supported error).
! 1123:
! 1124: - Generate a transfer error if we try to call chown with a `-1` for a uid or a
! 1125: gid (which is not settable).
! 1126:
! 1127: - Fixed the working of `--force` when used with `--one-file-system`.
! 1128:
! 1129: - Fix the popt arg parsing so that an option that doesn't take an arg will
! 1130: reject an attempt to supply one (can configure `--with-included-popt` if
! 1131: your system's popt library doesn't yet have this fix).
! 1132:
! 1133: - A couple minor option tweaks to the support/rrsync script, and also some
! 1134: regex changes that make vim highlighting happier.
! 1135:
! 1136: - Fixed some issues in the support/mnt-excl script.
! 1137:
! 1138: - Various manpage improvements.
! 1139:
! 1140: ### ENHANCEMENTS:
! 1141:
! 1142: - Added `.hg/` to the default cvs excludes (see `-C` & `--cvs-exclude`).
! 1143:
! 1144: ### DEVELOPER RELATED:
! 1145:
! 1146: - Use lchmod() whenever it is available (not just on symlinks).
! 1147:
! 1148: - A couple fixes to the `socketpair_tcp()` routine.
! 1149:
! 1150: - Updated the helper scripts in the packaging subdirectory.
! 1151:
! 1152: - Renamed configure.in to configure.ac.
! 1153:
! 1154: - Fixed configure's checking for iconv routines for newer OS X versions.
! 1155:
! 1156: - Fixed the testsuite/xattrs.test script on OS X.
! 1157:
! 1158: ------------------------------------------------------------------------------
! 1159: <a name="3.0.7"></a>
! 1160:
! 1161: # NEWS for rsync 3.0.7 (31 Dec 2009)
! 1162:
! 1163: ## Changes in this version:
! 1164:
! 1165: ### BUG FIXES:
! 1166:
! 1167: - Fixed a bogus free when using `--xattrs` with `--backup`.
! 1168:
! 1169: - Avoid an error when `--dry-run` was trying to stat a prior hard-link file
! 1170: that hasn't really been created.
! 1171:
! 1172: - Fixed a problem with `--compress` (`-z`) where the receiving side could
! 1173: return the error "inflate (token) returned -5".
! 1174:
! 1175: - Fixed a bug where `--delete-during` could delete in a directory before it
! 1176: noticed that the sending side sent an I/O error for that directory (both
! 1177: sides of the transfer must be at least 3.0.7).
! 1178:
! 1179: - Improved `--skip-compress`'s error handling of bad character-sets and got
! 1180: rid of a lingering debug fprintf().
! 1181:
! 1182: - Fixed the daemon's conveyance of `io_error` value from the sender.
! 1183:
! 1184: - An rsync daemon use seteuid() (when available) if it used setuid().
! 1185:
! 1186: - Get the permissions right on a `--fake-super` transferred directory that
! 1187: needs more owner permissions to emulate root behavior.
! 1188:
! 1189: - An absolute-path filter rule (i.e. with a '/' modifier) no longer loses its
! 1190: modifier when sending the filter rules to the remote rsync.
! 1191:
! 1192: - Improved the "--delete does not work without -r or -d" message.
! 1193:
! 1194: - Improved rsync's handling of `--timeout` to avoid a weird timeout case where
! 1195: the sender could timeout even though it has recently written data to the
! 1196: socket (but hasn't read data recently, due to the writing).
! 1197:
! 1198: - Some misc manpage improvements.
! 1199:
! 1200: - Fixed the chmod-temp-dir testsuite on a system without /var/tmp.
! 1201:
! 1202: - Make sure that a timeout specified in the daemon's config is used as a
! 1203: maximum timeout value when the user also specifies a timeout.
! 1204:
! 1205: - Improved the error-exit reporting when rsync gets an error trying to cleanup
! 1206: after an error: the initial error is reported.
! 1207:
! 1208: - Improved configure's detection of IPv6 for Solaris and Cygwin.
! 1209:
! 1210: - The AIX sysacls routines will now return ENOSYS if ENOTSUP is missing.
! 1211:
! 1212: - Made our (only used if missing) getaddrinfo() routine use `inet_pton()`
! 1213: (which we also provide) instead of `inet_aton()`.
! 1214:
! 1215: - The exit-related debug messages now mention the program's role so it is
! 1216: clear who output what message.
! 1217:
! 1218: ### DEVELOPER RELATED:
! 1219:
! 1220: - Got rid of type-punned compiler warnings output by newer gcc versions.
! 1221:
! 1222: - The Makefile now ensures that proto.h will be rebuilt if config.h changes.
! 1223:
! 1224: - The testsuite no longer uses `id -u`, so it works better on Solaris.
! 1225:
! 1226: ------------------------------------------------------------------------------
! 1227: <a name="3.0.6"></a>
! 1228:
! 1229: # NEWS for rsync 3.0.6 (8 May 2009)
! 1230:
! 1231: ## Changes in this version:
! 1232:
! 1233: ### BUG FIXES:
! 1234:
! 1235: - Fixed a `--read-batch` hang when rsync is reading a batch file that was
! 1236: created from an incremental-recursion transfer.
! 1237:
! 1238: - Fixed the daemon's socket code to handle the simultaneous arrival of
! 1239: multiple connections.
! 1240:
! 1241: - Fix `--safe-links`/`--copy-unsafe-links` to properly handle symlinks that
! 1242: have consecutive slashes in the value.
! 1243:
! 1244: - Fixed the parsing of an `[IPv6_LITERAL_ADDR]` when a USER@ is prefixed.
! 1245:
! 1246: - The sender now skips a (bogus) symlink that has a 0-length value, which
! 1247: avoids a transfer error in the receiver.
! 1248:
! 1249: - Fixed a case where the sender could die with a tag-0 error if there was an
! 1250: I/O during the sending of the file list.
! 1251:
! 1252: - Fixed the rrsync script to avoid a server-side problem when `-e` is at the
! 1253: start of the short options.
! 1254:
! 1255: - Fixed a problem where a vanished directory could turn into an exit code 23
! 1256: instead of the proper exit code 24.
! 1257:
! 1258: - Fixed the `--iconv` conversion of symlinks when doing a local copy.
! 1259:
! 1260: - Fixed a problem where `--one-file-system` was not stopping deletions on the
! 1261: receiving side when a mount-point directory did not match a directory in the
! 1262: transfer.
! 1263:
! 1264: - Fixed the dropping of an ACL mask when no named ACL values were present.
! 1265:
! 1266: - Fixed an ACL/xattr corruption issue where the `--backup` option could cause
! 1267: rsync to associate the wrong ACL/xattr information with received files.
! 1268:
! 1269: - Fixed the use of `--xattrs` with `--only-write-batch`.
! 1270:
! 1271: - Fixed the use of `--dry-run` with `--read-batch`.
! 1272:
! 1273: - Fixed configure's erroneous use of target.
! 1274:
! 1275: - Fixed configure's `--disable-debug` option.
! 1276:
! 1277: - Fixed a run-time issue for systems that can't find `iconv_open()` by adding
! 1278: the `--disable-iconv-open` configure option.
! 1279:
! 1280: - Complain and die if the user tries to combine `--remove-source-files` (or
! 1281: the deprecated `--remove-sent-files`) with `--read-batch`.
! 1282:
! 1283: - Fixed an failure transferring special files from Solaris to Linux.
! 1284:
! 1285: ------------------------------------------------------------------------------
! 1286: <a name="3.0.5"></a>
! 1287:
! 1288: # NEWS for rsync 3.0.5 (28 Dec 2008)
! 1289:
! 1290: ## Changes in this version:
! 1291:
! 1292: ### BUG FIXES:
! 1293:
! 1294: - Initialize xattr data in a couple spots in the hlink code, which avoids a
! 1295: crash when the xattr pointer's memory happens to start out non-zero. Also
! 1296: fixed the itemizing of an alt-dest file's xattrs when hard-linking.
! 1297:
! 1298: - Don't send a bogus `-` option to an older server if there were no short
! 1299: options specified.
! 1300:
! 1301: - Fixed skipping of unneeded updates in a batch file when incremental
! 1302: recursion is active. Added a test for this. Made batch-mode handle `redo`
! 1303: files properly (and without hanging).
! 1304:
! 1305: - Fix the %P logfile escape when the daemon logs from inside a chroot.
! 1306:
! 1307: - Fixed the use of `-s` (`--protect-args`) when used with a remote source or
! 1308: destination that had an empty path (e.g. `host:`). Also fixed a problem when
! 1309: `-s` was used when accessing a daemon via a remote-shell.
! 1310:
! 1311: - Fixed the use of a dot-dir path (e.g. foo/./bar) inside a `--files-from`
! 1312: file when the root of the transfer isn't the current directory.
! 1313:
! 1314: - Fixed a bug with `-K --delete` removing symlinks to directories when
! 1315: incremental recursion is active.
! 1316:
! 1317: - Fixed a hard to trigger hang when using `--remove-source-files`.
! 1318:
! 1319: - Got rid of an annoying delay when accessing a daemon via a remote-shell.
! 1320:
! 1321: - Properly ignore (superfluous) source args on a `--read-batch` command.
! 1322:
! 1323: - Improved the manpage's description of the `*` wildcard to remove the
! 1324: confusing `non-empty` qualifier.
! 1325:
! 1326: - Fixed reverse lookups in the compatibility-library version of getnameinfo().
! 1327:
! 1328: - Fixed a bug when using `--sparse` on a sparse file that has over 2GB of
! 1329: consecutive sparse data.
! 1330:
! 1331: - Avoid a hang when using at least 3 `--verbose` options on a transfer with a
! 1332: client sender (which includes local copying).
! 1333:
! 1334: - Fixed a problem with `--delete-delay` reporting an error when it was ready
! 1335: to remove a directory that was now gone.
! 1336:
! 1337: - Got rid of a bunch of `warn_unused_result` compiler warnings.
! 1338:
! 1339: - If an ftruncate() on a received file fails, it now causes a partial-
! 1340: transfer warning.
! 1341:
! 1342: - Allow a path with a leading `//` to be preserved (CYGWIN only).
! 1343:
! 1344: ### ENHANCEMENTS:
! 1345:
! 1346: - Made the support/atomic-rsync script able to perform a fully atomic update
! 1347: of the copied hierarchy when the destination is setup using a particular
! 1348: symlink idiom.
! 1349:
! 1350: ------------------------------------------------------------------------------
! 1351: <a name="3.0.4"></a>
! 1352:
! 1353: # NEWS for rsync 3.0.4 (6 Sep 2008)
! 1354:
! 1355: ## Changes in this version:
! 1356:
! 1357: ### BUG FIXES:
! 1358:
! 1359: - Fixed a bug in the hard-linking code where it would sometimes try to
! 1360: allocate 0 bytes of memory (which fails on some OSes, such as AIX).
! 1361:
! 1362: - Fixed the hard-linking of files from a device that has a device number of 0
! 1363: (which seems to be a common device number on NetBSD).
! 1364:
! 1365: - Fixed the handling of a `--partial-dir` that cannot be created. This
! 1366: particularly impacts the `--delay-updates` option (since the files cannot be
! 1367: delayed without a partial-dir), and was potentially destructive if the
! 1368: `--remove-source-files` was also specified.
! 1369:
! 1370: - Fixed a couple issues in the `--fake-super` handling of xattrs when the
! 1371: destination files have root-level attributes (e.g. selinux values) that a
! 1372: non-root copy can't affect.
! 1373:
! 1374: - Improved the keep-alive check in the generator to fire consistently in
! 1375: incremental-recursion mode when `--timeout` is enabled.
! 1376:
! 1377: - The `--iconv` option now converts the content of a symlink too, instead of
! 1378: leaving it in the wrong character-set (requires 3.0.4 on both sides of the
! 1379: transfer).
! 1380:
! 1381: - When using `--iconv`, if a filename fails to convert on the receiving side,
! 1382: this no longer makes deletions in the root-dir of the transfer fail silently
! 1383: (the user now gets a warning about deletions being disabled due to IO error
! 1384: as long as `--ignore-errors` was not specified).
! 1385:
! 1386: - When using `--iconv`, if a server-side receiver can't convert a filename,
! 1387: the error message sent back to the client no longer mangles the name with
! 1388: the wrong charset conversion.
! 1389:
! 1390: - Fixed a potential alignment issue in the IRIX ACL code when allocating the
! 1391: initial `struct acl` object. Also, cast mallocs to avoid warnings.
! 1392:
! 1393: - Changed some errors that were going to stdout to go to stderr.
! 1394:
! 1395: - Made `human_num()` and `human_dnum()` able to output a negative number
! 1396: (rather than outputting a cryptic string of punctuation).
! 1397:
! 1398: ### ENHANCEMENTS:
! 1399:
! 1400: - Rsync will avoid sending an `-e` option to the server if an older protocol
! 1401: is requested (and thus the option would not be useful). This lets the user
! 1402: specify the `--protocol=29` option to access an overly-restrictive server
! 1403: that is rejecting the protocol-30 use of `-e` to the server.
! 1404:
! 1405: - Improved the message output for an `RERR_PARTIAL` exit.
! 1406:
! 1407: ### DEVELOPER RELATED:
! 1408:
! 1409: - The Makefile will not halt for just a timestamp change on the Makefile or
! 1410: the configure files, only for actual changes in content.
! 1411:
! 1412: - Changed some commands in the testsuite's xattrs.test that called `rsync`
! 1413: instead of `$RSYNC`.
! 1414:
! 1415: - Enhanced the release scripts to be able to handle a branch release and to do
! 1416: even more consistency checks on the files.
! 1417:
! 1418: ------------------------------------------------------------------------------
! 1419: <a name="3.0.3"></a>
! 1420:
! 1421: # NEWS for rsync 3.0.3 (29 Jun 2008)
! 1422:
! 1423: ## Changes in this version:
! 1424:
! 1425: ### BUG FIXES:
! 1426:
! 1427: - Fixed a wildcard matching problem in the daemon when a module has `use
! 1428: chroot` enabled.
! 1429:
! 1430: - Fixed a crash bug in the hard-link code.
! 1431:
! 1432: - Fixed the sending of xattr directory information when the code finds a
! 1433: `--link-dest` or `--copy-dest` directory with unchanged xattrs -- the
! 1434: destination directory now gets these unchanged xattrs properly applied.
! 1435:
! 1436: - Fixed an xattr-sending glitch that could cause an `Internal abbrev` error.
! 1437:
! 1438: - Fixed the combination of `--xattrs` and `--backup`.
! 1439:
! 1440: - The generator no longer allows a '.' dir to be excluded by a daemon-exclude
! 1441: rule.
! 1442:
! 1443: - Fixed deletion handling when copying a single, empty directory (with no
! 1444: files) to a differently named, non-existent directory.
! 1445:
! 1446: - Fixed the conversion of spaces into dashes in the %M log escape.
! 1447:
! 1448: - Fixed several places in the code that were not returning the right errno
! 1449: when a function failed.
! 1450:
! 1451: - Fixed the backing up of a device or special file into a backup dir.
! 1452:
! 1453: - Moved the setting of the socket options prior to the connect().
! 1454:
! 1455: - If rsync exits in the middle of a `--progress` output, it now outputs a
! 1456: newline to help prevent the progress line from being overwritten.
! 1457:
! 1458: - Fixed a problem with how a destination path with a trailing slash or a
! 1459: trailing dot-dir was compared against the daemon excludes.
! 1460:
! 1461: - Fixed the sending of large (size > 16GB) files when talking to an older
! 1462: rsync (protocols < 30): we now use a compatible block size limit.
! 1463:
! 1464: - If a file's length is so huge that we overflow a checksum buffer count (i.e.
! 1465: several hundred TB), warn the user and avoid sending an invalid checksum
! 1466: struct over the wire.
! 1467:
! 1468: - If a source arg is excluded, `--relative` no longer adds the excluded arg's
! 1469: implied dirs to the transfer. This fix also made the exclude check happen in
! 1470: the better place in the sending code.
! 1471:
! 1472: - Use the `overflow_exit()` function for overflows, not `out_of_memory()`.
! 1473:
! 1474: - Improved the code to better handle a system that has only 32-bit file
! 1475: offsets.
! 1476:
! 1477: ### ENHANCEMENTS:
! 1478:
! 1479: - The rsyncd.conf manpage now consistently refers to the parameters in the
! 1480: daemon config file as `parameters`.
! 1481:
! 1482: - The description of the `--inplace` option was improved.
! 1483:
! 1484: ### EXTRAS:
! 1485:
! 1486: - Added a new script in the support directory, deny-rsync, which allows an
! 1487: admin to (temporarily) replace the rsync command with a script that sends an
! 1488: error message to the remote client via the rsync protocol.
! 1489:
! 1490: ### DEVELOPER RELATED:
! 1491:
! 1492: - Fixed a testcase failure if the tests are run as root and made some
! 1493: compatibility improvements.
! 1494:
! 1495: - Improved the daemon tests, including checking module comments, the listing
! 1496: of files, and the ensuring that daemon excludes can't affect a dot-dir arg.
! 1497:
! 1498: - Improved some build rules for those that build in a separate directory from
! 1499: the source, including better install rules for the man pages, and the fixing
! 1500: of a proto.h-tstamp rule that could make the binaries get rebuild without
! 1501: cause.
! 1502:
! 1503: - Improved the testsuite to work around a problem with some utilities (e.g. cp
! 1504: -p & touch -r) rounding sub-second timestamps.
! 1505:
! 1506: - Ensure that the early patches don't cause any generated-file hunks to
! 1507: bleed-over into patches that follow.
! 1508:
! 1509: ------------------------------------------------------------------------------
! 1510: <a name="3.0.2"></a>
! 1511:
! 1512: # NEWS for rsync 3.0.2 (8 Apr 2008)
! 1513:
! 1514: ## Changes in this version:
! 1515:
! 1516: ### BUG FIXES:
! 1517:
! 1518: - Fixed a potential buffer overflow in the xattr code.
! 1519:
! 1520: ### ENHANCEMENTS:
! 1521:
! 1522: - None.
! 1523:
! 1524: ### DEVELOPER RELATED:
! 1525:
! 1526: - The RPM spec file was improved to install more useful files.
! 1527:
! 1528: - A few developer-oriented scripts were moved from the support dir to the
! 1529: packaging dir.
! 1530:
! 1531: ------------------------------------------------------------------------------
! 1532: <a name="3.0.1"></a>
! 1533:
! 1534: # NEWS for rsync 3.0.1 (3 Apr 2008)
! 1535:
! 1536: ## Changes in this version:
! 1537:
! 1538: ### NOTABLE CHANGES IN BEHAVIOR:
! 1539:
! 1540: - Added the 'c'-flag to the itemizing of non-regular files so that the
! 1541: itemized output doesn't get hidden if there were no attribute changes, and
! 1542: also so that the itemizing of a `--copy-links` run will distinguish between
! 1543: copying an identical non-regular file and the creation of a revised version
! 1544: with a new value (e.g. a changed symlink referent, a new device number,
! 1545: etc.).
! 1546:
! 1547: ### BUG FIXES:
! 1548:
! 1549: - Fixed a crash bug when a single-use rsync daemon (via remote shell) was run
! 1550: without specifying a `--config=FILE` option.
! 1551:
! 1552: - Fixed a crash when backing up a directory that has a default ACL.
! 1553:
! 1554: - Fixed a bug in the handling of xattr values that could cause rsync to not
! 1555: think that a file's extended attributes are up-to-date.
! 1556:
! 1557: - Fixed the working of `--fake-super` with `--link-dest` and `--xattrs`.
! 1558:
! 1559: - Fixed a hang when combining `--dry-run` with `--remove-source-files`.
! 1560:
! 1561: - Fixed a bug with `--iconv`'s handling of files that cannot be converted: a
! 1562: failed name can no longer cause a transfer failure.
! 1563:
! 1564: - Fixed the building of the rounding.h file on systems that need custom
! 1565: CPPFLAGS to be used. Also improved the error reporting if the building of
! 1566: rounding.h fails.
! 1567:
! 1568: - Fixed the use of the `--protect-args` (`-s`) option when talking to a
! 1569: daemon.
! 1570:
! 1571: - Fixed the `--ignore-existing` option's protection of files on the receiver
! 1572: that are non-regular files on the sender (e.g. if a symlink or a dir on the
! 1573: sender is trying to replace a file on the receiver). The reverse protection
! 1574: (protecting a dir/symlink/device from being replaced by a file) was already
! 1575: working.
! 1576:
! 1577: - Fixed an assert failure if `--hard-links` is combined with an option that
! 1578: can skip a file in a set of hard-linked files (i.e. `--ignore-existing`,
! 1579: `--append`, etc.), without skipping all the files in the set.
! 1580:
! 1581: - Avoid setting the modify time on a directory that already has the right
! 1582: modify time set. This avoids tweaking the dir's ctime.
! 1583:
! 1584: - Improved the daemon-exclude handling to do a better job of applying the
! 1585: exclude rules to path entries. It also sends the user an error just as if
! 1586: the files were actually missing (instead of silently ignoring the user's
! 1587: args), and avoids sending the user the filter-action messages for these
! 1588: non-user-initiated rules.
! 1589:
! 1590: - Fixed some glitches with the dry-run code's missing-directory handling,
! 1591: including a problem when combined with `--fuzzy`.
! 1592:
! 1593: - Fixed some glitches with the skipped-directory handling.
! 1594:
! 1595: - Fixed the 'T'-flag itemizing of symlinks when `--time` isn't preserved.
! 1596:
! 1597: - Fixed a glitch in the itemizing of permissions with the `-E` option.
! 1598:
! 1599: - The `--append` option's restricting of transfers to those that add data no
! 1600: longer prevents the updating of non-content changes to otherwise up-to-date
! 1601: files (i.e. those with the same content but differing permissions,
! 1602: ownership, xattrs, etc.).
! 1603:
! 1604: - Don't allow `--fake-super` to be specified with `-XX` (double `--xattrs`)
! 1605: because the options conflict. If a daemon has `fake super` enabled, it
! 1606: automatically downgrades a `-XX` request to `-X`.
! 1607:
! 1608: - Fixed a couple bugs in the parsing of daemon-config excludes that could make
! 1609: a floating exclude rule get treated as matching an absolute path.
! 1610:
! 1611: - A daemon doesn't try to auto-refuse the `iconv` option if iconv-support
! 1612: wasn't compiled in to the daemon (avoiding a warning in the logs).
! 1613:
! 1614: - Fixed the inclusion of per-dir merge files from implied dirs.
! 1615:
! 1616: - Fixed the support/rrsync script to work with the latest options that rsync
! 1617: sends (including its flag-specifying use of `-e` to the server).
! 1618:
! 1619: ### ENHANCEMENTS:
! 1620:
! 1621: - Added the `--old-dirs` (`--old-d`) option to make it easier for a user to
! 1622: ask for file-listings with older rsync versions (this is easier than having
! 1623: to type `-r --exclude='/*/*'` manually).
! 1624:
! 1625: - When getting an error while asking an older rsync daemon for a file listing,
! 1626: rsync will try to notice if the error is a rejection of the `--dirs` (`-d`)
! 1627: option and let the user know how to work around the issue.
! 1628:
! 1629: - Added a few more `--no-OPTION` overrides.
! 1630:
! 1631: - Improved the documentation of the `--append` option.
! 1632:
! 1633: - Improved the documentation of the filter/exclude/include daemon parameters.
! 1634:
! 1635: ### INTERNAL:
! 1636:
! 1637: - Fixed a couple minor bugs in the included popt library (ones which I sent to
! 1638: the official popt project for inclusion in the 1.14 release).
! 1639:
! 1640: - Fixed a stat() call that should have been `do_stat()` so that the proper
! 1641: normal/64-bit stat() function gets called. (Was in an area that should not
! 1642: have caused problems, though.)
! 1643:
! 1644: - Changed the file-glob code to do a directory scan without using the `glob`
! 1645: and `glob.h`. This lets us do the globbing with less memory churn, and also
! 1646: avoid adding daemon-excluded items to the returned args.
! 1647:
! 1648: ### DEVELOPER RELATED:
! 1649:
! 1650: - The configure script tries to get the user's compiler to not warn about
! 1651: unused function parameters if the build is not including one or more of the
! 1652: ACL/xattrs/iconv features.
! 1653:
! 1654: - The configure script now has better checks for figuring out if the included
! 1655: popt code should be used or not.
! 1656:
! 1657: - Fixed two testsuite glitches: avoid a failure if someone's `cd` command
! 1658: outputs the current directory when cd-ing to a relative path, and made the
! 1659: itemized test query how rsync was built to determine if it should expect
! 1660: hard-linked symlinks or not.
! 1661:
! 1662: - Updated the testsuite to verify that various bug fixes remain fixed.
! 1663:
! 1664: - The RPM spec file was updated to have: (1) comments for how to use the
! 1665: rsync-patch tar file, and (2) an /etc/xinetd.d/rsync file.
! 1666:
! 1667: - Updated the build scripts to work with a revised FTP directory structure.
! 1668:
! 1669: ------------------------------------------------------------------------------
! 1670: <a name="3.0.0"></a>
! 1671:
! 1672: # NEWS for rsync 3.0.0 (1 Mar 2008)
! 1673:
! 1674: ## Changes in this version:
! 1675:
! 1676: ### PROTOCOL NUMBER:
! 1677:
! 1678: - The protocol number was changed to 30.
! 1679:
! 1680: ### NOTABLE CHANGES IN BEHAVIOR:
! 1681:
! 1682: - The handling of implied directories when using `--relative` has changed to
! 1683: send them as directories (e.g. no implied dir is ever sent as a symlink).
! 1684: This avoids unexpected behavior and should not adversely affect most people.
! 1685: If you're one of those rare individuals who relied upon having an implied
! 1686: dir be duplicated as a symlink, you should specify the transfer of the
! 1687: symlink and the transfer of the referent directory as separate args. (See
! 1688: also `--keep-dirlinks` and `--no-implied-dirs`.) Also, exclude rules no
! 1689: longer have a partial effect on implied dirs.
! 1690:
! 1691: - Requesting a remote file-listing without specifying `-r` (`--recursive`) now
! 1692: sends the `-d` (`--dirs`) option to the remote rsync rather than sending
! 1693: `-r` along with an extra exclude of `/*/*`. If the remote rsync does not
! 1694: understand the `-d` option (i.e. it is 2.6.3 or older), you will need to
! 1695: either turn off `-d` (`--no-d`), or specify `-r --exclude='/*/*'` manually.
! 1696:
! 1697: - In `--dry-run` mode, the last line of the verbose summary text is output
! 1698: with a "(DRY RUN)" suffix to help remind you that no updates were made.
! 1699: Similarly, `--only-write-batch` outputs `(BATCH ONLY)`.
! 1700:
! 1701: - A writable rsync daemon with `use chroot` disabled now defaults to a
! 1702: symlink-munging behavior designed to make symlinks safer while also allowing
! 1703: absolute symlinks to be stored and retrieved. This also has the effect of
! 1704: making symlinks unusable while they're in the daemon's hierarchy. See the
! 1705: daemon's `munge symlinks` parameter for details.
! 1706:
! 1707: - Starting up an extra copy of an rsync daemon will not clobber the pidfile
! 1708: for the running daemon -- if the pidfile exists, the new daemon will exit
! 1709: with an error. This means that your wrapper script that starts the rsync
! 1710: daemon should be made to handle lock-breaking (if you want any automatic
! 1711: breaking of locks to be done).
! 1712:
! 1713: ### BUG FIXES:
! 1714:
! 1715: - A daemon with `use chroot = no` and excluded items listed in the daemon
! 1716: config file now properly checks an absolute-path arg specified for these
! 1717: options: `--compare-dest`, `--link-dest`, `--copy-dest`, `--partial-dir`,
! 1718: `--backup-dir`, `--temp-dir`, and `--files-from`.
! 1719:
! 1720: - A daemon can now be told to disable all user- and group-name translation on
! 1721: a per-module basis. This avoids a potential problem with a writable daemon
! 1722: module that has `use chroot` enabled -- if precautions weren't taken, a user
! 1723: could try to add a missing library and get rsync to use it. This makes rsync
! 1724: safer by default, and more configurable when id-translation is not desired.
! 1725: See the daemon's `numeric ids` parameter for full details.
! 1726:
! 1727: - A chroot daemon can now indicate which part of its path should affect the
! 1728: chroot call, and which part should become an inside-chroot path for the
! 1729: module. This allows you to have outside-the-transfer paths (such as for
! 1730: libraries) even when you enable chroot protection. The idiom used in the
! 1731: rsyncd.conf file is: `path = /chroot/dirs/./dirs/inside`
! 1732:
! 1733: - If a file's data arrived successfully on the receiving side but the rename
! 1734: of the temporary file to the destination file failed AND the
! 1735: `--remove-source-files` (or the deprecated `--remove-sent-files`) option was
! 1736: specified, rsync no longer erroneously removes the associated source file.
! 1737:
! 1738: - Fixed the output of `-ii` when combined with one of the `--*-dest` options:
! 1739: it now itemizes all the items, not just the changed ones.
! 1740:
! 1741: - Made the output of all file types consistent when using a `--*-dest` option.
! 1742: Prior versions would output too many creation events for matching items.
! 1743:
! 1744: - The code that waits for a child pid now handles being interrupted by a
! 1745: signal. This fixes a problem with the pre-xfer exec function not being able
! 1746: to get the exit status from the script.
! 1747:
! 1748: - A negated filter rule (i.e. with a '!' modifier) no longer loses the
! 1749: negation when sending the filter rules to the remote rsync.
! 1750:
! 1751: - Fixed a problem with the `--out-format` (aka `--log-format`) option %f: it
! 1752: no longer outputs superfluous directory info for a non-daemon rsync.
! 1753:
! 1754: - Fixed a problem with `-vv` (double `--verbose`) and `--stats` when `pushing`
! 1755: files (which includes local copies). Version 2.6.9 would complete the copy,
! 1756: but exit with an error when the receiver output its memory stats.
! 1757:
! 1758: - If `--password-file` is used on a non-daemon transfer, rsync now complains
! 1759: and exits. This should help users figure out that they can't use this option
! 1760: to control a remote shell's password prompt.
! 1761:
! 1762: - Make sure that directory permissions of a newly-created destination
! 1763: directory are handled right when `--perms` is left off.
! 1764:
! 1765: - The itemized output of a newly-created destination directory is now output
! 1766: as a creation event, not a change event.
! 1767:
! 1768: - Improved `--hard-link` so that more corner cases are handled correctly when
! 1769: combined with options such as `--link-dest` and/or `--ignore-existing`.
! 1770:
! 1771: - The `--append` option no longer updates a file that has the same size.
! 1772:
! 1773: - Fixed a bug when combining `--backup` and `--backup-dir` with `--inplace`:
! 1774: any missing backup directories are now created.
! 1775:
! 1776: - Fixed a bug when using `--backup` and `--inplace` with `--whole-file` or
! 1777: `--read-batch`: backup files are actually created now.
! 1778:
! 1779: - The daemon pidfile is checked and created sooner in the startup sequence.
! 1780:
! 1781: - If a daemon module's `path` value is not an absolute pathname, the code now
! 1782: makes it absolute internally (making it work properly).
! 1783:
! 1784: - Ensure that a temporary file always has owner-write permission while we are
! 1785: writing to it. This avoids problems with some network filesystems when
! 1786: transferring read-only files.
! 1787:
! 1788: - Any errors output about password-file reading no longer cause an error at
! 1789: the end of the run about a partial transfer.
! 1790:
! 1791: - The `--read-batch` option for protocol 30 now ensures that several more
! 1792: options are set correctly for the current batch file: `--iconv`, `--acls`,
! 1793: `--xattrs`, `--inplace`, `--append`, and `--append-verify`.
! 1794:
! 1795: - Using `--only-write-batch` to a daemon receiver now works properly (older
! 1796: versions would update some files while writing the batch).
! 1797:
! 1798: - Avoid outputting a "file has vanished" message when the file is a broken
! 1799: symlink and `--copy-unsafe-links` or `--copy-dirlinks` is used (the code
! 1800: already handled this for `--copy-links`).
! 1801:
! 1802: - Fixed the combination of `--only-write-batch` and `--dry-run`.
! 1803:
! 1804: - Fixed rsync's ability to remove files that are not writable by the file's
! 1805: owner when rsync is running as the same user.
! 1806:
! 1807: - When transferring large files, the sender's hashtable of checksums is kept
! 1808: at a more reasonable state of fullness (no more than 80% full) so that the
! 1809: scanning of the hashtable will not bog down as the number of blocks
! 1810: increases.
! 1811:
! 1812: ### ENHANCEMENTS:
! 1813:
! 1814: - A new incremental-recursion algorithm is now used when rsync is talking to
! 1815: another 3.x version. This starts the transfer going more quickly (before all
! 1816: the files have been found), and requires much less memory. See the
! 1817: `--recursive` option in the manpage for some restrictions.
! 1818:
! 1819: - Lowered memory use in the non-incremental-recursion algorithm for typical
! 1820: option values (usually saving from 21-29 bytes per file).
! 1821:
! 1822: - The default `--delete` algorithm is now `--delete-during` when talking to a
! 1823: 3.x rsync. This is a faster scan than using `--delete-before` (which is the
! 1824: default when talking to older rsync versions), and is compatible with the
! 1825: new incremental recursion mode.
! 1826:
! 1827: - Rsync now allows multiple remote-source args to be specified rather than
! 1828: having to rely on a special space-splitting side-effect of the remote-
! 1829: shell. Additional remote args must specify the same host or an empty one
! 1830: (e.g. empty: `:file1` or `::module/file2`). For example, this means that
! 1831: local use of brace expansion now works: `rsync -av host:dir/{f1,f2} .`
! 1832:
! 1833: - Added the `--protect-args` (`-s`) option, that tells rsync to send most of
! 1834: the command-line args at the start of the transfer rather than as args to
! 1835: the remote-shell command. This protects them from space-splitting, and only
! 1836: interprets basic wildcard special shell characters (`*?[`).
! 1837:
! 1838: - Added the `--delete-delay` option, which is a more efficient way to delete
! 1839: files at the end of the transfer without needing a separate delete pass.
! 1840:
! 1841: - Added the `--acls` (`-A`) option to preserve Access Control Lists. This is
! 1842: an improved version of the prior patch that was available, and it even
! 1843: supports OS X ACLs. If you need to have backward compatibility with old,
! 1844: ACL-patched versions of rsync, apply the acls.diff file from the patches
! 1845: dir.
! 1846:
! 1847: - Added the `--xattrs` (`-X`) option to preserve extended attributes. This is
! 1848: an improved version of the prior patch that was available, and it even
! 1849: supports OS X xattrs (which includes their resource fork data). If you need
! 1850: to have backward compatibility with old, xattr-patched versions of rsync,
! 1851: apply the xattrs.diff file from the patches dir.
! 1852:
! 1853: - Added the `--fake-super` option that allows a non-super user to preserve all
! 1854: attributes of a file by using a special extended-attribute idiom. It even
! 1855: supports the storing of foreign ACL data on your backup server. There is
! 1856: also an analogous `fake super` parameter for an rsync daemon.
! 1857:
! 1858: - Added the `--iconv` option, which allows rsync to convert filenames from one
! 1859: character-set to another during the transfer. The default is to make this
! 1860: feature available as long as your system has `iconv_open()`. If compilation
! 1861: fails, specify `--disable-iconv` to configure, and then rebuild. If you want
! 1862: rsync to perform character-set conversions by default, you can specify
! 1863: `--enable-iconv=CONVERT_STRING` with the default value for the `--iconv`
! 1864: option that you wish to use. For example, `--enable-iconv=.` is a good
! 1865: choice. See the rsync manpage for an explanation of the `--iconv` option's
! 1866: settings.
! 1867:
! 1868: - A new daemon config parameter, `charset`, lets you control the character-
! 1869: set that is used during an `--iconv` transfer to/from a daemon module. You
! 1870: can also set your daemon to refuse `no-iconv` if you want to force the
! 1871: client to use an `--iconv` transfer (requiring an rsync 3.x client).
! 1872:
! 1873: - Added the `--skip-compress=LIST` option to override the default list of file
! 1874: suffixes that will not be compressed when using `--compress` (`-z`).
! 1875:
! 1876: - The daemon's default for `dont compress` was extended to include: `*.7z`
! 1877: `*.mp[34]` `*.mov` `*.avi` `*.ogg` `*.jpg` `*.jpeg` and the name-matching routine was also
! 1878: optimized to run more quickly.
! 1879:
! 1880: - The `--max-delete` option now outputs a warning if it skipped any file
! 1881: deletions, including a count of how many deletions were skipped. (Older
! 1882: versions just silently stopped deleting things.)
! 1883:
! 1884: - You may specify `--max-delete=0` to a 3.0.0 client to request that it warn
! 1885: about extraneous files without deleting anything. If you're not sure what
! 1886: version the client is, you can use the less-obvious `--max-delete=-1`, as
! 1887: both old and new versions will treat that as the same request (though older
! 1888: versions don't warn).
! 1889:
! 1890: - The `--hard-link` option now uses less memory on both the sending and
! 1891: receiving side for all protocol versions. For protocol 30, the use of a
! 1892: hashtable on the sending side allows us to more efficiently convey to the
! 1893: receiver what files are linked together. This reduces the amount of data
! 1894: sent over the socket by a considerable margin (rather than adding more
! 1895: data), and limits the in-memory storage of the device+inode information to
! 1896: just the sending side for the new protocol 30, or to the receiving side when
! 1897: speaking an older protocol (note that older rsync versions kept the
! 1898: device+inode information on both sides).
! 1899:
! 1900: - The filter rules now support a perishable (`p`) modifier that marks rules
! 1901: that should not have an effect in a directory that is being deleted. e.g.
! 1902: `-f '-p .svn/'` would only affect `live` .svn directories.
! 1903:
! 1904: - Rsync checks all the alternate-destination args for validity (e.g.
! 1905: `--link-dest`). This lets the user know when they specified a directory that
! 1906: does not exist.
! 1907:
! 1908: - If we get an ENOSYS error setting the time on a symlink, we don't complain
! 1909: about it anymore (for those systems that even support the setting of the
! 1910: modify-time on a symlink).
! 1911:
! 1912: - Protocol 30 now uses MD5 checksums instead of MD4.
! 1913:
! 1914: - Changed the `--append` option to not checksum the existing data in the
! 1915: destination file, which speeds up file appending.
! 1916:
! 1917: - Added the `--append-verify` option, which works like the older `--append`
! 1918: option (verifying the existing data in the destination file). For
! 1919: compatibility with older rsync versions, any use of `--append` that is
! 1920: talking protocol 29 or older will revert to the `--append-verify` method.
! 1921:
! 1922: - Added the `--contimeout=SECONDS` option that lets the user specify a
! 1923: connection timeout for rsync daemon access.
! 1924:
! 1925: - Documented and extended the support for the `RSYNC_CONNECT_PROG` variable
! 1926: that can be used to enhance the client side of a daemon connection.
! 1927:
! 1928: - Improved the dashes and double-quotes in the nroff manpage output.
! 1929:
! 1930: - Rsync now supports a lot more `--no-OPTION` override options.
! 1931:
! 1932: ### INTERNAL:
! 1933:
! 1934: - The file-list sorting algorithm now uses a sort that keeps any same-named
! 1935: items in the same order as they were specified. This allows rsync to always
! 1936: ensure that the first of the duplicates is the one that will be included in
! 1937: the copy. The new sort is also faster than the glibc version of qsort() and
! 1938: mergesort().
! 1939:
! 1940: - Rsync now supports the transfer of 64-bit timestamps (`time_t` values).
! 1941:
! 1942: - Made the file-deletion code use a little less stack when recursing through a
! 1943: directory hierarchy of extraneous files.
! 1944:
! 1945: - Fixed a build problem with older (2.x) versions of gcc.
! 1946:
! 1947: - Added some isType() functions that make dealing with signed characters
! 1948: easier without forcing variables via casts.
! 1949:
! 1950: - Changed strcat/strcpy/sprintf function calls to use safer versions.
! 1951:
! 1952: - Upgraded the included popt version to 1.10.2 and improved its use of
! 1953: string-handling functions.
! 1954:
! 1955: - Added missing prototypes for compatibility functions from the lib dir.
! 1956:
! 1957: - Configure determines if iconv() has a const arg, allowing us to avoid a
! 1958: compiler warning.
! 1959:
! 1960: - Made the sending of some numbers more efficient for protocol 30.
! 1961:
! 1962: - Make sure that a daemon process doesn't mind if the client was weird and
! 1963: omitted the `--server` option.
! 1964:
! 1965: - There are more internal logging categories available in protocol 30 than the
! 1966: age-old FINFO and FERROR, including `FERROR_XFER` and FWARN. These new
! 1967: categories allow some errors and warnings to go to stderr without causing an
! 1968: erroneous end-of-run warning about some files not being able to be
! 1969: transferred.
! 1970:
! 1971: - Improved the use of `const` on pointers.
! 1972:
! 1973: - Improved J.W.'s `pool_alloc` routines to add a way of incrementally freeing
! 1974: older sections of a pool's memory.
! 1975:
! 1976: - The getaddrinfo.c compatibility code in the `lib` dir was replaced with some
! 1977: new code (derived from samba, derived from PostgreSQL) that has a better
! 1978: license than the old code.
! 1979:
! 1980: ### DEVELOPER RELATED:
! 1981:
! 1982: - Rsync is now licensed under the GPLv3 or later.
! 1983:
! 1984: - Rsync is now being maintained in a `git` repository instead of CVS (though
! 1985: the old CVS repository still exists for historical access). Several
! 1986: maintenance scripts were updated to work with git.
! 1987:
! 1988: - Generated files are no longer committed into the source repository. The
! 1989: autoconf and autoheader commands are now automatically run during the normal
! 1990: use of `configure` and `make`. The latest dev versions of all generated
! 1991: files can also be copied from the samba.org web site (see the prepare-source
! 1992: script's fetch option).
! 1993:
! 1994: - The `patches` directory of diff files is now built from branches in the
! 1995: rsync git repository (branch patch/FOO creates file patches/FOO.diff). This
! 1996: directory is now distributed in a separate separate tar file named
! 1997: rsync-patches-VERSION.tar.gz instead of the main rsync-VERSION.tar.gz.
! 1998:
! 1999: - The proto.h file is now built using a simple perl script rather than a
! 2000: complex awk script, which proved to be more widely compatible.
! 2001:
! 2002: - When running the tests, we now put our per-test temp dirs into a sub-
! 2003: directory named testtmp (which is created, if missing). This allows someone
! 2004: to symlink the testtmp directory to another filesystem (which is useful if
! 2005: the build dir's filesystem does not support ACLs and xattrs, but another
! 2006: filesystem does).
! 2007:
! 2008: - Rsync now has a way of handling protocol-version changes during the
! 2009: development of a new protocol version. This causes any out-of-sync versions
! 2010: to speak an older protocol rather than fail in a cryptic manner. This
! 2011: addition makes it safer to deploy a pre-release version that may interact
! 2012: with the public. This new exchange of sub-version info does not interfere
! 2013: with the `{MIN,MAX}_PROTOCOL_VERSION` checking algorithm (which does not
! 2014: have enough range to allow the main protocol number to be incremented for
! 2015: every minor tweak in that happens during development).
! 2016:
! 2017: - The csprotocol.txt file was updated to mention the daemon protocol change in
! 2018: the 3.0.0 release.
! 2019:
! 2020: ------------------------------------------------------------------------------
! 2021: <a name="2.6.9"></a>
! 2022:
! 2023: # NEWS for rsync 2.6.9 (6 Nov 2006)
! 2024:
! 2025: ## Changes in this version:
! 2026:
! 2027: ### BUG FIXES:
! 2028:
! 2029: - If rsync is interrupted via a handled signal (such as SIGINT), it will once
! 2030: again clean-up its temp file from the destination dir.
! 2031:
! 2032: - Fixed an overzealous sanitizing bug in the handling of the `--link-dest`,
! 2033: `--copy-dest`, and `--compare-dest` options to a daemon without chroot: if
! 2034: the copy's destination dir is deeper than the top of the module's path,
! 2035: these options now accept a safe number of parent-dir (../) references (since
! 2036: these options are relative to the destination dir). The old code incorrectly
! 2037: chopped off all `../` prefixes for these options, no matter how deep the
! 2038: destination directory was in the module's hierarchy.
! 2039:
! 2040: - Fixed a bug where a deferred info/error/log message could get sent directly
! 2041: to the sender instead of being handled by rwrite() in the generator. This
! 2042: fixes an `unexpected tag 3` fatal error, and should also fix a potential
! 2043: problem where a deferred info/error message from the receiver might bypass
! 2044: the log file and get sent only to the client process. (These problems could
! 2045: only affect an rsync daemon that was receiving files.)
! 2046:
! 2047: - Fixed a bug when `--inplace` was combined with a `--*-dest` option and we
! 2048: update a file's data using an alternate basis file. The code now notices
! 2049: that it needs to copy the matching data from the basis file instead of
! 2050: (wrongly) assuming that it was already present in the file.
! 2051:
! 2052: - Fixed a bug where using `--dry-run` with a `--*-dest` option with a path
! 2053: relative to a directory that does not yet exist: the affected option gets
! 2054: its proper path value so that the output of the dry-run is right.
! 2055:
! 2056: - Fixed a bug in the %f logfile escape when receiving files: the destination
! 2057: path is now included in the output (e.g. you can now tell when a user
! 2058: specifies a subdir inside a module).
! 2059:
! 2060: - If the receiving side fails to create a directory, it will now skip trying
! 2061: to update everything that is inside that directory.
! 2062:
! 2063: - If `--link-dest` is specified with `--checksum` but without `--times`, rsync
! 2064: will now allow a hard-link to be created to a matching link-dest file even
! 2065: when the file's modify-time doesn't match the server's file.
! 2066:
! 2067: - The daemon now calls more timezone-using functions prior to doing a chroot.
! 2068: This should help some C libraries to generate proper timestamps from inside
! 2069: a chrooted daemon (and to not try to access /etc/timezone over and over
! 2070: again).
! 2071:
! 2072: - Fixed a bug in the handling of an absolute `--partial-dir=ABS_PATH` option:
! 2073: it now deletes an alternate basis file from the partial-dir that was used to
! 2074: successfully update a destination file.
! 2075:
! 2076: - Fixed a bug in the handling of `--delete-excluded` when using a per-dir
! 2077: merge file: the merge file is now honored on the receiving side, and only
! 2078: its unqualified include/exclude commands are ignored (just as is done for
! 2079: global include/excludes).
! 2080:
! 2081: - Fixed a recent bug where `--delete` was not working when transferring from
! 2082: the root (/) of the filesystem with `--relative` enabled.
! 2083:
! 2084: - Fixed a recent bug where an `--exclude='*'` could affect the root (/) of the
! 2085: filesystem with `--relative` enabled.
! 2086:
! 2087: - When `--inplace` creates a file, it is now created with owner read/write
! 2088: permissions (0600) instead of no permissions at all. This avoids a problem
! 2089: continuing a transfer that was interrupted (since `--inplace` will not
! 2090: update a file that has no write permissions).
! 2091:
! 2092: - If either `--remove-source-files` or `--remove-sent-files` is enabled and we
! 2093: are unable to remove the source file, rsync now outputs an error.
! 2094:
! 2095: - Fixed a bug in the daemon's `incoming chmod` rule: newly-created directories
! 2096: no longer get the 'F' (file) rules applied to them.
! 2097:
! 2098: - Fixed an infinite loop bug when a filter rule was rejected due to being
! 2099: overly long.
! 2100:
! 2101: - When the server receives a `--partial-dir` option from the client, it no
! 2102: longer runs the client-side code that adds an assumed filter rule (since the
! 2103: client will be sending us the rules in the usual manner, and they may have
! 2104: chosen to override the auto-added rule).
! 2105:
! 2106: ### ENHANCEMENTS:
! 2107:
! 2108: - Added the `--log-file=FILE` and `--log-file-format=FORMAT` options. These
! 2109: can be used to tell any rsync to output what it is doing to a log file.
! 2110: They work with a client rsync, a non-daemon server rsync (see the man page
! 2111: for instructions), and also allows the overriding of rsyncd.conf settings
! 2112: when starting a daemon.
! 2113:
! 2114: - The `--log-format` option was renamed to be `--out-format` to avoid
! 2115: confusing it with affecting the log-file output. (The old option remains as
! 2116: an alias for the new to preserve backward compatibility.)
! 2117:
! 2118: - Made `log file` and `syslog facility` settable on a per-module basis in the
! 2119: daemon's config file.
! 2120:
! 2121: - Added the `--remove-source-files` option as a replacement for the (now
! 2122: deprecated) `--remove-sent-files` option. This new option removes all
! 2123: non-dirs from the source directories, even if the file was already
! 2124: up-to-date. This fixes a problem where interrupting an rsync that was using
! 2125: `--remove-sent-files` and restarting it could leave behind a file that the
! 2126: earlier rsync synchronized, but didn't get to remove. (The deprecated
! 2127: `--remove-sent-files` is still understood for now, and still behaves in the
! 2128: same way as before.)
! 2129:
! 2130: - Added the option `--no-motd` to suppress the message-of-the-day output from
! 2131: a daemon when doing a copy. (See the manpage for a caveat.)
! 2132:
! 2133: - Added a new environment variable to the pre-/post-xfer exec commands (in the
! 2134: daemon's config file): `RSYNC_PID`. This value will be the same in both the
! 2135: pre- and post-xfer commands, so it can be used as a unique ID if the
! 2136: pre-xfer command wants to cache some arg/request info for the post-xfer
! 2137: command.
! 2138:
! 2139: ### INTERNAL:
! 2140:
! 2141: - Did a code audit using IBM's code-checker program and made several changes,
! 2142: including: replacing most of the strcpy() and sprintf() calls with
! 2143: strlcpy(), snprintf(), and memcpy(), adding a 0-value to an enum that had
! 2144: been intermingling a literal 0 with the defined enum values, silencing some
! 2145: uninitialized memory checks, marking some functions with a `noreturn`
! 2146: attribute, and changing an `if` that could never succeed on some platforms
! 2147: into a pre-processor directive that conditionally compiles the code.
! 2148:
! 2149: - Fixed a potential bug in `f_name_cmp()` when both the args are a top-level
! 2150: `.` dir (which doesn't happen in normal operations).
! 2151:
! 2152: - Changed `exit_cleanup()` so that it can never return instead of exit. The
! 2153: old code might return if it found the `exit_cleanup()` function was being
! 2154: called recursively. The new code is segmented so that any recursive calls
! 2155: move on to the next step of the exit-processing.
! 2156:
! 2157: - The macro WIFEXITED(stat) will now be defined if the OS didn't already
! 2158: define it.
! 2159:
! 2160: ### DEVELOPER RELATED:
! 2161:
! 2162: - The acls.diff and xattrs.diff patches have received a bunch of work to make
! 2163: them much closer to being acceptable in the main distribution. The xattrs
! 2164: patch also has some preliminary Mac OS X and FreeBSD compatibility code that
! 2165: various system types to exchange extended file-attributes.
! 2166:
! 2167: - A new diff in the patches dir, fake-root.diff, allows rsync to maintain a
! 2168: backup hierarchy with full owner, group, and device info without actually
! 2169: running as root. It does this using a special extended attribute, so it
! 2170: depends on xattrs.diff (which depends on acls.diff).
! 2171:
! 2172: - The rsync.yo and rsyncd.conf.yo files have been updated to work better with
! 2173: the latest yodl 2.x releases.
! 2174:
! 2175: - Updated config.guess and config.sub to their 2006-07-02 versions.
! 2176:
! 2177: - Updated various files to include the latest FSF address and to have
! 2178: consistent opening comments.
! 2179:
! 2180: ------------------------------------------------------------------------------
! 2181: <a name="2.6.8"></a>
! 2182:
! 2183: # NEWS for rsync 2.6.8 (22 Apr 2006)
! 2184:
! 2185: ## Changes in this version:
! 2186:
! 2187: ### BUG FIXES:
! 2188:
! 2189: - Fixed a bug in the exclude code where an anchored exclude without any
! 2190: wildcards fails to match an absolute source arg, but only when `--relative`
! 2191: is in effect.
! 2192:
! 2193: - Improved the I/O code for the generator to fix a potential hang when the
! 2194: receiver gets an EOF on the socket but the generator's select() call never
! 2195: indicates that the socket is writable for it to be notified about the EOF.
! 2196: (This can happen when using stunnel).
! 2197:
! 2198: - Fixed a problem with the file-reading code where a failed read (such as that
! 2199: caused by a bad sector) would not advance the file's read-position beyond
! 2200: the failed read's data.
! 2201:
! 2202: - Fixed a logging bug where the `log file` directive was not being honored in
! 2203: a single-use daemon (one spawned by a remote-shell connection or by init).
! 2204:
! 2205: - If rsync cannot honor the `--delete` option, we output an error and exit
! 2206: instead of silently ignoring the option.
! 2207:
! 2208: - Fixed a bug in the `--link-dest` code that prevented special files (such as
! 2209: fifos) from being linked.
! 2210:
! 2211: - The ability to hard-link symlinks and special files is now determined at
! 2212: configure time instead of at runtime. This fixes a bug with `--link-dest`
! 2213: creating a hard-link to a symlink's referent on a BSD system.
! 2214:
! 2215: ### ENHANCEMENTS:
! 2216:
! 2217: - In daemon mode, if rsync fails to bind to the requested port, the error(s)
! 2218: returned by socket() and/or bind() are now logged.
! 2219:
! 2220: - When we output a fatal error, we now output the version of rsync in the
! 2221: message.
! 2222:
! 2223: - Improved the documentation for the `--owner` and `--group` options.
! 2224:
! 2225: - The rsyncstats script in `support` has an improved line-parsing regex that
! 2226: is easier to read and also makes it to parse syslog-generated lines.
! 2227:
! 2228: - A new script in `support`: file-attr-restore, can be used to restore the
! 2229: attributes of a file-set (the permissions, ownership, and group info) taken
! 2230: from the cached output of a `find ARG... -ls` command.
! 2231:
! 2232: ### DEVELOPER RELATED:
! 2233:
! 2234: - Removed the unused function `write_int_named()`, the unused variable
! 2235: `io_read_phase`, and the rarely used variable `io_write_phase`. This also
! 2236: elides the confusing 'phase "unknown"' part of one error message.
! 2237:
! 2238: - Removed two unused configure checks and two related (also unused)
! 2239: compatibility functions.
! 2240:
! 2241: - The xattrs.diff patch received a security fix that prevents a potential
! 2242: buffer overflow in the `receive_xattr()` code.
! 2243:
! 2244: - The acls.diff patch has been improved quite a bit, with more to come.
! 2245:
! 2246: - A new patch was added: log-file.diff. This contains an early version of a
! 2247: future option, `--log-file=FILE`, that will allow any rsync to log its
! 2248: actions to a file (something that only a daemon supports at present).
! 2249:
! 2250: ------------------------------------------------------------------------------
! 2251: <a name="2.6.7"></a>
! 2252:
! 2253: # NEWS for rsync 2.6.7 (11 Mar 2006)
! 2254:
! 2255: ## Changes in this version:
! 2256:
! 2257: ### OUTPUT CHANGES:
! 2258:
! 2259: - The letter 'D' in the itemized output was being used for both devices
! 2260: (character or block) as well as other special files (such as fifos and named
! 2261: sockets). This has changed to separate non-device special files under the
! 2262: 'S' designation (e.g. `cS+++++++ path/fifo`). See also the `--specials`
! 2263: option, below.
! 2264:
! 2265: - The way rsync escapes unreadable characters has changed. First, rsync now
! 2266: has support for recognizing valid multibyte character sequences in your
! 2267: current locale, allowing it to escape fewer characters than before for a
! 2268: locale such as UTF-8. Second, it now uses an escape idiom of `\#123`, which
! 2269: is the literal string `\#` followed by exactly 3 octal digits. Rsync no
! 2270: longer doubles a backslash character in a filename (e.g. it used to output
! 2271: `foo\\bar` when copying `foo\bar`) -- now it only escapes a backslash that
! 2272: is followed by a hash-sign and 3 digits (0-9) (e.g. it will output
! 2273: `foo\#134#789` when copying `foo\#789`). See also the `--8-bit-output`
! 2274: (`-8`) option, mentioned below.
! 2275:
! 2276: Script writers: the local rsync is the one that outputs escaped names, so if
! 2277: you need to support unescaping of filenames for older rsyncs, I'd suggest
! 2278: that you parse the output of `rsync --version` and only use the old
! 2279: unescaping rules for 2.6.5 and 2.6.6.
! 2280:
! 2281: ### BUG FIXES:
! 2282:
! 2283: - Fixed a really old bug that caused `--checksum` (`-c`) to checksum all the
! 2284: files encountered during the delete scan (ouch).
! 2285:
! 2286: - Fixed a potential hang in a remote generator: when the receiver gets a
! 2287: read-error on the socket, it now signals the generator about this so that
! 2288: the generator does not try to send any of the terminating error messages to
! 2289: the client (avoiding a potential hang in some setups).
! 2290:
! 2291: - Made hard-links work with symlinks and devices again.
! 2292:
! 2293: - If the sender gets an early EOF reading a source file, we propagate this
! 2294: error to the receiver so that it can discard the file and try requesting it
! 2295: again (which is the existing behavior for other kinds of read errors).
! 2296:
! 2297: - If a device-file/special-file changes permissions, rsync now updates the
! 2298: permissions without recreating the file.
! 2299:
! 2300: - If the user specifies a remote-host for both the source and destination, we
! 2301: now output a syntax error rather than trying to open the destination
! 2302: hostspec as a filename.
! 2303:
! 2304: - When `--inplace` creates a new destination file, rsync now creates it with
! 2305: permissions 0600 instead of 0000 -- this makes restarting possible when the
! 2306: transfer gets interrupted in the middle of sending a new file.
! 2307:
! 2308: - Reject the combination of `--inplace` and `--sparse` since the sparse-output
! 2309: algorithm doesn't work when overwriting existing data.
! 2310:
! 2311: - Fixed the directory name in the error that is output when `pop_dir()` fails.
! 2312:
! 2313: - Really fixed the parsing of a `!` entry in .cvsignore files this time.
! 2314:
! 2315: - If the generator gets a stat() error on a file, output it (this used to
! 2316: require at least `-vv` for the error to be seen).
! 2317:
! 2318: - If waitpid() fails or the child rsync didn't exit cleanly, we now handle the
! 2319: exit status properly and generate a better error.
! 2320:
! 2321: - Fixed some glitches in the double-verbose output when using `--copy-dest`,
! 2322: `--link-dest`, or `--compare-dest`. Also improved how the verbose output
! 2323: handles hard-links (within the transfer) that had an up-to-date alternate
! 2324: `dest` file, and copied files (via `--copy-dest`).
! 2325:
! 2326: - Fixed the matching of the dont-compress items (e.g. `*.gz`) against files
! 2327: that have a path component containing a slash.
! 2328:
! 2329: - If the code reading a filter/exclude file gets an EINTR error, rsync now
! 2330: clears the error flag on the file handle so it can keep on reading.
! 2331:
! 2332: - If `--relative` is active, the sending side cleans up trailing `/` or `/.`
! 2333: suffixes to avoid triggering a bug in older rsync versions. Also, we now
! 2334: reject a `..` dir if it would be sent as a relative dir.
! 2335:
! 2336: - If a non-directory is in the way of a directory and rsync is run with
! 2337: `--dry-run` and `--delete`, rsync no longer complains about not being able
! 2338: to opendir() the not-yet present directory.
! 2339:
! 2340: - When `--list-only` is used and a non-existent local destination dir was also
! 2341: specified as a destination, rsync no longer generates a warning about being
! 2342: unable to create the missing directory.
! 2343:
! 2344: - Fixed some problems with `--relative --no-implied-dirs` when the destination
! 2345: directory did not yet exist: we can now create a symlink or device when it
! 2346: is the first thing in the missing dir, and `--fuzzy` no longer complains
! 2347: about being unable to open the missing dir.
! 2348:
! 2349: - Fixed a bug where the `--copy-links` option would not affect implied
! 2350: directories without `--copy-unsafe-links` (see `--relative`).
! 2351:
! 2352: - Got rid of the need for `--force` to be used in some circumstances with
! 2353: `--delete-after` (making it consistent with
! 2354: `--delete-before`/`--delete-during`).
! 2355:
! 2356: - Rsync now ignores the SIGXFSZ signal, just in case your OS sends this when a
! 2357: file is too large (rsync handles the write error).
! 2358:
! 2359: - Fixed a bug in the Proxy-Authorization header's base64-encoded value: it was
! 2360: not properly padded with trailing '=' chars. This only affects a user that
! 2361: need to use a password-authenticated proxy for an outgoing daemon-rsync
! 2362: connection.
! 2363:
! 2364: - If we're transferring an empty directory to a new name, rsync no longer
! 2365: forces `S_IWUSR` if it wasn't already set, nor does it accidentally leave it
! 2366: set.
! 2367:
! 2368: - Fixed a bug in the debug output (`-vvvvv`) that could mention the wrong
! 2369: checksum for the current file offset.
! 2370:
! 2371: - Rsync no longer allows a single directory to be copied over a non-directory
! 2372: destination arg.
! 2373:
! 2374: ### ENHANCEMENTS:
! 2375:
! 2376: - Added the `--append` option that makes rsync append data onto files that are
! 2377: longer on the source than the destination (this includes new files).
! 2378:
! 2379: - Added the `--min-size=SIZE` option to exclude small files from the transfer.
! 2380:
! 2381: - Added the `--compress-level` option to allow you to set how aggressive
! 2382: rsync's compression should be (this option implies `--compress`).
! 2383:
! 2384: - Enhanced the parsing of the SIZE value for `--min-size` and `--max-size` to
! 2385: allow easy entry of multiples of 1000 (instead of just multiples of 1024)
! 2386: and off-by-one values too (e.g. `--max-size=8mb-1`).
! 2387:
! 2388: - Added the `--8-bit-output` (`-8`) option, which tells rsync to avoid
! 2389: escaping high-bit characters that it thinks are unreadable in the current
! 2390: locale.
! 2391:
! 2392: - The new option `--human-readable` (`-h`) changes the output of `--progress`,
! 2393: `--stats`, and the end-of-run summary to be easier to read. If repeated, the
! 2394: units become powers of 1024 instead of powers of 1000. (The old meaning of
! 2395: `-h`, as a shorthand for `--help`, still works as long as you just use it on
! 2396: its own, as in `rsync -h`.)
! 2397:
! 2398: - If lutimes() and/or lchmod() are around, use them to allow the preservation
! 2399: of attributes on symlinks.
! 2400:
! 2401: - The `--link-dest` option now affects symlinks and devices (when possible).
! 2402:
! 2403: - Added two config items to the rsyncd.conf parsing: `pre-xfer exec` and
! 2404: `post-xfer exec`. These allow a command to be specified on a per-module
! 2405: basis that will be run before and/or after a daemon-mode transfer. (See the
! 2406: man page for a list of the environment variables that are set with
! 2407: information about the transfer.)
! 2408:
! 2409: - When using the `--relative` option, you can now insert a dot dir in the
! 2410: source path to indicate where the replication of the source dirs should
! 2411: start. For example, if you specify a source path of
! 2412: rsync://host/module/foo/bar/./baz/dir with `-R`, rsync will now only
! 2413: replicate the `baz/dir` part of the source path (note: a trailing dot dir is
! 2414: unaffected unless it also has a trailing slash).
! 2415:
! 2416: - Added some new `--no-FOO` options that make it easier to override unwanted
! 2417: implied or default options. For example, `-a --no-o` (aka `--archive
! 2418: --no-owner`) can be used to turn off the preservation of file ownership that
! 2419: is implied by `-a`.
! 2420:
! 2421: - Added the `--chmod=MODE` option that allows the destination permissions to
! 2422: be changed from the source permissions. E.g. `--chmod=g+w,o-rwx`
! 2423:
! 2424: - Added the `incoming chmod` and `outgoing chmod` daemon options that allow a
! 2425: module to specify what permissions changes should be applied to all files
! 2426: copied to and from the daemon.
! 2427:
! 2428: - Allow the `--temp-dir` option to be specified when starting a daemon, which
! 2429: sets the default temporary directory for incoming files.
! 2430:
! 2431: - If `--delete` is combined with `--dirs` without `--recursive`, rsync will
! 2432: now delete in any directory whose content is being synchronized.
! 2433:
! 2434: - If `--backup` is combined with `--delete` without `--backup-dir` (and
! 2435: without `--delete-excluded`), we add a `protect` filter-rule to ensure that
! 2436: files with the backup suffix are not deleted.
! 2437:
! 2438: - The file-count stats that are output by `--progress` were improved to better
! 2439: indicate what the numbers mean. For instance, the output: `(xfer#5,
! 2440: to-check=8383/9999)` indicates that this was the fifth file to be
! 2441: transferred, and we still need to check 8383 more files out of a total of
! 2442: 9999.
! 2443:
! 2444: - The include/exclude code now allows a `dir/***` directive (with 3 trailing
! 2445: stars) to match both the dir itself as well as all the content below the dir
! 2446: (`dir/**` would not match the dir).
! 2447:
! 2448: - Added the `--prune-empty-dirs` (`-m`) option that makes the receiving rsync
! 2449: discard empty chains of directories from the file-list. This makes it easier
! 2450: to selectively copy files from a source hierarchy and end up with just the
! 2451: directories needed to hold the resulting files.
! 2452:
! 2453: - If the `--itemize-changes` (`-i`) option is repeated, rsync now includes
! 2454: unchanged files in the itemized output (similar to `-vv`, but without all
! 2455: the other verbose messages that can get in the way). Of course, the client
! 2456: must be version 2.6.7 for this to work, but the remote rsync only needs to
! 2457: be 2.6.7 if you're pushing files.
! 2458:
! 2459: - Added the `--specials` option to tell rsync to copy non-device special files
! 2460: (which rsync now attempts even as a normal user). The `--devices` option now
! 2461: requests the copying of just devices (character and block). The `-D` option
! 2462: still requests both (e.g. `--devices` and `--specials`), `-a` still implies
! 2463: `-D`, and non-root users still get a silent downgrade that omits device
! 2464: copying.
! 2465:
! 2466: - Added the `--super` option to make the receiver always attempt super-user
! 2467: activities. This is useful for systems that allow things such as devices to
! 2468: be created or ownership to be set without being UID 0, and is also useful
! 2469: for someone who wants to ensure that errors will be output if the receiving
! 2470: rsync isn't being run as root.
! 2471:
! 2472: - Added the `--sockopts` option for those few who want to customize the TCP
! 2473: options used to contact a daemon rsync.
! 2474:
! 2475: - Added a way for the `--temp-dir` option to be combined with a partial-dir
! 2476: setting that lets rsync avoid non-atomic updates (for those times when
! 2477: `--temp-dir` is not being used because space is tight).
! 2478:
! 2479: - A new support script, files-to-excludes, will transform a list of files into
! 2480: a set of include/exclude directives that will copy those files.
! 2481:
! 2482: - A new option, `--executability` (`-E`) can be used to preserve just the
! 2483: execute bit on files, for those times when using the `--perms` option is not
! 2484: desired.
! 2485:
! 2486: - The daemon now logs each connection and also each module-list request that
! 2487: it receives.
! 2488:
! 2489: - New log-format options: %M (modtime), %U (uid), %G (gid), and %B (permission
! 2490: bits, e.g. `rwxr-xrwt`).
! 2491:
! 2492: - The `--dry-run` option no longer forces the enabling of `--verbose`.
! 2493:
! 2494: - The `--remove-sent-files` option now does a better job of incrementally
! 2495: removing the sent files on the sending side (older versions tended to clump
! 2496: up all the removals at the end).
! 2497:
! 2498: - A daemon now supersedes its minimal SIGCHLD handler with the standard
! 2499: PID-remembering version after forking. This ensures that the generator can
! 2500: get the child-exit status from the receiver.
! 2501:
! 2502: - Use of the `--bwlimit` option no longer interferes with the remote rsync
! 2503: sending error messages about invalid/refused options.
! 2504:
! 2505: - Rsync no longer returns a usage error when used with one local source arg
! 2506: and no destination: this now implies the `--list-only` option, just like the
! 2507: comparable situation with a remote source arg.
! 2508:
! 2509: - Added the `--copy-dirlinks` option, a more limited version of
! 2510: `--copy-links`.
! 2511:
! 2512: - Various documentation improvements, including: a better synopsis, some
! 2513: improved examples, a better discussion of the presence and absence of
! 2514: `--perms` (including how it interacts with the new `--executability` and
! 2515: `--chmod` options), an extended discussion of `--temp-dir`, an improved
! 2516: discussion of `--partial-dir`, a better description of rsync's pattern
! 2517: matching characters, an improved `--no-implied-dirs` section, and the
! 2518: documenting of what the `--stats` option outputs.
! 2519:
! 2520: - Various new and updated diffs in the patches dir, including: acls.diff,
! 2521: xattrs.diff, atimes.diff, detect-renamed.diff, and slp.diff.
! 2522:
! 2523: ### INTERNAL:
! 2524:
! 2525: - We now use sigaction() and sigprocmask() if possible, and fall back on
! 2526: signal() if not. Using sigprocmask() ensures that rsync enables all the
! 2527: signals that it needs, just in case it was started in a masked state.
! 2528:
! 2529: - Some buffer sizes were expanded a bit, particularly on systems where
! 2530: MAXPATHLEN is overly small (e.g. Cygwin).
! 2531:
! 2532: - If `io_printf()` tries to format more data than fits in the buffer, exit
! 2533: with an error instead of transmitting a truncated buffer.
! 2534:
! 2535: - If a `va_copy` macro is defined, lib/snprintf.c will use it when defining
! 2536: the `VA_COPY` macro.
! 2537:
! 2538: - Reduced the amount of stack memory needed for each level of directory
! 2539: recursion by nearly MAXPATHLEN bytes.
! 2540:
! 2541: - The wildmatch function was extended to allow an array of strings to be
! 2542: supplied as the string to match. This allows the exclude code to do less
! 2543: string copying.
! 2544:
! 2545: - Got rid of the `safe_fname()` function (and all the myriad calls) and
! 2546: replaced it with a new function in the log.c code that filters all the
! 2547: output going to the terminal.
! 2548:
! 2549: - Unified the `f_name()` and the `f_name_to()` functions.
! 2550:
! 2551: - Improved the hash-table code the sender uses to handle checksums to make it
! 2552: use slightly less memory and run just a little faster.
! 2553:
! 2554: ### DEVELOPER RELATED:
! 2555:
! 2556: - The diffs in the patches dir now require `patch -p1 <DIFF` instead of the
! 2557: previous `-p0`. Also, the version included in the release tar now affect
! 2558: generated files (e.g. configure, rsync.1, proto.h, etc.), so it is no longer
! 2559: necessary to run autoconf and/or yodl unless you're applying a patch that
! 2560: was checked out from CVS.
! 2561:
! 2562: - Several diffs in the patches dir now use the proper `--enable-FOO` configure
! 2563: option instead of `--with-FOO` to turn on the inclusion of the newly patched
! 2564: feature.
! 2565:
! 2566: - There is a new script, `prepare-source` than can be used to update the
! 2567: various generated files (proto.h, configure, etc.) even before configure has
! 2568: created the Makefile (this is mainly useful when patching the source with a
! 2569: patch that doesn't affect generated files).
! 2570:
! 2571: - The testsuite now sets HOME so that it won't be affected by a file such as
! 2572: ~/.popt.
! 2573:
! 2574: ------------------------------------------------------------------------------
! 2575: <a name="2.6.6"></a>
! 2576:
! 2577: # NEWS for rsync 2.6.6 (28 Jul 2005)
! 2578:
! 2579: ## Changes in this version:
! 2580:
! 2581: ### SECURITY FIXES:
! 2582:
! 2583: - The zlib code was upgraded to version 1.2.3 in order to make it more secure.
! 2584: While the widely-publicized security problem in zlib 1.2.2 did not affect
! 2585: rsync, another security problem surfaced that affects rsync's zlib 1.1.4.
! 2586:
! 2587: ### BUG FIXES:
! 2588:
! 2589: - The setting of `flist->high` in `clean_flist()` was wrong for an empty list.
! 2590: This could cause `flist_find()` to crash in certain rare circumstances (e.g.
! 2591: if just the right directory setup was around when `--fuzzy` was combined
! 2592: with `--link-dest`).
! 2593:
! 2594: - The outputting of hard-linked files when verbosity was > 1 was not right:
! 2595: (1) Without `-i` it would output the name of each hard-linked file as though
! 2596: it had been changed; it now outputs a `is hard linked` message for the file.
! 2597: (2) With `-i` it would output all dots for the unchanged attributes of a
! 2598: hard-link; it now changes those dots to spaces, as is done for other totally
! 2599: unchanged items.
! 2600:
! 2601: - When backing up a changed symlink or device, get rid of any old backup item
! 2602: so that we don't get an `already exists` error.
! 2603:
! 2604: - A couple places that were comparing a local and a remote modification-time
! 2605: were not honoring the `--modify-window` option.
! 2606:
! 2607: - Fixed a bug where the 'p' (permissions) itemized-changes flag might get set
! 2608: too often (if some non-significant mode bits differed).
! 2609:
! 2610: - Fixed a really old, minor bug that could cause rsync to warn about being
! 2611: unable to mkdir() a path that ends in `/.` because it just created the
! 2612: directory (required `--relative`, `--no-implied-dirs`, a source path that
! 2613: ended in either a trailing slash or a trailing `/.`, and a non-existing
! 2614: destination dir to tickle the bug in a recent version).
! 2615:
! 2616: ### ENHANCEMENTS:
! 2617:
! 2618: - Made the `max verbosity` setting in the rsyncd.conf file settable on a
! 2619: per-module basis (which now matches the documentation).
! 2620:
! 2621: - The support/rrsync script has been upgraded to verify the args of options
! 2622: that take args (instead of rejecting any such options). The script was also
! 2623: changed to try to be more secure and to fix a problem in the parsing of a
! 2624: pull operation that has multiple sources.
! 2625:
! 2626: - Improved the documentation that explains the difference between a normal
! 2627: daemon transfer and a daemon-over remote-shell transfer.
! 2628:
! 2629: - Some of the diffs supplied in the patches dir were fixed and/or improved.
! 2630:
! 2631: ### BUILD CHANGES:
! 2632:
! 2633: - Made configure define `NOBODY_USER` (currently hard-wired to `nobody`) and
! 2634: `NOBODY_GROUP` (set to either `nobody` or `nogroup` depending on what we
! 2635: find in the /etc/group file).
! 2636:
! 2637: - Added a test to the test suite, itemized.test, that tests the output of `-i`
! 2638: (log-format w/%i) and some double-verbose messages.
! 2639:
! 2640: ------------------------------------------------------------------------------
! 2641: <a name="2.6.5"></a>
! 2642:
! 2643: # NEWS for rsync 2.6.5 (1 Jun 2005)
! 2644:
! 2645: ## Changes in this version:
! 2646:
! 2647: ### OUTPUT CHANGES:
! 2648:
! 2649: - Non-printable chars in filenames are now output using backslash-escaped
! 2650: characters rather than '?'s. Any non-printable character is output using 3
! 2651: digits of octal (e.g. `\n` -> `\012`), and a backslash is now output as
! 2652: `\\`. Rsync also uses your locale setting, which can make it treat fewer
! 2653: high-bit characters as non-printable.
! 2654:
! 2655: - If rsync received an empty file-list when pulling files, it would output a
! 2656: `nothing to do` message and exit with a 0 (success) exit status, even if the
! 2657: remote rsync returned an error (it did not do this under the same conditions
! 2658: when pushing files). This was changed to make the pulling behavior the same
! 2659: as the pushing behavior: we now do the normal end-of-run outputting
! 2660: (depending on options) and exit with the appropriate exit status.
! 2661:
! 2662: ### BUG FIXES:
! 2663:
! 2664: - A crash bug was fixed when a daemon had its `path` set to `/`, did not have
! 2665: chroot enabled, and used some anchored excludes in the rsyncd.conf file.
! 2666:
! 2667: - Fixed a bug in the transfer of a single file when `-H` is specified (rsync
! 2668: would either infinite loop or perhaps crash).
! 2669:
! 2670: - Fixed a case where the generator might try (and fail) to tweak the
! 2671: write-permissions of a read-only directory in list-only mode (this only
! 2672: caused an annoying warning message).
! 2673:
! 2674: - If `--compare-dest` or `--link-dest` uses a locally-copied file as the basis
! 2675: for an updated version, log this better when `--verbose` or `-i` is in
! 2676: effect.
! 2677:
! 2678: - Fixed the accidental disabling of `--backup` during the `--delete-after`
! 2679: processing.
! 2680:
! 2681: - Restored the ability to use the `--address` option in client mode (in
! 2682: addition to its use in daemon mode).
! 2683:
! 2684: - Make sure that some temporary progress information from the delete
! 2685: processing does not get left on the screen when it is followed by a newline.
! 2686:
! 2687: - When `--existing` skips a directory with extra verbosity, refer to it as a
! 2688: `directory`, not a `file`.
! 2689:
! 2690: - When transferring a single file to a different-named file, any generator
! 2691: messages that are source-file related no longer refer to the file by the
! 2692: destination filename.
! 2693:
! 2694: - Fixed a bug where hard-linking a group of files might fail if the generator
! 2695: hasn't created a needed destination directory yet.
! 2696:
! 2697: - Fixed a bug where a hard-linked group of files that is newly-linked to a
! 2698: file in a `--link-dest` dir doesn't link the files from the rest of the
! 2699: cluster.
! 2700:
! 2701: - When deleting files with the `--one-file-system` (`-x`) option set, rsync no
! 2702: longer tries to remove files from inside a mount-point on the receiving
! 2703: side. Also, we don't complain about being unable to remove the mount-point
! 2704: dir.
! 2705:
! 2706: - Fixed a compatibility problem when using `--cvs-ignore` (`-C`) and sending
! 2707: files to an older rsync without using `--delete`.
! 2708:
! 2709: - Make sure that a `- !` or `+ !` include/exclude pattern does not trigger the
! 2710: list-clearing action that is reserved for `!`.
! 2711:
! 2712: - Avoid a timeout in the generator when the sender/receiver aren't handling
! 2713: the generator's checksum output quickly enough.
! 2714:
! 2715: - Fixed the omission of some directories in the delete processing when
! 2716: `--relative` (`-R`) was combined with a source path that had a trailing
! 2717: slash.
! 2718:
! 2719: - Fixed a case where rsync would erroneously delete some files and then
! 2720: re-transfer them when the options `--relative` (`-R`) and `--recursive`
! 2721: (`-r`) were both enabled (along with `--delete`) and a source path had a
! 2722: trailing slash.
! 2723:
! 2724: - Make sure that `--max-size` doesn't affect a device or a symlink.
! 2725:
! 2726: - Make sure that a system with a really small MAXPATHLEN does not cause the
! 2727: buffers in `readfd_unbuffered()` to be too small to receive normal messages.
! 2728: (This mainly affected Cygwin.)
! 2729:
! 2730: - If a source pathname ends with a filename of `..`, treat it as if `../` had
! 2731: been specified (so that we don't copy files to the parent dir of the
! 2732: destination).
! 2733:
! 2734: - If `--delete` is combined with a file-listing rsync command (i.e. no
! 2735: transfer is happening), avoid outputting a warning that we couldn't delete
! 2736: anything.
! 2737:
! 2738: - If `--stats` is specified with `--delete-after`, ensure that all the
! 2739: `deleting` messages are output before the statistics.
! 2740:
! 2741: - Improved one `if` in the deletion code that was only checking errno for
! 2742: ENOTEMPTY when it should have also been checking for EEXIST (for
! 2743: compatibility with OS variations).
! 2744:
! 2745: ### ENHANCEMENTS:
! 2746:
! 2747: - Added the `--only-write-batch=FILE` option that may be used (instead of
! 2748: `--write-batch=FILE`) to create a batch file without doing any actual
! 2749: updating of the destination. This allows you to divert all the file-updating
! 2750: data away from a slow data link (as long as you are pushing the data to the
! 2751: remote server when creating the batch).
! 2752:
! 2753: - When the generator is taking a long time to fill up its output buffer (e.g.
! 2754: if the transferred files are few, small, or missing), it now periodically
! 2755: flushes the output buffer so that the sender/receiver can get started on the
! 2756: files sooner rather than later.
! 2757:
! 2758: - Improved the keep-alive code to handle a long silence between the sender and
! 2759: the receiver that can occur when the sender is receiving the checksum data
! 2760: for a large file.
! 2761:
! 2762: - Improved the auth-errors that are logged by the daemon to include some
! 2763: information on why the authorization failed: wrong user, password mismatch,
! 2764: etc. (The client-visible message is unchanged!)
! 2765:
! 2766: - Improved the client's handling of an `@ERROR` from a daemon so that it does
! 2767: not complain about an unexpectedly closed socket (since we really did expect
! 2768: the socket to close).
! 2769:
! 2770: - If the daemon can't open the log-file specified in rsyncd.conf, fall back to
! 2771: using syslog and log an appropriate warning. This is better than what was
! 2772: typically a totally silent (and fatal) failure (since a daemon is not
! 2773: usually run with the `--no-detach` option that was necessary to see the
! 2774: error on stderr).
! 2775:
! 2776: - The man pages now consistently refer to an rsync daemon as a `daemon`
! 2777: instead of a `server` (to distinguish it from the server process in a
! 2778: non-daemon transfer).
! 2779:
! 2780: - Made a small change to the rrsync script (restricted rsync -- in the support
! 2781: dir) to make a read-only server reject all `--remove-*` options when sending
! 2782: files (to future-proof it against the possibility of other similar options
! 2783: being added at some point).
! 2784:
! 2785: ### INTERNAL:
! 2786:
! 2787: - Rsync now calls `setlocale(LC_CTYPE, "")`. This enables isprint() to better
! 2788: discern which filename characters need to be escaped in messages (which
! 2789: should result in fewer escaped characters in some locales).
! 2790:
! 2791: - Improved the naming of the log-file open/reopen/close functions.
! 2792:
! 2793: - Removed some protocol-compatibility code that was only needed to help
! 2794: someone running a pre-release of 2.6.4.
! 2795:
! 2796: ### BUILD CHANGES:
! 2797:
! 2798: - Added configure option `--disable-locale` to disable any use of setlocale()
! 2799: in the binary.
! 2800:
! 2801: - Fixed a bug in the `SUPPORT{,_HARD}_LINKS` #defines which prevented rsync
! 2802: from being built without symlink or hard-link support.
! 2803:
! 2804: - Only #define `HAVE_REMSH` if it is going to be set to 1.
! 2805:
! 2806: - Configure now disables the use of mkstemp() under HP-UX (since they refuse
! 2807: to fix its broken handling of large files).
! 2808:
! 2809: - Configure now explicitly checks for the lseek64() function so that the code
! 2810: can use `HAVE_LSEEK64` instead of inferring lseek64()'s presence based on
! 2811: the presence of the `off64_t` type.
! 2812:
! 2813: - Configure no longer mentions the change in the default remote-shell (from
! 2814: rsh to ssh) that occurred for the 2.6.0 release.
! 2815:
! 2816: - Some minor enhancements to the test scripts.
! 2817:
! 2818: - Added a few new `*.diff` files to the patches dir, including a patch that
! 2819: enables the optional copying of extended attributes.
! 2820:
! 2821: ------------------------------------------------------------------------------
! 2822: <a name="2.6.4"></a>
! 2823:
! 2824: # NEWS for rsync 2.6.4 (30 March 2005)
! 2825:
! 2826: ## Changes in this version:
! 2827:
! 2828: ### PROTOCOL NUMBER:
! 2829:
! 2830: - The protocol number was changed to 29.
! 2831:
! 2832: ### OUTPUT CHANGES:
! 2833:
! 2834: - When rsync deletes a directory and outputs a verbose message about it, it
! 2835: now appends a trailing slash to the name instead of (only sometimes)
! 2836: outputting a preceding "directory " string.
! 2837:
! 2838: - The `--stats` output will contain file-list time-statistics if both sides
! 2839: are 2.6.4, or if the local side is 2.6.4 and the files are being pushed
! 2840: (since the stats come from the sending side). (Requires protocol 29 for a
! 2841: pull.)
! 2842:
! 2843: - The `%o` (operation) log-format escape now has a third value (besides `send`
! 2844: and `recv`): `del.` (with trailing dot to make it 4 chars). This changes
! 2845: the way deletions are logged in the daemon's log file.
! 2846:
! 2847: - When the `--log-format` option is combined with `--verbose`, rsync now
! 2848: avoids outputting the name of the file twice in most circumstances. As long
! 2849: as the `--log-format` item does not refer to any post-transfer items (such
! 2850: as %b or %c), the `--log-format` message is output prior to the transfer, so
! 2851: `--verbose` is now the equivalent of a `--log-format` of '%n%L' (which
! 2852: outputs the name and any link info). If the log output must occur after the
! 2853: transfer to be complete, the only time the name is also output prior to the
! 2854: transfer is when `--progress` was specified (so that the name will precede
! 2855: the progress stats, and the full `--log-format` output will come after).
! 2856:
! 2857: - Non-printable characters in filenames are replaced with a '?' to avoid
! 2858: corrupting the screen or generating empty lines in the output.
! 2859:
! 2860: ### BUG FIXES:
! 2861:
! 2862: - Restore the list-clearing behavior of `!` in a .cvsignore file (2.6.3 was
! 2863: only treating it as a special token in an rsync include/exclude file).
! 2864:
! 2865: - The combination of `--verbose` and `--dry-run` now mentions the full list of
! 2866: changes that would be output without `--dry-run`.
! 2867:
! 2868: - Avoid a mkdir warning when removing a directory in the destination that
! 2869: already exists in the `--backup-dir`.
! 2870:
! 2871: - An OS that has a binary mode for its files (such as Cygwin) needed
! 2872: `setmode(fd, O_BINARY)` called on the temp-file we opened with mkstemp().
! 2873: (Fix derived from Cygwin's 2.6.3 rsync package.)
! 2874:
! 2875: - Fixed a potential hang when verbosity is high, the client side is the
! 2876: sender, and the file-list is large.
! 2877:
! 2878: - Fixed a potential protocol-corrupting bug where the generator could merge a
! 2879: message from the receiver into the middle of a multiplexed packet of data if
! 2880: only part of that data had been written out to the socket when the message
! 2881: from the generator arrived.
! 2882:
! 2883: - We now check if the OS doesn't support using mknod() for creating FIFOs and
! 2884: sockets, and compile-in some compatibility code using mkfifo() and socket()
! 2885: when necessary.
! 2886:
! 2887: - Fixed an off-by-one error in the handling of `--max-delete=N`. Also, if the
! 2888: `--max-delete` limit is exceeded during a run, we now output a warning about
! 2889: this at the end of the run and exit with a new error code (25).
! 2890:
! 2891: - One place in the code wasn't checking if fork() failed.
! 2892:
! 2893: - The `ignore nonreadable` daemon parameter used to erroneously affect
! 2894: readable symlinks that pointed to a non-existent file.
! 2895:
! 2896: - If the OS does not have lchown() and a chown() of a symlink will affect the
! 2897: referent of a symlink (as it should), we no longer try to set the user and
! 2898: group of a symlink.
! 2899:
! 2900: - The generator now properly runs the hard-link loop and the dir-time
! 2901: rewriting loop after we're sure that the redo phase is complete.
! 2902:
! 2903: - When `--backup` was specified with `--partial-dir=DIR`, where DIR is a
! 2904: relative path, the backup code was erroneously trying to backup a file that
! 2905: was put into the partial-dir.
! 2906:
! 2907: - If a file gets resent in a single transfer and the `--backup` option is
! 2908: enabled along with `--inplace`, rsync no longer performs a duplicate backup
! 2909: (it used to overwrite the first backup with the failed file).
! 2910:
! 2911: - One call to `flush_write_file()` was not being checked for an error.
! 2912:
! 2913: - The `--no-relative` option was not being sent from the client to a server
! 2914: sender.
! 2915:
! 2916: - If an rsync daemon specified `dont compress = ...` for a file and the client
! 2917: tried to specify `--compress`, the libz code was not handling a compression
! 2918: level of 0 properly. This could cause a transfer failure if the block-size
! 2919: for a file was large enough (e.g. rsync might have exited with an error for
! 2920: large files).
! 2921:
! 2922: - Fixed a bug that would sometimes surface when using `--compress` and sending
! 2923: a file with a block-size larger than 64K (either manually specified, or
! 2924: computed due to the file being really large). Prior versions of rsync would
! 2925: sometimes fail to decompress the data properly, and thus the transferred
! 2926: file would fail its verification.
! 2927:
! 2928: - If a daemon can't open the specified log file (i.e. syslog is not being
! 2929: used), die without crashing. We also output an error about the failure on
! 2930: stderr (which will only be seen if `--no-detach` was specified) and exit
! 2931: with a new error code (6).
! 2932:
! 2933: - A local transfer no longer duplicates all its include/exclude options (since
! 2934: the forked process already has a copy of the exclude list, there's no need
! 2935: to send them a set of duplicates).
! 2936:
! 2937: - The output of the items that are being updated by the generator (dirs,
! 2938: symlinks, devices) is now intermingled in the proper order with the output
! 2939: from the items that the receiver is updating (regular files) when pulling.
! 2940: This misordering was particularly bad when `--progress` was specified.
! 2941: (Requires protocol 29.)
! 2942:
! 2943: - When `--timeout` is specified, lulls that occur in the transfer while the
! 2944: generator is doing work that does not generate socket traffic (looking for
! 2945: changed files, deleting files, doing directory-time touch-ups, etc.) will
! 2946: cause a new keep-alive packet to be sent that should keep the transfer going
! 2947: as long as the generator continues to make progress. (Requires protocol 29.)
! 2948:
! 2949: - The stat size of a device is not added to the total file size of the items
! 2950: in the transfer (the size might be undefined on some OSes).
! 2951:
! 2952: - Fixed a problem with refused-option messages sometimes not making it back to
! 2953: the client side when a remote `--files-from` was in effect and the daemon
! 2954: was the receiver.
! 2955:
! 2956: - The `--compare-dest` option was not updating a file that differed in (the
! 2957: preserved) attributes from the version in the compare-dest DIR.
! 2958:
! 2959: - When rsync is copying files into a write-protected directory, fixed the
! 2960: change-report output for the directory so that we don't report an identical
! 2961: directory as changed.
! 2962:
! 2963: ### ENHANCEMENTS:
! 2964:
! 2965: - Rsync now supports popt's option aliases, which means that you can use
! 2966: /etc/popt and/or ~/.popt to create your own option aliases.
! 2967:
! 2968: - Added the `--delete-during` (`--del`) option which will delete files from
! 2969: the receiving side incrementally as each directory in the transfer is being
! 2970: processed. This makes it more efficient than the default,
! 2971: before-the-transfer behavior, which is now also available as
! 2972: `--delete-before` (and is still the default `--delete-WHEN` option that will
! 2973: be chosen if `--delete` or `--delete-excluded` is specified without a
! 2974: `--delete-WHEN` choice). All the `--del*` options infer `--delete`, so an
! 2975: rsync daemon that refuses `delete` will still refuse to allow any
! 2976: file-deleting options (including the new `--remove-sent-files` option).
! 2977:
! 2978: - All the `--delete-WHEN` options are now more memory efficient: Previously an
! 2979: duplicate set of file-list objects was created on the receiving side for the
! 2980: entire destination hierarchy. The new algorithm only creates one directory
! 2981: of objects at a time (for files inside the transfer).
! 2982:
! 2983: - Added the `--copy-dest` option, which works like `--link-dest` except that
! 2984: it locally copies identical files instead of hard-linking them.
! 2985:
! 2986: - Added support for specifying multiple `--compare-dest`, `--copy-dest`, or
! 2987: `--link-dest` options, but only of a single type. (Promoted from the patches
! 2988: dir and enhanced.) (Requires protocol 29.)
! 2989:
! 2990: - Added the `--max-size` option. (Promoted from the patches dir.)
! 2991:
! 2992: - The daemon-mode options are now separated from the normal rsync options so
! 2993: that they can't be mixed together. This makes it impossible to start a
! 2994: daemon that has improper default option values (which could cause problems
! 2995: when a client connects, such as hanging or crashing).
! 2996:
! 2997: - The `--bwlimit` option may now be used in combination with `--daemon` to
! 2998: specify both a default value for the daemon side and a value that cannot be
! 2999: exceeded by a user-specified `--bwlimit` option.
! 3000:
! 3001: - Added the `port` parameter to the rsyncd.conf file. (Promoted from the
! 3002: patches dir.) Also added `address`. The command-line options take precedence
! 3003: over a config-file option, as expected.
! 3004:
! 3005: - In `_exit_cleanup()`: when we are exiting with a partially-received file, we
! 3006: now flush any data in the write-cache before closing the partial file.
! 3007:
! 3008: - The `--inplace` support was enhanced to work with `--compare-dest`,
! 3009: `--link-dest`, and (the new) `--copy-dest` options. (Requires protocol 29.)
! 3010:
! 3011: - Added the `--dirs` (`-d`) option for an easier way to copy directories
! 3012: without recursion. Any directories that are encountered are created on the
! 3013: destination. Specifying a directory with a trailing slash copies its
! 3014: immediate contents to the destination.
! 3015:
! 3016: - The `--files-from` option now implies `--dirs` (`-d`).
! 3017:
! 3018: - Added the `--list-only` option, which is mainly a way for the client to put
! 3019: the server into listing mode without needing to resort to any internal
! 3020: option kluges (e.g. the age-old use of `-r --exclude='/*/*'` for a
! 3021: non-recursive listing). This option is used automatically (behind the
! 3022: scenes) when a modern rsync speaks to a modern daemon, but may also be
! 3023: specified manually if you want to force the use of the `--list-only` option
! 3024: over a remote-shell connection.
! 3025:
! 3026: - Added the `--omit-dir-times` (`-O`) option, which will avoid updating the
! 3027: modified time for directories when `--times` was specified. This option will
! 3028: avoid an extra pass through the file-list at the end of the transfer (to
! 3029: tweak all the directory times), which may provide an appreciable speedup for
! 3030: a really large transfer. (Promoted from the patches dir.)
! 3031:
! 3032: - Added the `--filter` (`-f`) option and its helper option, `-F`. Filter rules
! 3033: are an extension to the existing include/exclude handling that also supports
! 3034: nested filter files as well as per-directory filter files (like .cvsignore,
! 3035: but with full filter-rule parsing). This new option was chosen in order to
! 3036: ensure that all existing include/exclude processing remained 100% compatible
! 3037: with older versions. Protocol 29 is needed for full filter-rule support, but
! 3038: backward-compatible rules work with earlier protocol versions. (Promoted
! 3039: from the patches dir and enhanced.)
! 3040:
! 3041: - Added the `--delay-updates` option that puts all updated files into a
! 3042: temporary directory (by default `.~tmp~`, but settable via the
! 3043: `--partial-dir=DIR` option) until the end of the transfer. This makes the
! 3044: updates a little more atomic for a large transfer.
! 3045:
! 3046: - If rsync is put into the background, any output from `--progress` is
! 3047: reduced.
! 3048:
! 3049: - Documented the `max verbosity` setting for rsyncd.conf. (This setting was
! 3050: added a couple releases ago, but left undocumented.)
! 3051:
! 3052: - The sender and the generator now double-check the file-list index they are
! 3053: given, and refuse to try to do a file transfer on a non-file index (since
! 3054: that would indicate that something had gone very wrong).
! 3055:
! 3056: - Added the `--itemize-changes` (`-i`) option, which is a way to output a more
! 3057: detailed list of what files changed and in what way. The effect is the same
! 3058: as specifying a `--log-format` of `%i %n%L` (see both the rsync and
! 3059: rsyncd.conf manpages). Works with `--dry-run` too.
! 3060:
! 3061: - Added the `--fuzzy` (`-y`) option, which attempts to find a basis file for a
! 3062: file that is being created from scratch. The current algorithm only looks in
! 3063: the destination directory for the created file, but it does attempt to find
! 3064: a match based on size/mod-time (in case the file was renamed with no other
! 3065: changes) as well as based on a fuzzy name-matching algorithm. This option
! 3066: requires protocol 29 because it needs the new file-sorting order. (Promoted
! 3067: from patches dir and enhanced.) (Requires protocol 29.)
! 3068:
! 3069: - Added the `--remove-sent-files` option, which lets you move files between
! 3070: systems.
! 3071:
! 3072: - The hostname in HOST:PATH or HOST::PATH may now be an IPv6 literal enclosed
! 3073: in '[' and ']' (e.g. `[::1]`). (We already allowed IPv6 literals in the
! 3074: rsync://HOST:PORT/PATH format.)
! 3075:
! 3076: - When rsync recurses to build the file list, it no longer keeps open one or
! 3077: more directory handles from the dir's parent dirs.
! 3078:
! 3079: - When building under windows, the default for `--daemon` is now to avoid
! 3080: detaching, requiring the new `--detach` option to force rsync to detach.
! 3081:
! 3082: - The `--dry-run` option can now be combined with either `--write-batch` or
! 3083: `--read-batch`, allowing you to run a do-nothing test command to see what
! 3084: would happen without `--dry-run`.
! 3085:
! 3086: - The daemon's `read only` config item now sets an internal `read_only`
! 3087: variable that makes extra sure that no write/delete calls on the read-only
! 3088: side can succeed.
! 3089:
! 3090: - The log-format % escapes can now have a numeric field width in between the %
! 3091: and the escape letter (e.g. `%-40n %08p`).
! 3092:
! 3093: - Improved the option descriptions in the `--help` text.
! 3094:
! 3095: ### SUPPORT FILES:
! 3096:
! 3097: - Added atomic-rsync to the support dir: a perl script that will transfer some
! 3098: files using rsync, and then move the updated files into place all at once at
! 3099: the end of the transfer. Only works when pulling, and uses `--link-dest` and
! 3100: a parallel hierarchy of files to effect its update.
! 3101:
! 3102: - Added mnt-excl to the support dir: a perl script that takes the /proc/mounts
! 3103: file and translates it into a set of excludes that will exclude all mount
! 3104: points (even mapped mounts to the same disk). The excludes are made relative
! 3105: to the specified source dir and properly anchored.
! 3106:
! 3107: - Added savetransfer.c to the support dir: a C program that can make a copy of
! 3108: all the data that flows over the wire. This lets you test for data
! 3109: corruption (by saving the data on both the sending side and the receiving
! 3110: side) and provides one way to debug a protocol error.
! 3111:
! 3112: - Added rrsync to the support dir: this is an updated version of Joe Smith's
! 3113: restricted rsync perl script. This helps to ensure that only certain rsync
! 3114: commands can be run by an ssh invocation.
! 3115:
! 3116: ### INTERNAL:
! 3117:
! 3118: - Added better checking of the checksum-header values that come over the
! 3119: socket.
! 3120:
! 3121: - Merged a variety of file-deleting functions into a single function so that
! 3122: it is easier to maintain.
! 3123:
! 3124: - Improved the type of some variables (particularly blocksize vars) for
! 3125: consistency and proper size.
! 3126:
! 3127: - Got rid of the uint64 type (which we didn't need).
! 3128:
! 3129: - Use a slightly more compatible set of core #include directives.
! 3130:
! 3131: - Defined int32 in a way that ensures that the build dies if we can't find a
! 3132: variable with at least 32 bits.
! 3133:
! 3134: ### PROTOCOL DIFFERENCES FOR VERSION 29:
! 3135:
! 3136: - A 16-bit flag-word is transmitted after every file-list index. This
! 3137: indicates what is changing between the sender and the receiver. The
! 3138: generator now transmits an index and a flag-word to indicate when dirs and
! 3139: symlinks have changed (instead of producing a message), which makes the
! 3140: outputting of the information more consistent and less prone to screen
! 3141: corruption (because the local receiver/sender is now outputting all the
! 3142: file-change info messages).
! 3143:
! 3144: - If a file is being hard-linked, the `ITEM_XNAME_FOLLOWS` bit is enabled in
! 3145: the flag-word and the name of the file that was linked immediately follows
! 3146: in vstring format (see below).
! 3147:
! 3148: - If a file is being transferred with an alternate-basis file, the
! 3149: `ITEM_BASIS_TYPE_FOLLOWS` bit is enabled in the flag-word and a single byte
! 3150: follows, indicating what type of basis file was chosen. If that indicates
! 3151: that a fuzzy-match was selected, the `ITEM_XNAME_FOLLOWS` bit is set in the
! 3152: flag-word and the name of the match in vstring format follows the basis
! 3153: byte. A vstring is a variable length string that has its size written prior
! 3154: to the string, and no terminating null. If the string is from 1-127 bytes,
! 3155: the length is a single byte. If it is from 128-32767 bytes, the length is
! 3156: written as ((len >> 8) | 0x80) followed by (len % 0x100).
! 3157:
! 3158: - The sending of exclude names is done using filter-rule syntax. This means
! 3159: that all names have a prefixed rule indicator, even excludes (which used to
! 3160: be sent as a bare pattern, when possible). The `-C` option will include the
! 3161: per-dir .cvsignore merge file in the list of filter rules so it is
! 3162: positioned correctly (unlike in some older transfer scenarios).
! 3163:
! 3164: - Rsync sorts the filename list in a different way: it sorts the subdir names
! 3165: after the non-subdir names for each dir's contents, and it always puts a
! 3166: dir's contents immediately after the dir's name in the list. (Previously an
! 3167: item named `foo.txt` would sort in between directory `foo/` and `foo/bar`.)
! 3168:
! 3169: - When talking to a protocol 29 rsync daemon, a list-only request is able to
! 3170: note this before the options are sent over the wire and the new
! 3171: `--list-only` option is included in the options.
! 3172:
! 3173: - When the `--stats` bytes are sent over the wire (or stored in a batch), they
! 3174: now include two elapsed-time values: one for how long it took to build the
! 3175: file-list, and one for how long it took to send it over the wire (each
! 3176: expressed in thousandths of a second).
! 3177:
! 3178: - When `--delete-excluded` is specified with some filter rules (AKA excludes),
! 3179: a client sender will now initiate a send of the rules to the receiver (older
! 3180: protocols used to omit the sending of excludes in this situation since there
! 3181: were no receiver-specific rules that survived `--delete-excluded` back
! 3182: then). Note that, as with all the filter-list sending, only items that are
! 3183: significant to the other side will actually be sent over the wire, so the
! 3184: filter-rule list that is sent in this scenario is often empty.
! 3185:
! 3186: - An index equal to the file-list count is sent as a keep-alive packet from
! 3187: the generator to the sender, which then forwards it on to the receiver. This
! 3188: normally invalid index is only a valid keep-alive packet if the 16-bit
! 3189: flag-word that follows it contains a single bit (`ITEM_IS_NEW`, which is
! 3190: normally an illegal flag to appear alone).
! 3191:
! 3192: - A protocol-29 batch file includes a bit for the setting of the `--dirs`
! 3193: option and for the setting of the `--compress` option. Also, the shell
! 3194: script created by `--write-batch` will use the `--filter` option instead of
! 3195: `--exclude-from` to capture any filter rules.
! 3196:
! 3197: ### BUILD CHANGES:
! 3198:
! 3199: - Handle an operating system that use mkdev() in place of makedev().
! 3200:
! 3201: - Improved configure to better handle cross-compiling.
! 3202:
! 3203: ------------------------------------------------------------------------------
! 3204: <a name="2.6.3"></a>
! 3205:
! 3206: # NEWS for rsync 2.6.3 (30 Sep 2004)
! 3207:
! 3208: ## Changes in this version:
! 3209:
! 3210: ### SECURITY FIXES:
! 3211:
! 3212: - A bug in the `sanitize_path` routine (which affects a non-chrooted rsync
! 3213: daemon) could allow a user to craft a pathname that would get transformed
! 3214: into an absolute path for certain options (but not for file-transfer names).
! 3215: If you're running an rsync daemon with chroot disabled, **please upgrade**,
! 3216: ESPECIALLY if the user privs you run rsync under is anything above `nobody`.
! 3217:
! 3218: OUTPUT CHANGES (ATTN: those using a script to parse the verbose output):
! 3219:
! 3220: - Please note that the 2-line footer (output when verbose) now uses the term
! 3221: `sent` instead of `wrote` and `received` instead of `read`. If you are not
! 3222: parsing the numeric values out of this footer, a script would be better off
! 3223: using the empty line prior to the footer as the indicator that the verbose
! 3224: output is over.
! 3225:
! 3226: - The output from the `--stats` option was similarly affected to change
! 3227: `written` to `sent` and `read` to `received`.
! 3228:
! 3229: - Rsync ensures that a filename that contains a newline gets mentioned with
! 3230: each newline transformed into a question mark (which prevents a filename
! 3231: from causing an empty line to be output).
! 3232:
! 3233: - The `backed up ...` message that is output when at least 2 `--verbose`
! 3234: options are specified is now the same both with and without the
! 3235: `--backup-dir` option.
! 3236:
! 3237: ### BUG FIXES:
! 3238:
! 3239: - Fixed a crash bug that might appear when `--delete` was used and multiple
! 3240: source directories were specified.
! 3241:
! 3242: - Fixed a 32-bit truncation of the file length when generating the checksums.
! 3243:
! 3244: - The `--backup` code no longer attempts to create some directories over and
! 3245: over again (generating warnings along the way).
! 3246:
! 3247: - Fixed a bug in the reading of the secrets file (by the daemon) and the
! 3248: password file (by the client): the files no longer need to be terminated by
! 3249: a newline for their content to be read in.
! 3250:
! 3251: - If a file has a read error on the sending side or the reconstructed data
! 3252: doesn't match the expected checksum (perhaps due to the basis file changing
! 3253: during the transfer), the receiver will no longer retain the resulting file
! 3254: unless the `--partial` option was specified. (Note: for the read-error
! 3255: detection to work, neither side can be older than 2.6.3 -- older receivers
! 3256: will always retain the file, and older senders don't tell the receiver that
! 3257: the file had a read error.)
! 3258:
! 3259: - If a file gets resent in a single transfer and the `--backup` option is
! 3260: enabled, rsync no longer performs a duplicate backup (it used to overwrite
! 3261: the original file in the backup area).
! 3262:
! 3263: - Files specified in the daemon's `exclude` or `exclude from` config items are
! 3264: now excluded from being uploaded (assuming that the module allows uploading
! 3265: at all) in addition to the old download exclusion.
! 3266:
! 3267: - Got rid of a potential hang in the receiver when near the end of a phase.
! 3268:
! 3269: - When using `--backup` without a `--backup-dir`, rsync no longer preserves
! 3270: the modify time on directories. This avoids confusing NFS.
! 3271:
! 3272: - When `--copy-links` (`-L`) is specified, we now output a separate error for
! 3273: a symlink that has no referent instead of claiming that a file `vanished`.
! 3274:
! 3275: - The `--copy-links` (`-L`) option no longer has the side-effect of telling
! 3276: the receiving side to follow symlinks. See the `--keep-dirlinks` option
! 3277: (mentioned below) for a way to specify that behavior.
! 3278:
! 3279: - Error messages from the daemon server's option-parsing (such as refused
! 3280: options) are now successfully transferred back to the client (the server
! 3281: used to fail to send the message because the socket wasn't in the right
! 3282: state for the message to get through).
! 3283:
! 3284: - Most transfer errors that occur during a daemon transfer are now returned to
! 3285: the user in addition to being logged (some messages are intended to be
! 3286: daemon-only and are not affected by this).
! 3287:
! 3288: - Fixed a bug in the daemon authentication code when using one of the
! 3289: batch-processing options.
! 3290:
! 3291: - We try to work around some buggy IPv6 implementations that fail to implement
! 3292: `IPV6_V6ONLY`. This should fix the `address in use` error that some daemons
! 3293: get when running on an OS with a buggy IPv6 implementation. Also, if the new
! 3294: code gets this error, we might suggest that the user specify `--ipv4` or
! 3295: `--ipv6` (if we think it will help).
! 3296:
! 3297: - When the remote rsync dies, make a better effort to recover any error
! 3298: messages it may have sent before dying (the local rsync used to just die
! 3299: with a socket-write error).
! 3300:
! 3301: - When using `--delete` and a `--backup-dir` that contains files that are
! 3302: hard-linked to their destination equivalents, rsync now makes sure that
! 3303: removed files really get removed (avoids a really weird rename() behavior).
! 3304:
! 3305: - Avoid a bogus run-time complaint about a lack of 64-bit integers when the
! 3306: int64 type is defined as an `off_t` and it actually has 64-bits.
! 3307:
! 3308: - Added a configure check for open64() without mkstemp64() so that we can
! 3309: avoid using mkstemp() when such a combination is encountered. This bypasses
! 3310: a problem writing out large temp files on OSes such as AIX and HP-UX.
! 3311:
! 3312: - Fixed an age-old crash problem with `--read-batch` on a local copy (rsync
! 3313: was improperly assuming `--whole-file` for the local copy).
! 3314:
! 3315: - When `--dry-run` (`-n`) is used and the destination directory does not
! 3316: exist, rsync now produces a correct report of files that would be sent
! 3317: instead of dying with a chdir() error.
! 3318:
! 3319: - Fixed a bug that could cause a slow-to-connect rsync daemon to die with an
! 3320: error instead of waiting for the connection to finish.
! 3321:
! 3322: - Fixed an ssh interaction that could cause output to be lost when the user
! 3323: chose to combine the output of rsync's stdout and stderr (e.g. using the
! 3324: `2>&1`).
! 3325:
! 3326: - Fixed an option-parsing bug when `--files-from` got passed to a daemon.
! 3327:
! 3328: ### ENHANCEMENTS:
! 3329:
! 3330: - Added the `--partial-dir=DIR` option that lets you specify where to
! 3331: (temporarily) put a partially transferred file (instead of overwriting the
! 3332: destination file). E.g. `--partial-dir=.rsync-partial` Also added support
! 3333: for the `RSYNC_PARTIAL_DIR` environment variable that, when found,
! 3334: transforms a regular `--partial` option (such as the convenient `-P` option)
! 3335: into one that also specifies a directory.
! 3336:
! 3337: - Added `--keep-dirlinks` (`-K`), which allows you to symlink a directory onto
! 3338: another partition on the receiving side and have rsync treat it as matching
! 3339: a normal directory from the sender.
! 3340:
! 3341: - Added the `--inplace` option that tells rsync to write each destination file
! 3342: without using a temporary file. The matching of existing data in the
! 3343: destination file can be severely limited by this, but there are also cases
! 3344: where this is more efficient (such as appending data). Use only when needed
! 3345: (see the man page for more details).
! 3346:
! 3347: - Added the `write only` option for the daemon's config file.
! 3348:
! 3349: - Added long-option names for `-4` and `-6` (namely `--ipv4` and `--ipv6`) and
! 3350: documented all these options in the man page.
! 3351:
! 3352: - Improved the handling of the `--bwlimit` option so that it's less bursty,
! 3353: more accurate, and works properly over a larger range of values.
! 3354:
! 3355: - The rsync daemon-over-ssh code now looks for `SSH_CONNECTION` and
! 3356: `SSH2_CLIENT` in addition to `SSH_CLIENT` to figure out the IP address.
! 3357:
! 3358: - Added the `--checksum-seed=N` option for advanced users.
! 3359:
! 3360: - Batch writing/reading has a brand-new implementation that is simpler, fixes
! 3361: a few weird problems with the old code (such as no longer sprinkling the
! 3362: batch files into different dirs or even onto different systems), and is much
! 3363: less intrusive into the code (making it easier to maintain for the future).
! 3364: The new code generates just one data file instead of three, which makes it
! 3365: possible to read the batch on stdin via a remote shell. Also, the old
! 3366: requirement of forcing the same fixed checksum-seed for all batch processing
! 3367: has been removed.
! 3368:
! 3369: - If an rsync daemon has a module set with `list = no` (which hides its
! 3370: presence in the list of available modules), a user that fails to
! 3371: authenticate gets the same `unknown module` error that they would get if the
! 3372: module were actually unknown (while still logging the real error to the
! 3373: daemon's log file). This prevents fishing for module names.
! 3374:
! 3375: - The daemon's `refuse options` config item now allows you to match option
! 3376: names using wildcards and/or the single-letter option names.
! 3377:
! 3378: - Each transferred file now gets its permissions and modified-time updated
! 3379: before the temp-file gets moved into place. Previously, the finished file
! 3380: would have a very brief window where its permissions disallowed all group
! 3381: and world access.
! 3382:
! 3383: - Added the ability to parse a literal IPv6 address in an `rsync:` URL (e.g.
! 3384: rsync://[2001:638:500:101::21]:873/module/dir).
! 3385:
! 3386: - The daemon's wildcard expanding code can now handle more than 1000 filenames
! 3387: (it's now limited by memory instead of having a hard-wired limit).
! 3388:
! 3389: ### INTERNAL:
! 3390:
! 3391: - Some cleanup in the exclude code has saved some per-exclude memory and made
! 3392: the code easier to maintain.
! 3393:
! 3394: - Improved the argv-overflow checking for a remote command that has a lot of
! 3395: args.
! 3396:
! 3397: - Use rsyserr() in the various places that were still calling rprintf() with
! 3398: strerror() as an arg.
! 3399:
! 3400: - If an rsync daemon is listening on multiple sockets (to handle both IPv4 and
! 3401: IPv6 to a single port), we now close all the unneeded file handles after we
! 3402: accept a connection (we used to close just one of them).
! 3403:
! 3404: - Optimized the handling of larger block sizes (rsync used to slow to a crawl
! 3405: if the block size got too large).
! 3406:
! 3407: - Optimized away a loop in `hash_search()`.
! 3408:
! 3409: - Some improvements to the `sanitize_path()` and `clean_fname()` functions
! 3410: makes them more efficient and produce better results (while still being
! 3411: compatible with the file-name cleaning that gets done on both sides when
! 3412: sending the file-list).
! 3413:
! 3414: - Got rid of `alloc_sanitize_path()` after adding a destination-buffer arg to
! 3415: `sanitize_path()` made it possible to put all the former's functionality
! 3416: into the latter.
! 3417:
! 3418: - The file-list that is output when at least 4 verbose options are specified
! 3419: reports the uid value on the sender even when rsync is not running as root
! 3420: (since we might be sending to a root receiver).
! 3421:
! 3422: ### BUILD CHANGES:
! 3423:
! 3424: - Added a `gen` target to rebuild most of the generated files, including
! 3425: configure, config.h.in, the man pages, and proto.h.
! 3426:
! 3427: - If `make proto` doesn't find some changes in the prototypes, the proto.h
! 3428: file is left untouched (its time-stamp used to always be updated).
! 3429:
! 3430: - The variable `$STRIP` (that is optionally set by the install-strip target's
! 3431: rule) was changed to `$INSTALL_STRIP` because some systems have `$STRIP`
! 3432: already set in the environment.
! 3433:
! 3434: - Fixed a build problem when `SUPPORT_HARD_LINKS` isn't defined.
! 3435:
! 3436: - When cross-compiling, the gettimeofday() function is now assumed to be a
! 3437: modern version that takes two-args (since we can't test it).
! 3438:
! 3439: ### DEVELOPER RELATED:
! 3440:
! 3441: - The scripts in the testsuite dir were cleaned up a bit and a few new tests
! 3442: added.
! 3443:
! 3444: - Some new diffs were added to the patches dir, and some accepted ones were
! 3445: removed.
! 3446:
! 3447: ------------------------------------------------------------------------------
! 3448: <a name="2.6.2"></a>
! 3449:
! 3450: # NEWS for rsync 2.6.2 (30 Apr 2004)
! 3451:
! 3452: ## Changes in this version:
! 3453:
! 3454: ### BUG FIXES:
! 3455:
! 3456: - Fixed a major bug in the sorting of the filenames when `--relative` is used
! 3457: for some sources (just sources such as `/` and `/*` were affected). This fix
! 3458: ensures that we ask for the right file-list item when requesting changes
! 3459: from the sender.
! 3460:
! 3461: - Rsync now checks the return value of the close() function to better report
! 3462: disk-full problems on an NFS file system.
! 3463:
! 3464: - Restored the old daemon-server behavior of logging error messages rather
! 3465: than returning them to the user. (A better long-term fix will be sought in
! 3466: the future.)
! 3467:
! 3468: - An obscure uninitialized-variable bug was fixed in the uid/gid code. (This
! 3469: bug probably had no ill effects.)
! 3470:
! 3471: ### BUILD CHANGES:
! 3472:
! 3473: - Got rid of the configure check for sys/sysctl.h (it wasn't used and was
! 3474: causing a problem on some systems). Also improved the
! 3475: broken-largefile-locking test to try to avoid failure due to an NFS
! 3476: build-dir.
! 3477:
! 3478: - Fixed a compile problem on systems that don't define `AI_NUMERICHOST`.
! 3479:
! 3480: - Fixed a compile problem in the popt source for compilers that don't support
! 3481: `__attribute__`.
! 3482:
! 3483: ### DEVELOPER RELATED:
! 3484:
! 3485: - Improved the testsuite's `merge` test to work on OSF1.
! 3486:
! 3487: - Two new diffs were added to the patches dir.
! 3488:
! 3489: ------------------------------------------------------------------------------
! 3490: <a name="2.6.1"></a>
! 3491:
! 3492: # NEWS for rsync 2.6.1 (26 Apr 2004)
! 3493:
! 3494: ## Changes in this version:
! 3495:
! 3496: ### PROTOCOL NUMBER:
! 3497:
! 3498: - The protocol number was changed to 28.
! 3499:
! 3500: ### SECURITY FIXES:
! 3501:
! 3502: - Paths sent to an rsync daemon are more thoroughly sanitized when chroot is
! 3503: not used. If you're running a non-read-only rsync daemon with chroot
! 3504: disabled, **please upgrade**, ESPECIALLY if the user privs you run rsync
! 3505: under is anything above `nobody`.
! 3506:
! 3507: ### ENHANCEMENTS:
! 3508:
! 3509: - Lower memory use, more optimal transfer of data over the socket, and lower
! 3510: CPU usage (see the INTERNAL section for details).
! 3511:
! 3512: - The `RSYNC_PROXY` environment variable can now contain a `USER:PASS@` prefix
! 3513: before the `HOST:PORT` information. (Bardur Arantsson)
! 3514:
! 3515: - The `--progress` output now mentions how far along in the transfer we are,
! 3516: including both a count of files transferred and a percentage of the total
! 3517: file-count that we've processed. It also shows better
! 3518: current-rate-of-transfer and remaining-transfer-time values.
! 3519:
! 3520: - Documentation changes now attempt to describe some often misunderstood
! 3521: features more clearly.
! 3522:
! 3523: ### BUG FIXES:
! 3524:
! 3525: - When `-x` (`--one-file-system`) is combined with `-L` (`--copy-links`) or
! 3526: `--copy-unsafe-links,` no symlinked files are skipped, even if the referent
! 3527: file is on a different filesystem.
! 3528:
! 3529: - The `--link-dest` code now works properly for a non-root user when (1) the
! 3530: UIDs of the source and destination differ and `-o` was specified, or (2)
! 3531: when the group of the source can't be used on the destination and `-g` was
! 3532: specified.
! 3533:
! 3534: - Fixed a bug in the handling of `-H` (hard-links) that might cause the
! 3535: expanded PATH/NAME value of the current item to get overwritten (due to an
! 3536: expanded-name caching bug).
! 3537:
! 3538: - We now reset the `new data has been sent` flag at the start of each file we
! 3539: send. This makes sure that an interrupted transfer with the `--partial`
! 3540: option set doesn't keep a shorter temp file than the current basis file when
! 3541: no new data has been transferred over the wire for that file.
! 3542:
! 3543: - Fixed a byte-order problem in `--batch-mode` on big-endian machines. (Jay
! 3544: Fenlason)
! 3545:
! 3546: - When using `--cvs-exclude`, the exclude items we get from a per-directory's
! 3547: .cvsignore file once again only affect that one directory (not all following
! 3548: directories too). The items are also now properly word-split and parsed
! 3549: without any +/- prefix parsing.
! 3550:
! 3551: - When specifying the USER@HOST: prefix for a file, the USER part can now
! 3552: contain an '@', if needed (i.e. the last '@' is used to find the HOST, not
! 3553: the first).
! 3554:
! 3555: - Fixed some bugs in the handling of group IDs for non-root users: (1) It
! 3556: properly handles a group that the sender didn't have a name for (it would
! 3557: previously skip changing the group on any files in that group). (2) If
! 3558: `--numeric-ids` is used, rsync no longer attempts to set groups that the
! 3559: user doesn't have the permission to set.
! 3560:
! 3561: - Fixed the `refuse options` setting in the rsyncd.conf file.
! 3562:
! 3563: - Improved the `-x` (`--one-file-system`) flag's handling of any mount-point
! 3564: directories we encounter. It is both more optimal (in that it no longer does
! 3565: a useless scan of the contents of the mount-point dirs) and also fixes a
! 3566: bug where a remapped mount of the original filesystem could get discovered
! 3567: in a subdir we should be ignoring.
! 3568:
! 3569: - Rsync no longer discards a double-slash at the start of a filename when
! 3570: trying to open the file. It also no longer constructs names that start with
! 3571: a double slash (unless the user supplied them).
! 3572:
! 3573: - Path-specifying options to a daemon should now work the same with or without
! 3574: chroot turned on. Previously, such a option (such as `--link-dest`) would
! 3575: get its absolute path munged into a relative one if chroot was not on,
! 3576: making that setting fairly useless. Rsync now transforms the path into one
! 3577: that is based on the module's base dir when chroot is not enabled.
! 3578:
! 3579: - Fixed a compatibility problem interacting with older rsync versions that
! 3580: might send us an empty `--suffix` value without telling us that
! 3581: `--backup-dir` was specified.
! 3582:
! 3583: - The `hosts allow` option for a daemon-over-remote-shell process now has
! 3584: improved support for IPv6 addresses and a fix for systems that have a length
! 3585: field in their socket structs.
! 3586:
! 3587: - Fixed the ability to request an empty backup `--suffix` when sending files
! 3588: to an rsync daemon.
! 3589:
! 3590: - Fixed an option-parsing bug when `--files-from` was sent to a server sender.
! 3591:
! 3592: ### INTERNAL:
! 3593:
! 3594: - Most of the I/O is now buffered, which results in a pretty large speedup
! 3595: when running under MS Windows. (Craig Barratt)
! 3596:
! 3597: - Optimizations to the name-handling/comparing code have made some significant
! 3598: reductions in user-CPU time for large file sets.
! 3599:
! 3600: - Some cleanup of the variable types make the code more consistent.
! 3601:
! 3602: - Reduced memory requirements of hard link preservation. (J.W. Schultz)
! 3603:
! 3604: - Implemented a new algorithm for hard-link handling that speeds up the code
! 3605: significantly. (J.W. Schultz and Wayne Davison)
! 3606:
! 3607: - The `--hard-link` option now uses the first existing file in the group of
! 3608: linked files as the basis for the transfer. This prevents the sub-optimal
! 3609: transfer of a file's data when a new hardlink is added on the sending side
! 3610: and it sorts alphabetically earlier in the list than the files that are
! 3611: already present on the receiving side.
! 3612:
! 3613: - Dropped support for protocol versions less than 20 (2.3.0 released 15 Mar
! 3614: 1999) and activated warnings for protocols less than 25 (2.5.0 released 23
! 3615: Aug 2001). (Wayne Davison and J.W. Schultz, severally)
! 3616:
! 3617: - More optimal data transmission for `--hard-links` (protocol 28).
! 3618:
! 3619: - More optimal data transmission for `--checksum` (protocol 28).
! 3620:
! 3621: - Less memory is used when `--checksum` is specified.
! 3622:
! 3623: - Less memory is used in the file list (a per-file savings).
! 3624:
! 3625: - The generator is now better about not modifying the file list during the
! 3626: transfer in order to avoid a copy-on-write memory bifurcation (on systems
! 3627: where fork() uses shared memory). Previously, rsync's shared memory would
! 3628: slowly become unshared, resulting in real memory usage nearly doubling on
! 3629: the receiving side by the end of the transfer. Now, as long as permissions
! 3630: are being preserved, the shared memory should remain that way for the entire
! 3631: transfer.
! 3632:
! 3633: - Changed hardlink info and `file_struct` + strings to use allocation pools.
! 3634: This reduces memory use for large file-sets and permits freeing memory to
! 3635: the OS. (J.W. Schultz)
! 3636:
! 3637: - The 2 pipes used between the receiver and generator processes (which are
! 3638: forked on the same machine) were reduced to 1 pipe and the protocol improved
! 3639: so that (1) it is now impossible to have the `redo` pipe fill up and hang
! 3640: rsync, and (2) trailing messages from the receiver don't get lost on their
! 3641: way through the generator over to the sender (which mainly affected
! 3642: hard-link messages and verbose `--stats` output).
! 3643:
! 3644: - Improved the internal uid/gid code to be more portable and a little more
! 3645: optimized.
! 3646:
! 3647: - The device numbers sent when using `--devices` are now sent as separate
! 3648: major/minor values with 32-bit accuracy (protocol 28). Previously, the
! 3649: copied devices were sent as a single 32-bit number. This will make
! 3650: inter-operation of 64-bit binaries more compatible with their 32-bit
! 3651: brethren (with both ends of the connection are using protocol 28). Note that
! 3652: optimizations in the binary protocol for sending the device numbers often
! 3653: results in fewer bytes being used than before, even though more precision is
! 3654: now available.
! 3655:
! 3656: - Some cleanup of the exclude/include structures and its code made things
! 3657: clearer (internally), simpler, and more efficient.
! 3658:
! 3659: - The reading & writing of the file-list in batch-mode is now handled by the
! 3660: same code that sends & receives the list over the wire. This makes it much
! 3661: easier to maintain. (Note that the batch code is still considered to be
! 3662: experimental.)
! 3663:
! 3664: ### BUILD CHANGES:
! 3665:
! 3666: - The configure script now accepts `--with-rsyncd-conf=PATH` to override the
! 3667: default value of the /etc/rsyncd.conf file.
! 3668:
! 3669: - Fixed configure bug when running `./configure --disable-ipv6`.
! 3670:
! 3671: - Fixed compilation problem on Tru64 Unix (having to do with `sockaddr.sa_len`
! 3672: and `sockaddr.sin_len`).
! 3673:
! 3674: ### DEVELOPER RELATED:
! 3675:
! 3676: - Fixed `make test` bug when build dir is not the source dir.
! 3677:
! 3678: - Added a couple extra diffs in the `patches` dir, removed the ones that got
! 3679: applied, and rebuilt the rest.
! 3680:
! 3681: ------------------------------------------------------------------------------
! 3682: <a name="2.6.0"></a>
! 3683:
! 3684: # NEWS for rsync 2.6.0 (1 Jan 2004)
! 3685:
! 3686: ## Changes in this version:
! 3687:
! 3688: ### PROTOCOL NUMBER:
! 3689:
! 3690: - The protocol number was changed to 27. The maximum accepted protocol number
! 3691: was increased from 30 to 40.
! 3692:
! 3693: ### ENHANCEMENTS:
! 3694:
! 3695: - `ssh` is now the default remote shell for rsync. If you want to change this,
! 3696: configure like this: `./configure --with-rsh=rsh`.
! 3697:
! 3698: - Added `--files-from`, `--no-relative`, `--no-implied-dirs`, and `--from0`.
! 3699: Note that `--from0` affects the line-ending character for all the files read
! 3700: by the `--*-from` options. (Wayne Davison)
! 3701:
! 3702: - Length of csum2 is now per-file starting with protocol version
! 3703: 27. (J.W. Schultz)
! 3704:
! 3705: - Per-file dynamic block size is now sqrt(file length). The per-file checksum
! 3706: size is determined according to an algorithm provided by Donovan Baarda
! 3707: which reduces the probability of rsync algorithm corrupting data and falling
! 3708: back using the whole md4 checksums. (J.W. Schultz, Donovan Baarda)
! 3709:
! 3710: - The `--stats` option no longer includes the (debug) malloc summary unless
! 3711: the verbose option was specified at least twice.
! 3712:
! 3713: - Added a new error/warning code for when files vanish from the sending side.
! 3714: Made vanished source files not interfere with the file-deletion pass when
! 3715: `--delete-after` was specified.
! 3716:
! 3717: - Various trailing-info sections are now preceded by a newline.
! 3718:
! 3719: ### BUG FIXES:
! 3720:
! 3721: - Fixed several exclude/include matching bugs when using wild-cards. This has
! 3722: a several user-visible effects, all of which make the matching more
! 3723: consistent and intuitive. This should hopefully not cause anyone problems
! 3724: since it makes the matching work more like what people are expecting. (Wayne
! 3725: Davison)
! 3726:
! 3727: - A pattern with a `**` no longer causes a `*` to match slashes. For example,
! 3728: with `/*/foo/**`, `foo` must be 2 levels deep. [If your string has BOTH `*`
! 3729: and `**` wildcards, changing the `*` wildcards to `**` will provide the old
! 3730: behavior in all versions.]
! 3731:
! 3732: - `**/foo` now matches at the base of the transfer (like /foo does). [Use
! 3733: `/**/foo` to get the old behavior in all versions.]
! 3734:
! 3735: - A non-anchored wildcard term floats to match beyond the base of the
! 3736: transfer. E.g. `CVS/R*` matches at the end of the path, just like the
! 3737: non-wildcard term `CVS/Root` does. [Use `/CVS/R*` to get the old behavior in
! 3738: all versions.]
! 3739:
! 3740: - Including a `**` in the match term causes it to be matched against the
! 3741: entire path, not just the name portion, even if there aren't any interior
! 3742: slashes in the term. E.g. `foo**bar` would exclude `/path/foo-bar` (just
! 3743: like before) as well as `/foo-path/baz-bar` (unlike before). [Use `foo*bar`
! 3744: to get the old behavior in all versions.]
! 3745:
! 3746: - The exclude list specified in the daemon's config file is now properly
! 3747: applied to the pulled items no matter how deep the user's file-args are in
! 3748: the source tree. (Wayne Davison)
! 3749:
! 3750: - For protocol version >= 27, `mdfour_tail()` is called when the block size
! 3751: (including `checksum_seed`) is a multiple of 64. Previously it was not
! 3752: called, giving the wrong MD4 checksum. (Craig Barratt)
! 3753:
! 3754: - For protocol version >= 27, a 64 bit bit counter is used in mdfour.c as
! 3755: required by the RFC. Previously only a 32 bit bit counter was used, causing
! 3756: incorrect MD4 file checksums for file sizes >= 512MB - 4. (Craig Barratt)
! 3757:
! 3758: - Fixed a crash bug when interacting with older rsync versions and multiple
! 3759: files of the same name are destined for the same dir. (Wayne Davison)
! 3760:
! 3761: - Keep tmp names from overflowing MAXPATHLEN.
! 3762:
! 3763: - Make `--link-dest` honor the absence of `-p`, `-o`, and `-g`.
! 3764:
! 3765: - Made rsync treat a trailing slash in the destination in a more consistent
! 3766: manner.
! 3767:
! 3768: - Fixed file I/O error detection. (John Van Essen)
! 3769:
! 3770: - Fixed bogus `malformed address {hostname}` message in rsyncd log when
! 3771: checking IP address against hostnames from `hosts allow` and `hosts deny`
! 3772: parameters in config file.
! 3773:
! 3774: - Print heap statistics when verbose >= 2 instead of when >= 1.
! 3775:
! 3776: - Fixed a compression (`-z`) bug when syncing a mostly-matching file that
! 3777: contains already-compressed data. (Yasuoka Masahiko and Wayne Davison)
! 3778:
! 3779: - Fixed a bug in the `--backup` code that could cause deleted files to not get
! 3780: backed up.
! 3781:
! 3782: - When the backup code makes new directories, create them with mode 0700
! 3783: instead of 0755 (since the directory permissions in the backup tree are not
! 3784: yet copied from the main tree).
! 3785:
! 3786: - Call setgroups() in a more portable manner.
! 3787:
! 3788: - Improved file-related error messages to better indicate exactly what
! 3789: pathname failed. (Wayne Davison)
! 3790:
! 3791: - Fixed some bugs in the handling of `--delete` and `--exclude` when using the
! 3792: `--relative` (`-R`) option. (Wayne Davison)
! 3793:
! 3794: - Fixed bug that prevented regular files from replacing special files and
! 3795: caused a directory in `--link-dest` or `--compare-dest` to block the
! 3796: creation of a file with the same path. A directory still cannot be replaced
! 3797: by a regular file unless `--delete` specified. (J.W. Schultz)
! 3798:
! 3799: - Detect and report when open or opendir succeed but read and readdir fail
! 3800: caused by network filesystem issues and truncated files. (David Norwood,
! 3801: Michael Brown, J.W. Schultz)
! 3802:
! 3803: - Added a fix that should give ssh time to restore the tty settings if the
! 3804: user presses Ctrl-C at an ssh password prompt.
! 3805:
! 3806: ### INTERNAL:
! 3807:
! 3808: - Eliminated vestigial support for old versions that we stopped supporting.
! 3809: (J.W. Schultz)
! 3810:
! 3811: - Simplified some of the option-parsing code. (Wayne Davison)
! 3812:
! 3813: - Some cleanup made to the exclude code, as well as some new defines added to
! 3814: enhance readability. (Wayne Davison)
! 3815:
! 3816: - Changed the protocol-version code so that it can interact at a lower
! 3817: protocol level than the maximum supported by both sides. Added an
! 3818: undocumented option, `--protocol=N`, to force the value we advertise to the
! 3819: other side (primarily for testing purposes). (Wayne Davison)
! 3820:
! 3821: ------------------------------------------------------------------------------
! 3822: <a name="2.5.7"></a>
! 3823:
! 3824: # NEWS for rsync 2.5.7 (4 Dec 2003)
! 3825:
! 3826: ## Changes in this version:
! 3827:
! 3828: ### SECURITY FIXES:
! 3829:
! 3830: - Fix buffer handling bugs. (Andrew Tridgell, Martin Pool, Paul Russell,
! 3831: Andrea Barisani)
! 3832:
! 3833: ------------------------------------------------------------------------------
! 3834: <a name="2.5.6"></a>
! 3835:
! 3836: # NEWS for rsync 2.5.6, aka "the dwd-between-jobs release" (26 Jan 2003)
! 3837:
! 3838: ## Changes in this version:
! 3839:
! 3840: ### ENHANCEMENTS:
! 3841:
! 3842: - The `--delete-after` option now implies `--delete`. (Wayne Davison)
! 3843:
! 3844: - The `--suffix` option can now be used with `--backup-dir`. (Michael
! 3845: Zimmerman)
! 3846:
! 3847: - Combining `::` syntax with the `--rsh`/`-e` option now uses the specified
! 3848: remote-shell as a transport to talk to a (newly-spawned) server-daemon. This
! 3849: allows someone to use daemon features, such as modules, over a secure
! 3850: protocol, such as ssh. (JD Paul)
! 3851:
! 3852: - The rsync:// syntax for daemon connections is now accepted in the
! 3853: destination field.
! 3854:
! 3855: - If the file name given to `--include-from` or `--exclude-from` is `-`, rsync
! 3856: will read from standard input. (J.W. Schultz)
! 3857:
! 3858: - New option `--link-dest` which is like `--compare-dest` except that
! 3859: unchanged files are hard-linked in to the destination directory. (J.W.
! 3860: Schultz)
! 3861:
! 3862: - Don't report an error if an excluded file disappears during an rsync run.
! 3863: (Eugene Chupriyanov and Bo Kersey)
! 3864:
! 3865: - Added .svn to `--cvs-exclude` list to support subversion. (Jon Middleton)
! 3866:
! 3867: - Properly support IPv6 addresses in the rsyncd.conf `hosts allow` and `hosts
! 3868: deny` fields. (Hideaki Yoshifuji)
! 3869:
! 3870: - Changed exclude file handling to permit DOS or MAC style line terminations.
! 3871: (J.W. Schultz)
! 3872:
! 3873: - Ignore errors from chmod when `-p`/`-a`/`--preserve-perms` is not set.
! 3874: (Dave Dykstra)
! 3875:
! 3876: ### BUG FIXES:
! 3877:
! 3878: - Fix `forward name lookup failed` errors on AIX 4.3.3. (John L. Allen, Martin
! 3879: Pool)
! 3880:
! 3881: - Generate each file's rolling-checksum data as we send it, not in a separate
! 3882: (memory-eating) pass before hand. This prevents timeout errors on really
! 3883: large files. (Stefan Nehlsen)
! 3884:
! 3885: - Fix compilation on Tru64. (Albert Chin, Zoong Pham)
! 3886:
! 3887: - Better handling of some client-server errors. (Martin Pool)
! 3888:
! 3889: - Fixed a crash that would occur when sending a list of files that contains a
! 3890: duplicate name (if it sorts to the end of the file list) and using
! 3891: `--delete`. (Wayne Davison)
! 3892:
! 3893: - Fixed the file-name duplicate-removal code when dealing with multiple dups
! 3894: in a row. (Wayne Davison)
! 3895:
! 3896: - Fixed a bug that caused rsync to lose the exit status of its child processes
! 3897: and sometimes return an exit code of 0 instead of showing an error. (David
! 3898: R. Staples, Dave Dykstra)
! 3899:
! 3900: - Fixed bug in `--copy-unsafe-links` that caused it to be completely broken.
! 3901: (Dave Dykstra)
! 3902:
! 3903: - Prevent infinite recursion in cleanup code under certain circumstances.
! 3904: (Sviatoslav Sviridov and Marc Espie)
! 3905:
! 3906: - Fixed a bug that prevented rsync from creating intervening directories when
! 3907: `--relative-paths`/`-R` is set. (Craig Barratt)
! 3908:
! 3909: - Prevent `Connection reset by peer` messages from Cygwin. (Randy O'Meara)
! 3910:
! 3911: ### INTERNAL:
! 3912:
! 3913: - Many code cleanups and improved internal documentation. (Martin Pool, Nelson
! 3914: Beebe)
! 3915:
! 3916: - Portability fixes. (Dave Dykstra and Wayne Davison)
! 3917:
! 3918: - More test cases. (Martin Pool)
! 3919:
! 3920: - Some test-case fixes. (Brian Poole, Wayne Davison)
! 3921:
! 3922: - Updated included popt to the latest vendor drop, version 1.6.4. (Jos
! 3923: Backus)
! 3924:
! 3925: - Updated config.guess and config.sub to latest versions; this means rsync
! 3926: should build on more platforms. (Paul Green)
! 3927:
! 3928: ------------------------------------------------------------------------------
! 3929: <a name="2.5.5"></a>
! 3930:
! 3931: # NEWS for rsync 2.5.5, aka Snowy River (2 Apr 2002)
! 3932:
! 3933: ## Changes in this version:
! 3934:
! 3935: ### ENHANCEMENTS:
! 3936:
! 3937: - With `--progress`, when a transfer is complete show the time taken;
! 3938: otherwise show expected time to complete. (Cameron Simpson)
! 3939:
! 3940: - Make `make install-strip` works properly, and `make install` accepts a
! 3941: DESTDIR variable for help in building binary packages. (Peter
! 3942: Breitenlohner, Greg Louis)
! 3943:
! 3944: - If configured with `--enable-maintainer-mode`, then on receipt of a fatal
! 3945: signal rsync will try to open an xterm running gdb, similarly to Samba's
! 3946: `panic action` or GNOME's bug-buddy. (Martin Pool)
! 3947:
! 3948: ### BUG FIXES:
! 3949:
! 3950: - Fix situation where failure to fork (e.g. because out of process slots)
! 3951: would cause rsync to kill all processes owned by the current user. Yes,
! 3952: really! (Paul Haas, Martin Pool)
! 3953:
! 3954: - Fix test suite on Solaris. (Jos Backus, Martin Pool)
! 3955:
! 3956: - Fix minor memory leak in socket code. (Dave Dykstra, Martin Pool.)
! 3957:
! 3958: - Fix `--whole-file` problem that caused it to be the default even for remote
! 3959: connections. (Martin Pool, Frank Schulz)
! 3960:
! 3961: - Work around bug in Mac OS X mkdir(2), which cannot handle trailing slashes.
! 3962: <http://www.opensource.apple.com/bugs/X/BSD%20Kernel/2734739.html> (Martin
! 3963: Pool)
! 3964:
! 3965: - Improved network error handling. (Greg A. Woods)
! 3966:
! 3967: ------------------------------------------------------------------------------
! 3968: <a name="2.5.4"></a>
! 3969:
! 3970: # NEWS for rsync 2.5.4, aka "Imitation lizard skin" (13 Mar 2002)
! 3971:
! 3972: ## Changes in this version:
! 3973:
! 3974: ### BUG FIXES:
! 3975:
! 3976: - Additional fix for zlib double-free bug. (Martin Pool, Andrew Tridgell) (CVE
! 3977: CAN-2002-0059)
! 3978:
! 3979: ### ENHANCEMENTS:
! 3980:
! 3981: - Merge in changes from zlib 1.1.3 to zlib 1.1.4. (Jos Backus) (Note that
! 3982: rsync still uses a custom version of zlib; you can not just link against a
! 3983: system library. See zlib/README.rsync)
! 3984:
! 3985: - Additional test cases for `--compress`. (Martin Pool)
! 3986:
! 3987: ------------------------------------------------------------------------------
! 3988: <a name="2.5.3"></a>
! 3989:
! 3990: # NEWS for rsync 2.5.3, aka "Happy 26" (11 Mar 2002)
! 3991:
! 3992: ## Changes in this version:
! 3993:
! 3994: ### SECURITY FIXES:
! 3995:
! 3996: - Make sure that supplementary groups are removed from a server
! 3997: process after changing uid and gid. (Ethan Benson) (Debian bug
! 3998: #132272, CVE CAN-2002-0080)
! 3999:
! 4000: ### BUG FIXES:
! 4001:
! 4002: - Fix zlib double-free bug. (Owen Taylor, Mark J Cox) (CVE CAN-2002-0059)
! 4003:
! 4004: - Fixed problem that in many cases caused the error message unexpected read
! 4005: size of 0 in `map_ptr` and resulted in the wrong data being copied.
! 4006:
! 4007: - Fixed compilation errors on some systems caused by the use of `unsigned
! 4008: int64` in rsync.h.
! 4009:
! 4010: - Fixed problem on systems such as Sunos4 that do not support realloc on a
! 4011: NULL pointer; error was 'out of memory in "flist_expand"'.
! 4012:
! 4013: - Fix for rsync server processes hanging around after the client unexpectedly
! 4014: disconnects. (Colin Walters) (Debian bug #128632)
! 4015:
! 4016: - Cope with BSD systems on which mkdir() will not accept a trailing slash.
! 4017:
! 4018: ### ENHANCEMENTS:
! 4019:
! 4020: - Merge in changes from zlib 1.1.2 to zlib 1.1.3. (Note that rsync still uses
! 4021: a custom version of zlib; you can not just link against a system library.
! 4022: See zlib/README.rsync)
! 4023:
! 4024: - Command to initiate connections is only shown with `-vv`, rather than `-v`
! 4025: as in 2.5.2. Output from plain `-v` is more similar to what was historically
! 4026: used so as not to break scripts that try to parse the output.
! 4027:
! 4028: - Added `--no-whole-file` and `--no-blocking-io` options (Dave Dykstra)
! 4029:
! 4030: - Made the `--write-batch` and `--read-batch` options actually work and added
! 4031: documentation in the man page (Jos Backus)
! 4032:
! 4033: - If the daemon is unable to fork a child to accept a connection, print an
! 4034: error message. (Colin Walters)
! 4035:
! 4036: ------------------------------------------------------------------------------
! 4037: <a name="2.5.2"></a>
! 4038:
! 4039: # NEWS for rsync 2.5.2 (26 Jan 2002)
! 4040:
! 4041: ## Changes in this version:
! 4042:
! 4043: ### SECURITY FIXES:
! 4044:
! 4045: - Signedness security patch from Sebastian Krahmer <krahmer@suse.de> -- in
! 4046: some cases we were not sufficiently careful about reading integers from the
! 4047: network.
! 4048:
! 4049: ### PROTOCOL NUMBER:
! 4050:
! 4051: - The protocol number was changed to 26.
! 4052:
! 4053: ### BUG FIXES:
! 4054:
! 4055: - Fix possible string mangling in log files.
! 4056:
! 4057: - Fix for setting local address of outgoing sockets.
! 4058:
! 4059: - Better handling of hardlinks and devices on platforms with 64-bit `dev_t` or
! 4060: `ino_t`.
! 4061:
! 4062: - Name resolution on machines supporting IPv6 is improved.
! 4063:
! 4064: - Fix for device nodes. (dann frazier) (Debian #129135)
! 4065:
! 4066: ### ENHANCEMENTS:
! 4067:
! 4068: - With `-v`, rsync now shows the command used to initiate an ssh/rsh
! 4069: connection.
! 4070:
! 4071: - `--statistics` now shows memory heap usage on platforms that support
! 4072: mallinfo().
! 4073:
! 4074: - "The Ted T'so school of program optimization": make progress visible and
! 4075: people will think it's faster. (With `--progress`, rsync will show you how
! 4076: many files it has seen as it builds the `file_list`, giving some indication
! 4077: that it has not hung.)
! 4078:
! 4079: - Improvements to batch mode support. This is still experimental but testing
! 4080: would be welcome. (Jos Backus)
! 4081:
! 4082: - New `--ignore-existing` option, patch previously distributed with Vipul's
! 4083: Razor. (Debian #124286)
! 4084:
! 4085: ------------------------------------------------------------------------------
! 4086: <a name="2.5.1"></a>
! 4087:
! 4088: # NEWS for rsync 2.5.1 (3 Jan 2002)
! 4089:
! 4090: ## Changes in this version:
! 4091:
! 4092: ### BUG FIXES:
! 4093:
! 4094: - Fix for segfault in `--daemon` mode configuration parser. (Paul Mackerras)
! 4095:
! 4096: - Correct `string<->address` parsing for both IPv4 and 6. (YOSHIFUJI Hideaki,
! 4097: SUMIKAWA Munechika and Jun-ichiro `itojun` Hagino)
! 4098:
! 4099: - Various fixes for IPv6 support. (Dave Dykstra)
! 4100:
! 4101: - rsync.1 typo fix. (Matt Kraai)
! 4102:
! 4103: - Test suite typo fixes. (Tom Schmidt)
! 4104:
! 4105: - rsync.1 grammar and clarity improvements. (Edward Welbourne)
! 4106:
! 4107: - Correction to ./configure tests for `inet_ntop`. (Jeff Garzik)
! 4108:
! 4109: ### ENHANCEMENTS:
! 4110:
! 4111: - `--progress` and `-P` now show estimated data transfer rate (in a multiple
! 4112: of bytes/s) and estimated time to completion. (Rik Faith)
! 4113:
! 4114: - `--no-detach` option, required to run as a W32 service and also useful when
! 4115: running on Unix under daemontools, AIX's SRC, or a debugger. (Max Bowsher,
! 4116: Jos Backus)
! 4117:
! 4118: - Clearer error messages for some conditions.
! 4119:
! 4120: ------------------------------------------------------------------------------
! 4121: <a name="2.5.0"></a>
! 4122:
! 4123: # NEWS for rsync 2.5.0 (30 Nov 2001)
! 4124:
! 4125: ## Changes in this version:
! 4126:
! 4127: ### PROTOCOL NUMBER:
! 4128:
! 4129: - The protocol number was changed to 25.
! 4130:
! 4131: ### ANNOUNCEMENTS:
! 4132:
! 4133: - Martin Pool <mbp@samba.org> is now a co-maintainer.
! 4134:
! 4135: ### NEW FEATURES:
! 4136:
! 4137: - Support for LSB-compliant packaging <http://www.linuxbase.org/>
! 4138:
! 4139: - Shell wildcards are allowed in `auth users` lines.
! 4140:
! 4141: - Merged UNC rsync+ patch to support creation of standalone patch sets. By
! 4142: Bert J. Dempsey and Debra Weiss, updated by Jos Backus.
! 4143: <http://www.ils.unc.edu/i2dsi/unc_rsync+.html>
! 4144:
! 4145: - IPv6 support based on a patch from KAME.net, on systems including modern
! 4146: versions of Linux, Solaris, and HP-UX. Also includes IPv6 compatibility
! 4147: functions for old OSs by the Internet Software Consortium, Paul Vixie, the
! 4148: OpenSSH portability project, and OpenBSD.
! 4149:
! 4150: ### ENHANCEMENTS:
! 4151:
! 4152: - Include/exclude cluestick: with `-vv`, print out whether files are included
! 4153: or excluded and why.
! 4154:
! 4155: - Many error messages have more friendly explanations and more details.
! 4156:
! 4157: - Manual page improvements plus scanty protocol documentation.
! 4158:
! 4159: - When running as `--daemon` in the background and using a `log file`
! 4160: rsyncd.conf directive, close the log file every time it is open when going
! 4161: to sleep on the socket. This allows the log file to get cleaned out by
! 4162: another process.
! 4163:
! 4164: - Change to using libpopt rather than getopt for processing options. This
! 4165: makes the code cleaner and the behaviour more consistent across platforms.
! 4166: popt is included and built if not installed on the platform.
! 4167:
! 4168: - More details in `--version`, including note about whether 64-bit files,
! 4169: symlinks and hardlinks are supported.
! 4170:
! 4171: - MD4 code may use less CPU cycles.
! 4172:
! 4173: - Use mkstemp on systems where it is secure. If we use mktemp, explain that we
! 4174: do it in a secure way.
! 4175:
! 4176: - `--whole-file` is the default when source and target are on the local
! 4177: machine.
! 4178:
! 4179: ### BUG FIXES:
! 4180:
! 4181: - Fix for various bugs causing rsync to hang.
! 4182:
! 4183: - Attempt to fix Large File Summit support on AIX.
! 4184:
! 4185: - Attempt to fix error handling lockup bug.
! 4186:
! 4187: - Give a non-0 exit code if **any** of the files we have been asked to
! 4188: transfer fail to transfer.
! 4189:
! 4190: - For log messages containing ridiculously long strings that might overflow a
! 4191: buffer rsync no longer aborts, but rather prints an ellipsis at the end of
! 4192: the string. (Patch from Ed Santiago.)
! 4193:
! 4194: ### PLATFORMS:
! 4195:
! 4196: - Improved support for UNICOS (tested on Cray T3E and Cray SV1)
! 4197:
! 4198: - autoconf2.52 (or later) is now required to rebuild the autoconf scripts. It
! 4199: is not required to simply build rsync.
! 4200:
! 4201: - Platforms thought to work in this release:
! 4202:
! 4203: - Cray SV1 UNICOS 10.0.0.8 cc
! 4204: - Debian Linux 2.2 UltraSparc gcc
! 4205: - Debian Linux testing/unstable ARM gcc
! 4206: - FreeBSD 3.3-RELEASE i386 cc
! 4207: - FreeBSD 4.1.1-RELEASE i386 cc
! 4208: - FreeBSD 4.3-STABLE i386 cc
! 4209: - HP PA-RISC HP-UX 10.20 gcc
! 4210: - HP PA-RISC HP-UX 11.11 cc
! 4211: - IRIX 6.5 MIPS cc
! 4212: - IRIX 6.5 MIPS gcc
! 4213: - Mac OS X PPC (--disable-ipv6) cc
! 4214: - NetBSD 1.5 i386 gcc
! 4215: - NetBSD Current i386 cc
! 4216: - OpenBSD 2.5 Sparc gcc
! 4217: - OpenBSD 2.9 i386 cc
! 4218: - OpenBSD Current i386 cc
! 4219: - RedHat 6.2 i386 gcc
! 4220: - RedHat 6.2 i386 insure++
! 4221: - RedHat 7.0 i386 gcc
! 4222: - RedHat 7.1 i386 (Kernel 2.4.10) gcc
! 4223: - Slackware 8.0 i686 (Kernel 2.4.10)
! 4224: - Solaris 8 UltraSparc cc
! 4225: - Solaris 8 UltraSparc gcc
! 4226: - Solaris 8 i386 gcc
! 4227: - SuSE 7.1 i386 gcc2.95.2
! 4228: - SuSE 7.1 ppc gcc2.95.2
! 4229: - i386-pc-sco3.2v5.0.5 cc
! 4230: - i386-pc-sco3.2v5.0.5 gcc
! 4231: - powerpc-ibm-aix4.3.3.0 cc
! 4232: - i686-unknown-sysv5UnixWare7.1.0 gcc
! 4233: - i686-unknown-sysv5UnixWare7.1.0 cc
! 4234:
! 4235: ### TESTING:
! 4236:
! 4237: - The existing test.sh script by Phil Hands has been merged into a
! 4238: test framework that works from both `make check` and the Samba
! 4239: build farm.
! 4240:
! 4241: ------------------------------------------------------------------------------
! 4242:
! 4243: ## Partial Protocol History
! 4244:
! 4245: | RELEASE DATE | VER. | DATE OF COMMIT\* | PROTOCOL |
! 4246: |--------------|--------|------------------|-------------|
! 4247: | 06 Aug 2020 | 3.2.3 | | 31 |
! 4248: | 04 Jul 2020 | 3.2.2 | | 31 |
! 4249: | 22 Jun 2020 | 3.2.1 | | 31 |
! 4250: | 19 Jun 2020 | 3.2.0 | | 31 |
! 4251: | 28 Jan 2018 | 3.1.3 | | 31 |
! 4252: | 21 Dec 2015 | 3.1.2 | | 31 |
! 4253: | 22 Jun 2014 | 3.1.1 | | 31 |
! 4254: | 28 Sep 2013 | 3.1.0 | 31 Aug 2008 | 31 |
! 4255: | 23 Sep 2011 | 3.0.9 | | 30 |
! 4256: | 26 Mar 2011 | 3.0.8 | | 30 |
! 4257: | 31 Dec 2009 | 3.0.7 | | 30 |
! 4258: | 08 May 2009 | 3.0.6 | | 30 |
! 4259: | 28 Dec 2008 | 3.0.5 | | 30 |
! 4260: | 06 Sep 2008 | 3.0.4 | | 30 |
! 4261: | 29 Jun 2008 | 3.0.3 | | 30 |
! 4262: | 08 Apr 2008 | 3.0.2 | | 30 |
! 4263: | 03 Apr 2008 | 3.0.1 | | 30 |
! 4264: | 01 Mar 2008 | 3.0.0 | 11 Nov 2006 | 30 |
! 4265: | 06 Nov 2006 | 2.6.9 | | 29 |
! 4266: | 22 Apr 2006 | 2.6.8 | | 29 |
! 4267: | 11 Mar 2006 | 2.6.7 | | 29 |
! 4268: | 28 Jul 2005 | 2.6.6 | | 29 |
! 4269: | 01 Jun 2005 | 2.6.5 | | 29 |
! 4270: | 30 Mar 2005 | 2.6.4 | 17 Jan 2005 | 29 |
! 4271: | 30 Sep 2004 | 2.6.3 | | 28 |
! 4272: | 30 Apr 2004 | 2.6.2 | | 28 |
! 4273: | 26 Apr 2004 | 2.6.1 | 08 Jan 2004 | 28 |
! 4274: | 01 Jan 2004 | 2.6.0 | 10 Apr 2003 | 27 (MAX=40) |
! 4275: | 04 Dec 2003 | 2.5.7 | | 26 |
! 4276: | 26 Jan 2003 | 2.5.6 | | 26 |
! 4277: | 02 Apr 2002 | 2.5.5 | | 26 |
! 4278: | 13 Mar 2002 | 2.5.4 | | 26 |
! 4279: | 11 Mar 2002 | 2.5.3 | | 26 |
! 4280: | 26 Jan 2002 | 2.5.2 | 11 Jan 2002 | 26 |
! 4281: | 03 Jan 2002 | 2.5.1 | | 25 |
! 4282: | 30 Nov 2001 | 2.5.0 | 23 Aug 2001 | 25 |
! 4283: | 06 Sep 2000 | 2.4.6 | | 24 |
! 4284: | 19 Aug 2000 | 2.4.5 | | 24 |
! 4285: | 29 Jul 2000 | 2.4.4 | | 24 |
! 4286: | 09 Apr 2000 | 2.4.3 | | 24 |
! 4287: | 30 Mar 2000 | 2.4.2 | | 24 |
! 4288: | 30 Jan 2000 | 2.4.1 | 29 Jan 2000 | 24 |
! 4289: | 29 Jan 2000 | 2.4.0 | 28 Jan 2000 | 23 |
! 4290: | 25 Jan 2000 | 2.3.3 | 23 Jan 2000 | 22 |
! 4291: | 08 Nov 1999 | 2.3.2 | 26 Jun 1999 | 21 |
! 4292: | 06 Apr 1999 | 2.3.1 | | 20 |
! 4293: | 15 Mar 1999 | 2.3.0 | 15 Mar 1999 | 20 |
! 4294: | 25 Nov 1998 | 2.2.1 | | 19 |
! 4295: | 03 Nov 1998 | 2.2.0 | | 19 |
! 4296: | 09 Sep 1998 | 2.1.1 | | 19 |
! 4297: | 20 Jul 1998 | 2.1.0 | | 19 |
! 4298: | 17 Jul 1998 | 2.0.19 | | 19 |
! 4299: | 18 Jun 1998 | 2.0.17 | | 19 |
! 4300: | 01 Jun 1998 | 2.0.16 | | 19 |
! 4301: | 27 May 1998 | 2.0.13 | 27 May 1998 | 19 |
! 4302: | 26 May 1998 | 2.0.12 | | 18 |
! 4303: | 22 May 1998 | 2.0.11 | | 18 |
! 4304: | 18 May 1998 | 2.0.9 | 18 May 1998 | 18 |
! 4305: | 17 May 1998 | 2.0.8 | | 17 |
! 4306: | 15 May 1998 | 2.0.1 | | 17 |
! 4307: | 14 May 1998 | 2.0.0 | | 17 |
! 4308: | 17 Apr 1998 | 1.7.4 | | 17 |
! 4309: | 13 Apr 1998 | 1.7.3 | | 17 |
! 4310: | 05 Apr 1998 | 1.7.2 | | 17 |
! 4311: | 26 Mar 1998 | 1.7.1 | | 17 |
! 4312: | 26 Mar 1998 | 1.7.0 | 26 Mar 1998 | 17 (MAX=30) |
! 4313: | 13 Jan 1998 | 1.6.9 | 13 Jan 1998 | 15 (MAX=20) |
! 4314:
! 4315: \* DATE OF COMMIT is the date the protocol change was committed to version
! 4316: control.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to NEWS.md CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / rsync