File:  [ELWIX - Embedded LightWeight unIX -] / embedaddon / rsync / NEWS
Revision 1.1.1.2 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Mon Oct 14 07:51:14 2013 UTC (10 years, 8 months ago) by misho
Branches: rsync, MAIN
CVS tags: RSYNC3_1_0, HEAD
v 3.1.0

    1: NEWS for rsync 3.1.0 (28 Sep 2013)
    2: Protocol: 31 (changed)
    3: Changes since 3.0.9:
    4: 
    5:   OUTPUT CHANGES:
    6: 
    7:     - Output numbers in 3-digit groups by default (e.g. 1,234,567).  See the
    8:       --human-readable option for a way to turn it off.  See also the daemon's
    9:       "log format" parameter and related command-line options (including
   10:       --out-format) for a modifier that can be used to request digit-grouping
   11:       or human-readable output in log escapes. (Note that log output is
   12:       unchanged by default.)
   13: 
   14:     - The --list-only option is now affected by the --human-readable setting.
   15:       It will display digit groupings by default, and unit suffixes if higher
   16:       levels of readability are requested.  Also, the column width for the size
   17:       output has increased from 11 to 14 characters when human readability is
   18:       enabled.  Use --no-h to get the old-style output and column size.
   19: 
   20:     - The output of the --progress option has changed:  the string "xfer" was
   21:       shortened to "xfr", and the string "to-check" was shortened to "to-chk",
   22:       both designed to make room for the (by default) wider display of file
   23:       size numbers without making the total line-length longer.  Also, when
   24:       incremental recursion is enabled, the string "ir-chk" will be used
   25:       instead of "to-chk" up until the incremental-recursion scan is done,
   26:       letting you know that the value to check and the total value will still
   27:       be increasing as new files are found.
   28: 
   29:     - Enhanced the --stats output: 1) to mention how many files were created
   30:       (protocol >= 28), 2) to mention how many files were deleted (a new line
   31:       for protocol 31, but only output when --delete is in effect), and 3) to
   32:       follow the file-count, created-count, and deleted-count with a subcount
   33:       list that shows the counts by type.  The wording of the transferred count
   34:       has also changed so that it is clearer that it is only a count of regular
   35:       files.
   36: 
   37:   BUG FIXES:
   38: 
   39:     - Fixed a bug in the iconv code when EINVAL or EILSEQ is returned with a
   40:       full output buffer.
   41: 
   42:     - Fixed some rare bugs in --iconv processing that might cause a multibyte
   43:       character to get translated incorrectly.
   44: 
   45:     - Fixed a bogus "vanished file" error if some files were specified with
   46:       "./" prefixes and others were not.
   47: 
   48:     - Fixed a bug in --sparse where an extra gap could get inserted after a
   49:       partial write.
   50: 
   51:     - Changed the way --progress overwrites its prior output in order to make
   52:       it nearly impossible for the progress to get overwritten by an error.
   53: 
   54:     - Improved the propagation of abnormal-exit error messages.  This should
   55:       help the client side to receive errors from the server when it is exiting
   56:       abnormally, and should also avoid dying with an "connection unexpectedly
   57:       closed" exit when the closed connection is really expected.
   58: 
   59:     - The sender now checks each file it plans to remove to ensure that it
   60:       hasn't changed from the first stat's info.  This helps to avoid losing
   61:       file data when the user is not using the option in a safe manner.
   62: 
   63:     - Fixed a data-duplication bug in the compress option that made compression
   64:       less efficient.  This improves protocol 31 onward, while behaving in a
   65:       compatible (buggy) manner with older rsync protocols.
   66: 
   67:     - When creating a temp-file, rsync is now a bit smarter about it dot-char
   68:       choices, which can fix a problem on OS X with names that start with "..".
   69: 
   70:     - Rsync now sets a cleanup flag for --inplace and --append transfers that
   71:       will flush the write buffer if the transfer aborts.  This ensures that
   72:       more received data gets written out to the disk on an aborted transfer
   73:       (which is quite helpful on a slow, flaky connection).
   74: 
   75:     - The reads that map_ptr() now does are aligned on 1K boundaries.  This
   76:       helps some filesystems and/or files that don't like unaligned reads.
   77: 
   78:     - Fix an issue in the msleep() function if time jumps backwards.
   79: 
   80:     - Fix daemon-server module-name splitting bug where an arg would get split
   81:       even if --protect-args was used.
   82: 
   83:   ENHANCEMENTS:
   84: 
   85:     - Added the --remote-option=OPT (-M OPT) command-line option that is useful
   86:       for things like sending a remote --log-file=FILE or --fake-super option.
   87: 
   88:     - Added the --info=FLAGS and --debug=FLAGS options to allow finer-grained
   89:       control over what is output.  Added an extra type of --progress output
   90:       using --info=progress2.
   91: 
   92:     - The --msgs2stderr option can help with debugging rsync by allowing the
   93:       debug messages to get output to stderr rather than travel via the socket
   94:       protocol.
   95: 
   96:     - Added the --delete-missing-args and --ignore-missing-args options to
   97:       either delete or ignore user-specified files on the receiver that are
   98:       missing on the sender (normally the absence of user-specified files
   99:       generates an error).
  100: 
  101:     - Added a "T" (terabyte) category to the --human-readable size suffixes.
  102: 
  103:     - Added the --usermap/--groupmap/--chown options for manipulating file
  104:       ownership during the copy.
  105: 
  106:     - Added the "%C" escape to the log-output handling, which will output the
  107:       MD5 checksum of any transferred file, or all files if --checksum was
  108:       specified (when protocol 30 or above is in effect).
  109: 
  110:     - Added the "reverse lookup" parameter to the rsync daemon config file to
  111:       allow reverse-DNS lookups to be disabled.
  112: 
  113:     - Added a forward-DNS lookup for the daemon's hosts allow/deny config.  Can
  114:       be disabled via "forward lookup" parameter (defaults to enabled).
  115: 
  116:     - Added a way for more than one group to be specified in the daemon's
  117:       config file, including a way to specify that you want all of the
  118:       specified user's groups without having to name them.  Also changed the
  119:       daemon to complain about an inability to set explicitly-specified uid/gid
  120:       values, even when not run by a super-user.
  121: 
  122:     - The daemon now tries to send the user the error messages from the
  123:       pre-xfer exec script when it fails.
  124: 
  125:     - Improved the use of alt-dest options into an existing hierarchy of files:
  126:       If a match is found in an alt-dir, it takes precedence over an existing
  127:       file.  (We'll need to wait for a future version before attribute-changes
  128:       on otherwise unchanged files are safe when using an existing hierarchy.)
  129: 
  130:     - Added per-user authorization options and group-authorization support to
  131:       the daemon's "auth users" parameter.
  132: 
  133:     - Added a way to reference environment variables in a daemon's config file
  134:       (using %VAR% references).
  135: 
  136:     - When replacing a non-dir with a symlink/hard-link/device/special-file,
  137:       the update should now be done in an atomic manner.
  138: 
  139:     - Avoid re-sending xattr info for hard-linked files w/the same xattrs
  140:       (protocol 31).
  141: 
  142:     - The backup code was improved to use better logic maintaining the backup
  143:       directory hierarchy.  Also, when a file is being backed up, rsync tries
  144:       to hard-link it into place so that the upcoming replacement of the
  145:       destination file will be atomic (for the normal, non-inplace logic).
  146: 
  147:     - Added the ability to synchronize nano-second modified times.
  148: 
  149:     - Added a few more default suffixes for the "dont compress" settings.
  150: 
  151:     - Added the checking of the RSYNC_PROTECT_ARGS environment variable to allow
  152:       the default for the --protect-args command-line option to be overridden.
  153: 
  154:     - Added the --preallocate command-line option.
  155: 
  156:     - Allow --password-file=- to read the password from stdin (filename "-").
  157: 
  158:     - Rsync now comes packaged with an rsync-ssl helper script that can be
  159:       used to contact a remote rsync daemon using a piped-stunnel command.
  160:       It also includes an stunnel config file to run the server side to
  161:       support ssl daemon connections.  See the packaging/lsb/rsync.spec
  162:       file for one way to package the resulting files.  (Suggestions for
  163:       how to make this even easier to install & use are welcomed.)
  164: 
  165:     - Improved the speed of some --inplace updates when there are lots of
  166:       identical checksum blocks that end up being unusable.
  167: 
  168:     - Added the --outbuf=N|L|B option for choosing the output buffering.
  169: 
  170:     - Repeating the --fuzzy option now causes the code to look for fuzzy
  171:       matches inside alt-dest directories too.
  172: 
  173:     - The --chmod option now supports numeric modes, e.g. --chmod=644,D755
  174: 
  175:     - Added some Solaris xattr code.
  176: 
  177:     - Made an rsync daemon (the listening process) exit with a 0 status when
  178:       it was signaled to die.  This helps launchd.
  179: 
  180:     - Improved the RSYNC_* environment variables for the pre-xfer exec script:
  181:       when a daemon is sent multiple request args, they are now joined into a
  182:       single return value (separated by spaces) so that the RSYNC_REQUEST
  183:       environment variable is accurate for any "pre-xfer exec".  The values in
  184:       RSYNC_ARG# vars are no longer truncated at the "." arg (prior to the
  185:       request dirs/files), so that all the requested values are also listed
  186:       (separately) in RSYNC_ARG# variables.
  187: 
  188:   EXTRAS:
  189: 
  190:     - Added an "instant-rsyncd" script to the support directory, which makes
  191:       it easy to configure a simple rsync daemon in the current directory.
  192: 
  193:     - Added the "mapfrom" and "mapto" scripts to the support directory, which
  194:       makes it easier to do user/group mapping in a local transfer based on
  195:       passwd/group files from another machine.
  196: 
  197:     - There's a new, improved version of the lsh script in the support dir:
  198:       it's written in perl and supports -u without resorting to using sudo
  199:       (when run as root).  The old shell version is now named lsh.sh.
  200: 
  201:     - There is a helper script named rsync-slash-strip in the support directory
  202:       for anyone that wants to change the way rsync handles args with trailing
  203:       slashes.  (e.g. arg/ would get stripped to arg while arg/. would turn into
  204:       arg/).
  205: 
  206:   INTERNAL:
  207: 
  208:     - The I/O code was rewritten to be simpler and do bigger buffered reads
  209:       over the socket.  The I/O between the receiver and the generator was
  210:       changed to be standard multiplexed-I/O (like that over the socket).
  211: 
  212:     - The sender tries to use any dead time while the generator is looking for
  213:       files to transfer in order to do sender-side directory scanning in a more
  214:       parallel manner.
  215: 
  216:     - A daemon can now inform a client about a daemon-configured timeout value
  217:       so that the client can assist in the keep-alive activity (protocol 31).
  218: 
  219:     - The filter code received some refactoring to make it more extendible, to
  220:       read better, and do better sanity checking.
  221: 
  222:     - Really big numbers are now output using our own big-num routine rather
  223:       than casting them to a double and using a %.0f conversion.
  224: 
  225:     - The pool_alloc library has received some minor improvements in alignment
  226:       handling.
  227: 
  228:     - Added init_stat_x() function to avoid duplication of acl/xattr init code.
  229: 
  230:     - The included zlib was upgraded from 1.2.3 to 1.2.8.
  231: 
  232:     - Rsync can now be compiled to use an unmodified zlib library instead of
  233:       the tweaked one that is included with rsync.  This will eventually
  234:       become the default, at which point we'll start the countdown to removing
  235:       the included zlib.  Until then, feel free to configure using:
  236: 
  237: 	./configure --with-included-zlib=no
  238: 
  239:   DEVELOPER RELATED:
  240: 
  241:     - Added more conditional debug output.
  242: 
  243:     - Fixed some build issues for android and minix.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>