Fixed failing hunks.
[rsync/rsync-patches.git] / atimes.diff
1 After applying this patch, run these commands for a successful build:
2
3     ./prepare-source
4     ./configure                      (optional if already run)
5     make
6
7
8 --- old/flist.c
9 +++ new/flist.c
10 @@ -46,6 +46,7 @@ extern int preserve_devices;
11  extern int preserve_specials;
12  extern int preserve_uid;
13  extern int preserve_gid;
14 +extern int preserve_atimes;
15  extern int relative_paths;
16  extern int implied_dirs;
17  extern int prune_empty_dirs;
18 @@ -79,7 +80,13 @@ void init_flist(void)
19         struct file_struct f;
20  
21         /* Figure out how big the file_struct is without trailing padding */
22 -       file_struct_len = offsetof(struct file_struct, flags) + sizeof f.flags;
23 +       if (preserve_atimes)
24 +               file_struct_len = offsetof(struct file_struct, fl4g5);
25 +       else
26 +               file_struct_len = offsetof(struct file_struct, atime);
27 +       /* The "flags" uchar is no longer accessed directly, so I
28 +        * mangled the name to fl4g5 as a reminder. */
29 +       file_struct_len += sizeof f.fl4g5;
30         checksum_len = protocol_version < 21 ? 2 : MD4_SUM_LENGTH;
31  }
32  
33 @@ -135,16 +142,18 @@ static void list_file_entry(struct file_
34  
35  #ifdef SUPPORT_LINKS
36         if (preserve_links && S_ISLNK(f->mode)) {
37 -               rprintf(FINFO, "%s %11.0f %s %s -> %s\n",
38 +               rprintf(FINFO, "%s %11.0f %s %s %s -> %s\n",
39                         permbuf,
40                         (double)f->length, timestring(f->modtime),
41 +                       preserve_atimes ? timestring(f->atime) : "",
42                         f_name(f, NULL), f->u.link);
43         } else
44  #endif
45         {
46 -               rprintf(FINFO, "%s %11.0f %s %s\n",
47 +               rprintf(FINFO, "%s %11.0f %s %s %s\n",
48                         permbuf,
49                         (double)f->length, timestring(f->modtime),
50 +                       preserve_atimes ? timestring(f->atime) : "",
51                         f_name(f, NULL));
52         }
53  }
54 @@ -298,6 +307,7 @@ static void send_file_entry(struct file_
55  {
56         unsigned short flags;
57         static time_t modtime;
58 +       static time_t atime;
59         static mode_t mode;
60         static int64 dev;
61         static dev_t rdev;
62 @@ -313,7 +323,7 @@ static void send_file_entry(struct file_
63  
64         if (!file) {
65                 write_byte(f, 0);
66 -               modtime = 0, mode = 0;
67 +               modtime = 0, atime = 0, mode = 0;
68                 dev = 0, rdev = MAKEDEV(0, 0);
69                 rdev_major = 0;
70                 uid = 0, gid = 0;
71 @@ -323,7 +333,7 @@ static void send_file_entry(struct file_
72  
73         f_name(file, fname);
74  
75 -       flags = file->flags & XMIT_TOP_DIR;
76 +       flags = FFLAGS(file) & XMIT_TOP_DIR;
77  
78         if (file->mode == mode)
79                 flags |= XMIT_SAME_MODE;
80 @@ -359,6 +369,12 @@ static void send_file_entry(struct file_
81                 flags |= XMIT_SAME_TIME;
82         else
83                 modtime = file->modtime;
84 +       if (preserve_atimes && !S_ISDIR(mode)) {
85 +               if (file->atime == atime)
86 +                       flags |= XMIT_SAME_ATIME;
87 +               else
88 +                       atime = file->atime;
89 +       }
90  
91  #ifdef SUPPORT_HARD_LINKS
92         if (file->link_u.idev) {
93 @@ -412,6 +428,8 @@ static void send_file_entry(struct file_
94                 write_int(f, modtime);
95         if (!(flags & XMIT_SAME_MODE))
96                 write_int(f, to_wire_mode(mode));
97 +       if (preserve_atimes && !S_ISDIR(mode) && !(flags & XMIT_SAME_ATIME))
98 +               write_int(f, atime);
99         if (preserve_uid && !(flags & XMIT_SAME_UID)) {
100                 if (!numeric_ids)
101                         add_uid(uid);
102 @@ -478,6 +496,7 @@ static struct file_struct *receive_file_
103                                               unsigned short flags, int f)
104  {
105         static time_t modtime;
106 +       static time_t atime;
107         static mode_t mode;
108         static int64 dev;
109         static dev_t rdev;
110 @@ -496,7 +515,7 @@ static struct file_struct *receive_file_
111         struct file_struct *file;
112  
113         if (!flist) {
114 -               modtime = 0, mode = 0;
115 +               modtime = 0, atime = 0, mode = 0;
116                 dev = 0, rdev = MAKEDEV(0, 0);
117                 rdev_major = 0;
118                 uid = 0, gid = 0;
119 @@ -552,6 +571,8 @@ static struct file_struct *receive_file_
120                 modtime = (time_t)read_int(f);
121         if (!(flags & XMIT_SAME_MODE))
122                 mode = from_wire_mode(read_int(f));
123 +       if (preserve_atimes && !S_ISDIR(mode) && !(flags & XMIT_SAME_ATIME))
124 +               atime = (time_t)read_int(f);
125  
126         if (chmod_modes && !S_ISLNK(mode))
127                 mode = tweak_mode(mode, chmod_modes);
128 @@ -607,6 +628,8 @@ static struct file_struct *receive_file_
129         file->mode = mode;
130         file->uid = uid;
131         file->gid = gid;
132 +       if (preserve_atimes)
133 +               file->atime = atime;
134  
135         if (dirname_len) {
136                 file->dirname = lastdir = bp;
137 @@ -632,12 +655,12 @@ static struct file_struct *receive_file_
138                             && lastname[del_hier_name_len-1] == '.'
139                             && lastname[del_hier_name_len-2] == '/')
140                                 del_hier_name_len -= 2;
141 -                       file->flags |= FLAG_TOP_DIR | FLAG_DEL_HERE;
142 +                       FFLAGS(file) |= FLAG_TOP_DIR | FLAG_DEL_HERE;
143                 } else if (in_del_hier) {
144                         if (!relative_paths || !del_hier_name_len
145                          || (l1 >= del_hier_name_len
146                           && lastname[del_hier_name_len] == '/'))
147 -                               file->flags |= FLAG_DEL_HERE;
148 +                               FFLAGS(file) |= FLAG_DEL_HERE;
149                         else
150                                 in_del_hier = 0;
151                 }
152 @@ -853,12 +876,14 @@ struct file_struct *make_file(char *fnam
153         memset(bp, 0, file_struct_len);
154         bp += file_struct_len;
155  
156 -       file->flags = flags;
157 +       FFLAGS(file) = flags;
158         file->modtime = st.st_mtime;
159         file->length = st.st_size;
160         file->mode = st.st_mode;
161         file->uid = st.st_uid;
162         file->gid = st.st_gid;
163 +       if (preserve_atimes)
164 +               file->atime = st.st_atime;
165  
166  #ifdef SUPPORT_HARD_LINKS
167         if (flist && flist->hlink_pool) {
168 @@ -971,7 +996,7 @@ static void send_if_directory(int f, str
169         char is_dot_dir = fbuf[ol-1] == '.' && (ol == 1 || fbuf[ol-2] == '/');
170  
171         if (S_ISDIR(file->mode)
172 -           && !(file->flags & FLAG_MOUNT_POINT) && f_name(file, fbuf)) {
173 +           && !(FFLAGS(file) & FLAG_MOUNT_POINT) && f_name(file, fbuf)) {
174                 void *save_filters;
175                 unsigned int len = strlen(fbuf);
176                 if (len > 1 && fbuf[len-1] == '/')
177 @@ -1583,8 +1608,9 @@ static void clean_flist(struct file_list
178                         }
179                         /* Make sure we don't lose track of a user-specified
180                          * top directory. */
181 -                       flist->files[keep]->flags |= flist->files[drop]->flags
182 -                                                  & (FLAG_TOP_DIR|FLAG_DEL_HERE);
183 +                       FFLAGS(flist->files[keep])
184 +                           |= FFLAGS(flist->files[drop])
185 +                            & (FLAG_TOP_DIR|FLAG_DEL_HERE);
186  
187                         clear_file(flist->files[drop], flist);
188  
189 @@ -1708,7 +1734,7 @@ static void output_flist(struct file_lis
190                         file->dirname ? file->dirname : "",
191                         file->dirname ? "/" : "", NS(file->basename),
192                         S_ISDIR(file->mode) ? "/" : "", (int)file->mode,
193 -                       (double)file->length, uidbuf, gidbuf, file->flags);
194 +                       (double)file->length, uidbuf, gidbuf, FFLAGS(file));
195         }
196  }
197  
198 --- old/generator.c
199 +++ new/generator.c
200 @@ -43,6 +43,7 @@ extern int preserve_perms;
201  extern int preserve_uid;
202  extern int preserve_gid;
203  extern int preserve_times;
204 +extern int preserve_atimes;
205  extern int omit_dir_times;
206  extern int delete_mode;
207  extern int delete_before;
208 @@ -89,6 +90,7 @@ extern dev_t filesystem_dev;
209  extern char *backup_dir;
210  extern char *backup_suffix;
211  extern int backup_suffix_len;
212 +extern unsigned int file_struct_len;
213  extern struct file_list *the_file_list;
214  extern struct filter_list_struct server_filter_list;
215  
216 @@ -181,7 +183,7 @@ static int delete_item(char *fname, int 
217         for (j = dirlist->count; j--; ) {
218                 struct file_struct *fp = dirlist->files[j];
219  
220 -               if (fp->flags & FLAG_MOUNT_POINT)
221 +               if (FFLAGS(fp) & FLAG_MOUNT_POINT)
222                         continue;
223  
224                 strlcpy(p, fp->basename, remainder);
225 @@ -259,7 +261,7 @@ static void delete_in_dir(struct file_li
226         filt_array[cur_depth] = push_local_filters(fbuf, dlen);
227  
228         if (one_file_system) {
229 -               if (file->flags & FLAG_TOP_DIR)
230 +               if (FFLAGS(file) & FLAG_TOP_DIR)
231                         filesystem_dev = stp->st_dev;
232                 else if (filesystem_dev != stp->st_dev)
233                         return;
234 @@ -271,7 +273,7 @@ static void delete_in_dir(struct file_li
235          * from the filesystem. */
236         for (i = dirlist->count; i--; ) {
237                 struct file_struct *fp = dirlist->files[i];
238 -               if (!fp->basename || fp->flags & FLAG_MOUNT_POINT)
239 +               if (!fp->basename || FFLAGS(fp) & FLAG_MOUNT_POINT)
240                         continue;
241                 if (flist_find(flist, fp) < 0) {
242                         f_name(fp, delbuf);
243 @@ -297,11 +299,11 @@ static void do_delete_pass(struct file_l
244         for (j = 0; j < flist->count; j++) {
245                 struct file_struct *file = flist->files[j];
246  
247 -               if (!(file->flags & FLAG_DEL_HERE))
248 +               if (!(FFLAGS(file) & FLAG_DEL_HERE))
249                         continue;
250  
251                 f_name(file, fbuf);
252 -               if (verbose > 1 && file->flags & FLAG_TOP_DIR)
253 +               if (verbose > 1 && FFLAGS(file) & FLAG_TOP_DIR)
254                         rprintf(FINFO, "deleting in %s\n", fbuf);
255  
256                 if (link_stat(fbuf, &st, keep_dirlinks) < 0
257 @@ -345,6 +347,9 @@ void itemize(struct file_struct *file, i
258                      && (!(iflags & ITEM_XNAME_FOLLOWS) || *xname))
259                     || (keep_time && cmp_time(file->modtime, st->st_mtime) != 0))
260                         iflags |= ITEM_REPORT_TIME;
261 +               if (preserve_atimes && !S_ISDIR(file->mode) && !S_ISLNK(file->mode)
262 +                && cmp_time(file->atime, st->st_atime) != 0)
263 +                       iflags |= ITEM_REPORT_ATIME;
264                 if ((file->mode & CHMOD_BITS) != (st->st_mode & CHMOD_BITS))
265                         iflags |= ITEM_REPORT_PERMS;
266                 if (preserve_uid && am_root && file->uid != st->st_uid)
267 @@ -548,7 +553,7 @@ static int find_fuzzy(struct file_struct
268                 uint32 dist;
269  
270                 if (!S_ISREG(fp->mode) || !fp->length
271 -                   || fp->flags & FLAG_NO_FUZZY)
272 +                   || FFLAGS(fp) & FLAG_NO_FUZZY)
273                         continue;
274  
275                 name = fp->basename;
276 @@ -664,6 +669,8 @@ static int try_dests_reg(struct file_str
277                                           itemizing && verbose > 1,
278                                           code) < 0)
279                                 goto try_a_copy;
280 +                       if (preserve_atimes)
281 +                               set_file_attrs(fname, file, stp, 0);
282                         if (preserve_hard_links && file->link_u.links)
283                                 hard_link_cluster(file, ndx, itemizing, code);
284                 } else
285 @@ -941,7 +948,7 @@ static void recv_generator(char *fname, 
286                     && verbose && code && f_out != -1)
287                         rprintf(code, "%s/\n", fname);
288                 if (delete_during && f_out != -1 && !phase && dry_run < 2
289 -                   && (file->flags & FLAG_DEL_HERE))
290 +                   && (FFLAGS(file) & FLAG_DEL_HERE))
291                         delete_in_dir(the_file_list, fname, file, &st);
292                 return;
293         }
294 @@ -1244,7 +1251,7 @@ static void recv_generator(char *fname, 
295         if (fuzzy_dirlist) {
296                 int j = flist_find(fuzzy_dirlist, file);
297                 if (j >= 0) /* don't use changing file as future fuzzy basis */
298 -                       fuzzy_dirlist->files[j]->flags |= FLAG_NO_FUZZY;
299 +                       FFLAGS(fuzzy_dirlist->files[j]) |= FLAG_NO_FUZZY;
300         }
301  
302         /* open the file */
303 --- old/hlink.c
304 +++ new/hlink.c
305 @@ -30,6 +30,7 @@ extern int make_backups;
306  extern int remove_source_files;
307  extern int stdout_format_has_i;
308  extern char *basis_dir[];
309 +extern unsigned int file_struct_len;
310  extern struct file_list *the_file_list;
311  
312  #ifdef SUPPORT_HARD_LINKS
313 @@ -90,10 +91,10 @@ static void link_idev_data(void)
314                         FPTR(cur)->link_u.links = pool_talloc(hlink_pool,
315                             struct hlink, 1, "hlink_list");
316  
317 -                       FPTR(head)->flags |= FLAG_HLINK_TOL;
318 +                       FFLAGS(FPTR(head)) |= FLAG_HLINK_TOL;
319                         FPTR(cur)->F_HLINDEX = to;
320                         FPTR(cur)->F_NEXT = head;
321 -                       FPTR(cur)->flags |= FLAG_HLINK_EOL;
322 +                       FFLAGS(FPTR(cur)) |= FLAG_HLINK_EOL;
323                         hlink_list[to++] = head;
324                 } else
325                         FPTR(cur)->link_u.links = NULL;
326 @@ -179,7 +180,7 @@ int hard_link_check(struct file_struct *
327  {
328  #ifdef SUPPORT_HARD_LINKS
329         int head;
330 -       if (skip && !(file->flags & FLAG_HLINK_EOL))
331 +       if (skip && !(FFLAGS(file) & FLAG_HLINK_EOL))
332                 head = hlink_list[file->F_HLINDEX] = file->F_NEXT;
333         else
334                 head = hlink_list[file->F_HLINDEX];
335 @@ -279,8 +280,8 @@ void hard_link_cluster(struct file_struc
336         file->F_HLINDEX = FINISHED_LINK;
337         if (link_stat(f_name(file, hlink1), &st1, 0) < 0)
338                 return;
339 -       if (!(file->flags & FLAG_HLINK_TOL)) {
340 -               while (!(file->flags & FLAG_HLINK_EOL)) {
341 +       if (!(FFLAGS(file) & FLAG_HLINK_TOL)) {
342 +               while (!(FFLAGS(file) & FLAG_HLINK_EOL)) {
343                         ndx = file->F_NEXT;
344                         file = FPTR(ndx);
345                 }
346 @@ -300,6 +301,6 @@ void hard_link_cluster(struct file_struc
347                         send_msg(MSG_SUCCESS, numbuf, 4);
348                 }
349                 file->F_HLINDEX = FINISHED_LINK;
350 -       } while (!(file->flags & FLAG_HLINK_EOL));
351 +       } while (!(FFLAGS(file) & FLAG_HLINK_EOL));
352  #endif
353  }
354 --- old/log.c
355 +++ new/log.c
356 @@ -37,6 +37,7 @@ extern int msg_fd_out;
357  extern int allow_8bit_chars;
358  extern int protocol_version;
359  extern int preserve_times;
360 +extern int preserve_atimes;
361  extern int stdout_format_has_i;
362  extern int stdout_format_has_o_or_i;
363  extern int logfile_format_has_i;
364 @@ -609,7 +610,8 @@ static void log_formatted(enum logcode c
365                         n[5] = !(iflags & ITEM_REPORT_PERMS) ? '.' : 'p';
366                         n[6] = !(iflags & ITEM_REPORT_OWNER) ? '.' : 'o';
367                         n[7] = !(iflags & ITEM_REPORT_GROUP) ? '.' : 'g';
368 -                       n[8] = '.';
369 +                       n[8] = !(iflags & ITEM_REPORT_ATIME) ? '.'
370 +                            : S_ISLNK(file->mode) ? 'U' : 'u';
371                         n[9] = '\0';
372  
373                         if (iflags & (ITEM_IS_NEW|ITEM_MISSING_DATA)) {
374 --- old/options.c
375 +++ new/options.c
376 @@ -55,6 +55,7 @@ int preserve_uid = 0;
377  int preserve_gid = 0;
378  int preserve_times = 0;
379  int omit_dir_times = 0;
380 +int preserve_atimes = 0;
381  int update_only = 0;
382  int cvs_exclude = 0;
383  int dry_run = 0;
384 @@ -309,8 +310,9 @@ void usage(enum logcode F)
385    rprintf(F,"     --devices               preserve device files (super-user only)\n");
386    rprintf(F,"     --specials              preserve special files\n");
387    rprintf(F," -D                          same as --devices --specials\n");
388 -  rprintf(F," -t, --times                 preserve times\n");
389 -  rprintf(F," -O, --omit-dir-times        omit directories when preserving times\n");
390 +  rprintf(F," -t, --times                 preserve modify times\n");
391 +  rprintf(F," -O, --omit-dir-times        omit directories when preserving modify times\n");
392 +  rprintf(F," -U, --atimes                preserve access (use) times\n");
393    rprintf(F,"     --super                 receiver attempts super-user activities\n");
394    rprintf(F," -S, --sparse                handle sparse files efficiently\n");
395    rprintf(F," -n, --dry-run               show what would have been transferred\n");
396 @@ -424,6 +426,9 @@ static struct poptOption long_options[] 
397    {"times",           't', POPT_ARG_VAL,    &preserve_times, 1, 0, 0 },
398    {"no-times",         0,  POPT_ARG_VAL,    &preserve_times, 0, 0, 0 },
399    {"no-t",             0,  POPT_ARG_VAL,    &preserve_times, 0, 0, 0 },
400 +  {"atimes",          'U', POPT_ARG_VAL,    &preserve_atimes, 1, 0, 0 },
401 +  {"no-atimes",        0,  POPT_ARG_VAL,    &preserve_atimes, 0, 0, 0 },
402 +  {"no-k",             0,  POPT_ARG_VAL,    &preserve_atimes, 0, 0, 0 },
403    {"omit-dir-times",  'O', POPT_ARG_VAL,    &omit_dir_times, 2, 0, 0 },
404    {"modify-window",    0,  POPT_ARG_INT,    &modify_window, OPT_MODIFY_WINDOW, 0, 0 },
405    {"super",            0,  POPT_ARG_VAL,    &am_root, 2, 0, 0 },
406 @@ -1537,6 +1542,8 @@ void server_options(char **args,int *arg
407                 argstr[x++] = 'D';
408         if (preserve_times)
409                 argstr[x++] = 't';
410 +       if (preserve_atimes)
411 +               argstr[x++] = 'U';
412         if (preserve_perms)
413                 argstr[x++] = 'p';
414         else if (preserve_executability && am_sender)
415 --- old/rsync.c
416 +++ new/rsync.c
417 @@ -34,6 +34,7 @@ extern int verbose;
418  extern int dry_run;
419  extern int preserve_perms;
420  extern int preserve_executability;
421 +extern int preserve_atimes;
422  extern int preserve_times;
423  extern int omit_dir_times;
424  extern int am_root;
425 @@ -127,6 +128,7 @@ int set_file_attrs(char *fname, struct f
426         int updated = 0;
427         STRUCT_STAT st2;
428         int change_uid, change_gid;
429 +       time_t atime, mtime;
430  
431         if (!st) {
432                 if (dry_run)
433 @@ -145,18 +147,33 @@ int set_file_attrs(char *fname, struct f
434                 }
435         }
436  
437 +       /* This code must be the first update in the function due to
438 +        * how it uses the "updated" variable. */
439         if (!preserve_times || (S_ISDIR(st->st_mode) && omit_dir_times))
440                 flags |= ATTRS_SKIP_MTIME;
441 +       if (!preserve_atimes || S_ISDIR(st->st_mode))
442 +               flags |= ATTRS_SKIP_ATIME;
443         if (!(flags & ATTRS_SKIP_MTIME)
444             && cmp_time(st->st_mtime, file->modtime) != 0) {
445 -               int ret = set_modtime(fname, file->modtime, st->st_mode);
446 +               mtime = file->modtime;
447 +               updated = 1;
448 +       } else
449 +               mtime = st->st_mtime;
450 +       if (!(flags & ATTRS_SKIP_ATIME)
451 +           && cmp_time(st->st_atime, file->atime) != 0) {
452 +               atime = file->atime;
453 +               updated = 1;
454 +       } else
455 +               atime = st->st_atime;
456 +       if (updated) {
457 +               int ret = set_times(fname, mtime, atime, st->st_mode);
458                 if (ret < 0) {
459                         rsyserr(FERROR, errno, "failed to set times on %s",
460                                 full_fname(fname));
461                         return 0;
462                 }
463 -               if (ret == 0) /* ret == 1 if symlink could not be set */
464 -                       updated = 1;
465 +               if (ret > 0) /* ret == 1 if symlink could not be set */
466 +                       updated = 0;
467         }
468  
469         change_uid = am_root && preserve_uid && st->st_uid != file->uid;
470 --- old/rsync.h
471 +++ new/rsync.h
472 @@ -54,6 +54,7 @@
473  #define XMIT_HAS_IDEV_DATA (1<<9)
474  #define XMIT_SAME_DEV (1<<10)
475  #define XMIT_RDEV_MINOR_IS_SMALL (1<<11)
476 +#define XMIT_SAME_ATIME (1<<12)
477  
478  /* These flags are used in the live flist data. */
479  
480 @@ -120,6 +121,7 @@
481  
482  #define ATTRS_REPORT           (1<<0)
483  #define ATTRS_SKIP_MTIME       (1<<1)
484 +#define ATTRS_SKIP_ATIME       (1<<2)
485  
486  #define FULL_FLUSH     1
487  #define NORMAL_FLUSH   0
488 @@ -529,9 +531,12 @@ struct file_struct {
489         uid_t uid;
490         gid_t gid;
491         mode_t mode;
492 -       uchar flags;    /* this item MUST remain last */
493 +       time_t atime;   /* this MUST be second to last */
494 +       uchar fl4g5;    /* this item MUST remain last */
495  };
496  
497 +#define FFLAGS(f) ((uchar*)(f))[file_struct_len-1]
498 +
499  /*
500   * Start the flist array at FLIST_START entries and grow it
501   * by doubling until FLIST_LINEAR then grow by FLIST_LINEAR
502 --- old/rsync.yo
503 +++ new/rsync.yo
504 @@ -327,8 +327,9 @@ to the detailed description below for a 
505       --devices               preserve device files (super-user only)
506       --specials              preserve special files
507   -D                          same as --devices --specials
508 - -t, --times                 preserve times
509 - -O, --omit-dir-times        omit directories when preserving times
510 + -t, --times                 preserve modify times
511 + -O, --omit-dir-times        omit directories when preserving mod-times
512 + -U, --atimes                preserve access (use) times
513       --super                 receiver attempts super-user activities
514   -S, --sparse                handle sparse files efficiently
515   -n, --dry-run               show what would have been transferred
516 @@ -862,6 +863,12 @@ it is preserving modification times (see
517  the directories on the receiving side, it is a good idea to use bf(-O).
518  This option is inferred if you use bf(--backup) without bf(--backup-dir).
519  
520 +dit(bf(-U, --atimes)) This tells rsync to set the access (use) times of the
521 +destination files to the same value as the source files.  Note that the
522 +reading of the source file may update the atime of the source files, so
523 +repeated rsync runs with --atimes may be needed if you want to force the
524 +access-time values to be 100% identical on the two systems.
525 +
526  dit(bf(--super)) This tells the receiving side to attempt super-user
527  activities even if the receiving rsync wasn't run by the super-user.  These
528  activities include: preserving users via the bf(--owner) option, preserving
529 @@ -1378,7 +1385,7 @@ with older versions of rsync, but that a
530  verbose messages).
531  
532  The "%i" escape has a cryptic output that is 9 letters long.  The general
533 -format is like the string bf(YXcstpogz), where bf(Y) is replaced by the
534 +format is like the string bf(YXcstpogu), where bf(Y) is replaced by the
535  type of update being done, bf(X) is replaced by the file-type, and the
536  other letters represent attributes that may be output if they are being
537  modified.
538 @@ -1418,7 +1425,7 @@ quote(itemize(
539    by the file transfer.
540    it() A bf(t) means the modification time is different and is being updated
541    to the sender's value (requires bf(--times)).  An alternate value of bf(T)
542 -  means that the time will be set to the transfer time, which happens
543 +  means that the modify time will be set to the transfer time, which happens
544    anytime a symlink is transferred, or when a file or device is transferred
545    without bf(--times).
546    it() A bf(p) means the permissions are different and are being updated to
547 @@ -1427,7 +1434,10 @@ quote(itemize(
548    sender's value (requires bf(--owner) and super-user privileges).
549    it() A bf(g) means the group is different and is being updated to the
550    sender's value (requires bf(--group) and the authority to set the group).
551 -  it() The bf(z) slot is reserved for future use.
552 +  it() A bf(u) means the access (use) time is different and is being updated to
553 +  the sender's value (requires bf(--atimes)).  An alternate value of bf(U)
554 +  means that the access time will be set to the transfer time, which happens
555 +  when a symlink or directory is updated.
556  ))
557  
558  One other output is possible:  when deleting files, the "%i" will output
559 --- old/sender.c
560 +++ new/sender.c
561 @@ -41,6 +41,7 @@ extern int do_progress;
562  extern int inplace;
563  extern int batch_fd;
564  extern int write_batch;
565 +extern unsigned int file_struct_len;
566  extern struct stats stats;
567  extern struct file_list *the_file_list;
568  extern char *stdout_format;
569 @@ -368,7 +369,7 @@ void send_files(struct file_list *flist,
570                         rprintf(FINFO, "sender finished %s\n", fname);
571  
572                 /* Flag that we actually sent this entry. */
573 -               file->flags |= FLAG_SENT;
574 +               FFLAGS(file) |= FLAG_SENT;
575         }
576         make_backups = save_make_backups;
577  
578 --- old/testsuite/atimes.test
579 +++ new/testsuite/atimes.test
580 @@ -0,0 +1,19 @@
581 +#! /bin/sh
582 +
583 +# Test rsync copying atimes
584 +
585 +. "$suitedir/rsync.fns"
586 +
587 +set -x
588 +
589 +mkdir "$fromdir"
590 +
591 +touch "$fromdir/foo"
592 +touch -a -t 200102031717.42 "$fromdir/foo"
593 +
594 +TLS_ARGS=--atime
595 +
596 +checkit "$RSYNC -rtUgvvv \"$fromdir/\" \"$todir/\"" "$fromdir" "$todir"
597 +
598 +# The script would have aborted on error, so getting here means we've won.
599 +exit 0
600 --- old/testsuite/rsync.fns
601 +++ new/testsuite/rsync.fns
602 @@ -66,7 +66,7 @@ printmsg() {
603  }
604  
605  rsync_ls_lR() {
606 -    find "$@" -print | sort | sed 's/ /\\ /g' | xargs "$TOOLDIR/tls"
607 +    find "$@" -print | sort | sed 's/ /\\ /g' | xargs "$TOOLDIR/tls" $TLS_ARGS
608  }
609  
610  check_perms() {
611 @@ -184,6 +184,10 @@ checkit() {
612      # We can just write everything to stdout/stderr, because the
613      # wrapper hides it unless there is a problem.
614  
615 +    if test x$TLS_ARGS = x--atime; then
616 +       ( cd "$2" && rsync_ls_lR . ) > "$tmpdir/ls-from"
617 +    fi
618 +
619      echo "Running: \"$1\""  
620      eval "$1" 
621      status=$?
622 @@ -191,10 +195,13 @@ checkit() {
623         failed="YES";
624      fi
625  
626 +    if test x$TLS_ARGS != x--atime; then
627 +       ( cd "$2" && rsync_ls_lR . ) > "$tmpdir/ls-from"
628 +    fi
629 +
630      echo "-------------"
631      echo "check how the directory listings compare with diff:"
632      echo ""
633 -    ( cd "$2" && rsync_ls_lR . ) > "$tmpdir/ls-from"
634      ( cd "$3" && rsync_ls_lR . ) > "$tmpdir/ls-to"
635      diff $diffopt "$tmpdir/ls-from" "$tmpdir/ls-to" || failed=YES
636  
637 --- old/tls.c
638 +++ new/tls.c
639 @@ -34,6 +34,7 @@
640   * change. */
641  
642  #include "rsync.h"
643 +#include "popt.h"
644  
645  #define PROGRAM "tls"
646  
647 @@ -43,6 +44,8 @@ int read_only = 1;
648  int list_only = 0;
649  int preserve_perms = 0;
650  
651 +static int display_atime = 0;
652
653  static void failed(char const *what, char const *where)
654  {
655         fprintf(stderr, PROGRAM ": %s %s: %s\n",
656 @@ -50,12 +53,29 @@ static void failed(char const *what, cha
657         exit(1);
658  }
659  
660 +static void storetime(char *dest, time_t t)
661 +{
662 +       if (t) {
663 +               struct tm *mt = gmtime(&t);
664 +
665 +               sprintf(dest, "%04d-%02d-%02d %02d:%02d:%02d ",
666 +                       (int)mt->tm_year + 1900,
667 +                       (int)mt->tm_mon + 1,
668 +                       (int)mt->tm_mday,
669 +                       (int)mt->tm_hour,
670 +                       (int)mt->tm_min,
671 +                       (int)mt->tm_sec);
672 +       } else {
673 +               strcpy(dest, "                    ");
674 +       }
675 +}
676 +
677  static void list_file(const char *fname)
678  {
679         STRUCT_STAT buf;
680         char permbuf[PERMSTRING_SIZE];
681 -       struct tm *mt;
682 -       char datebuf[50];
683 +       char mtimebuf[50];
684 +       char atimebuf[50];
685         char linkbuf[4096];
686  
687         if (do_lstat(fname, &buf) < 0)
688 @@ -88,19 +108,8 @@ static void list_file(const char *fname)
689  
690         permstring(permbuf, buf.st_mode);
691  
692 -       if (buf.st_mtime) {
693 -               mt = gmtime(&buf.st_mtime);
694 -
695 -               sprintf(datebuf, "%04d-%02d-%02d %02d:%02d:%02d",
696 -                       (int)mt->tm_year + 1900,
697 -                       (int)mt->tm_mon + 1,
698 -                       (int)mt->tm_mday,
699 -                       (int)mt->tm_hour,
700 -                       (int)mt->tm_min,
701 -                       (int)mt->tm_sec);
702 -       } else {
703 -               strcpy(datebuf, "                   ");
704 -       }
705 +       storetime(mtimebuf, buf.st_mtime);
706 +       storetime(atimebuf, buf.st_atime);
707  
708         /* TODO: Perhaps escape special characters in fname? */
709  
710 @@ -111,23 +120,55 @@ static void list_file(const char *fname)
711                     (long)minor(buf.st_rdev));
712         } else /* NB: use double for size since it might not fit in a long. */
713                 printf("%12.0f", (double)buf.st_size);
714 -       printf(" %6ld.%-6ld %6ld %s %s%s\n",
715 +       printf(" %6ld.%-6ld %6ld %s%s%s%s\n",
716                (long)buf.st_uid, (long)buf.st_gid, (long)buf.st_nlink,
717 -              datebuf, fname, linkbuf);
718 +              mtimebuf, display_atime && !S_ISDIR(buf.st_mode) ? atimebuf : "",
719 +              fname, linkbuf);
720 +}
721 +
722 +static struct poptOption long_options[] = {
723 +  /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
724 +  {"atime",           'u', POPT_ARG_NONE,   &display_atime, 0,   0, 0},
725 +  {"help",            'h', POPT_ARG_NONE,   0,              'h', 0, 0},
726 +  {0,0,0,0,0,0,0}
727 +};
728 +
729 +static void tls_usage(int ret)
730 +{
731 +       fprintf(stderr, "usage: " PROGRAM " [--atime | -u] DIR ...\n"
732 +           "Trivial file listing program for portably checking rsync\n");
733 +       exit(ret);
734  }
735  
736  int
737  main(int argc, char *argv[])
738  {
739 -       if (argc < 2) {
740 -               fprintf(stderr, "usage: " PROGRAM " DIR ...\n"
741 -                       "Trivial file listing program for portably checking rsync\n");
742 -               return 1;
743 +       poptContext pc;
744 +       const char **extra_args;
745 +       int opt;
746 +
747 +       pc = poptGetContext(PROGRAM, argc, (const char **)argv,
748 +                           long_options, 0);
749 +       while ((opt = poptGetNextOpt(pc)) != -1) {
750 +               switch (opt) {
751 +               case 'h':
752 +                       tls_usage(0);
753 +               default:
754 +                       fprintf(stderr,
755 +                               "%s: %s\n",
756 +                               poptBadOption(pc, POPT_BADOPTION_NOALIAS),
757 +                               poptStrerror(opt));
758 +                       tls_usage(1);
759 +               }
760         }
761  
762 -       for (argv++; *argv; argv++) {
763 -               list_file(*argv);
764 -       }
765 +       extra_args = poptGetArgs(pc);
766 +       if (*extra_args == NULL)
767 +               tls_usage(1);
768 +
769 +       for (; *extra_args; extra_args++)
770 +               list_file(*extra_args);
771 +       poptFreeContext(pc);
772  
773         return 0;
774  }
775 --- old/util.c
776 +++ new/util.c
777 @@ -121,7 +121,7 @@ void overflow_exit(char *str)
778         exit_cleanup(RERR_MALLOC);
779  }
780  
781 -int set_modtime(char *fname, time_t modtime, mode_t mode)
782 +int set_times(char *fname, time_t modtime, time_t atime, mode_t mode)
783  {
784  #if !defined HAVE_LUTIMES || !defined HAVE_UTIMES
785         if (S_ISLNK(mode))
786 @@ -129,9 +129,13 @@ int set_modtime(char *fname, time_t modt
787  #endif
788  
789         if (verbose > 2) {
790 -               rprintf(FINFO, "set modtime of %s to (%ld) %s",
791 +               char mtimebuf[200];
792 +
793 +               strlcpy(mtimebuf, timestring(modtime), sizeof mtimebuf);
794 +               rprintf(FINFO,
795 +                       "set modtime, atime of %s to (%ld) %s, (%ld) %s\n",
796                         fname, (long)modtime,
797 -                       asctime(localtime(&modtime)));
798 +                       mtimebuf, (long)atime, timestring(atime));
799         }
800  
801         if (dry_run)
802 @@ -140,7 +144,7 @@ int set_modtime(char *fname, time_t modt
803         {
804  #ifdef HAVE_UTIMES
805                 struct timeval t[2];
806 -               t[0].tv_sec = time(NULL);
807 +               t[0].tv_sec = atime;
808                 t[0].tv_usec = 0;
809                 t[1].tv_sec = modtime;
810                 t[1].tv_usec = 0;
811 @@ -151,12 +155,12 @@ int set_modtime(char *fname, time_t modt
812                 return utimes(fname, t);
813  #elif defined HAVE_UTIMBUF
814                 struct utimbuf tbuf;
815 -               tbuf.actime = time(NULL);
816 +               tbuf.actime = atime;
817                 tbuf.modtime = modtime;
818                 return utime(fname,&tbuf);
819  #elif defined HAVE_UTIME
820                 time_t t[2];
821 -               t[0] = time(NULL);
822 +               t[0] = atime;
823                 t[1] = modtime;
824                 return utime(fname,t);
825  #else