Mention the latest changes plus a few missed items.
[rsync/rsync.git] / NEWS
1 NEWS for rsync 2.6.4 (UNRELEASED)
2 Protocol: 29 (changed)
3 Changes since 2.6.3:
4
5   OUTPUT CHANGES:
6
7     - When rsync deletes a directory and outputs a verbose message about
8       it, it now appends a trailing slash to the name instead of (only
9       sometimes) outputting a preceding "directory " string.
10
11     - The --stats output will contain time file-list time statistics if
12       both sides are 2.6.4, or if the local side is 2.6.4 and the files
13       are being pushed (since the stats come from the sending side).
14   
15   BUG FIXES:
16
17     - Restore the list-clearing behavior of "!" in a .cvsignore file (2.6.3
18       was only treating it as a special token in an rsync include/exclude
19       file).
20
21     - Avoid a mkdir warning when removing a directory in the destination
22       that already exists in the --backup-dir.
23
24     - An OS that has a binary mode for its files (such as cygwin0 needed
25       setmode(fd, O_BINARY) called on the temp-file we opened with
26       mkstemp().  (Fix derived from the cygwin's rsync package.)
27
28     - Fixed a potential hang when verbosity is high, the client side is
29       the sender, and the file-list is large.
30
31     - We now check if the OS doesn't support using mknod() for creating
32       FIFOs and sockets, and compile-in using mkfifo() and socket() when
33       necessary.
34
35     - Fixed an off-by-one error in the handling of --max-delete=N.
36
37     - One place in the code wasn't checking if fork() failed.
38
39     - The "ignore nonreadable" daemon parameter no longer affects symlinks
40       that are being copied, even if they point nowhere.
41
42     - If the OS does not have lchown() and its chown() tries to set the
43       referent of a symlink (as it should), we no longer try to set the
44       user and group of a symlink.
45
46     - The generator now properly runs the hard-link loop and the dir-time
47       rewriting loop after we're sure that the redo phase is complete.
48
49     - When --backup was specified with --partial-dir=DIR (where DIR is a
50       relative path), the backup code was erroneously trying to backup a
51       file that was put into the partial-dir.
52
53   ENHANCEMENTS:
54
55     - Rsync now supports popt's option aliases, which means that you can
56       use /etc/popt and/or ~/.popt to create your own option aliases.
57
58     - Added the --delete-during (--del) option which will delete files
59       from on the receiving side incrementally as each directory in the
60       transfer is being processed (which makes it more efficient than the
61       default, before-the-transfer behavior of --delete).  Note that the
62       --del option is implemented as an internally-defined popt alias, so
63       an rsync daemon that refuses "delete" (which, for safety's sake,
64       really matches "delete*") will still refuse all delete options.
65
66     - Added the --copy-dest option, which works like --link-dest except
67       that it includes copies of identical files.
68
69     - Added support for specifying multiple --compare-dest, --copy-dest, or
70       --link-dest options, but only of a single type. (Promoted from the
71       patches dir and enhanced.)
72
73     - Added the --max-size option. (Promoted from the patches dir.)
74
75     - The daemon-mode options were separated from the normal rsync options
76       so that they can't be mixed together.  This makes it impossible to
77       start a daemon that had improper default option values that could
78       cause problems (such as a hang or an abort) when a client connects.
79
80     - The --bwlimit option may now be used in combination with --daemon
81       to specify a default value for the daemon side and also a value
82       that cannot be exceeded by a user-specified --bwlimit option.
83
84     - Added the "port" parameter to the rsyncd.conf file. (Promoted from
85       the patches dir.)
86
87     - In _exit_cleanup(): when we are exiting with a partially-received
88       file, we now flush any data in the write-cache before closing the
89       partial file.
90
91     - The --inplace support was enhanced to work with --compare-dest,
92       --link-dest, and (the new) --copy-dest options.
93
94     - Added the --dirs (-d) option for an easier way to copy directories
95       without recursion.
96
97     - Added the --list-only option which is mainly a way for the client to
98       put the server into listing mode without needing to resort to any
99       option kluges (e.g. the age-old use of "-r --exclude="/*/*" for a
100       non-recursive listing).
101
102     - Added the --omit-dir-times (-O) option which will avoid updating the
103       modified time for directories when --times was specified.  For a
104       really large transfer, this option will avoid an extra pass through
105       the file-list at the end of the transfer to tweak all the directory
106       times.
107
108     - Added the --filter (-f) option and its helper option, -F.  Filter
109       rules are an extension to the existing include/exclude handling
110       that also supports nested filter files as well as per-directory
111       filter files (like .cvsignore, but with full filter-rule parsing).
112       This new option was chosen in order to ensure that all existing
113       include/exclude processing remained 100% compatible with older
114       versions.
115
116     - Added the --delay-updates option that puts all updated files into
117       a temporary directory (by default ".~tmp~", but settable via the
118       --partial-dir=DIR option) until the end of the transfer.  This
119       makes the updates a little more atomic for a large transfer.
120
121   SUPPORT FILES:
122
123     - Added support/atomic-rsync -- a perl script that will transfer some
124       files using rsync, and then move the updated files into place all at
125       once at the end of the transfer.  Only works when pulling, and uses
126       --link-dest and a parallel hierarchy of files to effect its update.
127
128     - Added support/mnt-excl that takes the /proc/mounts file and
129       translates it into a set of excludes that will exclude all mount
130       points (even mapped mounts to the same disk).  The excludes are made
131       relative to the specified source dir and properly anchored.
132
133     - Added support/savetransfer.c -- a C program that can make a copy of
134       all the data that flows over the wire.  This lets you test for data
135       corruption (by saving the data on both the sending side and the
136       receiving side) or provides a way to help debug a protocol error.
137
138     - Added support/rrsync -- my version of Joe Smith's restricted rsync
139       perl script.  This helps to ensure that only certain rsync commands
140       can be run by an ssh invocation.
141
142   INTERNAL:
143
144     - Added better checking of the checksum header values that come over
145       the socket.
146
147     - Improved the type of some variables for consistency and proper size.
148
149   BUILD CHANGES:
150
151     - Handle an operating system that use mkdev() in place of makedev().