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