News de la 3.0.8
 

rsync  version 3.0.7  protocol version 30                                                                                                                            
Copyright (C) 1996-2009 by Andrew Tridgell, Wayne Davison, and others.                                                                                                
Web site: http://rsync.samba.org/                                                                                                                                    
Capabilities:                                                                                                                                                        
    64-bit files, 64-bit inums, 64-bit timestamps, 64-bit long ints,                                                                                                  
    socketpairs, hardlinks, symlinks, IPv6, batchfiles, inplace,                                                                                                      
    append, ACLs, xattrs, iconv, no symtimes                                                                                                                          
                                                                                                                                                                     
rsync comes with ABSOLUTELY NO WARRANTY.  This is free software, and you                                                                                              
are welcome to redistribute it under certain conditions.  See the GNU                                                                                                
General Public Licence for details.                                                                                                                                  
                                                                                                                                                                     
rsync is a file transfer program capable of efficient remote update                                                                                                  
via a fast differencing algorithm.                                                                                                                                    
                                                                                                                                                                     
Usage: rsync [OPTION]... SRC [SRC]... DEST                                                                                                                            
  or   rsync [OPTION]... SRC [SRC]... [USER@]HOST:DEST                                                                                                                
  or   rsync [OPTION]... SRC [SRC]... [USER@]HOST::DEST                                                                                                              
  or   rsync [OPTION]... SRC [SRC]... rsync://[USER@]HOST/DEST                                                                                                
  or   rsync [OPTION]... [USER@]HOST:SRC [DEST]                                                                                                                      
  or   rsync [OPTION]... [USER@]HOST::SRC [DEST]                                                                                                                      
  or   rsync [OPTION]... rsync://[USER@]HOST/SRC [DEST]                                                                                                        
The ':' usages connect via remote shell, while '::' & 'rsync://' usages connect                                                                                      
to an rsync daemon, and require SRC or DEST to start with a module name.                                                                                              
                                                                                                                                                                     
