Mention the latest improvements.
[rsync/rsync.git] / NEWS
1 NEWS for rsync 2.6.7 (UNRELEASED)
2 Protocol: 29 (unchanged)
3 Changes since 2.6.6:
4
5   OUTPUT CHANGES:
6
7     - The itemized output now uses 'S' for a special file instead of
8       clumping them together with the 'D' for devices.  The number of
9       characters is also different (to remove an unused field).
10
11   BUG FIXES:
12
13     - Fixed a really old bug that caused --checksum (-c) to checksum all the
14       files encountered during the delete scan (ouch).
15
16     - Made hard-links work with symlinks and devices again.
17
18     - If a device-file/special-file changes permissions, rsync now updates the
19       permissions without recreating the file.
20
21     - If the user specifies a remote-host for both the source and destination,
22       we now output a syntax error rather than trying to open the destination
23       hostspec as a filename.
24
25     - When --inplace creates a new destination file, rsync now creates it with
26       permissions 0600 instead of 0000 -- this makes restarting possible when
27       the transfer gets interrupted in the middle of sending a new file.
28
29     - Reject the combination of --inplace and --sparse since the sparse-output
30       algorithm doesn't work when overwriting existing data.
31
32     - Fixed the directory name in the error that is output when pop_dir()
33       fails.
34
35     - Really fixed the parsing of a "!" entry in .cvsignore files this time.
36
37     - If the generator gets a stat() error on a file, output it (this used to
38       require at least -vv for the error to be seen).
39
40     - If waitpid() fails or the child rsync didn't exit cleanly, we now handle
41       the exit status properly and generate a better error.
42
43     - Fixed some glitches in the double-verbose output when using --copy-dest,
44       --link-dest, or --compare-dest.
45
46     - Fixed the matching of the dont-compress items (e.g. *.gz) against files
47       that have a path component containing a slash.
48
49     - If code reading a filter/exclude file an EINTR error, rsync now clears
50       the error flag on the file handle so it can keep on reading.
51
52     - If --relative is active, the sending side cleans up trailing "/" or "/."
53       suffixes to avoid triggering a bug in older rsync versions.  Also, we now
54       reject a ".." dir if it would be sent as a relative dir.
55
56     - If a non-directory is in the way of a directory and rsync is run with
57       --dry-run and --delete, rsync no longer complains about not being
58       able to opendir() the not-yet present directory.
59
60     - Got rid of the need for --force to be used in some circumstances with
61       --delete-after (making it consistent with --delete-before/-during).
62
63   ENHANCEMENTS:
64
65     - Added the --specials option to tell rsync to copy special files (and does
66       not require root).  The --devices option now affects just character and
67       block devices (which now matches the documentation).  The -D option still
68       requests both --devices and --specials, and -a still implies -D.
69
70     - Added the --append option that makes rsync append data onto files
71       that are longer on the source than the destination (this includes new
72       files).
73
74     - Added the --min-size=SIZE option to exclude small files from the
75       transfer.
76
77     - Added the --compress-level option to allow you to set how aggressive
78       rsync's compression should be (this option implies --compress).
79
80     - Enhanced the parsing of the SIZE value for --min-size and --max-size
81       to allow easy entry of multiples of 1000 (instead of just multiples
82       of 1024) and off-by-one values too (e.g. --max-size=8mb-1).
83
84     - The options --human-readable (-h) and --si change the output of the
85       --stats and the end-of-run summary to be easier to read.
86
87     - If lutimes() and/or lchmod() are around, use them to allow the
88       preservation of attributes on symlinks.
89
90     - The --link-dest option now affects symlinks and devices (when
91       possible).
92
93     - Improved the output of hard-linked and copied files when using
94       --link-dest, --copy-dest, or --compare-dest.
95
96     - Added two config items to the rsyncd.conf parsing:  "pre-xfer exec"
97       and "post-xfer exec".  These allow a command to be specified on a
98       per-module basis that will be run before and/or after a daemon-mode
99       transfer.  (See the manpage for a list of the environment variables
100       that are set with information about the transfer.)
101
102     - When using the --relative option, you can now insert a dot dir in
103       the source path to indicate where the replication of the source dirs
104       should start.  For example, if you specify a source path of
105       rsync://host/module/foo/bar/./baz/dir with -R, rsync will now only
106       replicate the "baz/dir" part of the source path (note: a trailing
107       dot dir is unaffected unless it also has a trailing slash).
108
109     - Added some new --no-FOO options that make it easier to override
110       unwanted implied or default options.  For example, "-a --no-o" (aka
111       "--archive --no-owner") can be used to turn off the preservation of
112       file ownership that is implied by -a.
113
114     - Added the --chmod=MODE option that allows the destination permissions
115       to be changed from the source permissions.  E.g. --chmod=g+w,o-rwx
116
117     - Added the "incoming chmod" daemon option to allow a module to specify
118       what permissions changes should be applied to all files copied to the
119       daemon.
120
121     - Allow the --temp-dir option to be specified when starting a daemon,
122       which sets the default temporary directory for incoming files.
123
124     - If --delete is combined with --dirs without --recursive, rsync will
125       now delete in any directory whose content is being synchronized.
126
127     - If --backup is combined with --delete without --backup-dir (and
128       without --delete-excluded), we add a "protect" filter-rule to ensure
129       that files with the backup suffix are not deleted.
130
131     - The file-count stats that are output by --progress were improved to
132       better indicate what the numbers mean.  For instance, the output:
133       "(xfer#5, to-check=8383/9999)" indicates that this was the fifth file
134       to be transferred, and we still need to check 8383 more files out of
135       a total of 9999.
136
137     - The include/exclude code now allows a dir/*** directive (with 3
138       trailing stars) to match both the dir itself as well as all the
139       content below the dir (dir/** would not match the dir).
140
141     - Added the --prune-empty-dirs (-m) option that makes the receiving
142       rsync discard empty chains of directories from the file-list.  This
143       makes it easier to selectively copy files from a source hierarchy and
144       end up with just the directories needed to hold the resulting files.
145
146     - If the --itemize-changes (-i) option is repeated, rsync now includes
147       unchanged files in the itemized output (similar to -vv, but without
148       all the other verbose messages that can get in the way).  Of course,
149       the client must be version 2.6.7 for this to work, but the remote
150       rsync only needs to be 2.6.7 if you're pushing files.
151
152     - Added the --super option to make the receiver always attempt super-
153       user activities.  This is useful for systems that allow things such
154       as devices to be created or ownership to be set without being UID 0,
155       and is also useful for someone who wants to ensure that errors will
156       be output if the receiving rsync isn't being run as root.
157
158     - Added the --sockopts option for those few who want to customize the
159       TCP options used to contact a daemon rsync.
160
161     - Added a way for the --temp-dir option to be combined with a partial-dir
162       setting that lets rsync avoid non-atomic updates (for those times when
163       --temp-dir is not being used because space is tight).
164
165     - Some minor documentation improvements.
166
167     - Updated some diffs in the patches dir.
168
169   INTERNAL:
170
171     - Some buffer sizes were expanded a bit, particularly on systems where
172       MAXPATHLEN is overly small (e.g. cygwin).
173
174     - If io_printf() tries to format more data than fits in the buffer, exit
175       with an error instead of transmitting a truncated buffer.
176
177     - If a va_copy macro is defined, lib/snprintf.c will use it when defining
178       the VA_COPY macro.
179
180     - Reduced the amount of stack memory needed for each level of directory
181       recursion by nearly MAXPATHLEN bytes.
182
183     - The wildmatch function was extended to allow an array of strings to
184       be supplied as the string to match.  This allows the exclude code to
185       do less string copying.
186
187     - Got rid of the safe_fname() function (and all the myriad calls) and
188       replaced it with a new function in the log.c code that filters all
189       the output going to the terminal.
190
191     - Unified the f_name() and the f_name_to() functions.
192
193   DEVELOPER RELATED:
194
195     - Several diffs in the patches dir now use the proper --enable-FOO
196       configure option instead of --with-FOO to turn on the inclusion of
197       the newly patched feature.
198
199     - The testsuite now sets HOME so that it won't be affecting by a file
200       such as ~/.popt.