cbe698902250aee71c6d65eba3ce1ee9b36c6c08
[rsync-patches.git] / flags.diff
1 This patch provides --fileflags, which preserves the st_flags stat() field.
2 Modified from a patch that was written by Rolf Grossmann.
3
4 To use this patch, run these commands for a successful build:
5
6     patch -p1 <patches/flags.diff
7     ./prepare-source
8     ./configure
9     make
10
11 diff --git a/compat.c b/compat.c
12 --- a/compat.c
13 +++ b/compat.c
14 @@ -44,6 +44,7 @@ extern int protocol_version;
15  extern int protect_args;
16  extern int preserve_uid;
17  extern int preserve_gid;
18 +extern int preserve_fileflags;
19  extern int preserve_acls;
20  extern int preserve_xattrs;
21  extern int need_messages_from_generator;
22 @@ -60,7 +61,7 @@ extern iconv_t ic_send, ic_recv;
23  #endif
24  
25  /* These index values are for the file-list's extra-attribute array. */
26 -int uid_ndx, gid_ndx, acls_ndx, xattrs_ndx, unsort_ndx;
27 +int uid_ndx, gid_ndx, fileflags_ndx, acls_ndx, xattrs_ndx, unsort_ndx;
28  
29  int receiver_symlink_times = 0; /* receiver can set the time on a symlink */
30  
31 @@ -134,6 +135,8 @@ void setup_protocol(int f_out,int f_in)
32                 uid_ndx = ++file_extra_cnt;
33         if (preserve_gid)
34                 gid_ndx = ++file_extra_cnt;
35 +       if (preserve_fileflags)
36 +               fileflags_ndx = ++file_extra_cnt;
37         if (preserve_acls && !am_sender)
38                 acls_ndx = ++file_extra_cnt;
39         if (preserve_xattrs)
40 diff --git a/configure.in b/configure.in
41 --- a/configure.in
42 +++ b/configure.in
43 @@ -551,7 +551,7 @@ AC_CHECK_FUNCS(waitpid wait4 getcwd strdup chown chmod lchmod mknod mkfifo \
44      memmove lchown vsnprintf snprintf vasprintf asprintf setsid glob strpbrk \
45      strlcat strlcpy strtol mallinfo getgroups setgroups geteuid getegid \
46      setlocale setmode open64 lseek64 mkstemp64 mtrace va_copy __va_copy \
47 -    strerror putenv iconv_open locale_charset nl_langinfo getxattr \
48 +    chflags strerror putenv iconv_open locale_charset nl_langinfo getxattr \
49      extattr_get_link sigaction sigprocmask setattrlist)
50  
51  dnl cygwin iconv.h defines iconv_open as libiconv_open
52 diff --git a/flist.c b/flist.c
53 --- a/flist.c
54 +++ b/flist.c
55 @@ -50,6 +50,7 @@ extern int preserve_links;
56  extern int preserve_hard_links;
57  extern int preserve_devices;
58  extern int preserve_specials;
59 +extern int fileflags_ndx;
60  extern int uid_ndx;
61  extern int gid_ndx;
62  extern int eol_nulls;
63 @@ -344,6 +345,9 @@ static void send_file_entry(int f, struct file_struct *file, int ndx, int first_
64  {
65         static time_t modtime;
66         static mode_t mode;
67 +#ifdef SUPPORT_FLAGS
68 +       static uint32 fileflags;
69 +#endif
70  #ifdef SUPPORT_HARD_LINKS
71         static int64 dev;
72  #endif
73 @@ -403,6 +407,14 @@ static void send_file_entry(int f, struct file_struct *file, int ndx, int first_
74                 xflags |= XMIT_SAME_MODE;
75         else
76                 mode = file->mode;
77 +#ifdef SUPPORT_FLAGS
78 +       if (fileflags_ndx) {
79 +               if (F_FFLAGS(file) == fileflags)
80 +                       xflags |= XMIT_SAME_FLAGS;
81 +               else
82 +                       fileflags = F_FFLAGS(file);
83 +       }
84 +#endif
85  
86         if ((preserve_devices && IS_DEVICE(mode))
87          || (preserve_specials && IS_SPECIAL(mode))) {
88 @@ -522,6 +534,10 @@ static void send_file_entry(int f, struct file_struct *file, int ndx, int first_
89         }
90         if (!(xflags & XMIT_SAME_MODE))
91                 write_int(f, to_wire_mode(mode));
92 +#ifdef SUPPORT_FLAGS
93 +       if (fileflags_ndx && !(xflags & XMIT_SAME_FLAGS))
94 +               write_int(f, (int)fileflags);
95 +#endif
96         if (uid_ndx && !(xflags & XMIT_SAME_UID)) {
97                 if (protocol_version < 30)
98                         write_int(f, uid);
99 @@ -610,6 +626,9 @@ static struct file_struct *recv_file_entry(struct file_list *flist,
100  {
101         static int64 modtime;
102         static mode_t mode;
103 +#ifdef SUPPORT_FLAGS
104 +       static uint32 fileflags;
105 +#endif
106  #ifdef SUPPORT_HARD_LINKS
107         static int64 dev;
108  #endif
109 @@ -744,6 +763,10 @@ static struct file_struct *recv_file_entry(struct file_list *flist,
110  
111         if (chmod_modes && !S_ISLNK(mode))
112                 mode = tweak_mode(mode, chmod_modes);
113 +#ifdef SUPPORT_FLAGS
114 +       if (fileflags_ndx && !(xflags & XMIT_SAME_FLAGS))
115 +               fileflags = (uint32)read_int(f);
116 +#endif
117  
118         if (uid_ndx && !(xflags & XMIT_SAME_UID)) {
119                 if (protocol_version < 30)
120 @@ -865,6 +888,10 @@ static struct file_struct *recv_file_entry(struct file_list *flist,
121                 OPT_EXTRA(file, 0)->unum = (uint32)(file_length >> 32);
122         }
123         file->mode = mode;
124 +#ifdef SUPPORT_FLAGS
125 +       if (fileflags_ndx)
126 +               F_FFLAGS(file) = fileflags;
127 +#endif
128         if (uid_ndx)
129                 F_OWNER(file) = uid;
130         if (gid_ndx) {
131 @@ -1199,6 +1226,10 @@ struct file_struct *make_file(const char *fname, struct file_list *flist,
132                 OPT_EXTRA(file, 0)->unum = (uint32)(st.st_size >> 32);
133         }
134         file->mode = st.st_mode;
135 +#ifdef SUPPORT_FLAGS
136 +       if (fileflags_ndx)
137 +               F_FFLAGS(file) = st.st_flags;
138 +#endif
139         if (uid_ndx)
140                 F_OWNER(file) = st.st_uid;
141         if (gid_ndx)
142 diff --git a/generator.c b/generator.c
143 --- a/generator.c
144 +++ b/generator.c
145 @@ -124,6 +124,7 @@ static const char *solo_file = NULL;
146  #define DEL_FOR_SYMLINK        (1<<5) /* making room for a replacement symlink */
147  #define DEL_FOR_DEVICE         (1<<6) /* making room for a replacement device */
148  #define DEL_FOR_SPECIAL        (1<<7) /* making room for a replacement special */
149 +#define DEL_AN_IMMUTABLE       (1<<8) /* item has an immutable flag set */
150  
151  #define DEL_MAKE_ROOM (DEL_FOR_FILE|DEL_FOR_DIR|DEL_FOR_SYMLINK|DEL_FOR_DEVICE|DEL_FOR_SPECIAL)
152  
153 @@ -163,6 +164,10 @@ static enum delret delete_item(char *fbuf, int mode, int flags)
154  
155         if (!am_root && !(mode & S_IWUSR) && flags & DEL_OWNED_BY_US)
156                 do_chmod(fbuf, mode |= S_IWUSR);
157 +#ifdef SUPPORT_FLAGS
158 +       if (fileflags_ndx && flags & DEL_AN_IMMUTABLE)
159 +               make_mutable(fbuf, mode, NODELETE_FLAGS);
160 +#endif
161  
162         if (S_ISDIR(mode) && !(flags & DEL_DIR_IS_EMPTY)) {
163                 ignore_perishable = 1;
164 @@ -284,6 +289,14 @@ static enum delret delete_dir_contents(char *fname, int flags)
165                         flags |= DEL_OWNED_BY_US;
166                 else
167                         flags &= ~DEL_OWNED_BY_US;
168 +#ifdef SUPPORT_FLAGS
169 +               if (fileflags_ndx) {
170 +                       if (F_FFLAGS(fp) & NODELETE_FLAGS)
171 +                               flags |= DEL_AN_IMMUTABLE;
172 +                       else
173 +                               flags &= ~DEL_AN_IMMUTABLE;
174 +               }
175 +#endif 
176                 /* Save stack by recursing to ourself directly. */
177                 if (S_ISDIR(fp->mode)) {
178                         if (!am_root && !(fp->mode & S_IWUSR) && flags & DEL_OWNED_BY_US)
179 @@ -343,15 +356,22 @@ static int flush_delete_delay(void)
180  
181  static int remember_delete(struct file_struct *file, const char *fname, int flags)
182  {
183 -       const char *plus = (!am_root && !(file->mode & S_IWUSR) && flags & DEL_OWNED_BY_US)
184 -                        ? "+" : "";
185 +       char buf[16], *bp = buf;
186         int len;
187  
188 +       if (!am_root && !(file->mode & S_IWUSR) && flags & DEL_OWNED_BY_US)
189 +               *bp++ = '+';
190 +#ifdef SUPPORT_FLAGS
191 +       if (flags & DEL_AN_IMMUTABLE)
192 +               *bp++ = '-';
193 +#endif
194 +       *bp = '\0';
195 +
196         while (1) {
197                 len = snprintf(deldelay_buf + deldelay_cnt,
198                                deldelay_size - deldelay_cnt,
199                                "%s%x %s%c",
200 -                              plus, (int)file->mode, fname, '\0');
201 +                              buf, (int)file->mode, fname, '\0');
202                 if ((deldelay_cnt += len) <= deldelay_size)
203                         break;
204                 if (deldelay_fd < 0 && !start_delete_delay_temp())
205 @@ -364,10 +384,10 @@ static int remember_delete(struct file_struct *file, const char *fname, int flag
206         return 1;
207  }
208  
209 -static int read_delay_line(char *buf, int *own_flag_p)
210 +static int read_delay_line(char *buf, int *flags_p)
211  {
212         static int read_pos = 0;
213 -       int j, len, mode;
214 +       int j, len, mode, flags = 0;
215         char *bp, *past_space;
216  
217         while (1) {
218 @@ -407,9 +427,15 @@ static int read_delay_line(char *buf, int *own_flag_p)
219         bp = deldelay_buf + read_pos;
220         if (*bp == '+') {
221                 bp++;
222 -               *own_flag_p = DEL_OWNED_BY_US;
223 -       } else
224 -               *own_flag_p = 0;
225 +               flags |= DEL_OWNED_BY_US;
226 +       }
227 +#ifdef SUPPORT_FLAGS
228 +       if (*bp == '-') {
229 +               bp++;
230 +               flags |= DEL_AN_IMMUTABLE;
231 +       }
232 +#endif
233 +       *flags_p = flags;
234  
235         if (sscanf(bp, "%x ", &mode) != 1) {
236           invalid_data:
237 @@ -434,15 +460,15 @@ static int read_delay_line(char *buf, int *own_flag_p)
238  
239  static void do_delayed_deletions(char *delbuf)
240  {
241 -       int mode, own_flag;
242 +       int mode, flags;
243  
244         if (deldelay_fd >= 0) {
245                 if (deldelay_cnt && !flush_delete_delay())
246                         return;
247                 lseek(deldelay_fd, 0, 0);
248         }
249 -       while ((mode = read_delay_line(delbuf, &own_flag)) >= 0)
250 -               delete_item(delbuf, mode, own_flag | DEL_RECURSE);
251 +       while ((mode = read_delay_line(delbuf, &flags)) >= 0)
252 +               delete_item(delbuf, mode, DEL_RECURSE | flags);
253         if (deldelay_fd >= 0)
254                 close(deldelay_fd);
255  }
256 @@ -505,6 +531,9 @@ static void delete_in_dir(char *fbuf, struct file_struct *file, dev_t *fs_dev)
257                 }
258                 if (flist_find(cur_flist, fp) < 0) {
259                         int flags = DEL_RECURSE
260 +#ifdef SUPPORT_FLAGS
261 +                                 | (fileflags_ndx && F_FFLAGS(fp) & NODELETE_FLAGS ? DEL_AN_IMMUTABLE : 0)
262 +#endif
263                                   | (!uid_ndx || (uid_t)F_OWNER(fp) == our_uid ? DEL_OWNED_BY_US : 0);
264                         f_name(fp, delbuf);
265                         if (delete_during == 2) {
266 @@ -1329,6 +1358,10 @@ static void recv_generator(char *fname, struct file_struct *file, int ndx,
267  
268         if (statret == 0 && sx.st.st_uid == our_uid)
269                 del_opts |= DEL_OWNED_BY_US;
270 +#ifdef SUPPORT_FLAGS
271 +       if (statret == 0 && fileflags_ndx && sx.st.st_flags & NODELETE_FLAGS)
272 +               del_opts |= DEL_AN_IMMUTABLE;
273 +#endif
274  
275         if (is_dir) {
276                 if (!implied_dirs && file->flags & FLAG_IMPLIED_DIR)
277 diff --git a/options.c b/options.c
278 --- a/options.c
279 +++ b/options.c
280 @@ -52,6 +52,7 @@ int preserve_hard_links = 0;
281  int preserve_acls = 0;
282  int preserve_xattrs = 0;
283  int preserve_perms = 0;
284 +int preserve_fileflags = 0;
285  int preserve_executability = 0;
286  int preserve_devices = 0;
287  int preserve_specials = 0;
288 @@ -224,6 +225,7 @@ static void print_rsync_version(enum logcode f)
289         char const *links = "no ";
290         char const *iconv = "no ";
291         char const *ipv6 = "no ";
292 +       char const *fileflags = "no ";
293         STRUCT_STAT *dumstat;
294  
295  #if SUBPROTOCOL_VERSION != 0
296 @@ -256,6 +258,9 @@ static void print_rsync_version(enum logcode f)
297  #if defined HAVE_LUTIMES && defined HAVE_UTIMES
298         symtimes = "";
299  #endif
300 +#ifdef SUPPORT_FLAGS
301 +       fileflags = "";
302 +#endif
303  
304         rprintf(f, "%s  version %s  protocol version %d%s\n",
305                 RSYNC_NAME, RSYNC_VERSION, PROTOCOL_VERSION, subprotocol);
306 @@ -269,8 +274,8 @@ static void print_rsync_version(enum logcode f)
307                 (int)(sizeof (int64) * 8));
308         rprintf(f, "    %ssocketpairs, %shardlinks, %ssymlinks, %sIPv6, batchfiles, %sinplace,\n",
309                 got_socketpair, hardlinks, links, ipv6, have_inplace);
310 -       rprintf(f, "    %sappend, %sACLs, %sxattrs, %siconv, %ssymtimes\n",
311 -               have_inplace, acls, xattrs, iconv, symtimes);
312 +       rprintf(f, "    %sappend, %sACLs, %sxattrs, %siconv, %ssymtimes, %sfile-flags\n",
313 +               have_inplace, acls, xattrs, iconv, symtimes, fileflags);
314  
315  #ifdef MAINTAINER_MODE
316         rprintf(f, "Panic Action: \"%s\"\n", get_panic_action());
317 @@ -337,6 +342,7 @@ void usage(enum logcode F)
318    rprintf(F," -K, --keep-dirlinks         treat symlinked dir on receiver as dir\n");
319    rprintf(F," -H, --hard-links            preserve hard links\n");
320    rprintf(F," -p, --perms                 preserve permissions\n");
321 +  rprintf(F,"     --fileflags             preserve file-flags\n");
322    rprintf(F," -E, --executability         preserve the file's executability\n");
323    rprintf(F,"     --chmod=CHMOD           affect file and/or directory permissions\n");
324  #ifdef SUPPORT_ACLS
325 @@ -477,6 +483,8 @@ static struct poptOption long_options[] = {
326    {"perms",           'p', POPT_ARG_VAL,    &preserve_perms, 1, 0, 0 },
327    {"no-perms",         0,  POPT_ARG_VAL,    &preserve_perms, 0, 0, 0 },
328    {"no-p",             0,  POPT_ARG_VAL,    &preserve_perms, 0, 0, 0 },
329 +  {"fileflags",        0,  POPT_ARG_VAL,    &preserve_fileflags, 1, 0, 0 },
330 +  {"no-fileflags",     0,  POPT_ARG_VAL,    &preserve_fileflags, 0, 0, 0 },
331    {"executability",   'E', POPT_ARG_NONE,   &preserve_executability, 0, 0, 0 },
332    {"acls",            'A', POPT_ARG_NONE,   0, 'A', 0, 0 },
333    {"no-acls",          0,  POPT_ARG_VAL,    &preserve_acls, 0, 0, 0 },
334 @@ -1311,6 +1319,15 @@ int parse_arguments(int *argc_p, const char ***argv_p, int frommain)
335         }
336  #endif
337  
338 +#ifndef SUPPORT_FLAGS
339 +       if (preserve_fileflags) {
340 +               snprintf(err_buf, sizeof err_buf,
341 +                        "the --fileflags option is not supported on this %s\n",
342 +                        am_server ? "server" : "client");
343 +               return 0;
344 +       }
345 +#endif
346 +
347         if (write_batch && read_batch) {
348                 snprintf(err_buf, sizeof err_buf,
349                         "--write-batch and --read-batch can not be used together\n");
350 @@ -1826,6 +1843,9 @@ void server_options(char **args, int *argc_p)
351         if (xfer_dirs && !recurse && delete_mode && am_sender)
352                 args[ac++] = "--no-r";
353  
354 +       if (preserve_fileflags)
355 +               args[ac++] = "--fileflags";
356 +
357         if (do_compression && def_compress_level != Z_DEFAULT_COMPRESSION) {
358                 if (asprintf(&arg, "--compress-level=%d", def_compress_level) < 0)
359                         goto oom;
360 diff --git a/rsync.c b/rsync.c
361 --- a/rsync.c
362 +++ b/rsync.c
363 @@ -32,6 +32,7 @@ extern int dry_run;
364  extern int preserve_acls;
365  extern int preserve_xattrs;
366  extern int preserve_perms;
367 +extern int preserve_fileflags;
368  extern int preserve_executability;
369  extern int preserve_times;
370  extern int am_root;
371 @@ -339,6 +340,41 @@ mode_t dest_mode(mode_t flist_mode, mode_t stat_mode, int dflt_perms,
372         return new_mode;
373  }
374  
375 +#ifdef SUPPORT_FLAGS
376 +/* Set a file's st_flags. */
377 +static int set_fileflags(const char *fname, uint32 fileflags)
378 +{
379 +       if (do_chflags(fname, fileflags) != 0) {
380 +               rsyserr(FERROR_XFER, errno,
381 +                       "failed to set file flags on %s",
382 +                       full_fname(fname));
383 +               return 0;
384 +       }
385 +
386 +       return 1;
387 +}
388 +
389 +/* Remove immutable flags from an object, so it can be altered/removed. */
390 +void make_mutable(const char *fname, mode_t mode, uint32 fileflags)
391 +{
392 +       if (S_ISLNK(mode))
393 +               return;
394 +
395 +       if (fileflags & NOCHANGE_FLAGS)
396 +               set_fileflags(fname, fileflags & ~NOCHANGE_FLAGS);
397 +}
398 +
399 +/* Undo a prior make_mutable() call. */
400 +void undo_make_mutable(const char *fname, mode_t mode, uint32 fileflags)
401 +{
402 +       if (S_ISLNK(mode))
403 +               return;
404 +
405 +       if (fileflags & NOCHANGE_FLAGS)
406 +               set_fileflags(fname, fileflags);
407 +}
408 +#endif
409 +
410  int set_file_attrs(const char *fname, struct file_struct *file, stat_x *sxp,
411                    const char *fnamecmp, int flags)
412  {
413 @@ -472,6 +508,15 @@ int set_file_attrs(const char *fname, struct file_struct *file, stat_x *sxp,
414         }
415  #endif
416  
417 +#ifdef SUPPORT_FLAGS
418 +       if (preserve_fileflags && !S_ISLNK(sxp->st.st_mode)
419 +        && sxp->st.st_flags != F_FFLAGS(file)) {
420 +               if (!set_fileflags(fname, F_FFLAGS(file)))
421 +                       goto cleanup;
422 +               updated = 1;
423 +       }
424 +#endif
425 +
426         if (verbose > 1 && flags & ATTRS_REPORT) {
427                 if (updated)
428                         rprintf(FCLIENT, "%s\n", fname);
429 @@ -533,6 +578,10 @@ int finish_transfer(const char *fname, const char *fnametmp,
430         set_file_attrs(fnametmp, file, NULL, fnamecmp,
431                        ok_to_set_time ? 0 : ATTRS_SKIP_MTIME);
432  
433 +#ifdef SUPPORT_FLAGS
434 +       if (preserve_fileflags)
435 +               make_mutable(fnametmp, file->mode, F_FFLAGS(file));
436 +#endif
437         /* move tmp file over real file */
438         if (verbose > 2)
439                 rprintf(FINFO, "renaming %s to %s\n", fnametmp, fname);
440 @@ -550,6 +599,10 @@ int finish_transfer(const char *fname, const char *fnametmp,
441         }
442         if (ret == 0) {
443                 /* The file was moved into place (not copied), so it's done. */
444 +#ifdef SUPPORT_FLAGS
445 +               if (preserve_fileflags)
446 +                       undo_make_mutable(fname, file->mode, F_FFLAGS(file));
447 +#endif
448                 return 1;
449         }
450         /* The file was copied, so tweak the perms of the copied file.  If it
451 diff --git a/rsync.h b/rsync.h
452 --- a/rsync.h
453 +++ b/rsync.h
454 @@ -60,6 +60,7 @@
455  #define XMIT_RDEV_MINOR_8_pre30 (1<<11)        /* protocols 28 - 29  */
456  #define XMIT_GROUP_NAME_FOLLOWS (1<<11) /* protocols 30 - now */
457  #define XMIT_HLINK_FIRST (1<<12)       /* protocols 30 - now (HLINKED files only) */
458 +#define XMIT_SAME_FLAGS (1<<14)                /* protocols ?? - now */
459  
460  /* These flags are used in the live flist data. */
461  
462 @@ -452,6 +453,21 @@ typedef unsigned int size_t;
463  #endif
464  #endif
465  
466 +#ifdef HAVE_CHFLAGS
467 +#define SUPPORT_FLAGS 1
468 +#endif
469 +
470 +#ifdef SUPPORT_FLAGS
471 +#ifndef UF_NOUNLINK
472 +#define UF_NOUNLINK 0
473 +#endif
474 +#ifndef SF_NOUNLINK
475 +#define SF_NOUNLINK 0
476 +#endif
477 +#define NODELETE_FLAGS (UF_IMMUTABLE|UF_NOUNLINK|SF_IMMUTABLE|SF_NOUNLINK)
478 +#define NOCHANGE_FLAGS (NODELETE_FLAGS|UF_APPEND|SF_APPEND)
479 +#endif
480 +
481  /* Find a variable that is either exactly 32-bits or longer.
482   * If some code depends on 32-bit truncation, it will need to
483   * take special action in a "#if SIZEOF_INT32 > 4" section. */
484 @@ -620,6 +636,7 @@ extern int file_extra_cnt;
485  extern int inc_recurse;
486  extern int uid_ndx;
487  extern int gid_ndx;
488 +extern int fileflags_ndx;
489  extern int acls_ndx;
490  extern int xattrs_ndx;
491  
492 @@ -657,6 +674,7 @@ extern int xattrs_ndx;
493  /* When the associated option is on, all entries will have these present: */
494  #define F_OWNER(f) REQ_EXTRA(f, uid_ndx)->unum
495  #define F_GROUP(f) REQ_EXTRA(f, gid_ndx)->unum
496 +#define F_FFLAGS(f) REQ_EXTRA(f, fileflags_ndx)->unum
497  #define F_ACL(f) REQ_EXTRA(f, acls_ndx)->num
498  #define F_XATTR(f) REQ_EXTRA(f, xattrs_ndx)->num
499  #define F_NDX(f) REQ_EXTRA(f, unsort_ndx)->num
500 diff --git a/rsync.yo b/rsync.yo
501 --- a/rsync.yo
502 +++ b/rsync.yo
503 @@ -338,6 +338,7 @@ to the detailed description below for a complete description.  verb(
504   -K, --keep-dirlinks         treat symlinked dir on receiver as dir
505   -H, --hard-links            preserve hard links
506   -p, --perms                 preserve permissions
507 +     --fileflags             preserve file-flags
508   -E, --executability         preserve executability
509       --chmod=CHMOD           affect file and/or directory permissions
510   -A, --acls                  preserve ACLs (implies -p)
511 @@ -540,7 +541,8 @@ specified, in which case bf(-r) is not implied.
512  
513  Note that bf(-a) bf(does not preserve hardlinks), because
514  finding multiply-linked files is expensive.  You must separately
515 -specify bf(-H).
516 +specify bf(-H).  Note also that for backward compatibility, bf(-a)
517 +currently does bf(not) imply the bf(--fileflags) option.
518  
519  dit(--no-OPTION) You may turn off one or more implied options by prefixing
520  the option name with "no-".  Not all options may be prefixed with a "no-":
521 @@ -922,6 +924,13 @@ super-user copies all namespaces except system.*.  A normal user only copies
522  the user.* namespace.  To be able to backup and restore non-user namespaces as
523  a normal user, see the bf(--fake-super) option.
524  
525 +dit(bf(--fileflags)) This option causes rsync to update the file-flags
526 +to be the same as the source file, if your OS supports the bf(chflags)(2)
527 +system call.  In any case, an attempt is made to remove flags that would
528 +prevent a file to be altered.  Some flags can only be altered by the
529 +super-user and can only be unset below a certain secure-level (usually
530 +single-user mode).
531 +
532  dit(bf(--chmod)) This option tells rsync to apply one or more
533  comma-separated "chmod" strings to the permission of the files in the
534  transfer.  The resulting value is treated as though it was the permissions
535 diff --git a/syscall.c b/syscall.c
536 --- a/syscall.c
537 +++ b/syscall.c
538 @@ -174,6 +174,15 @@ int do_chmod(const char *path, mode_t mode)
539  }
540  #endif
541  
542 +#ifdef SUPPORT_FLAGS
543 +int do_chflags(const char *path, u_long flags)
544 +{
545 +       if (dry_run) return 0;
546 +       RETURN_ERROR_IF_RO_OR_LO;
547 +       return chflags(path, flags);
548 +}
549 +#endif
550 +
551  int do_rename(const char *fname1, const char *fname2)
552  {
553         if (dry_run) return 0;