Options                                                                                                                                                              
 -v, --verbose               increase verbosity                                                                                                                      
 -q, --quiet                 suppress non-error messages                                                                                                              
     --no-motd               suppress daemon-mode MOTD (see manpage caveat)                                                                                          
 -c, --checksum              skip based on checksum, not mod-time & size                                                                                              
 -a, --archive               archive mode; equals -rlptgoD (no -H,-A,-X)                                                                                              
     --no-OPTION             turn off an implied OPTION (e.g. --no-D)                                                                                                
 -r, --recursive             recurse into directories                                                                                                                
 -R, --relative              use relative path names                                                                                                                  
     --no-implied-dirs       don't send implied dirs with --relative                                                                                                  
 -b, --backup                make backups (see --suffix & --backup-dir)                                                                                              
     --backup-dir=DIR        make backups into hierarchy based in DIR                                                                                                
     --suffix=SUFFIX         set backup suffix (default ~ w/o --backup-dir)                                                                                          
     --backup-dir-dels=DIR   backup removed files into hierarchy based in DIR                                                                                        
     --suffix-dels=SUFFIX    set removed-files suffix (def. --suffix w/o b-d-d)                                                                                      
 -u, --update                skip files that are newer on the receiver                                                                                                
     --inplace               update destination files in-place (SEE MAN PAGE)                                                                                        
     --append                append data onto shorter files                                                                                                          
     --append-verify         like --append, but with old data in file checksum                                                                                        
 -d, --dirs                  transfer directories without recursing                                                                                                  
 -l, --links                 copy symlinks as symlinks                                                                                                                
 -L, --copy-links            transform symlink into referent file/dir                                                                                                
     --copy-unsafe-links     only "unsafe" symlinks are transformed                                                                                                  
     --safe-links            ignore symlinks that point outside the source tree                                                                                      
 -k, --copy-dirlinks         transform symlink to a dir into referent dir                                                                                            
 -K, --keep-dirlinks         treat symlinked dir on receiver as dir                                                                                                  
 -H, --hard-links            preserve hard links                                                                                                                      
 -p, --perms                 preserve permissions                                                                                                                    
 -E, --executability         preserve the file's executability                                                                                                        
     --chmod=CHMOD           affect file and/or directory permissions                                                                                                
 -A, --acls                  preserve ACLs (implies --perms)                                                                                                          
 -X, --xattrs                preserve extended attributes                                                                                                            
 -o, --owner                 preserve owner (super-user only)                                                                                                        
 -g, --group                 preserve group                                                                                                                          
     --devices               preserve device files (super-user only)                                                                                                  
     --specials              preserve special files                                                                                                                  
 -D                          same as --devices --specials                                                                                                            
 -t, --times                 preserve modification times                                                                                                              
 -O, --omit-dir-times        omit directories from --times                                                                                                            
     --super                 receiver attempts super-user activities                                                                                                  
     --fake-super            store/recover privileged attrs using xattrs                                                                                              
 -S, --sparse                handle sparse files efficiently                                                                                                          
 -n, --dry-run               perform a trial run with no changes made                                                                                                
 -W, --whole-file            copy files whole (without delta-xfer algorithm)                                                                                          
 -x, --one-file-system       don't cross filesystem boundaries                                                                                                        
 -B, --block-size=SIZE       force a fixed checksum block-size                                                                                                        
 -e, --rsh=COMMAND           specify the remote shell to use                                                                                                          
     --rsync-path=PROGRAM    specify the rsync to run on the remote machine                                                                                          
     --existing              skip creating new files on receiver                                                                                                      
     --ignore-existing       skip updating files that already exist on receiver                                                                                      
     --remove-source-files   sender removes synchronized files (non-dirs)                                                                                            
     --del                   an alias for --delete-during                                                                                                            
     --delete                delete extraneous files from destination dirs                                                                                            
     --delete-before         receiver deletes before transfer, not during                                                                                            
     --delete-during         receiver deletes during transfer (default)                                                                                              
     --delete-delay          find deletions during, delete after                                                                                                      
     --delete-after          receiver deletes after transfer, not during                                                                                              
     --delete-excluded       also delete excluded files from destination dirs                                                                                        
     --ignore-errors         delete even if there are I/O errors                                                                                                      
     --force                 force deletion of directories even if not empty                                                                                          
     --max-delete=NUM        don't delete more than NUM files                                                                                                        
     --max-size=SIZE         don't transfer any file larger than SIZE                                                                                                
     --min-size=SIZE         don't transfer any file smaller than SIZE                                                                                                
     --partial               keep partially transferred files                                                                                                        
     --partial-dir=DIR       put a partially transferred file into DIR                                                                                                
     --delay-updates         put all updated files into place at transfer's end                                                                                      
 -m, --prune-empty-dirs      prune empty directory chains from the file-list                                                                                          
     --numeric-ids           don't map uid/gid values by user/group name                                                                                              
     --timeout=SECONDS       set I/O timeout in seconds                                                                                                              
     --contimeout=SECONDS    set daemon connection timeout in seconds                                                                                                
 -I, --ignore-times          don't skip files that match in size and mod-time                                                                                        
     --size-only             skip files that match in size                                                                                                            
     --modify-window=NUM     compare mod-times with reduced accuracy                                                                                                  
 -T, --temp-dir=DIR          create temporary files in directory DIR                                                                                                  
 -y, --fuzzy                 find similar file for basis if no dest file                                                                                              
     --compare-dest=DIR      also compare destination files relative to DIR                                                                                          
     --copy-dest=DIR         ... and include copies of unchanged files                                                                                                
     --link-dest=DIR         hardlink to files in DIR when unchanged                                                                                                  
 -z, --compress              compress file data during the transfer                                                                                                  
     --compress-level=NUM    explicitly set compression level                                                                                                        
     --skip-compress=LIST    skip compressing files with a suffix in LIST                                                                                            
 -C, --cvs-exclude           auto-ignore files the same way CVS does                                                                                                  
 -f, --filter=RULE           add a file-filtering RULE                                                                                                                
 -F                          same as --filter='dir-merge /.rsync-filter'                                                                                              
                             repeated: --filter='- .rsync-filter'                                                                                                    
     --exclude=PATTERN       exclude files matching PATTERN                                                                                                          
     --exclude-from=FILE     read exclude patterns from FILE                                                                                                          
     --include=PATTERN       don't exclude files matching PATTERN                                                                                                    
     --include-from=FILE     read include patterns from FILE                                                                                                          
     --files-from=FILE       read list of source-file names from FILE                                                                                                
 -0, --from0                 all *-from/filter files are delimited by 0s                                                                                              
 -s, --protect-args          no space-splitting; only wildcard special-chars                                                                                          
     --address=ADDRESS       bind address for outgoing socket to daemon                                                                                              
     --port=PORT             specify double-colon alternate port number                                                                                              
     --sockopts=OPTIONS      specify custom TCP options                                                                                                              
     --blocking-io           use blocking I/O for the remote shell                                                                                                    
     --stats                 give some file-transfer stats                                                                                                            
 -8, --8-bit-output          leave high-bit chars unescaped in output                                                                                                
 -h, --human-readable        output numbers in a human-readable format                                                                                                
     --progress              show progress during transfer                                                                                                            
 -P                          same as --partial --progress                                                                                                            
 -i, --itemize-changes       output a change-summary for all updates                                                                                                  
     --out-format=FORMAT     output updates using the specified FORMAT                                                                                                
     --log-file=FILE         log what we're doing to the specified FILE                                                                                              
     --log-file-format=FMT   log updates using the specified FMT                                                                                                      
     --password-file=FILE    read daemon-access password from FILE                                                                                                    
     --list-only             list the files instead of copying them                                                                                                  
     --bwlimit=KBPS          limit I/O bandwidth; KBytes per second                                                                                                  
     --write-batch=FILE      write a batched update to FILE                                                                                                          
     --only-write-batch=FILE like --write-batch but w/o updating destination                                                                                          
     --read-batch=FILE       read a batched update from FILE                                                                                                          
     --protocol=NUM          force an older protocol version to be used                                                                                              
     --iconv=CONVERT_SPEC    request charset conversion of filenames                                                                                                  
 -4, --ipv4                  prefer IPv4                                                                                                                              
 -6, --ipv6                  prefer IPv6                                                                                                                              
     --version               print version number                                                                                                                    
