Annotation of embedaddon/rsync/NEWS.md, revision 1.1.1.1
1.1 misho 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.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to NEWS.md CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / rsync