1: Optimize the --checksum option using externally created .rsyncsums files.
2:
3: This adds a new option, --sumfiles=MODE, that allows you to use a cache of
4: checksums when performing a --checksum transfer. These checksum files
5: (.rsyncsums) must be created by some other process -- see the perl script,
6: rsyncsums, in the support dir for one way.
7:
8: This option can be particularly helpful to a public mirror that wants to
9: pre-compute their .rsyncsums files, set the "checksum files = strict" option
10: in their daemon config file, and thus make it quite efficient for a client
11: rsync to make use of the --checksum option on their server.
12:
13: To use this patch, run these commands for a successful build:
14:
15: patch -p1 <patches/checksum-reading.diff
16: ./configure (optional if already run)
17: make
18:
19: based-on: e94bad1c156fc3910f24e2b3b71a81b0b0bdeb70
20: diff --git a/clientserver.c b/clientserver.c
21: --- a/clientserver.c
22: +++ b/clientserver.c
23: @@ -44,6 +44,8 @@ extern int numeric_ids;
24: extern int filesfrom_fd;
25: extern int remote_protocol;
26: extern int protocol_version;
27: +extern int always_checksum;
28: +extern int checksum_files;
29: extern int io_timeout;
30: extern int no_detach;
31: extern int write_batch;
32: @@ -1033,6 +1035,9 @@ static int rsync_module(int f_in, int f_out, int i, const char *addr, const char
33: } else if (am_root < 0) /* Treat --fake-super from client as --super. */
34: am_root = 2;
35:
36: + checksum_files = always_checksum ? lp_checksum_files(i)
37: + : CSF_IGNORE_FILES;
38: +
39: if (filesfrom_fd == 0)
40: filesfrom_fd = f_in;
41:
42: diff --git a/daemon-parm.txt b/daemon-parm.txt
43: --- a/daemon-parm.txt
44: +++ b/daemon-parm.txt
45: @@ -49,6 +49,7 @@ INTEGER max_connections 0
46: INTEGER max_verbosity 1
47: INTEGER timeout 0
48:
49: +ENUM checksum_files CSF_IGNORE_FILES
50: ENUM syslog_facility LOG_DAEMON
51:
52: BOOL fake_super False
53: diff --git a/flist.c b/flist.c
54: --- a/flist.c
55: +++ b/flist.c
56: @@ -22,6 +22,7 @@
57:
58: #include "rsync.h"
59: #include "ifuncs.h"
60: +#include "itypes.h"
61: #include "rounding.h"
62: #include "inums.h"
63: #include "io.h"
64: @@ -33,6 +34,7 @@ extern int am_sender;
65: extern int am_generator;
66: extern int inc_recurse;
67: extern int always_checksum;
68: +extern int basis_dir_cnt;
69: extern int checksum_type;
70: extern int module_id;
71: extern int ignore_errors;
72: @@ -62,6 +64,7 @@ extern int implied_dirs;
73: extern int ignore_perishable;
74: extern int non_perishable_cnt;
75: extern int prune_empty_dirs;
76: +extern int checksum_files;
77: extern int copy_links;
78: extern int copy_unsafe_links;
79: extern int protocol_version;
80: @@ -73,6 +76,7 @@ extern int sender_symlink_iconv;
81: extern int output_needs_newline;
82: extern int sender_keeps_checksum;
83: extern int unsort_ndx;
84: +extern char *basis_dir[];
85: extern uid_t our_uid;
86: extern struct stats stats;
87: extern char *filesfrom_host;
88: @@ -90,6 +94,20 @@ extern int filesfrom_convert;
89: extern iconv_t ic_send, ic_recv;
90: #endif
91:
92: +#ifdef HAVE_UTIMENSAT
93: +#ifdef HAVE_STRUCT_STAT_ST_MTIM_TV_NSEC
94: +#define ST_MTIME_NSEC st_mtim.tv_nsec
95: +#elif defined(HAVE_STRUCT_STAT_ST_MTIMENSEC)
96: +#define ST_MTIME_NSEC st_mtimensec
97: +#endif
98: +#endif
99: +
100: +#define RSYNCSUMS_FILE ".rsyncsums"
101: +#define RSYNCSUMS_LEN (sizeof RSYNCSUMS_FILE-1)
102: +
103: +#define CLEAN_STRIP_ROOT (1<<0)
104: +#define CLEAN_KEEP_LAST (1<<1)
105: +
106: #define PTR_SIZE (sizeof (struct file_struct *))
107:
108: int io_error;
109: @@ -134,8 +152,12 @@ static char empty_sum[MAX_DIGEST_LEN];
110: static int flist_count_offset; /* for --delete --progress */
111: static int show_filelist_progress;
112:
113: +static struct csum_cache {
114: + struct file_list *flist;
115: +} *csum_cache = NULL;
116: +
117: static struct file_list *flist_new(int flags, const char *msg);
118: -static void flist_sort_and_clean(struct file_list *flist, int strip_root);
119: +static void flist_sort_and_clean(struct file_list *flist, int flags);
120: static void output_flist(struct file_list *flist);
121:
122: void init_flist(void)
123: @@ -324,6 +346,235 @@ static void flist_done_allocating(struct file_list *flist)
124: flist->pool_boundary = ptr;
125: }
126:
127: +void reset_checksum_cache()
128: +{
129: + int slot, slots = am_sender ? 1 : basis_dir_cnt + 1;
130: +
131: + if (!csum_cache)
132: + csum_cache = new_array0(struct csum_cache, slots);
133: +
134: + for (slot = 0; slot < slots; slot++) {
135: + struct file_list *flist = csum_cache[slot].flist;
136: +
137: + if (flist) {
138: + /* Reset the pool memory and empty the file-list array. */
139: + pool_free_old(flist->file_pool,
140: + pool_boundary(flist->file_pool, 0));
141: + flist->used = 0;
142: + } else
143: + flist = csum_cache[slot].flist = flist_new(FLIST_TEMP, "reset_checksum_cache");
144: +
145: + flist->low = 0;
146: + flist->high = -1;
147: + flist->next = NULL;
148: + }
149: +}
150: +
151: +/* The basename_len count is the length of the basename + 1 for the '\0'. */
152: +static int add_checksum(struct file_list *flist, const char *dirname,
153: + const char *basename, int basename_len, OFF_T file_length,
154: + time_t mtime, uint32 ctime, uint32 inode,
155: + const char *sum)
156: +{
157: + struct file_struct *file;
158: + int alloc_len, extra_len;
159: + char *bp;
160: +
161: + if (basename_len == RSYNCSUMS_LEN+1 && *basename == '.'
162: + && strcmp(basename, RSYNCSUMS_FILE) == 0)
163: + return 0;
164: +
165: + /* "2" is for a 32-bit ctime num and an 32-bit inode num. */
166: + extra_len = (file_extra_cnt + (file_length > 0xFFFFFFFFu) + SUM_EXTRA_CNT + 2)
167: + * EXTRA_LEN;
168: +#if EXTRA_ROUNDING > 0
169: + if (extra_len & (EXTRA_ROUNDING * EXTRA_LEN))
170: + extra_len = (extra_len | (EXTRA_ROUNDING * EXTRA_LEN)) + EXTRA_LEN;
171: +#endif
172: + alloc_len = FILE_STRUCT_LEN + extra_len + basename_len;
173: + bp = pool_alloc(flist->file_pool, alloc_len, "add_checksum");
174: +
175: + memset(bp, 0, extra_len + FILE_STRUCT_LEN);
176: + bp += extra_len;
177: + file = (struct file_struct *)bp;
178: + bp += FILE_STRUCT_LEN;
179: +
180: + memcpy(bp, basename, basename_len);
181: +
182: + file->mode = S_IFREG;
183: + file->modtime = mtime;
184: + file->len32 = (uint32)file_length;
185: + if (file_length > 0xFFFFFFFFu) {
186: + file->flags |= FLAG_LENGTH64;
187: + OPT_EXTRA(file, 0)->unum = (uint32)(file_length >> 32);
188: + }
189: + file->dirname = dirname;
190: + F_CTIME(file) = ctime;
191: + F_INODE(file) = inode;
192: + bp = F_SUM(file);
193: + memcpy(bp, sum, flist_csum_len);
194: +
195: + flist_expand(flist, 1);
196: + flist->files[flist->used++] = file;
197: +
198: + flist->sorted = flist->files;
199: +
200: + return 1;
201: +}
202: +
203: +/* The "dirname" arg's data must remain unchanged during the lifespan of
204: + * the created csum_cache[].flist object because we use it directly. */
205: +static void read_checksums(int slot, struct file_list *flist, const char *dirname)
206: +{
207: + char line[MAXPATHLEN+1024], fbuf[MAXPATHLEN], sum[MAX_DIGEST_LEN];
208: + FILE *fp;
209: + char *cp;
210: + int len, i;
211: + time_t mtime;
212: + OFF_T file_length;
213: + uint32 ctime, inode;
214: + int dlen = dirname ? strlcpy(fbuf, dirname, sizeof fbuf) : 0;
215: +
216: + if (dlen >= (int)(sizeof fbuf - 1 - RSYNCSUMS_LEN))
217: + return;
218: + if (dlen)
219: + fbuf[dlen++] = '/';
220: + else
221: + dirname = NULL;
222: + strlcpy(fbuf+dlen, RSYNCSUMS_FILE, sizeof fbuf - dlen);
223: + if (slot) {
224: + pathjoin(line, sizeof line, basis_dir[slot-1], fbuf);
225: + cp = line;
226: + } else
227: + cp = fbuf;
228: + if (!(fp = fopen(cp, "r")))
229: + return;
230: +
231: + while (fgets(line, sizeof line, fp)) {
232: + cp = line;
233: + if (checksum_type == 5) {
234: + char *alt_sum = cp;
235: + if (*cp == '=')
236: + while (*++cp == '=') {}
237: + else
238: + while (isHexDigit(cp)) cp++;
239: + if (cp - alt_sum != MD4_DIGEST_LEN*2 || *cp != ' ')
240: + break;
241: + while (*++cp == ' ') {}
242: + }
243: +
244: + if (*cp == '=') {
245: + continue;
246: + } else {
247: + for (i = 0; i < flist_csum_len*2; i++, cp++) {
248: + int x;
249: + if (isHexDigit(cp)) {
250: + if (isDigit(cp))
251: + x = *cp - '0';
252: + else
253: + x = (*cp & 0xF) + 9;
254: + } else {
255: + cp = "";
256: + break;
257: + }
258: + if (i & 1)
259: + sum[i/2] |= x;
260: + else
261: + sum[i/2] = x << 4;
262: + }
263: + }
264: + if (*cp != ' ')
265: + break;
266: + while (*++cp == ' ') {}
267: +
268: + if (checksum_type != 5) {
269: + char *alt_sum = cp;
270: + if (*cp == '=')
271: + while (*++cp == '=') {}
272: + else
273: + while (isHexDigit(cp)) cp++;
274: + if (cp - alt_sum != MD5_DIGEST_LEN*2 || *cp != ' ')
275: + break;
276: + while (*++cp == ' ') {}
277: + }
278: +
279: + file_length = 0;
280: + while (isDigit(cp))
281: + file_length = file_length * 10 + *cp++ - '0';
282: + if (*cp != ' ')
283: + break;
284: + while (*++cp == ' ') {}
285: +
286: + mtime = 0;
287: + while (isDigit(cp))
288: + mtime = mtime * 10 + *cp++ - '0';
289: + if (*cp != ' ')
290: + break;
291: + while (*++cp == ' ') {}
292: +
293: + ctime = 0;
294: + while (isDigit(cp))
295: + ctime = ctime * 10 + *cp++ - '0';
296: + if (*cp != ' ')
297: + break;
298: + while (*++cp == ' ') {}
299: +
300: + inode = 0;
301: + while (isDigit(cp))
302: + inode = inode * 10 + *cp++ - '0';
303: + if (*cp != ' ')
304: + break;
305: + while (*++cp == ' ') {}
306: +
307: + len = strlen(cp);
308: + while (len && (cp[len-1] == '\n' || cp[len-1] == '\r'))
309: + len--;
310: + if (!len)
311: + break;
312: + cp[len++] = '\0'; /* len now counts the null */
313: + if (strchr(cp, '/'))
314: + break;
315: + if (len > MAXPATHLEN)
316: + continue;
317: +
318: + strlcpy(fbuf+dlen, cp, sizeof fbuf - dlen);
319: +
320: + add_checksum(flist, dirname, cp, len, file_length,
321: + mtime, ctime, inode,
322: + sum);
323: + }
324: + fclose(fp);
325: +
326: + flist_sort_and_clean(flist, CLEAN_KEEP_LAST);
327: +}
328: +
329: +void get_cached_checksum(int slot, const char *fname, struct file_struct *file,
330: + STRUCT_STAT *stp, char *sum_buf)
331: +{
332: + struct file_list *flist = csum_cache[slot].flist;
333: + int j;
334: +
335: + if (!flist->next) {
336: + flist->next = cur_flist; /* next points from checksum flist to file flist */
337: + read_checksums(slot, flist, file->dirname);
338: + }
339: +
340: + if ((j = flist_find(flist, file)) >= 0) {
341: + struct file_struct *fp = flist->sorted[j];
342: +
343: + if (F_LENGTH(fp) == stp->st_size
344: + && fp->modtime == stp->st_mtime
345: + && (checksum_files & CSF_LAX
346: + || (F_CTIME(fp) == (uint32)stp->st_ctime
347: + && F_INODE(fp) == (uint32)stp->st_ino))) {
348: + memcpy(sum_buf, F_SUM(fp), MAX_DIGEST_LEN);
349: + return;
350: + }
351: + }
352: +
353: + file_checksum(fname, stp, sum_buf);
354: +}
355: +
356: /* Call this with EITHER (1) "file, NULL, 0" to chdir() to the file's
357: * F_PATHNAME(), or (2) "NULL, dir, dirlen" to chdir() to the supplied dir,
358: * with dir == NULL taken to be the starting directory, and dirlen < 0
359: @@ -1201,7 +1452,7 @@ struct file_struct *make_file(const char *fname, struct file_list *flist,
360: STRUCT_STAT *stp, int flags, int filter_level)
361: {
362: static char *lastdir;
363: - static int lastdir_len = -1;
364: + static int lastdir_len = -2;
365: struct file_struct *file;
366: char thisname[MAXPATHLEN];
367: char linkname[MAXPATHLEN];
368: @@ -1347,9 +1598,16 @@ struct file_struct *make_file(const char *fname, struct file_list *flist,
369: memcpy(lastdir, thisname, len);
370: lastdir[len] = '\0';
371: lastdir_len = len;
372: + if (checksum_files && am_sender && flist)
373: + reset_checksum_cache();
374: }
375: - } else
376: + } else {
377: basename = thisname;
378: + if (checksum_files && am_sender && flist && lastdir_len == -2) {
379: + lastdir_len = -1;
380: + reset_checksum_cache();
381: + }
382: + }
383: basename_len = strlen(basename) + 1; /* count the '\0' */
384:
385: #ifdef SUPPORT_LINKS
386: @@ -1367,11 +1625,8 @@ struct file_struct *make_file(const char *fname, struct file_list *flist,
387: extra_len += EXTRA_LEN;
388: #endif
389:
390: - if (always_checksum && am_sender && S_ISREG(st.st_mode)) {
391: - file_checksum(thisname, &st, tmp_sum);
392: - if (sender_keeps_checksum)
393: - extra_len += SUM_EXTRA_CNT * EXTRA_LEN;
394: - }
395: + if (sender_keeps_checksum && S_ISREG(st.st_mode))
396: + extra_len += SUM_EXTRA_CNT * EXTRA_LEN;
397:
398: #if EXTRA_ROUNDING > 0
399: if (extra_len & (EXTRA_ROUNDING * EXTRA_LEN))
400: @@ -1460,8 +1715,14 @@ struct file_struct *make_file(const char *fname, struct file_list *flist,
401: return NULL;
402: }
403:
404: - if (sender_keeps_checksum && S_ISREG(st.st_mode))
405: - memcpy(F_SUM(file), tmp_sum, flist_csum_len);
406: + if (always_checksum && am_sender && S_ISREG(st.st_mode)) {
407: + if (flist && checksum_files)
408: + get_cached_checksum(0, thisname, file, &st, tmp_sum);
409: + else
410: + file_checksum(thisname, &st, tmp_sum);
411: + if (sender_keeps_checksum)
412: + memcpy(F_SUM(file), tmp_sum, flist_csum_len);
413: + }
414:
415: if (unsort_ndx)
416: F_NDX(file) = stats.num_dirs;
417: @@ -2673,7 +2934,7 @@ struct file_list *recv_file_list(int f, int dir_ndx)
418: /* The --relative option sends paths with a leading slash, so we need
419: * to specify the strip_root option here. We rejected leading slashes
420: * for a non-relative transfer in recv_file_entry(). */
421: - flist_sort_and_clean(flist, relative_paths);
422: + flist_sort_and_clean(flist, relative_paths ? CLEAN_STRIP_ROOT : 0);
423:
424: if (protocol_version < 30) {
425: /* Recv the io_error flag */
426: @@ -2918,7 +3179,7 @@ void flist_free(struct file_list *flist)
427:
428: /* This routine ensures we don't have any duplicate names in our file list.
429: * duplicate names can cause corruption because of the pipelining. */
430: -static void flist_sort_and_clean(struct file_list *flist, int strip_root)
431: +static void flist_sort_and_clean(struct file_list *flist, int flags)
432: {
433: char fbuf[MAXPATHLEN];
434: int i, prev_i;
435: @@ -2969,7 +3230,7 @@ static void flist_sort_and_clean(struct file_list *flist, int strip_root)
436: /* If one is a dir and the other is not, we want to
437: * keep the dir because it might have contents in the
438: * list. Otherwise keep the first one. */
439: - if (S_ISDIR(file->mode)) {
440: + if (S_ISDIR(file->mode) || flags & CLEAN_KEEP_LAST) {
441: struct file_struct *fp = flist->sorted[j];
442: if (!S_ISDIR(fp->mode))
443: keep = i, drop = j;
444: @@ -2985,8 +3246,8 @@ static void flist_sort_and_clean(struct file_list *flist, int strip_root)
445: } else
446: keep = j, drop = i;
447:
448: - if (!am_sender) {
449: - if (DEBUG_GTE(DUP, 1)) {
450: + if (!am_sender || flags & CLEAN_KEEP_LAST) {
451: + if (DEBUG_GTE(DUP, 1) && !(flags & CLEAN_KEEP_LAST)) {
452: rprintf(FINFO,
453: "removing duplicate name %s from file list (%d)\n",
454: f_name(file, fbuf), drop + flist->ndx_start);
455: @@ -3008,7 +3269,7 @@ static void flist_sort_and_clean(struct file_list *flist, int strip_root)
456: }
457: flist->high = prev_i;
458:
459: - if (strip_root) {
460: + if (flags & CLEAN_STRIP_ROOT) {
461: /* We need to strip off the leading slashes for relative
462: * paths, but this must be done _after_ the sorting phase. */
463: for (i = flist->low; i <= flist->high; i++) {
464: diff --git a/generator.c b/generator.c
465: --- a/generator.c
466: +++ b/generator.c
467: @@ -52,6 +52,7 @@ extern int delete_after;
468: extern int missing_args;
469: extern int msgdone_cnt;
470: extern int ignore_errors;
471: +extern int checksum_files;
472: extern int remove_source_files;
473: extern int delay_updates;
474: extern int update_only;
475: @@ -601,7 +602,7 @@ void itemize(const char *fnamecmp, struct file_struct *file, int ndx, int statre
476:
477:
478: /* Perform our quick-check heuristic for determining if a file is unchanged. */
479: -int unchanged_file(char *fn, struct file_struct *file, STRUCT_STAT *st)
480: +int unchanged_file(char *fn, struct file_struct *file, STRUCT_STAT *st, int slot)
481: {
482: if (st->st_size != F_LENGTH(file))
483: return 0;
484: @@ -610,7 +611,10 @@ int unchanged_file(char *fn, struct file_struct *file, STRUCT_STAT *st)
485: of the file time to determine whether to sync */
486: if (always_checksum > 0 && S_ISREG(st->st_mode)) {
487: char sum[MAX_DIGEST_LEN];
488: - file_checksum(fn, st, sum);
489: + if (checksum_files && slot >= 0)
490: + get_cached_checksum(slot, fn, file, st, sum);
491: + else
492: + file_checksum(fn, st, sum);
493: return memcmp(sum, F_SUM(file), flist_csum_len) == 0;
494: }
495:
496: @@ -907,7 +911,7 @@ static int try_dests_reg(struct file_struct *file, char *fname, int ndx,
497: best_match = j;
498: match_level = 1;
499: }
500: - if (!unchanged_file(cmpbuf, file, &sxp->st))
501: + if (!unchanged_file(cmpbuf, file, &sxp->st, j+1))
502: continue;
503: if (match_level == 1) {
504: best_match = j;
505: @@ -1220,7 +1224,7 @@ static void recv_generator(char *fname, struct file_struct *file, int ndx,
506: * --ignore-non-existing, daemon exclude, or mkdir failure. */
507: static struct file_struct *skip_dir = NULL;
508: static struct file_list *fuzzy_dirlist[MAX_BASIS_DIRS+1];
509: - static int need_fuzzy_dirlist = 0;
510: + static int need_new_dirscan = 0;
511: struct file_struct *fuzzy_file = NULL;
512: int fd = -1, f_copy = -1;
513: stat_x sx, real_sx;
514: @@ -1337,8 +1341,9 @@ static void recv_generator(char *fname, struct file_struct *file, int ndx,
515: fuzzy_dirlist[i] = NULL;
516: }
517: }
518: - need_fuzzy_dirlist = 1;
519: - }
520: + need_new_dirscan = 1;
521: + } else if (checksum_files)
522: + need_new_dirscan = 1;
523: #ifdef SUPPORT_ACLS
524: if (!preserve_perms)
525: dflt_perms = default_perms_for_dir(dn);
526: @@ -1346,6 +1351,24 @@ static void recv_generator(char *fname, struct file_struct *file, int ndx,
527: }
528: parent_dirname = dn;
529:
530: + if (need_new_dirscan && S_ISREG(file->mode)) {
531: + int i;
532: + strlcpy(fnamecmpbuf, dn, sizeof fnamecmpbuf);
533: + for (i = 0; i < fuzzy_basis; i++) {
534: + if (i && pathjoin(fnamecmpbuf, MAXPATHLEN, basis_dir[i-1], dn) >= MAXPATHLEN)
535: + continue;
536: + fuzzy_dirlist[i] = get_dirlist(fnamecmpbuf, -1, GDL_IGNORE_FILTER_RULES | GDL_PERHAPS_DIR);
537: + if (fuzzy_dirlist[i] && fuzzy_dirlist[i]->used == 0) {
538: + flist_free(fuzzy_dirlist[i]);
539: + fuzzy_dirlist[i] = NULL;
540: + }
541: + }
542: + if (checksum_files) {
543: + reset_checksum_cache();
544: + }
545: + need_new_dirscan = 0;
546: + }
547: +
548: statret = link_stat(fname, &sx.st, keep_dirlinks && is_dir);
549: stat_errno = errno;
550: }
551: @@ -1749,22 +1772,6 @@ static void recv_generator(char *fname, struct file_struct *file, int ndx,
552: partialptr = NULL;
553:
554: if (statret != 0 && fuzzy_basis) {
555: - if (need_fuzzy_dirlist && S_ISREG(file->mode)) {
556: - const char *dn = file->dirname ? file->dirname : ".";
557: - int i;
558: - strlcpy(fnamecmpbuf, dn, sizeof fnamecmpbuf);
559: - for (i = 0; i < fuzzy_basis; i++) {
560: - if (i && pathjoin(fnamecmpbuf, MAXPATHLEN, basis_dir[i-1], dn) >= MAXPATHLEN)
561: - continue;
562: - fuzzy_dirlist[i] = get_dirlist(fnamecmpbuf, -1, GDL_IGNORE_FILTER_RULES | GDL_PERHAPS_DIR);
563: - if (fuzzy_dirlist[i] && fuzzy_dirlist[i]->used == 0) {
564: - flist_free(fuzzy_dirlist[i]);
565: - fuzzy_dirlist[i] = NULL;
566: - }
567: - }
568: - need_fuzzy_dirlist = 0;
569: - }
570: -
571: /* Sets fnamecmp_type to FNAMECMP_FUZZY or above. */
572: fuzzy_file = find_fuzzy(file, fuzzy_dirlist, &fnamecmp_type);
573: if (fuzzy_file) {
574: @@ -1797,7 +1804,7 @@ static void recv_generator(char *fname, struct file_struct *file, int ndx,
575: ;
576: else if (fnamecmp_type >= FNAMECMP_FUZZY)
577: ;
578: - else if (unchanged_file(fnamecmp, file, &sx.st)) {
579: + else if (unchanged_file(fnamecmp, file, &sx.st, fnamecmp_type == FNAMECMP_FNAME ? 0 : -1)) {
580: if (partialptr) {
581: do_unlink(partialptr);
582: handle_partial_dir(partialptr, PDIR_DELETE);
583: diff --git a/hlink.c b/hlink.c
584: --- a/hlink.c
585: +++ b/hlink.c
586: @@ -406,7 +406,7 @@ int hard_link_check(struct file_struct *file, int ndx, char *fname,
587: }
588: break;
589: }
590: - if (!unchanged_file(cmpbuf, file, &alt_sx.st))
591: + if (!unchanged_file(cmpbuf, file, &alt_sx.st, j+1))
592: continue;
593: statret = 1;
594: if (unchanged_attrs(cmpbuf, file, &alt_sx))
595: diff --git a/loadparm.c b/loadparm.c
596: --- a/loadparm.c
597: +++ b/loadparm.c
598: @@ -162,6 +162,13 @@ static struct enum_list enum_syslog_facility[] = {
599: { -1, NULL }
600: };
601:
602: +static struct enum_list enum_checksum_files[] = {
603: + { CSF_IGNORE_FILES, "none" },
604: + { CSF_LAX_MODE, "lax" },
605: + { CSF_STRICT_MODE, "strict" },
606: + { -1, NULL }
607: +};
608: +
609: /* Expand %VAR% references. Any unknown vars or unrecognized
610: * syntax leaves the raw chars unchanged. */
611: static char *expand_vars(const char *str)
612: diff --git a/options.c b/options.c
613: --- a/options.c
614: +++ b/options.c
615: @@ -117,6 +117,7 @@ size_t bwlimit_writemax = 0;
616: int ignore_existing = 0;
617: int ignore_non_existing = 0;
618: int need_messages_from_generator = 0;
619: +int checksum_files = CSF_IGNORE_FILES;
620: int max_delete = INT_MIN;
621: OFF_T max_size = -1;
622: OFF_T min_size = -1;
623: @@ -573,7 +574,7 @@ enum {OPT_SERVER = 1000, OPT_DAEMON, OPT_SENDER, OPT_EXCLUDE, OPT_EXCLUDE_FROM,
624: OPT_INCLUDE, OPT_INCLUDE_FROM, OPT_MODIFY_WINDOW, OPT_MIN_SIZE, OPT_CHMOD,
625: OPT_READ_BATCH, OPT_WRITE_BATCH, OPT_ONLY_WRITE_BATCH, OPT_MAX_SIZE,
626: OPT_NO_D, OPT_APPEND, OPT_NO_ICONV, OPT_INFO, OPT_DEBUG, OPT_BLOCK_SIZE,
627: - OPT_USERMAP, OPT_GROUPMAP, OPT_CHOWN, OPT_BWLIMIT, OPT_STDERR,
628: + OPT_USERMAP, OPT_GROUPMAP, OPT_CHOWN, OPT_BWLIMIT, OPT_STDERR, OPT_SUMFILES,
629: OPT_OLD_COMPRESS, OPT_NEW_COMPRESS, OPT_NO_COMPRESS,
630: OPT_STOP_AFTER, OPT_STOP_AT,
631: OPT_REFUSED_BASE = 9000};
632: @@ -729,6 +730,7 @@ static struct poptOption long_options[] = {
633: {"no-c", 0, POPT_ARG_VAL, &always_checksum, 0, 0, 0 },
634: {"checksum-choice", 0, POPT_ARG_STRING, &checksum_choice, 0, 0, 0 },
635: {"cc", 0, POPT_ARG_STRING, &checksum_choice, 0, 0, 0 },
636: + {"sumfiles", 0, POPT_ARG_STRING, 0, OPT_SUMFILES, 0, 0 },
637: {"block-size", 'B', POPT_ARG_STRING, 0, OPT_BLOCK_SIZE, 0, 0 },
638: {"compare-dest", 0, POPT_ARG_STRING, 0, OPT_COMPARE_DEST, 0, 0 },
639: {"copy-dest", 0, POPT_ARG_STRING, 0, OPT_COPY_DEST, 0, 0 },
640: @@ -1722,6 +1724,23 @@ int parse_arguments(int *argc_p, const char ***argv_p)
641: }
642: break;
643:
644: + case OPT_SUMFILES:
645: + arg = poptGetOptArg(pc);
646: + checksum_files = 0;
647: + if (strcmp(arg, "lax") == 0)
648: + checksum_files |= CSF_LAX_MODE;
649: + else if (strcmp(arg, "strict") == 0)
650: + checksum_files |= CSF_STRICT_MODE;
651: + else if (strcmp(arg, "none") == 0)
652: + checksum_files = CSF_IGNORE_FILES;
653: + else {
654: + snprintf(err_buf, sizeof err_buf,
655: + "Invalid argument passed to --sumfiles (%s)\n",
656: + arg);
657: + return 0;
658: + }
659: + break;
660: +
661: case OPT_INFO:
662: arg = poptGetOptArg(pc);
663: parse_output_words(info_words, info_levels, arg, USER_PRIORITY);
664: @@ -2052,6 +2071,9 @@ int parse_arguments(int *argc_p, const char ***argv_p)
665: }
666: #endif
667:
668: + if (!always_checksum)
669: + checksum_files = CSF_IGNORE_FILES;
670: +
671: if (write_batch && read_batch) {
672: snprintf(err_buf, sizeof err_buf,
673: "--write-batch and --read-batch can not be used together\n");
674: diff --git a/rsync.1.md b/rsync.1.md
675: --- a/rsync.1.md
676: +++ b/rsync.1.md
677: @@ -338,6 +338,7 @@ detailed description below for a complete description.
678: --quiet, -q suppress non-error messages
679: --no-motd suppress daemon-mode MOTD
680: --checksum, -c skip based on checksum, not mod-time & size
681: +--sumfiles=MODE use .rsyncsums to speedup --checksum mode
682: --archive, -a archive mode; equals -rlptgoD (no -H,-A,-X)
683: --no-OPTION turn off an implied OPTION (e.g. --no-D)
684: --recursive, -r recurse into directories
685: @@ -698,6 +699,8 @@ your home directory (remove the '=' for that).
686: file that has the same size as the corresponding sender's file: files with
687: either a changed size or a changed checksum are selected for transfer.
688:
689: + See also the `--sumfiles` option for a way to use cached checksum data.
690: +
691: Note that rsync always verifies that each _transferred_ file was correctly
692: reconstructed on the receiving side by checking a whole-file checksum that
693: is generated as the file is transferred, but that automatic
694: @@ -708,6 +711,38 @@ your home directory (remove the '=' for that).
695: can be overridden using either the `--checksum-choice` (`--cc`) option or an
696: environment variable that is discussed in that option's section.
697:
698: +0. `--sumfiles=MODE`
699: +
700: + This option tells rsync to make use of any cached checksum information it
701: + finds in per-directory .rsyncsums files when the current transfer is using
702: + the `--checksum` option. If the checksum data is up-to-date, it is used
703: + instead of recomputing it, saving both disk I/O and CPU time. If the
704: + checksum data is missing or outdated, the checksum is computed just as it
705: + would be if `--sumfiles` was not specified.
706: +
707: + The MODE value is either "lax", for relaxed checking (which compares size
708: + and mtime), "strict" (which also compares ctime and inode), or "none" to
709: + ignore any .rsyncsums files ("none" is the default). Rsync does not create
710: + or update these files, but there is a perl script in the support directory
711: + named "rsyncsums" that can be used for that.
712: +
713: + This option has no effect unless `--checksum`, `-c` was also specified. It
714: + also only affects the current side of the transfer, so if you want the
715: + remote side to parse its own .rsyncsums files, specify the option via
716: + `--remote-option` (`-M`) (e.g. "`-M--sumfiles=lax`").
717: +
718: + To avoid transferring the system's checksum files, you can use an exclude
719: + (e.g. `--exclude=.rsyncsums`). To make this easier to type, you can use a
720: + popt alias. For instance, adding the following line in your ~/.popt file
721: + defines a `--cs` option that enables lax checksum files and excludes the
722: + checksum files:
723: +
724: + > rsync alias --cs -c --sumfiles=lax -M--sumfiles=lax -f-_.rsyncsums
725: +
726: + An rsync daemon does not allow the client to control this setting, so see
727: + the "checksum files" daemon parameter for information on how to make a
728: + daemon use cached checksum data.
729: +
730: 0. `--archive`, `-a`
731:
732: This is equivalent to `-rlptgoD`. It is a quick way of saying you want
733: diff --git a/rsync.h b/rsync.h
734: --- a/rsync.h
735: +++ b/rsync.h
736: @@ -882,6 +882,10 @@ extern int xattrs_ndx;
737: #define F_SUM(f) ((char*)OPT_EXTRA(f, START_BUMP(f) + HLINK_BUMP(f) \
738: + SUM_EXTRA_CNT - 1))
739:
740: +/* These are only valid on an entry derived from a checksum file. */
741: +#define F_CTIME(f) OPT_EXTRA(f, LEN64_BUMP(f) + SUM_EXTRA_CNT)->unum
742: +#define F_INODE(f) OPT_EXTRA(f, LEN64_BUMP(f) + SUM_EXTRA_CNT + 1)->unum
743: +
744: /* Some utility defines: */
745: #define F_IS_ACTIVE(f) (f)->basename[0]
746: #define F_IS_HLINKED(f) ((f)->flags & FLAG_HLINKED)
747: @@ -1094,6 +1098,13 @@ typedef struct {
748: #define RELNAMECACHE_LEN (offsetof(relnamecache, fname))
749: #endif
750:
751: +#define CSF_ENABLE (1<<1)
752: +#define CSF_LAX (1<<2)
753: +
754: +#define CSF_IGNORE_FILES 0
755: +#define CSF_LAX_MODE (CSF_ENABLE|CSF_LAX)
756: +#define CSF_STRICT_MODE (CSF_ENABLE)
757: +
758: #include "byteorder.h"
759: #include "lib/mdigest.h"
760: #include "lib/wildmatch.h"
761: diff --git a/rsyncd.conf.5.md b/rsyncd.conf.5.md
762: --- a/rsyncd.conf.5.md
763: +++ b/rsyncd.conf.5.md
764: @@ -419,6 +419,19 @@ the values of parameters. See the GLOBAL PARAMETERS section for more details.
765: the max connections limit is not exceeded for the modules sharing the lock
766: file. The default is `/var/run/rsyncd.lock`.
767:
768: +0. `checksum files`
769: +
770: + This parameter tells rsync to make use of any cached checksum information
771: + it finds in per-directory .rsyncsums files when the current transfer is
772: + using the `--checksum` option. The value can be set to either "lax",
773: + "strict", or "none". See the client's `--sumfiles` option for what these
774: + choices do.
775: +
776: + Note also that the client's command-line option, `--sumfiles`, has no
777: + effect on a daemon. A daemon will only access checksum files if this
778: + config option tells it to. See also the `exclude` directive for a way to
779: + hide the .rsyncsums files from the user.
780: +
781: 0. `read only`
782:
783: This parameter determines whether clients will be able to upload files or
784: diff --git a/support/rsyncsums b/support/rsyncsums
785: new file mode 100755
786: --- /dev/null
787: +++ b/support/rsyncsums
788: @@ -0,0 +1,201 @@
789: +#!/usr/bin/perl -w
790: +use strict;
791: +
792: +use Getopt::Long;
793: +use Cwd qw(abs_path cwd);
794: +use Digest::MD4;
795: +use Digest::MD5;
796: +
797: +our $SUMS_FILE = '.rsyncsums';
798: +
799: +&Getopt::Long::Configure('bundling');
800: +&usage if !&GetOptions(
801: + 'recurse|r' => \( my $recurse_opt ),
802: + 'mode|m=s' => \( my $cmp_mode = 'strict' ),
803: + 'check|c' => \( my $check_opt ),
804: + 'verbose|v+' => \( my $verbosity = 0 ),
805: + 'help|h' => \( my $help_opt ),
806: +);
807: +&usage if $help_opt || $cmp_mode !~ /^(lax|strict)$/;
808: +
809: +my $ignore_ctime_and_inode = $cmp_mode eq 'lax' ? 0 : 1;
810: +
811: +my $start_dir = cwd();
812: +
813: +my @dirs = @ARGV;
814: +@dirs = '.' unless @dirs;
815: +foreach (@dirs) {
816: + $_ = abs_path($_);
817: +}
818: +
819: +$| = 1;
820: +
821: +my $exit_code = 0;
822: +
823: +my $md4 = Digest::MD4->new;
824: +my $md5 = Digest::MD5->new;
825: +
826: +while (@dirs) {
827: + my $dir = shift @dirs;
828: +
829: + if (!chdir($dir)) {
830: + warn "Unable to chdir to $dir: $!\n";
831: + next;
832: + }
833: + if (!opendir(DP, '.')) {
834: + warn "Unable to opendir $dir: $!\n";
835: + next;
836: + }
837: +
838: + my $reldir = $dir;
839: + $reldir =~ s#^$start_dir(/|$)# $1 ? '' : '.' #eo;
840: + if ($verbosity) {
841: + print "$reldir ... ";
842: + print "\n" if $check_opt;
843: + }
844: +
845: + my %cache;
846: + my $f_cnt = 0;
847: + if (open(FP, '<', $SUMS_FILE)) {
848: + while (<FP>) {
849: + chomp;
850: + my($sum4, $sum5, $size, $mtime, $ctime, $inode, $fn) = split(' ', $_, 7);
851: + $cache{$fn} = [ 0, $sum4, $sum5, $size, $mtime, $ctime & 0xFFFFFFFF, $inode & 0xFFFFFFFF ];
852: + $f_cnt++;
853: + }
854: + close FP;
855: + }
856: +
857: + my @subdirs;
858: + my $d_cnt = 0;
859: + my $update_cnt = 0;
860: + while (defined(my $fn = readdir(DP))) {
861: + next if $fn =~ /^\.\.?$/ || $fn =~ /^\Q$SUMS_FILE\E$/o || -l $fn;
862: + if (-d _) {
863: + push(@subdirs, "$dir/$fn") unless $fn =~ /^(CVS|\.svn|\.git|\.bzr)$/;
864: + next;
865: + }
866: + next unless -f _;
867: +
868: + my($size,$mtime,$ctime,$inode) = (stat(_))[7,9,10,1];
869: + $ctime &= 0xFFFFFFFF;
870: + $inode &= 0xFFFFFFFF;
871: + my $ref = $cache{$fn};
872: + $d_cnt++;
873: +
874: + if (!$check_opt) {
875: + if (defined $ref) {
876: + $$ref[0] = 1;
877: + if ($$ref[3] == $size
878: + && $$ref[4] == $mtime
879: + && ($ignore_ctime_and_inode || ($$ref[5] == $ctime && $$ref[6] == $inode))
880: + && $$ref[1] !~ /=/ && $$ref[2] !~ /=/) {
881: + next;
882: + }
883: + }
884: + if (!$update_cnt++) {
885: + print "UPDATING\n" if $verbosity;
886: + }
887: + }
888: +
889: + if (!open(IN, $fn)) {
890: + print STDERR "Unable to read $fn: $!\n";
891: + if (defined $ref) {
892: + delete $cache{$fn};
893: + $f_cnt--;
894: + }
895: + next;
896: + }
897: +
898: + my($sum4, $sum5);
899: + while (1) {
900: + while (sysread(IN, $_, 64*1024)) {
901: + $md4->add($_);
902: + $md5->add($_);
903: + }
904: + $sum4 = $md4->hexdigest;
905: + $sum5 = $md5->hexdigest;
906: + print " $sum4 $sum5" if $verbosity > 2;
907: + print " $fn" if $verbosity > 1;
908: + my($size2,$mtime2,$ctime2,$inode2) = (stat(IN))[7,9,10,1];
909: + $ctime2 &= 0xFFFFFFFF;
910: + $inode2 &= 0xFFFFFFFF;
911: + last if $size == $size2 && $mtime == $mtime2
912: + && ($ignore_ctime_and_inode || ($ctime == $ctime2 && $inode == $inode2));
913: + $size = $size2;
914: + $mtime = $mtime2;
915: + $ctime = $ctime2;
916: + $inode = $inode2;
917: + sysseek(IN, 0, 0);
918: + print " REREADING\n" if $verbosity > 1;
919: + }
920: +
921: + close IN;
922: +
923: + if ($check_opt) {
924: + my $dif;
925: + if (!defined $ref) {
926: + $dif = 'MISSING';
927: + } elsif ($sum4 ne $$ref[1] || $sum5 ne $$ref[2]) {
928: + $dif = 'FAILED';
929: + } else {
930: + print " OK\n" if $verbosity > 1;
931: + next;
932: + }
933: + if ($verbosity < 2) {
934: + print $verbosity ? ' ' : "$reldir/";
935: + print $fn;
936: + }
937: + print " $dif\n";
938: + $exit_code = 1;
939: + } else {
940: + print "\n" if $verbosity > 1;
941: + $cache{$fn} = [ 1, $sum4, $sum5, $size, $mtime, $ctime, $inode ];
942: + }
943: + }
944: +
945: + closedir DP;
946: +
947: + unshift(@dirs, sort @subdirs) if $recurse_opt;
948: +
949: + if ($check_opt) {
950: + ;
951: + } elsif ($d_cnt == 0) {
952: + if ($f_cnt) {
953: + print "(removed $SUMS_FILE) " if $verbosity;
954: + unlink($SUMS_FILE);
955: + }
956: + print "empty\n" if $verbosity;
957: + } elsif ($update_cnt || $d_cnt != $f_cnt) {
958: + print "UPDATING\n" if $verbosity && !$update_cnt;
959: + open(FP, '>', $SUMS_FILE) or die "Unable to write $dir/$SUMS_FILE: $!\n";
960: +
961: + foreach my $fn (sort keys %cache) {
962: + my $ref = $cache{$fn};
963: + my($found, $sum4, $sum5, $size, $mtime, $ctime, $inode) = @$ref;
964: + next unless $found;
965: + printf FP '%s %s %10d %10d %10d %10d %s' . "\n", $sum4, $sum5, $size, $mtime, $ctime, $inode, $fn;
966: + }
967: + close FP;
968: + } else {
969: + print "ok\n" if $verbosity;
970: + }
971: +}
972: +
973: +exit $exit_code;
974: +
975: +sub usage
976: +{
977: + die <<EOT;
978: +Usage: rsyncsums [OPTIONS] [DIRS]
979: +
980: +Options:
981: + -r, --recurse Update $SUMS_FILE files in subdirectories too.
982: + -m, --mode=MODE Compare entries in either "lax" or "strict" mode. Using
983: + "lax" compares size and mtime, while "strict" additionally
984: + compares ctime and inode. Default: strict.
985: + -c, --check Check if the checksums are right (doesn't update).
986: + -v, --verbose Mention what we're doing. Repeat for more info.
987: + -h, --help Display this help message.
988: +EOT
989: +}
990: diff -Nurp a/rsync.1 b/rsync.1
991: --- a/rsync.1
992: +++ b/rsync.1
993: @@ -414,6 +414,7 @@ detailed description below for a complet
994: --quiet, -q suppress non-error messages
995: --no-motd suppress daemon-mode MOTD
996: --checksum, -c skip based on checksum, not mod-time & size
997: +--sumfiles=MODE use .rsyncsums to speedup --checksum mode
998: --archive, -a archive mode; equals -rlptgoD (no -H,-A,-X)
999: --no-OPTION turn off an implied OPTION (e.g. --no-D)
1000: --recursive, -r recurse into directories
1001: @@ -766,6 +767,8 @@ its checksums when it is scanning for ch
1002: file that has the same size as the corresponding sender's file: files with
1003: either a changed size or a changed checksum are selected for transfer.
1004: .IP
1005: +See also the \fB\-\-sumfiles\fP option for a way to use cached checksum data.
1006: +.IP
1007: Note that rsync always verifies that each \fItransferred\fP file was correctly
1008: reconstructed on the receiving side by checking a whole-file checksum that
1009: is generated as the file is transferred, but that automatic
1010: @@ -775,6 +778,40 @@ before-the-transfer "Does this file need
1011: The checksum used is auto-negotiated between the client and the server, but
1012: can be overridden using either the \fB\-\-checksum-choice\fP (\fB\-\-cc\fP) option or an
1013: environment variable that is discussed in that option's section.
1014: +.IP "\fB\-\-sumfiles=MODE\fP"
1015: +This option tells rsync to make use of any cached checksum information it
1016: +finds in per-directory .rsyncsums files when the current transfer is using
1017: +the \fB\-\-checksum\fP option. If the checksum data is up-to-date, it is used
1018: +instead of recomputing it, saving both disk I/O and CPU time. If the
1019: +checksum data is missing or outdated, the checksum is computed just as it
1020: +would be if \fB\-\-sumfiles\fP was not specified.
1021: +.IP
1022: +The MODE value is either "lax", for relaxed checking (which compares size
1023: +and mtime), "strict" (which also compares ctime and inode), or "none" to
1024: +ignore any .rsyncsums files ("none" is the default). Rsync does not create
1025: +or update these files, but there is a perl script in the support directory
1026: +named "rsyncsums" that can be used for that.
1027: +.IP
1028: +This option has no effect unless \fB\-\-checksum\fP, \fB\-c\fP was also specified. It
1029: +also only affects the current side of the transfer, so if you want the
1030: +remote side to parse its own .rsyncsums files, specify the option via
1031: +\fB\-\-remote-option\fP (\fB\-M\fP) (e.g. "\fB\-M\-\-sumfiles=lax\fP").
1032: +.IP
1033: +To avoid transferring the system's checksum files, you can use an exclude
1034: +(e.g. \fB\-\-exclude=.rsyncsums\fP). To make this easier to type, you can use a
1035: +popt alias. For instance, adding the following line in your ~/.popt file
1036: +defines a \fB\-\-cs\fP option that enables lax checksum files and excludes the
1037: +checksum files:
1038: +.RS 4
1039: +.IP
1040: +.nf
1041: +rsync alias --cs -c --sumfiles=lax -M--sumfiles=lax -f-_.rsyncsums
1042: +.fi
1043: +.RE
1044: +.IP
1045: +An rsync daemon does not allow the client to control this setting, so see
1046: +the "checksum files" daemon parameter for information on how to make a
1047: +daemon use cached checksum data.
1048: .IP "\fB\-\-archive\fP, \fB\-a\fP"
1049: This is equivalent to \fB\-rlptgoD\fP. It is a quick way of saying you want
1050: recursion and want to preserve almost everything (with \fB\-H\fP being a notable
1051: diff -Nurp a/rsync.1.html b/rsync.1.html
1052: --- a/rsync.1.html
1053: +++ b/rsync.1.html
1054: @@ -329,6 +329,7 @@ detailed description below for a complet
1055: --quiet, -q suppress non-error messages
1056: --no-motd suppress daemon-mode MOTD
1057: --checksum, -c skip based on checksum, not mod-time & size
1058: +--sumfiles=MODE use .rsyncsums to speedup --checksum mode
1059: --archive, -a archive mode; equals -rlptgoD (no -H,-A,-X)
1060: --no-OPTION turn off an implied OPTION (e.g. --no-D)
1061: --recursive, -r recurse into directories
1062: @@ -681,6 +682,7 @@ scan that builds the list of the availab
1063: its checksums when it is scanning for changed files, and will checksum any
1064: file that has the same size as the corresponding sender's file: files with
1065: either a changed size or a changed checksum are selected for transfer.</p>
1066: +<p>See also the <code>--sumfiles</code> option for a way to use cached checksum data.</p>
1067: <p>Note that rsync always verifies that each <u>transferred</u> file was correctly
1068: reconstructed on the receiving side by checking a whole-file checksum that
1069: is generated as the file is transferred, but that automatic
1070: @@ -691,6 +693,36 @@ can be overridden using either the <code
1071: environment variable that is discussed in that option's section.</p>
1072: </dd>
1073:
1074: +<dt><code>--sumfiles=MODE</code></dt><dd>
1075: +<p>This option tells rsync to make use of any cached checksum information it
1076: +finds in per-directory .rsyncsums files when the current transfer is using
1077: +the <code>--checksum</code> option. If the checksum data is up-to-date, it is used
1078: +instead of recomputing it, saving both disk I/O and CPU time. If the
1079: +checksum data is missing or outdated, the checksum is computed just as it
1080: +would be if <code>--sumfiles</code> was not specified.</p>
1081: +<p>The MODE value is either "lax", for relaxed checking (which compares size
1082: +and mtime), "strict" (which also compares ctime and inode), or "none" to
1083: +ignore any .rsyncsums files ("none" is the default). Rsync does not create
1084: +or update these files, but there is a perl script in the support directory
1085: +named "rsyncsums" that can be used for that.</p>
1086: +<p>This option has no effect unless <code>--checksum</code>, <code>-c</code> was also specified. It
1087: +also only affects the current side of the transfer, so if you want the
1088: +remote side to parse its own .rsyncsums files, specify the option via
1089: +<code>--remote-option</code> (<code>-M</code>) (e.g. "<code>-M--sumfiles=lax</code>").</p>
1090: +<p>To avoid transferring the system's checksum files, you can use an exclude
1091: +(e.g. <code>--exclude=.rsyncsums</code>). To make this easier to type, you can use a
1092: +popt alias. For instance, adding the following line in your ~/.popt file
1093: +defines a <code>--cs</code> option that enables lax checksum files and excludes the
1094: +checksum files:</p>
1095: +<blockquote>
1096: +<pre><code>rsync alias --cs -c --sumfiles=lax -M--sumfiles=lax -f-_.rsyncsums
1097: +</code></pre>
1098: +</blockquote>
1099: +<p>An rsync daemon does not allow the client to control this setting, so see
1100: +the "checksum files" daemon parameter for information on how to make a
1101: +daemon use cached checksum data.</p>
1102: +</dd>
1103: +
1104: <dt><code>--archive</code>, <code>-a</code></dt><dd>
1105: <p>This is equivalent to <code>-rlptgoD</code>. It is a quick way of saying you want
1106: recursion and want to preserve almost everything (with <code>-H</code> being a notable
1107: diff -Nurp a/rsyncd.conf.5 b/rsyncd.conf.5
1108: --- a/rsyncd.conf.5
1109: +++ b/rsyncd.conf.5
1110: @@ -394,6 +394,17 @@ This parameter specifies the file to use
1111: parameter. The rsync daemon uses record locking on this file to ensure that
1112: the max connections limit is not exceeded for the modules sharing the lock
1113: file. The default is \fB/var/run/rsyncd.lock\fP.
1114: +.IP "\fBchecksum\ files\fP"
1115: +This parameter tells rsync to make use of any cached checksum information
1116: +it finds in per-directory .rsyncsums files when the current transfer is
1117: +using the \fB\-\-checksum\fP option. The value can be set to either "lax",
1118: +"strict", or "none". See the client's \fB\-\-sumfiles\fP option for what these
1119: +choices do.
1120: +.IP
1121: +Note also that the client's command-line option, \fB\-\-sumfiles\fP, has no
1122: +effect on a daemon. A daemon will only access checksum files if this
1123: +config option tells it to. See also the \fBexclude\fP directive for a way to
1124: +hide the .rsyncsums files from the user.
1125: .IP "\fBread\ only\fP"
1126: This parameter determines whether clients will be able to upload files or
1127: not. If "read only" is true then any attempted uploads will fail. If
1128: diff -Nurp a/rsyncd.conf.5.html b/rsyncd.conf.5.html
1129: --- a/rsyncd.conf.5.html
1130: +++ b/rsyncd.conf.5.html
1131: @@ -405,6 +405,18 @@ the max connections limit is not exceede
1132: file. The default is <code>/var/run/rsyncd.lock</code>.</p>
1133: </dd>
1134:
1135: +<dt><code>checksum files</code></dt><dd>
1136: +<p>This parameter tells rsync to make use of any cached checksum information
1137: +it finds in per-directory .rsyncsums files when the current transfer is
1138: +using the <code>--checksum</code> option. The value can be set to either "lax",
1139: +"strict", or "none". See the client's <code>--sumfiles</code> option for what these
1140: +choices do.</p>
1141: +<p>Note also that the client's command-line option, <code>--sumfiles</code>, has no
1142: +effect on a daemon. A daemon will only access checksum files if this
1143: +config option tells it to. See also the <code>exclude</code> directive for a way to
1144: +hide the .rsyncsums files from the user.</p>
1145: +</dd>
1146: +
1147: <dt><code>read only</code></dt><dd>
1148: <p>This parameter determines whether clients will be able to upload files or
1149: not. If "read only" is true then any attempted uploads will fail. If
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>