(-h) --help                  show this help (-h works with no other options)                                                                                          
                                                                                                                                                                     
Use "rsync --daemon --help" to see the daemon-mode command-line options.                                                                                              
Please see the rsync(1) and rsyncd.conf(5) man pages for full documentation.                                                                                          
See http://rsync.samba.org/ for updates, bug reports, and answers

NEWS for rsync 3.0.8 (26 Mar 2011)
Protocol: 30 (unchanged)
Changes since 3.0.7:
 
  BUG FIXES:
 
    - Fixed two buffer-overflow issues: one where a directory path that is
      exactly MAXPATHLEN was not handled correctly, and one handling a
      --backup-dir that is extra extra large.
 
    - Fixed a data-corruption issue when preserving hard-links without
      preserving file ownership, and doing deletions either before or during
      the transfer (CVE-2011-1097).  This fixes some assert errors in the
      hard-linking code, and some potential failed checksums (via -c) that
      should have matched.
 
    - Fixed a potential crash when an rsync daemon has a filter/exclude list
      and the transfer is using ACLs or xattrs.
 
    - Fixed a hang if a really large file is being processed by an rsync that
      can't handle 64-bit numbers.  Rsync will now complain about the file
      being too big and skip it.
 
    - For devices and special files, we now avoid gathering useless ACL and/or
      xattr information for files that aren't being copied.  (The un-copied
      files are still put into the file list, but there's no need to gather
      data that is not going to be used.)  This ensures that if the user uses
      --no-D, that rsync can't possibly complain about being unable to gather
      extended information from special files that are in the file list (but
      not in the transfer).
 
    - Properly handle requesting remote filenames that start with a dash.  This
      avoids a potential error where a filename could be interpreted as a
      (usually invalid) option.
 
    - Fixed a bug in the comparing of upper-case letters in file suffixes for
      --skip-compress.
 
    - If an rsync daemon has a module configured without a path setting, rsync
      will now disallow access to that module.
 
    - If the destination arg is an empty string, it will be treated as a
      reference to the current directory (as 2.x used to do).
 
    - If rsync was compiled with a newer time-setting function (such as
      lutimes), rsync will fall-back to an older function (such as utimes) on a
      system where the newer function is not around.  This helps to make the
      rsync binary more portable in mixed-OS-release situations.
 
    - Fixed a batch-file writing bug that would not write out the full set of
      compatibility flags that the transfer was using.  This fixes a potential
      protocol problem for a batch file that contains a sender-side I/O error:
      it would have been sent in a way that the batch-reader wasn't expecting.
 
    - Some improvements to the hard-linking code to ensure that device-number
      hashing is working right, and to supply more information if the hard-link
      code fails.
 
    - The --inplace code was improved to not search for an impossible checksum
      position.  The quadruple-verbose chunk[N] message will now mention when
      an inplace chunk was handled by a seek rather than a read+write.
 
    - Improved ACL mask handling, e.g. for Solaris.
 
    - Fixed a bug that prevented --numeric-ids from disabling the translation
      of user/group IDs for ACLs.
 
    - Fixed an issue where an xattr and/or ACL transfer that used an alt-dest
      option (e.g. --link-dest) could output an error trying to itemize the
      changes against the alt-dest directory's xattr/ACL info but was instead
      trying to access the not-yet-existing new destination directory.
 
    - Improved xattr system-error messages to mention the full path to the
      file.
 
    - The --link-dest checking for identical symlinks now avoids considering
      attribute differences that cannot be changed on the receiver.
 
    - Avoid trying to read/write xattrs on certain file types for certain OSes.
      Improved configure to set NO_SYMLINK_XATTRS, NO_DEVICE_XATTRS, and/or
      NO_SPECIAL_XATTRS defines in config.h.
 
    - Improved the unsafe-symlink errors messages.
 
    - Fixed a bug setting xattrs on new files that aren't user writable.
 
    - Avoid re-setting xattrs on a hard-linked file w/the same xattrs.
 
    - Fixed a bug with --fake-super when copying files and dirs that aren't
      user writable.
 
    - Fixed a bug where a sparse file could have its last sparse block turned
      into a real block when rsync sets the file size (requires ftruncate).
 
    - If a temp-file name is too long, rsync now avoids truncating the name in
      the middle of adjacent high-bit characters.  This prevents a potential
      filename error if the filesystem doesn't allow a name to contain an
      invalid multi-byte sequence.
 
    - If a muli-protocol socket connection fails (i.e., when contacting a
      daemon), we now report all the failures, not just the last one.  This
      avoids losing a relevant error (e.g. an IPv4 connection-refused error)
      that happened before the final error (e.g. an IPv6 protocol-not-supported
      error).
 
    - Generate a transfer error if we try to call chown with a -1 for a uid or
      a gid (which is not settable).
 
    - Fixed the working of --force when used with --one-file-system.
 
    - Fix the popt arg parsing so that an option that doesn't take an arg will
      reject an attempt to supply one (can configure --with-included-popt if
      your system's popt library doesn't yet have this fix).
 
    - A couple minor option tweaks to the support/rrsync script, and also some
      regex changes that make vim highlighting happier.
 
    - Fixed some issues in the support/mnt-excl script.
 
    - Various manpage improvements.
 
  ENHANCEMENTS:
 
    - Added ".hg/" to the default cvs excludes (see -C & --cvs-exclude).
 
  DEVELOPER RELATED:
 
    - Use lchmod() whenever it is available (not just on symlinks).
 
    - A couple fixes to the socketpair_tcp() routine.
 
    - Updated the helper scripts in the packaging subdirectory.
 
    - Renamed configure.in to configure.ac.
 
    - Fixed configure's checking for iconv routines for newer OS X versions.
 
    - Fixed the testsuite/xattrs.test script on OS X.