1 NEWS for rsync 2.6.4 (UNRELEASED)
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.
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 (Requires protocol 29.)
18 - Restore the list-clearing behavior of "!" in a .cvsignore file (2.6.3
19 was only treating it as a special token in an rsync include/exclude
22 - The combination of --verbose and --dry-run now mentions changes in
23 directories and it now includes the full update information that
24 would be output without --dry-run at higher levels of verbosity.
26 - Avoid a mkdir warning when removing a directory in the destination
27 that already exists in the --backup-dir.
29 - An OS that has a binary mode for its files (such as cygwin0 needed
30 setmode(fd, O_BINARY) called on the temp-file we opened with
31 mkstemp(). (Fix derived from the cygwin's rsync package.)
33 - Fixed a potential hang when verbosity is high, the client side is
34 the sender, and the file-list is large.
36 - We now check if the OS doesn't support using mknod() for creating
37 FIFOs and sockets, and compile-in using mkfifo() and socket() when
40 - Fixed an off-by-one error in the handling of --max-delete=N.
42 - One place in the code wasn't checking if fork() failed.
44 - The "ignore nonreadable" daemon parameter no longer affects symlinks
45 that are being copied, even if they point nowhere.
47 - If the OS does not have lchown() and its chown() tries to set the
48 referent of a symlink (as it should), we no longer try to set the
49 user and group of a symlink.
51 - The generator now properly runs the hard-link loop and the dir-time
52 rewriting loop after we're sure that the redo phase is complete.
54 - When --backup was specified with --partial-dir=DIR (where DIR is a
55 relative path), the backup code was erroneously trying to backup a
56 file that was put into the partial-dir.
58 - One call to flush_write_file() was not being checked for an error.
60 - The --no-relative option was not being sent from the client to a
63 - If an rsync daemon specified "dont compress = ..." for a file and the
64 client tried to specify --compress, the libz code was not handling a
65 compression level of 0 properly. This could cause a transfer failure
66 if the block-size for a file was large enough (i.e. rsync might have
67 exited with an error for large files).
69 - If a daemon can't open the specified log file (i.e. syslog is not
70 being used), die without crashing. We also try to output an error
71 about the failure (which will only be seen if --no-detach was
74 - A local transfer no longer duplicates all its include/exclude options
75 by sending the forked process a copy of the list it already has.
79 - Rsync now supports popt's option aliases, which means that you can
80 use /etc/popt and/or ~/.popt to create your own option aliases.
82 - Added the --delete-during (--del) option which will delete files
83 from on the receiving side incrementally as each directory in the
84 transfer is being processed (which makes it more efficient than the
85 default, before-the-transfer behavior of --delete). Note that the
86 --del option is implemented as an internally-defined popt alias, so
87 an rsync daemon that refuses "delete" (which, for safety's sake,
88 really matches "delete*") will still refuse all delete options. The
89 default --delete behavior is also explicitly selectable via
92 - All the --delete-WHEN options are now more memory efficient:
93 Previously an entire duplicate set of file-list objects was created
94 on the receiving side for the entire destination hierarchy. The new
95 algorithm only creates one directory of objects at a time.
97 - Added the --copy-dest option, which works like --link-dest except
98 that it includes copies of identical files.
100 - Added support for specifying multiple --compare-dest, --copy-dest, or
101 --link-dest options, but only of a single type. (Promoted from the
102 patches dir and enhanced.)
104 - Added the --max-size option. (Promoted from the patches dir.)
106 - The daemon-mode options were separated from the normal rsync options
107 so that they can't be mixed together. This makes it impossible to
108 start a daemon that had improper default option values that could
109 cause problems (such as a hang or an abort) when a client connects.
111 - The --bwlimit option may now be used in combination with --daemon
112 to specify both a default value for the daemon side and a value
113 that cannot be exceeded by a user-specified --bwlimit option.
115 - Added the "port" parameter to the rsyncd.conf file. (Promoted from
116 the patches dir.) Also added "address". A command-line option
117 will take precedence over a config-file option, as expected.
119 - In _exit_cleanup(): when we are exiting with a partially-received
120 file, we now flush any data in the write-cache before closing the
123 - The --inplace support was enhanced to work with --compare-dest,
124 --link-dest, and (the new) --copy-dest options. (Requires protocol
127 - Added the --dirs (-d) option for an easier way to copy directories
130 - Added the --list-only option which is mainly a way for the client to
131 put the server into listing mode without needing to resort to any
132 option kluges (e.g. the age-old use of "-r --exclude="/*/*" for a
133 non-recursive listing). This option is used automatically when a
134 modern rsync speaks to a modern daemon, but may also be specified
135 manually if you want to force the use of the --list-only option over
136 a remote-shell connection.
138 - Added the --omit-dir-times (-O) option which will avoid updating the
139 modified time for directories when --times was specified. This
140 option will avoid an extra pass through the file-list at the end of
141 the transfer (to tweak all the directory times), which can result in
142 an appreciable speedup for a really large transfer. (Promoted from
145 - Added the --filter (-f) option and its helper option, -F. Filter
146 rules are an extension to the existing include/exclude handling
147 that also supports nested filter files as well as per-directory
148 filter files (like .cvsignore, but with full filter-rule parsing).
149 This new option was chosen in order to ensure that all existing
150 include/exclude processing remained 100% compatible with older
151 versions. Protocol 29 is needed for full filter-rule support, but
152 backward-compatible rules work with earlier protocol versions.
153 (Promoted from the patches dir.)
155 - Added the --delay-updates option that puts all updated files into
156 a temporary directory (by default ".~tmp~", but settable via the
157 --partial-dir=DIR option) until the end of the transfer. This
158 makes the updates a little more atomic for a large transfer.
160 - If rsync is put into the background, any output from --progress is
163 - Documented the "max verbosity" setting for rsyncd.conf. (This
164 setting was added a couple releases ago, but left undocumented.)
166 - The sender and the generator now double-check the file-list index
167 they are given, and refuse to operate on a directory index (since
168 that would indicate that something had gone very wrong).
170 - Added the --fuzzy option, which attempts to find a basis file for a
171 file that is being created from scratch. The current algorithm
172 only looks in the destination directory for the created file, but
173 it does attempt to find a match based on size/mod-time (in case the
174 file was renamed with no other changes) as well as based on a fuzzy
175 name-matching algorithm. This option requires protocol 29 because
176 it needs the new file-sorting order. (Promoted from patches dir
181 - Added support/atomic-rsync -- a perl script that will transfer some
182 files using rsync, and then move the updated files into place all at
183 once at the end of the transfer. Only works when pulling, and uses
184 --link-dest and a parallel hierarchy of files to effect its update.
186 - Added support/mnt-excl that takes the /proc/mounts file and
187 translates it into a set of excludes that will exclude all mount
188 points (even mapped mounts to the same disk). The excludes are made
189 relative to the specified source dir and properly anchored.
191 - Added support/savetransfer.c -- a C program that can make a copy of
192 all the data that flows over the wire. This lets you test for data
193 corruption (by saving the data on both the sending side and the
194 receiving side) or provides a way to help debug a protocol error.
196 - Added support/rrsync -- my version of Joe Smith's restricted rsync
197 perl script. This helps to ensure that only certain rsync commands
198 can be run by an ssh invocation.
200 - Improved the option descriptions in the --help text.
204 - Added better checking of the checksum-header values that come over
207 - Merged the various delete-file functions into a single function so
208 that it is easier to maintain.
210 - Improved the type of some variables (particularly blocksize vars) for
211 consistency and proper size.
213 - Got rid of the uint64 type (which we didn't need).
215 - Use a slightly more compatible set of core #include directives.
217 - Defined int32 in a way that ensures that the build dies if we can't
218 find a variable with at least 32 bits.
220 PROTOCOL DIFFERENCES FOR VERSION 29:
222 - If --inplace is specified, the generator sends an extra byte after
223 each index integer indicating what kind of basis file is being used
224 for the transfer (see the FNAMECMP_* defines).
226 - The sending of exclude names is done using filter-rule syntax. This
227 means that all names have a prefixed rule indicator, even excludes
228 (which used to be sent as a bare pattern, when possible). The -C
229 option will include the per-dir .cvsignore merge file in the list of
230 filter rules so it is positioned correctly (unlike in some older
233 - Rsync sorts the filename list in a different way: it sorts the
234 subdir names after the non-subdir names for each dir's contents, and
235 it always puts a dir's contents immediately after the dir's name in
236 the list. (Previously an item named "foo.txt" would sort in between
237 directory "foo/" and "foo/bar".)
239 - When talking to a protocol 29 rsync daemon, a list-only request
240 is able to note this before the options are sent over the wire, and
241 the new --list-only option is enabled.
243 - When the --stats bytes are sent over the wire (or stored in a batch),
244 they now include two elapsed-time values: one for how long it took to
245 build the file-list, and one for how long it took to send it over the
246 wire (each expressed in thousandths of a second).
248 - When --delete-excluded is specified with some filter rules (AKA
249 excludes), a client sender will still initiate a send of the filter
250 rules to the receiver, but it only includes those rules that are
251 receiver-specific. Older protocols used to omit the sending of
252 excludes in this situation (since there were no receiver-specific
253 rules that survived --delete-excluded back then).
255 - A protocol-29 batch file includes a bit for the setting of the --dirs
256 option. Also, the shell script created by --write-batch will use the
257 --filter option instead of --exclude-from to capture any filter rules.
261 - Handle an operating system that use mkdev() in place of makedev().
263 - Improved configure to better handle cross-compiling.