1 This patch provides --flags, which preserves the st_flags field.
2 Modified from a patch that was written by Rolf Grossmann.
4 To use this patch, run these commands for a successful build:
6 patch -p1 <patches/flags.diff
13 @@ -549,7 +549,7 @@ AC_CHECK_FUNCS(waitpid wait4 getcwd strd
14 memmove lchown vsnprintf snprintf vasprintf asprintf setsid glob strpbrk \
15 strlcat strlcpy strtol mallinfo getgroups setgroups geteuid getegid \
16 setlocale setmode open64 lseek64 mkstemp64 mtrace va_copy __va_copy \
17 - strerror putenv iconv_open locale_charset nl_langinfo \
18 + chflags strerror putenv iconv_open locale_charset nl_langinfo \
19 sigaction sigprocmask)
21 AC_CHECK_FUNCS(getpgrp tcgetpgrp)
24 @@ -44,6 +44,7 @@ extern int preserve_links;
25 extern int preserve_hard_links;
26 extern int preserve_devices;
27 extern int preserve_specials;
28 +extern int preserve_flags;
29 extern int preserve_uid;
30 extern int preserve_gid;
31 extern int relative_paths;
32 @@ -305,6 +306,9 @@ static void send_file_entry(struct file_
34 static time_t modtime;
37 + static uint32 fileflags;
41 static uint32 rdev_major;
42 @@ -335,6 +339,12 @@ static void send_file_entry(struct file_
43 flags |= XMIT_SAME_MODE;
47 + if (file->fileflags == fileflags)
48 + flags |= XMIT_SAME_FLAGS;
50 + fileflags = file->fileflags;
52 if ((preserve_devices && IS_DEVICE(mode))
53 || (preserve_specials && IS_SPECIAL(mode))) {
54 if (protocol_version < 28) {
55 @@ -418,6 +428,10 @@ static void send_file_entry(struct file_
56 write_int(f, modtime);
57 if (!(flags & XMIT_SAME_MODE))
58 write_int(f, to_wire_mode(mode));
60 + if (preserve_flags && !(flags & XMIT_SAME_FLAGS))
61 + write_int(f, (int)fileflags);
63 if (preserve_uid && !(flags & XMIT_SAME_UID)) {
66 @@ -485,6 +499,9 @@ static struct file_struct *receive_file_
68 static time_t modtime;
71 + static uint32 fileflags;
75 static uint32 rdev_major;
76 @@ -558,9 +575,12 @@ static struct file_struct *receive_file_
77 modtime = (time_t)read_int(f);
78 if (!(flags & XMIT_SAME_MODE))
79 mode = from_wire_mode(read_int(f));
81 if (chmod_modes && !S_ISLNK(mode))
82 mode = tweak_mode(mode, chmod_modes);
84 + if (preserve_flags && !(flags & XMIT_SAME_FLAGS))
85 + fileflags = (uint32)read_int(f);
88 if (preserve_uid && !(flags & XMIT_SAME_UID))
89 uid = (uid_t)read_int(f);
90 @@ -611,6 +631,9 @@ static struct file_struct *receive_file_
91 file->modtime = modtime;
92 file->length = file_length;
95 + file->fileflags = fileflags;
100 @@ -871,6 +894,9 @@ struct file_struct *make_file(char *fnam
101 file->modtime = st.st_mtime;
102 file->length = st.st_size;
103 file->mode = st.st_mode;
104 +#ifdef SUPPORT_FLAGS
105 + file->fileflags = st.st_flags;
107 file->uid = st.st_uid;
108 file->gid = st.st_gid;
112 @@ -99,6 +99,12 @@ int non_perishable_cnt = 0;
113 static int deletion_count = 0; /* used to implement --max-delete */
114 static FILE *delete_delay_fp = NULL;
116 +#ifdef SUPPORT_FLAGS
117 +#define FILEFLAGS(ff) ff
119 +#define FILEFLAGS(ff) 0
122 /* For calling delete_item() and delete_dir_contents(). */
123 #define DEL_RECURSE (1<<1) /* recurse */
124 #define DEL_DIR_IS_EMPTY (1<<2) /* internal delete_FUNCTIONS use only */
125 @@ -114,7 +120,6 @@ enum delret {
126 /* Forward declaration for delete_item(). */
127 static enum delret delete_dir_contents(char *fname, int flags);
130 static int is_backup_file(char *fn)
132 int k = strlen(fn) - backup_suffix_len;
133 @@ -127,17 +132,20 @@ static int is_backup_file(char *fn)
134 * Note that fbuf must point to a MAXPATHLEN buffer if the mode indicates it's
135 * a directory! (The buffer is used for recursion, but returned unchanged.)
137 -static enum delret delete_item(char *fbuf, int mode, char *replace, int flags)
138 +static enum delret delete_item(char *fbuf, int mode, uint32 fileflags, char *replace, int flags)
145 - rprintf(FINFO, "delete_item(%s) mode=%o flags=%d\n",
146 - fbuf, mode, flags);
147 + rprintf(FINFO, "delete_item(%s) mode=%o fileflags=%o flags=%d\n",
148 + fbuf, mode, fileflags, flags);
151 +#ifdef SUPPORT_FLAGS
152 + make_mutable(fbuf, mode, fileflags);
154 if (S_ISDIR(mode) && !(flags & DEL_DIR_IS_EMPTY)) {
155 ignore_perishable = 1;
156 /* If DEL_RECURSE is not set, this just reports emptiness. */
157 @@ -249,7 +257,7 @@ static enum delret delete_dir_contents(c
158 if (S_ISDIR(fp->mode)
159 && delete_dir_contents(fname, flags | DEL_RECURSE) != DR_SUCCESS)
161 - if (delete_item(fname, fp->mode, NULL, flags) != DR_SUCCESS)
162 + if (delete_item(fname, fp->mode, FILEFLAGS(fp->fileflags), NULL, flags) != DR_SUCCESS)
166 @@ -401,10 +409,10 @@ static void delete_in_dir(struct file_li
168 if (flist_find(flist, fp) < 0) {
170 - if (delete_delay_fp)
171 + if (delete_delay_fp) /* XXX need to output fileflags value here too */
172 fprintf(delete_delay_fp, "%o %s%c", fp->mode, delbuf, '\0');
174 - delete_item(delbuf, fp->mode, NULL, DEL_RECURSE);
175 + delete_item(delbuf, fp->mode, FILEFLAGS(fp->fileflags), NULL, DEL_RECURSE);
179 @@ -1103,7 +1111,7 @@ static void recv_generator(char *fname,
180 * we need to delete it. If it doesn't exist, then
181 * (perhaps recursively) create it. */
182 if (statret == 0 && !S_ISDIR(st.st_mode)) {
183 - if (delete_item(fname, st.st_mode, "directory", del_opts) != 0)
184 + if (delete_item(fname, st.st_mode, FILEFLAGS(st.st_flags), "directory", del_opts) != 0)
188 @@ -1197,7 +1205,7 @@ static void recv_generator(char *fname,
190 /* Not the right symlink (or not a symlink), so
192 - if (delete_item(fname, st.st_mode, "symlink", del_opts) != 0)
193 + if (delete_item(fname, st.st_mode, FILEFLAGS(st.st_flags), "symlink", del_opts) != 0)
195 } else if (basis_dir[0] != NULL) {
196 int j = try_dests_non(file, fname, ndx, fnamecmpbuf, &st,
197 @@ -1268,7 +1276,7 @@ static void recv_generator(char *fname,
198 goto return_with_success;
201 - if (delete_item(fname, st.st_mode, t, del_opts) != 0)
202 + if (delete_item(fname, st.st_mode, FILEFLAGS(st.st_flags), t, del_opts) != 0)
204 } else if (basis_dir[0] != NULL) {
205 int j = try_dests_non(file, fname, ndx, fnamecmpbuf, &st,
206 @@ -1354,7 +1362,7 @@ static void recv_generator(char *fname,
207 fnamecmp_type = FNAMECMP_FNAME;
209 if (statret == 0 && !S_ISREG(st.st_mode)) {
210 - if (delete_item(fname, st.st_mode, "regular file", del_opts) != 0)
211 + if (delete_item(fname, st.st_mode, FILEFLAGS(st.st_flags), "regular file", del_opts) != 0)
217 @@ -48,6 +48,7 @@ int copy_links = 0;
218 int preserve_links = 0;
219 int preserve_hard_links = 0;
220 int preserve_perms = 0;
221 +int preserve_flags = 0;
222 int preserve_executability = 0;
223 int preserve_devices = 0;
224 int preserve_specials = 0;
225 @@ -201,6 +202,7 @@ static void print_rsync_version(enum log
226 char const *hardlinks = "no ";
227 char const *links = "no ";
228 char const *ipv6 = "no ";
229 + char const *flags = "no ";
230 STRUCT_STAT *dumstat;
232 #ifdef HAVE_SOCKETPAIR
233 @@ -223,6 +225,10 @@ static void print_rsync_version(enum log
237 +#ifdef SUPPORT_FLAGS
241 rprintf(f, "%s version %s protocol version %d\n",
242 RSYNC_NAME, RSYNC_VERSION, PROTOCOL_VERSION);
243 rprintf(f, "Copyright (C) 1996-2006 by Andrew Tridgell, Wayne Davison, and others.\n");
244 @@ -235,9 +241,9 @@ static void print_rsync_version(enum log
245 /* Note that this field may not have type ino_t. It depends
246 * on the complicated interaction between largefile feature
248 - rprintf(f, " %sinplace, %sIPv6, "
249 + rprintf(f, " %sinplace, %sIPv6, %sfile flags, "
250 "%d-bit system inums, %d-bit internal inums\n",
251 - have_inplace, ipv6,
252 + have_inplace, ipv6, flags,
253 (int) (sizeof dumstat->st_ino * 8),
254 (int) (sizeof (int64) * 8));
255 #ifdef MAINTAINER_MODE
256 @@ -304,6 +310,7 @@ void usage(enum logcode F)
257 rprintf(F," -K, --keep-dirlinks treat symlinked dir on receiver as dir\n");
258 rprintf(F," -H, --hard-links preserve hard links\n");
259 rprintf(F," -p, --perms preserve permissions\n");
260 + rprintf(F," --flags preserve file flags\n");
261 rprintf(F," -E, --executability preserve the file's executability\n");
262 rprintf(F," --chmod=CHMOD affect file and/or directory permissions\n");
263 rprintf(F," -o, --owner preserve owner (super-user only)\n");
264 @@ -425,6 +432,8 @@ static struct poptOption long_options[]
265 {"perms", 'p', POPT_ARG_VAL, &preserve_perms, 1, 0, 0 },
266 {"no-perms", 0, POPT_ARG_VAL, &preserve_perms, 0, 0, 0 },
267 {"no-p", 0, POPT_ARG_VAL, &preserve_perms, 0, 0, 0 },
268 + {"flags", 0, POPT_ARG_VAL, &preserve_flags, 1, 0, 0 },
269 + {"no-flags", 0, POPT_ARG_VAL, &preserve_flags, 0, 0, 0 },
270 {"executability", 'E', POPT_ARG_NONE, &preserve_executability, 0, 0, 0 },
271 {"times", 't', POPT_ARG_VAL, &preserve_times, 1, 0, 0 },
272 {"no-times", 0, POPT_ARG_VAL, &preserve_times, 0, 0, 0 },
273 @@ -1130,6 +1139,15 @@ int parse_arguments(int *argc, const cha
277 +#ifndef SUPPORT_FLAGS
278 + if (preserve_flags) {
279 + snprintf(err_buf, sizeof err_buf,
280 + "file flags are not supported on this %s\n",
281 + am_server ? "server" : "client");
286 if (write_batch && read_batch) {
287 snprintf(err_buf, sizeof err_buf,
288 "--write-batch and --read-batch can not be used together\n");
289 @@ -1584,6 +1602,9 @@ void server_options(char **args,int *arg
290 if (xfer_dirs && !recurse && delete_mode && am_sender)
291 args[ac++] = "--no-r";
293 + if (preserve_flags)
294 + args[ac++] = "--flags";
296 if (do_compression && def_compress_level != Z_DEFAULT_COMPRESSION) {
297 if (asprintf(&arg, "--compress-level=%d", def_compress_level) < 0)
302 #include <langinfo.h>
305 +#define NOCHANGE_FLAGS (UF_IMMUTABLE|UF_APPEND|UF_NOUNLINK|SF_IMMUTABLE|SF_APPEND|SF_NOUNLINK)
309 extern int preserve_perms;
310 +extern int preserve_flags;
311 extern int preserve_executability;
312 extern int preserve_times;
313 extern int omit_dir_times;
314 @@ -123,6 +126,41 @@ mode_t dest_mode(mode_t flist_mode, mode
318 +#ifdef SUPPORT_FLAGS
319 +/* Set a file's st_flags. */
320 +static int set_fileflags(const char *fname, uint32 fileflags)
322 + if (do_chflags(fname, fileflags) != 0) {
323 + rsyserr(FERROR, errno,
324 + "failed to set file flags on %s",
325 + full_fname(fname));
332 +/* Remove immutable flags from an object, so it can be altered/removed. */
333 +void make_mutable(char *fname, mode_t mode, uint32 fileflags)
335 + if (!preserve_flags && S_ISLNK(mode))
338 + if (fileflags & NOCHANGE_FLAGS)
339 + set_fileflags(fname, fileflags & ~NOCHANGE_FLAGS);
342 +/* Undo a prior make_mutable() call. */
343 +void undo_make_mutable(char *fname, mode_t mode, uint32 fileflags)
345 + if (!preserve_flags && S_ISLNK(mode))
348 + if (fileflags & NOCHANGE_FLAGS)
349 + set_fileflags(fname, fileflags);
353 int set_file_attrs(char *fname, struct file_struct *file, STRUCT_STAT *st,
356 @@ -221,6 +259,15 @@ int set_file_attrs(char *fname, struct f
360 +#ifdef SUPPORT_FLAGS
361 + if (preserve_flags && !S_ISLNK(st->st_mode)
362 + && st->st_flags != file->fileflags) {
363 + if (!set_fileflags(fname, file->fileflags))
369 if (verbose > 1 && flags & ATTRS_REPORT) {
371 rprintf(FCLIENT, "%s\n", fname);
372 @@ -268,6 +315,9 @@ void finish_transfer(char *fname, char *
373 set_file_attrs(fnametmp, file, NULL,
374 ok_to_set_time ? 0 : ATTRS_SKIP_MTIME);
376 +#ifdef SUPPORT_FLAGS
377 + make_mutable(fnametmp, file->mode, file->fileflags);
379 /* move tmp file over real file */
381 rprintf(FINFO, "renaming %s to %s\n", fnametmp, fname);
382 @@ -282,6 +332,9 @@ void finish_transfer(char *fname, char *
385 /* The file was moved into place (not copied), so it's done. */
386 +#ifdef SUPPORT_FLAGS
387 + undo_make_mutable(fname, file->mode, file->fileflags);
391 /* The file was copied, so tweak the perms of the copied file. If it
395 #define XMIT_HAS_IDEV_DATA (1<<9)
396 #define XMIT_SAME_DEV (1<<10)
397 #define XMIT_RDEV_MINOR_IS_SMALL (1<<11)
398 +#define XMIT_SAME_FLAGS (1<<12)
400 /* These flags are used in the live flist data. */
402 @@ -345,6 +346,10 @@ enum msgcode {
407 +#define SUPPORT_FLAGS 1
410 /* Find a variable that is either exactly 32-bits or longer.
411 * If some code depends on 32-bit truncation, it will need to
412 * take special action in a "#if SIZEOF_INT32 > 4" section. */
413 @@ -528,6 +533,9 @@ struct file_struct {
417 +#ifdef SUPPORT_FLAGS
425 @@ -321,6 +321,7 @@ to the detailed description below for a
426 -K, --keep-dirlinks treat symlinked dir on receiver as dir
427 -H, --hard-links preserve hard links
428 -p, --perms preserve permissions
429 + --flags preserve file flags
430 -E, --executability preserve executability
431 --chmod=CHMOD affect file and/or directory permissions
432 -o, --owner preserve owner (super-user only)
433 @@ -510,7 +511,9 @@ specified, in which case bf(-r) is not i
435 Note that bf(-a) bf(does not preserve hardlinks), because
436 finding multiply-linked files is expensive. You must separately
438 +specify bf(-H). Note also that for compatibility, bf(-a)
439 +currently bf(does not include --flags) (see there) to include preserving
440 +change file flags (if supported by the OS).
442 dit(--no-OPTION) You may turn off one or more implied options by prefixing
443 the option name with "no-". Not all options may be prefixed with a "no-":
444 @@ -805,6 +808,13 @@ quote(itemization(
446 If bf(--perms) is enabled, this option is ignored.
448 +dit(bf(--flags)) This option causes rsync to update the change file flags
449 +to be the same as the source file, if your OS supports the bf(chflags)(2)
450 +system call. In any case, an attempt is made to remove flags that would
451 +prevent a file to be altered. Some flags can only be altered by the
452 +super-user and can only be unset below a certain secure-level (usually
455 dit(bf(--chmod)) This option tells rsync to apply one or more
456 comma-separated "chmod" strings to the permission of the files in the
457 transfer. The resulting value is treated as though it was the permissions
460 @@ -153,6 +153,15 @@ int do_chmod(const char *path, mode_t mo
464 +#ifdef SUPPORT_FLAGS
465 +int do_chflags(const char *path, u_long flags)
467 + if (dry_run) return 0;
468 + RETURN_ERROR_IF_RO_OR_LO;
469 + return chflags(path, flags);
473 int do_rename(const char *fname1, const char *fname2)
475 if (dry_run) return 0;