NEWS

   1 NEWS for rsync 2.6.4 (UNRELEASED)
   2 Protocol: 29 (changed)
   3 Changes since 2.6.3:
   4
   5   OUTPUT CHANGES:
   6
   7     - When rsync deletes a directory and outputs a verbose message about
   8       it, it now appends a trailing slash to the name instead of (only
   9       sometimes) outputting a preceding "directory " string.
  10
  11     - The --stats output will contain file-list time-statistics if both
  12       sides are 2.6.4, or if the local side is 2.6.4 and the files are
  13       being pushed (since the stats come from the sending side).
  14
  15   BUG FIXES:
  16
  17     - Restore the list-clearing behavior of "!" in a .cvsignore file (2.6.3
  18       was only treating it as a special token in an rsync include/exclude
  19       file).
  20
  21     - The --dry-run option (-n) now mentions changes in directories (w/-v).
  22       It also now includes the normal uptodate output information for -vv.
  23
  24     - Avoid a mkdir warning when removing a directory in the destination
  25       that already exists in the --backup-dir.
  26
  27     - An OS that has a binary mode for its files (such as cygwin0 needed
  28       setmode(fd, O_BINARY) called on the temp-file we opened with
  29       mkstemp().  (Fix derived from the cygwin's rsync package.)
  30
  31     - Fixed a potential hang when verbosity is high, the client side is
  32       the sender, and the file-list is large.
  33
  34     - We now check if the OS doesn't support using mknod() for creating
  35       FIFOs and sockets, and compile-in using mkfifo() and socket() when
  36       necessary.
  37
  38     - Fixed an off-by-one error in the handling of --max-delete=N.
  39
  40     - One place in the code wasn't checking if fork() failed.
  41
  42     - The "ignore nonreadable" daemon parameter no longer affects symlinks
  43       that are being copied, even if they point nowhere.
  44
  45     - If the OS does not have lchown() and its chown() tries to set the
  46       referent of a symlink (as it should), we no longer try to set the
  47       user and group of a symlink.
  48
  49     - The generator now properly runs the hard-link loop and the dir-time
  50       rewriting loop after we're sure that the redo phase is complete.
  51
  52     - When --backup was specified with --partial-dir=DIR (where DIR is a
  53       relative path), the backup code was erroneously trying to backup a
  54       file that was put into the partial-dir.
  55
  56     - One call to flush_write_file() was not being checked for an error.
  57
  58     - The --no-relative option was not being sent from the client to a
  59       server sender.
  60
  61     - If an rsync daemon specified "dont compress = ..." for a file and the
  62       client tried to specify --compress, the libz code was not handling a
  63       compression level of 0 properly.  This could cause a transfer failure
  64       if the block-size for a file was large enough (i.e. rsync might have
  65       exited with an error for large files).
  66
  67     - If a daemon can't open the specified log file (i.e. syslog is not
  68       being used), die without crashing.  We also try to output an error
  69       about the failure (which will only be seen if --no-detach was
  70       specified).
  71
  72     - A local transfer no longer duplicates all its include/exclude options
  73       by sending the forked process a copy of the list it already has.
  74
  75   ENHANCEMENTS:
  76
  77     - Rsync now supports popt's option aliases, which means that you can
  78       use /etc/popt and/or ~/.popt to create your own option aliases.
  79
  80     - Added the --delete-during (--del) option which will delete files
  81       from on the receiving side incrementally as each directory in the
  82       transfer is being processed (which makes it more efficient than the
  83       default, before-the-transfer behavior of --delete).  Note that the
  84       --del option is implemented as an internally-defined popt alias, so
  85       an rsync daemon that refuses "delete" (which, for safety's sake,
  86       really matches "delete*") will still refuse all delete options.  The
  87       default --delete behavior is also explicitly selectable via
  88       --delete-before.
  89
  90     - All the --delete-WHEN options are now more memory efficient:
  91       Previously an entire duplicate set of file-list objects was created
  92       on the receiving side for the entire destination hierarchy.  The new
  93       algorithm only creates a single directory of objects at a time.
  94
  95     - Added the --copy-dest option, which works like --link-dest except
  96       that it includes copies of identical files.
  97
  98     - Added support for specifying multiple --compare-dest, --copy-dest, or
  99       --link-dest options, but only of a single type. (Promoted from the
 100       patches dir and enhanced.)
 101
 102     - Added the --max-size option. (Promoted from the patches dir.)
 103
 104     - The daemon-mode options were separated from the normal rsync options
 105       so that they can't be mixed together.  This makes it impossible to
 106       start a daemon that had improper default option values that could
 107       cause problems (such as a hang or an abort) when a client connects.
 108
 109     - The --bwlimit option may now be used in combination with --daemon
 110       to specify both a default value for the daemon side and a value
 111       that cannot be exceeded by a user-specified --bwlimit option.
 112
 113     - Added the "port" parameter to the rsyncd.conf file. (Promoted from
 114       the patches dir.)  Also added "address".
 115
 116     - In _exit_cleanup(): when we are exiting with a partially-received
 117       file, we now flush any data in the write-cache before closing the
 118       partial file.
 119
 120     - The --inplace support was enhanced to work with --compare-dest,
 121       --link-dest, and (the new) --copy-dest options.
 122
 123     - Added the --dirs (-d) option for an easier way to copy directories
 124       without recursion.
 125
 126     - Added the --list-only option which is mainly a way for the client to
 127       put the server into listing mode without needing to resort to any
 128       option kluges (e.g. the age-old use of "-r --exclude="/*/*" for a
 129       non-recursive listing).  This option is used automatically when a
 130       modern rsync speaks to a modern daemon, but may also be specified
 131       manually if you want to force the use of the --list-only option over
 132       a remote-shell connection.
 133
 134     - Added the --omit-dir-times (-O) option which will avoid updating the
 135       modified time for directories when --times was specified.  This
 136       option will avoid an extra pass through the file-list at the end of
 137       the transfer (to tweak all the directory times), which can result in
 138       an appreciable speedup for a really large transfer. (Promoted from
 139       the patches dir.)
 140
 141     - Added the --filter (-f) option and its helper option, -F.  Filter
 142       rules are an extension to the existing include/exclude handling
 143       that also supports nested filter files as well as per-directory
 144       filter files (like .cvsignore, but with full filter-rule parsing).
 145       This new option was chosen in order to ensure that all existing
 146       include/exclude processing remained 100% compatible with older
 147       versions.
 148
 149     - Added the --delay-updates option that puts all updated files into
 150       a temporary directory (by default ".~tmp~", but settable via the
 151       --partial-dir=DIR option) until the end of the transfer.  This
 152       makes the updates a little more atomic for a large transfer.
 153
 154     - If rsync is put into the background, any output from --progress is
 155       reduced.
 156
 157     - Documented the "max verbosity" setting for rsyncd.conf.  (This
 158       setting was added a couple releases ago, but left undocumented.)
 159
 160     - The sender and the generator now double-check the file-list index
 161       they are given, and refuse to operate on a directory index (since
 162       that would indicate that something had gone very wrong).
 163
 164   SUPPORT FILES:
 165
 166     - Added support/atomic-rsync -- a perl script that will transfer some
 167       files using rsync, and then move the updated files into place all at
 168       once at the end of the transfer.  Only works when pulling, and uses
 169       --link-dest and a parallel hierarchy of files to effect its update.
 170
 171     - Added support/mnt-excl that takes the /proc/mounts file and
 172       translates it into a set of excludes that will exclude all mount
 173       points (even mapped mounts to the same disk).  The excludes are made
 174       relative to the specified source dir and properly anchored.
 175
 176     - Added support/savetransfer.c -- a C program that can make a copy of
 177       all the data that flows over the wire.  This lets you test for data
 178       corruption (by saving the data on both the sending side and the
 179       receiving side) or provides a way to help debug a protocol error.
 180
 181     - Added support/rrsync -- my version of Joe Smith's restricted rsync
 182       perl script.  This helps to ensure that only certain rsync commands
 183       can be run by an ssh invocation.
 184
 185     - Improved the option descriptions in the --help text.
 186
 187   INTERNAL:
 188
 189     - Added better checking of the checksum-header values that come over
 190       the socket.
 191
 192     - Merged the various delete-file functions into a single function so
 193       that it is easier to maintain.
 194
 195     - Improved the type of some variables (particularly blocksize vars) for
 196       consistency and proper size.
 197
 198     - Got rid of the uint64 type (which we didn't need).
 199
 200     - Use a slightly more compatible set of core #include directives.
 201
 202     - Defined int32 in a way that ensures that the build dies if we can't
 203       find a variable with at least 32 bits.
 204
 205   BUILD CHANGES:
 206
 207     - Handle an operating system that use mkdev() in place of makedev().
 208
 209     - Improved configure to better handle cross-compiling.