Return to NEWS.md CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / rsync

rsync 3.2.3

    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.