Mention the latest changes.
[rsync/rsync.git] / NEWS
1 NEWS for rsync 3.0.0 (UNRELEASED)
2 Protocol: 30 (changed)
3 Changes since 2.6.9:
4
5   BUG FIXES:
6
7     - Fixed the output of -ii when combined with one of the --*-dest options:
8       it now itemizes all the items, not just the changed ones.
9
10     - Made the output of all file types consistent when using a --*-dest
11       option.  Prior versions used to output too many creation events for
12       matching items.
13
14     - The code that waits for a child pid now handles being interrupted by a
15       signal.  This fixes a problem with the pre-xfer exec function not being
16       able to get the exit status from the script.
17
18     - A negated filter rule now sends the negation option when sending the
19       filter rules.
20
21     - Fixed a problem with the --out-format (aka --log-format) option:  it
22       would output superfluous directory information for a non-daemon rsync.
23
24     - Fixed a problem with -vv (double --verbose) and --stats when "pushing"
25       files (which includes local copies).  Version 2.6.9 would complete the
26       copy, but exit with an error when the receiver output its memory stats.
27
28     - If --password-file is used on a non-daemon transfer, rsync now complains
29       and exits.  This should help users figure out that they can't use this
30       option to control a remote shell's password prompt.
31
32     - Make sure that directory permissions of a newly-created destination
33       directory are handled right when --perms is left off.
34
35     - Improved --hard-link so that more corner cases are handled correctly
36       when combined with options such as --link-dest and/or --ignore-existing.
37
38   ENHANCEMENTS:
39
40     - A new incremental-recursion algorithm is now used when rsync is talking
41       to another 3.0.0 version.  This starts the transfer going more quickly
42       (before all the files have been found), and requires much less memory.
43       See the --recursive option in the manpage for some restrictions.
44
45     - The default --delete algorithm is now --delete-during when talking to a
46       3.x rsync.  This is a faster scan than using --delete-before (which is
47       the default when talking to older rsync versions), and is compatible with
48       the new incremental recursion mode.
49
50     - Added the --delete-delay option, which is a more efficient way to delete
51       files at the end of the transfer without needing a separate delete pass.
52
53     - Added the --acls (-A) option to preserve Access Control Lists.  This is
54       an improved version of the prior patch that was available.  (If you need
55       to have backward compatibility with old, patched versions, the new
56       acls.diff patch that will add that.)
57
58     - Added the --xattrs (-X) option to preserver extended attributes.  This is
59       an improved version of the prior patch that was available.  (If you need
60       to have backward compatibility with old, patched versions, the new
61       xattrs.diff patch that will add that.)
62
63     - Added the --fake-super option that allows a non-super user to preserve
64       all attributes of a file by using a special extended-attribute idiom.
65       There is also an analogous "fake super" option for an rsync daemon.
66
67     - Added the --iconv option, which allows rsync to convert filenames from
68       one character-set to another during the transfer.  The default is to make
69       this feature available as long as your system has iconv_open().  If
70       compilation fails, specify --disable-iconv to configure and rebuild.  If
71       you want rsync to perform character-set conversions by default, you can
72       specify --enable-iconv=CONVERT_STRING with the default value for the
73       --iconv option that you wish to use.  For example, --enable-iconv=. is a
74       good choice.  See the rsync man page for an explanation of the --iconv
75       option's settings.
76
77     - Added the --skip-compress=LIST option to override of the default list of
78       file suffixes that will not be compressed when using --compress.
79
80     - You may specify --max-delete=0 to a 3.0.0 client as long as the receiving
81       side is at least version 3.0.0.  This means that you can pull from an
82       older rsync with this option, but pushing to an older rsync will generate
83       an error.  *Be sure to never specify a 0 value to an older rsync client,
84       or it will be silently ignored.*
85
86     - The --hard-link option now uses less memory on both the sending and
87       receiving side for all protocol versions.  For protocol 30, the use of a
88       hashtable on the sending side allows us to more efficiently convey to the
89       receiver what files are linked together.  This reduces the amount of data
90       sent over the socket by a considerable margin (rather than adding more
91       data), and limits the in-memory storage of the device+inode information
92       to just the sending side for the new protocol 30, or to the receiving
93       side when speaking an older protocol (note that older rsync versions kept
94       the device+inode information on both sides).
95
96     - A lot more --no-OPTION override options are now supported.
97
98   INTERNAL:
99
100     - The file-list sorting algorithm now uses a sort that keeps any same-
101       named items in the same order as they were specified.  This allows
102       rsync to always ensure that the first of the duplicates is the one
103       that will be included in the copy.  The new sort was also faster
104       than the glibc version of qsort() and mergesort() in my testing.
105
106     - Rsync now supports the transfer of 64-bit timestamps (time_t values).
107
108     - Fixed a build problem with older (2.x) versions of gcc.
109
110     - Added some isType() functions that make dealing with signed characters
111       easier without forcing variables via casts.
112
113     - Upgraded the included popt version to 1.10.2 and improved its use of
114       string-handling functions.
115
116     - Added missing prototypes for compatibility functions from the lib dir.
117
118     - Configure determines if iconv() has a const arg, allowing us to avoid a
119       compiler warning.
120
121     - Made the sending of some numbers more efficient for protocol 30.
122
123     - Make sure that a daemon process doesn't mind if the client was weird and
124       omitted the --server option.
125
126     - Improved the use of "const" on pointers.
127
128     - Improved J.W.'s pool_alloc routines to add a way of freeing older
129       sections of a pool's memory.
130
131   DEVELOPER RELATED:
132
133     - Rsync is now licensed under the GPLv3 or later.
134
135     - Rsync now has a way of handling protocol-version changes during the
136       development of a new protocol version.  This exchange of sub-version
137       info does not interfere with the {MIN,MAX}_PROTOCOL_VERSION checking
138       in older versions (which would be the case if every minor change made
139       to the protocol in CVS incremented the main PROTOCOL_VERSION value).