Add support for negotiated checksum names.
[rsync.git] / options.c
1 /*
2  * Command-line (and received via daemon-socket) option parsing.
3  *
4  * Copyright (C) 1998-2001 Andrew Tridgell <tridge@samba.org>
5  * Copyright (C) 2000, 2001, 2002 Martin Pool <mbp@samba.org>
6  * Copyright (C) 2002-2020 Wayne Davison
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 3 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License along
19  * with this program; if not, visit the http://fsf.org website.
20  */
21
22 #include "rsync.h"
23 #include "itypes.h"
24 #include "latest-year.h"
25 #include <popt.h>
26 #include <zlib.h>
27
28 extern int module_id;
29 extern int local_server;
30 extern int sanitize_paths;
31 extern int daemon_over_rsh;
32 extern unsigned int module_dirlen;
33 extern filter_rule_list filter_list;
34 extern filter_rule_list daemon_filter_list;
35
36 #define NOT_SPECIFIED (-42)
37
38 int make_backups = 0;
39
40 /**
41  * If 1, send the whole file as literal data rather than trying to
42  * create an incremental diff.
43  *
44  * If -1, then look at whether we're local or remote and go by that.
45  *
46  * @sa disable_deltas_p()
47  **/
48 int whole_file = -1;
49
50 int append_mode = 0;
51 int keep_dirlinks = 0;
52 int copy_dirlinks = 0;
53 int copy_links = 0;
54 int write_devices = 0;
55 int preserve_links = 0;
56 int preserve_hard_links = 0;
57 int preserve_acls = 0;
58 int preserve_xattrs = 0;
59 int preserve_perms = 0;
60 int preserve_executability = 0;
61 int preserve_devices = 0;
62 int preserve_specials = 0;
63 int preserve_uid = 0;
64 int preserve_gid = 0;
65 int preserve_times = 0;
66 int preserve_atimes = 0;
67 int update_only = 0;
68 int open_noatime = 0;
69 int cvs_exclude = 0;
70 int dry_run = 0;
71 int do_xfers = 1;
72 int ignore_times = 0;
73 int delete_mode = 0;
74 int delete_during = 0;
75 int delete_before = 0;
76 int delete_after = 0;
77 int delete_excluded = 0;
78 int remove_source_files = 0;
79 int one_file_system = 0;
80 int protocol_version = PROTOCOL_VERSION;
81 int sparse_files = 0;
82 int preallocate_files = 0;
83 int do_compression = 0;
84 int def_compress_level = NOT_SPECIFIED;
85 int am_root = 0; /* 0 = normal, 1 = root, 2 = --super, -1 = --fake-super */
86 int am_server = 0;
87 int am_sender = 0;
88 int am_starting_up = 1;
89 int relative_paths = -1;
90 int implied_dirs = 1;
91 int missing_args = 0; /* 0 = FERROR_XFER, 1 = ignore, 2 = delete */
92 int numeric_ids = 0;
93 int msgs2stderr = 0;
94 int allow_8bit_chars = 0;
95 int force_delete = 0;
96 int io_timeout = 0;
97 int prune_empty_dirs = 0;
98 int use_qsort = 0;
99 char *files_from = NULL;
100 int filesfrom_fd = -1;
101 char *filesfrom_host = NULL;
102 int eol_nulls = 0;
103 int protect_args = -1;
104 int human_readable = 1;
105 int recurse = 0;
106 int allow_inc_recurse = 1;
107 int xfer_dirs = -1;
108 int am_daemon = 0;
109 int connect_timeout = 0;
110 int keep_partial = 0;
111 int safe_symlinks = 0;
112 int copy_unsafe_links = 0;
113 int munge_symlinks = 0;
114 int size_only = 0;
115 int daemon_bwlimit = 0;
116 int bwlimit = 0;
117 int fuzzy_basis = 0;
118 size_t bwlimit_writemax = 0;
119 int ignore_existing = 0;
120 int ignore_non_existing = 0;
121 int need_messages_from_generator = 0;
122 int max_delete = INT_MIN;
123 OFF_T max_size = -1;
124 OFF_T min_size = -1;
125 int ignore_errors = 0;
126 int modify_window = 0;
127 int blocking_io = -1;
128 int checksum_seed = 0;
129 int inplace = 0;
130 int delay_updates = 0;
131 long block_size = 0; /* "long" because popt can't set an int32. */
132 char *skip_compress = NULL;
133 char *copy_as = NULL;
134 item_list dparam_list = EMPTY_ITEM_LIST;
135
136 /** Network address family. **/
137 int default_af_hint
138 #ifdef INET6
139         = 0;            /* Any protocol */
140 #else
141         = AF_INET;      /* Must use IPv4 */
142 # ifdef AF_INET6
143 #  undef AF_INET6
144 # endif
145 # define AF_INET6 AF_INET /* make -6 option a no-op */
146 #endif
147
148 /** Do not go into the background when run as --daemon.  Good
149  * for debugging and required for running as a service on W32,
150  * or under Unix process-monitors. **/
151 int no_detach
152 #if defined _WIN32 || defined __WIN32__
153         = 1;
154 #else
155         = 0;
156 #endif
157
158 int write_batch = 0;
159 int read_batch = 0;
160 int backup_dir_len = 0;
161 int backup_suffix_len;
162 unsigned int backup_dir_remainder;
163
164 char *backup_suffix = NULL;
165 char *tmpdir = NULL;
166 char *partial_dir = NULL;
167 char *basis_dir[MAX_BASIS_DIRS+1];
168 char *config_file = NULL;
169 char *shell_cmd = NULL;
170 char *logfile_name = NULL;
171 char *logfile_format = NULL;
172 char *stdout_format = NULL;
173 char *password_file = NULL;
174 char *rsync_path = RSYNC_PATH;
175 char *backup_dir = NULL;
176 char backup_dir_buf[MAXPATHLEN];
177 char *sockopts = NULL;
178 char *usermap = NULL;
179 char *groupmap = NULL;
180 int rsync_port = 0;
181 int compare_dest = 0;
182 int copy_dest = 0;
183 int link_dest = 0;
184 int basis_dir_cnt = 0;
185 char *dest_option = NULL;
186
187 static int remote_option_alloc = 0;
188 int remote_option_cnt = 0;
189 const char **remote_options = NULL;
190 const char *checksum_choice = NULL;
191 const char *compress_choice = NULL;
192
193 int quiet = 0;
194 int output_motd = 1;
195 int log_before_transfer = 0;
196 int stdout_format_has_i = 0;
197 int stdout_format_has_o_or_i = 0;
198 int logfile_format_has_i = 0;
199 int logfile_format_has_o_or_i = 0;
200 int always_checksum = 0;
201 int list_only = 0;
202
203 #define MAX_BATCH_NAME_LEN 256  /* Must be less than MAXPATHLEN-13 */
204 char *batch_name = NULL;
205
206 int need_unsorted_flist = 0;
207 #ifdef ICONV_OPTION
208 char *iconv_opt = ICONV_OPTION;
209 #endif
210
211 struct chmod_mode_struct *chmod_modes = NULL;
212
213 static const char *debug_verbosity[] = {
214         /*0*/ NULL,
215         /*1*/ NULL,
216         /*2*/ "BIND,CMD,CONNECT,DEL,DELTASUM,DUP,FILTER,FLIST,ICONV",
217         /*3*/ "ACL,BACKUP,CONNECT2,DELTASUM2,DEL2,EXIT,FILTER2,FLIST2,FUZZY,GENR,OWN,RECV,SEND,TIME",
218         /*4*/ "CMD2,DELTASUM3,DEL3,EXIT2,FLIST3,ICONV2,OWN2,PROTO,TIME2",
219         /*5*/ "CHDIR,DELTASUM4,FLIST4,FUZZY2,HASH,HLINK",
220 };
221
222 #define MAX_VERBOSITY ((int)(sizeof debug_verbosity / sizeof debug_verbosity[0]) - 1)
223
224 static const char *info_verbosity[1+MAX_VERBOSITY] = {
225         /*0*/ NULL,
226         /*1*/ "COPY,DEL,FLIST,MISC,NAME,STATS,SYMSAFE",
227         /*2*/ "BACKUP,MISC2,MOUNT,NAME2,REMOVE,SKIP",
228 };
229
230 #define MAX_OUT_LEVEL 4 /* The largest N allowed for any flagN word. */
231
232 short info_levels[COUNT_INFO], debug_levels[COUNT_DEBUG];
233
234 #define DEFAULT_PRIORITY 0      /* Default/implied/--verbose set values. */
235 #define HELP_PRIORITY 1         /* The help output uses this level. */
236 #define USER_PRIORITY 2         /* User-specified via --info or --debug */
237 #define LIMIT_PRIORITY 3        /* Overriding priority when limiting values. */
238
239 #define W_CLI (1<<0)    /* client side */
240 #define W_SRV (1<<1)    /* server side */
241 #define W_SND (1<<2)    /* sending side */
242 #define W_REC (1<<3)    /* receiving side */
243
244 struct output_struct {
245         char *name;     /* The name of the info/debug flag. */
246         char *help;     /* The description of the info/debug flag. */
247         uchar namelen;  /* The length of the name string. */
248         uchar flag;     /* The flag's value, for consistency check. */
249         uchar where;    /* Bits indicating where the flag is used. */
250         uchar priority; /* See *_PRIORITY defines. */
251 };
252
253 #define INFO_WORD(flag, where, help) { #flag, help, sizeof #flag - 1, INFO_##flag, where, 0 }
254
255 static struct output_struct info_words[COUNT_INFO+1] = {
256         INFO_WORD(BACKUP, W_REC, "Mention files backed up"),
257         INFO_WORD(COPY, W_REC, "Mention files copied locally on the receiving side"),
258         INFO_WORD(DEL, W_REC, "Mention deletions on the receiving side"),
259         INFO_WORD(FLIST, W_CLI, "Mention file-list receiving/sending (levels 1-2)"),
260         INFO_WORD(MISC, W_SND|W_REC, "Mention miscellaneous information (levels 1-2)"),
261         INFO_WORD(MOUNT, W_SND|W_REC, "Mention mounts that were found or skipped"),
262         INFO_WORD(NAME, W_SND|W_REC, "Mention 1) updated file/dir names, 2) unchanged names"),
263         INFO_WORD(PROGRESS, W_CLI, "Mention 1) per-file progress or 2) total transfer progress"),
264         INFO_WORD(REMOVE, W_SND, "Mention files removed on the sending side"),
265         INFO_WORD(SKIP, W_REC, "Mention files that are skipped due to options used"),
266         INFO_WORD(STATS, W_CLI|W_SRV, "Mention statistics at end of run (levels 1-3)"),
267         INFO_WORD(SYMSAFE, W_SND|W_REC, "Mention symlinks that are unsafe"),
268         { NULL, "--info", 0, 0, 0, 0 }
269 };
270
271 #define DEBUG_WORD(flag, where, help) { #flag, help, sizeof #flag - 1, DEBUG_##flag, where, 0 }
272
273 static struct output_struct debug_words[COUNT_DEBUG+1] = {
274         DEBUG_WORD(ACL, W_SND|W_REC, "Debug extra ACL info"),
275         DEBUG_WORD(BACKUP, W_REC, "Debug backup actions (levels 1-2)"),
276         DEBUG_WORD(BIND, W_CLI, "Debug socket bind actions"),
277         DEBUG_WORD(CHDIR, W_CLI|W_SRV, "Debug when the current directory changes"),
278         DEBUG_WORD(CONNECT, W_CLI, "Debug connection events (levels 1-2)"),
279         DEBUG_WORD(CMD, W_CLI, "Debug commands+options that are issued (levels 1-2)"),
280         DEBUG_WORD(DEL, W_REC, "Debug delete actions (levels 1-3)"),
281         DEBUG_WORD(DELTASUM, W_SND|W_REC, "Debug delta-transfer checksumming (levels 1-4)"),
282         DEBUG_WORD(DUP, W_REC, "Debug weeding of duplicate names"),
283         DEBUG_WORD(EXIT, W_CLI|W_SRV, "Debug exit events (levels 1-3)"),
284         DEBUG_WORD(FILTER, W_SND|W_REC, "Debug filter actions (levels 1-2)"),
285         DEBUG_WORD(FLIST, W_SND|W_REC, "Debug file-list operations (levels 1-4)"),
286         DEBUG_WORD(FUZZY, W_REC, "Debug fuzzy scoring (levels 1-2)"),
287         DEBUG_WORD(GENR, W_REC, "Debug generator functions"),
288         DEBUG_WORD(HASH, W_SND|W_REC, "Debug hashtable code"),
289         DEBUG_WORD(HLINK, W_SND|W_REC, "Debug hard-link actions (levels 1-3)"),
290         DEBUG_WORD(ICONV, W_CLI|W_SRV, "Debug iconv character conversions (levels 1-2)"),
291         DEBUG_WORD(IO, W_CLI|W_SRV, "Debug I/O routines (levels 1-4)"),
292         DEBUG_WORD(NSTR, W_CLI|W_SRV, "Debug negotiation strings"),
293         DEBUG_WORD(OWN, W_REC, "Debug ownership changes in users & groups (levels 1-2)"),
294         DEBUG_WORD(PROTO, W_CLI|W_SRV, "Debug protocol information"),
295         DEBUG_WORD(RECV, W_REC, "Debug receiver functions"),
296         DEBUG_WORD(SEND, W_SND, "Debug sender functions"),
297         DEBUG_WORD(TIME, W_REC, "Debug setting of modified times (levels 1-2)"),
298         { NULL, "--debug", 0, 0, 0, 0 }
299 };
300
301 static int verbose = 0;
302 static int do_stats = 0;
303 static int do_progress = 0;
304 static int daemon_opt;   /* sets am_daemon after option error-reporting */
305 static int omit_dir_times = 0;
306 static int omit_link_times = 0;
307 static int F_option_cnt = 0;
308 static int modify_window_set;
309 static int itemize_changes = 0;
310 static int refused_delete, refused_archive_part, refused_compress;
311 static int refused_partial, refused_progress, refused_delete_before;
312 static int refused_delete_during;
313 static int refused_inplace, refused_no_iconv;
314 static BOOL usermap_via_chown, groupmap_via_chown;
315 #ifdef HAVE_SETVBUF
316 static char *outbuf_mode;
317 #endif
318 static char *bwlimit_arg, *max_size_arg, *min_size_arg;
319 static char tmp_partialdir[] = ".~tmp~";
320
321 /** Local address to bind.  As a character string because it's
322  * interpreted by the IPv6 layer: should be a numeric IP4 or IP6
323  * address, or a hostname. **/
324 char *bind_address;
325
326 static void output_item_help(struct output_struct *words);
327
328 /* This constructs a string that represents all the options set for either
329  * the --info or --debug setting, skipping any implied options (by -v, etc.).
330  * This is used both when conveying the user's options to the server, and
331  * when the help output wants to tell the user what options are implied. */
332 static char *make_output_option(struct output_struct *words, short *levels, uchar where)
333 {
334         char *str = words == info_words ? "--info=" : "--debug=";
335         int j, counts[MAX_OUT_LEVEL+1], pos, skipped = 0, len = 0, max = 0, lev = 0;
336         int word_count = words == info_words ? COUNT_INFO : COUNT_DEBUG;
337         char *buf;
338
339         memset(counts, 0, sizeof counts);
340
341         for (j = 0; words[j].name; j++) {
342                 if (words[j].flag != j) {
343                         rprintf(FERROR, "rsync: internal error on %s%s: %d != %d\n",
344                                 words == info_words ? "INFO_" : "DEBUG_",
345                                 words[j].name, words[j].flag, j);
346                         exit_cleanup(RERR_UNSUPPORTED);
347                 }
348                 if (!(words[j].where & where))
349                         continue;
350                 if (words[j].priority == DEFAULT_PRIORITY) {
351                         /* Implied items don't need to be mentioned. */
352                         skipped++;
353                         continue;
354                 }
355                 len += len ? 1 : strlen(str);
356                 len += strlen(words[j].name);
357                 len += levels[j] == 1 ? 0 : 1;
358
359                 if (words[j].priority == HELP_PRIORITY)
360                         continue; /* no abbreviating for help */
361
362                 assert(levels[j] <= MAX_OUT_LEVEL);
363                 if (++counts[levels[j]] > max) {
364                         /* Determine which level has the most items. */
365                         lev = levels[j];
366                         max = counts[lev];
367                 }
368         }
369
370         /* Sanity check the COUNT_* define against the length of the table. */
371         if (j != word_count) {
372                 rprintf(FERROR, "rsync: internal error: %s is wrong! (%d != %d)\n",
373                         words == info_words ? "COUNT_INFO" : "COUNT_DEBUG",
374                         j, word_count);
375                 exit_cleanup(RERR_UNSUPPORTED);
376         }
377
378         if (!len)
379                 return NULL;
380
381         len++;
382         if (!(buf = new_array(char, len)))
383                 out_of_memory("make_output_option");
384         pos = 0;
385
386         if (skipped || max < 5)
387                 lev = -1;
388         else {
389                 if (lev == 0)
390                         pos += snprintf(buf, len, "%sNONE", str);
391                 else if (lev == 1)
392                         pos += snprintf(buf, len, "%sALL", str);
393                 else
394                         pos += snprintf(buf, len, "%sALL%d", str, lev);
395         }
396
397         for (j = 0; words[j].name && pos < len; j++) {
398                 if (words[j].priority == DEFAULT_PRIORITY || levels[j] == lev || !(words[j].where & where))
399                         continue;
400                 if (pos)
401                         buf[pos++] = ',';
402                 else
403                         pos += strlcpy(buf+pos, str, len-pos);
404                 if (pos < len)
405                         pos += strlcpy(buf+pos, words[j].name, len-pos);
406                 /* Level 1 is implied by the name alone. */
407                 if (levels[j] != 1 && pos < len)
408                         buf[pos++] = '0' + levels[j];
409         }
410
411         buf[pos] = '\0';
412
413         return buf;
414 }
415
416 static void parse_output_words(struct output_struct *words, short *levels,
417                                const char *str, uchar priority)
418 {
419         const char *s;
420         int j, len, lev;
421
422         for ( ; str; str = s) {
423                 if ((s = strchr(str, ',')) != NULL)
424                         len = s++ - str;
425                 else
426                         len = strlen(str);
427                 if (!len)
428                         continue;
429                 if (!isDigit(str)) {
430                         while (len && isDigit(str+len-1))
431                                 len--;
432                 }
433                 lev = isDigit(str+len) ? atoi(str+len) : 1;
434                 if (lev > MAX_OUT_LEVEL)
435                         lev = MAX_OUT_LEVEL;
436                 if (len == 4 && strncasecmp(str, "help", 4) == 0) {
437                         output_item_help(words);
438                         exit_cleanup(0);
439                 }
440                 if (len == 4 && strncasecmp(str, "none", 4) == 0)
441                         len = lev = 0;
442                 else if (len == 3 && strncasecmp(str, "all", 3) == 0)
443                         len = 0;
444                 for (j = 0; words[j].name; j++) {
445                         if (!len
446                          || (len == words[j].namelen && strncasecmp(str, words[j].name, len) == 0)) {
447                                 if (priority >= words[j].priority) {
448                                         words[j].priority = priority;
449                                         levels[j] = lev;
450                                 }
451                                 if (len)
452                                         break;
453                         }
454                 }
455                 if (len && !words[j].name && !am_server) {
456                         rprintf(FERROR, "Unknown %s item: \"%.*s\"\n",
457                                 words[j].help, len, str);
458                         exit_cleanup(RERR_SYNTAX);
459                 }
460         }
461 }
462
463 /* Tell the user what all the info or debug flags mean. */
464 static void output_item_help(struct output_struct *words)
465 {
466         short *levels = words == info_words ? info_levels : debug_levels;
467         const char **verbosity = words == info_words ? info_verbosity : debug_verbosity;
468         char buf[128], *opt, *fmt = "%-10s %s\n";
469         int j;
470
471         reset_output_levels();
472
473         rprintf(FINFO, "Use OPT or OPT1 for level 1 output, OPT2 for level 2, etc.; OPT0 silences.\n");
474         rprintf(FINFO, "\n");
475         for (j = 0; words[j].name; j++)
476                 rprintf(FINFO, fmt, words[j].name, words[j].help);
477         rprintf(FINFO, "\n");
478
479         snprintf(buf, sizeof buf, "Set all %s options (e.g. all%d)",
480                  words[j].help, MAX_OUT_LEVEL);
481         rprintf(FINFO, fmt, "ALL", buf);
482
483         snprintf(buf, sizeof buf, "Silence all %s options (same as all0)",
484                  words[j].help);
485         rprintf(FINFO, fmt, "NONE", buf);
486
487         rprintf(FINFO, fmt, "HELP", "Output this help message");
488         rprintf(FINFO, "\n");
489         rprintf(FINFO, "Options added for each increase in verbose level:\n");
490
491         for (j = 1; j <= MAX_VERBOSITY; j++) {
492                 parse_output_words(words, levels, verbosity[j], HELP_PRIORITY);
493                 opt = make_output_option(words, levels, W_CLI|W_SRV|W_SND|W_REC);
494                 if (opt) {
495                         rprintf(FINFO, "%d) %s\n", j, strchr(opt, '=')+1);
496                         free(opt);
497                 }
498                 reset_output_levels();
499         }
500 }
501
502 /* The --verbose option now sets info+debug flags. */
503 static void set_output_verbosity(int level, uchar priority)
504 {
505         int j;
506
507         if (level > MAX_VERBOSITY)
508                 level = MAX_VERBOSITY;
509
510         for (j = 1; j <= level; j++) {
511                 parse_output_words(info_words, info_levels, info_verbosity[j], priority);
512                 parse_output_words(debug_words, debug_levels, debug_verbosity[j], priority);
513         }
514 }
515
516 /* Limit the info+debug flag levels given a verbose-option level limit. */
517 void limit_output_verbosity(int level)
518 {
519         short info_limits[COUNT_INFO], debug_limits[COUNT_DEBUG];
520         int j;
521
522         if (level > MAX_VERBOSITY)
523                 return;
524
525         memset(info_limits, 0, sizeof info_limits);
526         memset(debug_limits, 0, sizeof debug_limits);
527
528         /* Compute the level limits in the above arrays. */
529         for (j = 1; j <= level; j++) {
530                 parse_output_words(info_words, info_limits, info_verbosity[j], LIMIT_PRIORITY);
531                 parse_output_words(debug_words, debug_limits, debug_verbosity[j], LIMIT_PRIORITY);
532         }
533
534         for (j = 0; j < COUNT_INFO; j++) {
535                 if (info_levels[j] > info_limits[j])
536                         info_levels[j] = info_limits[j];
537         }
538
539         for (j = 0; j < COUNT_DEBUG; j++) {
540                 if (debug_levels[j] > debug_limits[j])
541                         debug_levels[j] = debug_limits[j];
542         }
543 }
544
545 void reset_output_levels(void)
546 {
547         int j;
548
549         memset(info_levels, 0, sizeof info_levels);
550         memset(debug_levels, 0, sizeof debug_levels);
551
552         for (j = 0; j < COUNT_INFO; j++)
553                 info_words[j].priority = DEFAULT_PRIORITY;
554
555         for (j = 0; j < COUNT_DEBUG; j++)
556                 debug_words[j].priority = DEFAULT_PRIORITY;
557 }
558
559 void negate_output_levels(void)
560 {
561         int j;
562
563         for (j = 0; j < COUNT_INFO; j++)
564                 info_levels[j] *= -1;
565
566         for (j = 0; j < COUNT_DEBUG; j++)
567                 debug_levels[j] *= -1;
568 }
569
570 static void print_rsync_version(enum logcode f)
571 {
572         char *subprotocol = "";
573         char const *got_socketpair = "no ";
574         char const *have_inplace = "no ";
575         char const *hardlinks = "no ";
576         char const *prealloc = "no ";
577         char const *symtimes = "no ";
578         char const *acls = "no ";
579         char const *xattrs = "no ";
580         char const *links = "no ";
581         char const *iconv = "no ";
582         char const *ipv6 = "no ";
583         char const *simd = "no ";
584         char const *xxhash = "no ";
585         STRUCT_STAT *dumstat;
586
587 #if SUBPROTOCOL_VERSION != 0
588         if (asprintf(&subprotocol, ".PR%d", SUBPROTOCOL_VERSION) < 0)
589                 out_of_memory("print_rsync_version");
590 #endif
591 #ifdef HAVE_SOCKETPAIR
592         got_socketpair = "";
593 #endif
594 #ifdef HAVE_FTRUNCATE
595         have_inplace = "";
596 #endif
597 #ifdef SUPPORT_HARD_LINKS
598         hardlinks = "";
599 #endif
600 #ifdef SUPPORT_PREALLOCATION
601         prealloc = "";
602 #endif
603 #ifdef SUPPORT_ACLS
604         acls = "";
605 #endif
606 #ifdef SUPPORT_XATTRS
607         xattrs = "";
608 #endif
609 #ifdef SUPPORT_LINKS
610         links = "";
611 #endif
612 #ifdef INET6
613         ipv6 = "";
614 #endif
615 #ifdef ICONV_OPTION
616         iconv = "";
617 #endif
618 #ifdef CAN_SET_SYMLINK_TIMES
619         symtimes = "";
620 #endif
621 #ifdef HAVE_SIMD
622         simd = "";
623 #endif
624 #ifdef SUPPORT_XXHASH
625         xxhash = "";
626 #endif
627
628         rprintf(f, "%s  version %s  protocol version %d%s\n",
629                 RSYNC_NAME, RSYNC_VERSION, PROTOCOL_VERSION, subprotocol);
630         rprintf(f, "Copyright (C) 1996-" LATEST_YEAR " by Andrew Tridgell, Wayne Davison, and others.\n");
631         rprintf(f, "Web site: http://rsync.samba.org/\n");
632         rprintf(f, "Capabilities:\n");
633         rprintf(f, "    %d-bit files, %d-bit inums, %d-bit timestamps, %d-bit long ints,\n",
634                 (int)(sizeof (OFF_T) * 8),
635                 (int)(sizeof dumstat->st_ino * 8), /* Don't check ino_t! */
636                 (int)(sizeof (time_t) * 8),
637                 (int)(sizeof (int64) * 8));
638         rprintf(f, "    %ssocketpairs, %shardlinks, %ssymlinks, %sIPv6, batchfiles, %sinplace,\n",
639                 got_socketpair, hardlinks, links, ipv6, have_inplace);
640         rprintf(f, "    %sappend, %sACLs, %sxattrs, %siconv, %ssymtimes, %sprealloc, %sSIMD, %sxxhash\n",
641                 have_inplace, acls, xattrs, iconv, symtimes, prealloc, simd, xxhash);
642
643 #ifdef MAINTAINER_MODE
644         rprintf(f, "Panic Action: \"%s\"\n", get_panic_action());
645 #endif
646
647 #if SIZEOF_INT64 < 8
648         rprintf(f, "WARNING: no 64-bit integers on this platform!\n");
649 #endif
650         if (sizeof (int64) != SIZEOF_INT64) {
651                 rprintf(f,
652                         "WARNING: size mismatch in SIZEOF_INT64 define (%d != %d)\n",
653                         (int) SIZEOF_INT64, (int) sizeof (int64));
654         }
655
656         rprintf(f,"\n");
657         rprintf(f,"rsync comes with ABSOLUTELY NO WARRANTY.  This is free software, and you\n");
658         rprintf(f,"are welcome to redistribute it under certain conditions.  See the GNU\n");
659         rprintf(f,"General Public Licence for details.\n");
660 }
661
662
663 void usage(enum logcode F)
664 {
665   print_rsync_version(F);
666
667   rprintf(F,"\n");
668   rprintf(F,"rsync is a file transfer program capable of efficient remote update\n");
669   rprintf(F,"via a fast differencing algorithm.\n");
670
671   rprintf(F,"\n");
672   rprintf(F,"Usage: rsync [OPTION]... SRC [SRC]... DEST\n");
673   rprintf(F,"  or   rsync [OPTION]... SRC [SRC]... [USER@]HOST:DEST\n");
674   rprintf(F,"  or   rsync [OPTION]... SRC [SRC]... [USER@]HOST::DEST\n");
675   rprintf(F,"  or   rsync [OPTION]... SRC [SRC]... rsync://[USER@]HOST[:PORT]/DEST\n");
676   rprintf(F,"  or   rsync [OPTION]... [USER@]HOST:SRC [DEST]\n");
677   rprintf(F,"  or   rsync [OPTION]... [USER@]HOST::SRC [DEST]\n");
678   rprintf(F,"  or   rsync [OPTION]... rsync://[USER@]HOST[:PORT]/SRC [DEST]\n");
679   rprintf(F,"The ':' usages connect via remote shell, while '::' & 'rsync://' usages connect\n");
680   rprintf(F,"to an rsync daemon, and require SRC or DEST to start with a module name.\n");
681   rprintf(F,"\n");
682   rprintf(F,"Options\n");
683   rprintf(F," -v, --verbose               increase verbosity\n");
684   rprintf(F,"     --info=FLAGS            fine-grained informational verbosity\n");
685   rprintf(F,"     --debug=FLAGS           fine-grained debug verbosity\n");
686   rprintf(F,"     --msgs2stderr           special output handling for debugging\n");
687   rprintf(F," -q, --quiet                 suppress non-error messages\n");
688   rprintf(F,"     --no-motd               suppress daemon-mode MOTD (see manpage caveat)\n");
689   rprintf(F," -c, --checksum              skip based on checksum, not mod-time & size\n");
690   rprintf(F," -a, --archive               archive mode; equals -rlptgoD (no -H,-A,-X)\n");
691   rprintf(F,"     --no-OPTION             turn off an implied OPTION (e.g. --no-D)\n");
692   rprintf(F," -r, --recursive             recurse into directories\n");
693   rprintf(F," -R, --relative              use relative path names\n");
694   rprintf(F,"     --no-implied-dirs       don't send implied dirs with --relative\n");
695   rprintf(F," -b, --backup                make backups (see --suffix & --backup-dir)\n");
696   rprintf(F,"     --backup-dir=DIR        make backups into hierarchy based in DIR\n");
697   rprintf(F,"     --suffix=SUFFIX         set backup suffix (default %s w/o --backup-dir)\n",BACKUP_SUFFIX);
698   rprintf(F," -u, --update                skip files that are newer on the receiver\n");
699   rprintf(F,"     --inplace               update destination files in-place (SEE MAN PAGE)\n");
700   rprintf(F,"     --append                append data onto shorter files\n");
701   rprintf(F,"     --append-verify         like --append, but with old data in file checksum\n");
702   rprintf(F," -d, --dirs                  transfer directories without recursing\n");
703   rprintf(F," -l, --links                 copy symlinks as symlinks\n");
704   rprintf(F," -L, --copy-links            transform symlink into referent file/dir\n");
705   rprintf(F,"     --copy-unsafe-links     only \"unsafe\" symlinks are transformed\n");
706   rprintf(F,"     --safe-links            ignore symlinks that point outside the source tree\n");
707   rprintf(F,"     --munge-links           munge symlinks to make them safer (but unusable)\n");
708   rprintf(F," -k, --copy-dirlinks         transform symlink to a dir into referent dir\n");
709   rprintf(F," -K, --keep-dirlinks         treat symlinked dir on receiver as dir\n");
710   rprintf(F," -H, --hard-links            preserve hard links\n");
711   rprintf(F," -p, --perms                 preserve permissions\n");
712   rprintf(F," -E, --executability         preserve the file's executability\n");
713   rprintf(F,"     --chmod=CHMOD           affect file and/or directory permissions\n");
714 #ifdef SUPPORT_ACLS
715   rprintf(F," -A, --acls                  preserve ACLs (implies --perms)\n");
716 #endif
717 #ifdef SUPPORT_XATTRS
718   rprintf(F," -X, --xattrs                preserve extended attributes\n");
719 #endif
720   rprintf(F," -o, --owner                 preserve owner (super-user only)\n");
721   rprintf(F," -g, --group                 preserve group\n");
722   rprintf(F,"     --devices               preserve device files (super-user only)\n");
723   rprintf(F,"     --specials              preserve special files\n");
724   rprintf(F," -D                          same as --devices --specials\n");
725   rprintf(F," -t, --times                 preserve modification times\n");
726   rprintf(F," -U, --atimes                preserve access (last-used) times\n");
727   rprintf(F,"     --open-noatime          avoid changing the atime on opened files\n");
728   rprintf(F," -O, --omit-dir-times        omit directories from --times\n");
729   rprintf(F," -J, --omit-link-times       omit symlinks from --times\n");
730   rprintf(F,"     --super                 receiver attempts super-user activities\n");
731 #ifdef SUPPORT_XATTRS
732   rprintf(F,"     --fake-super            store/recover privileged attrs using xattrs\n");
733 #endif
734   rprintf(F," -S, --sparse                turn sequences of nulls into sparse blocks\n");
735 #ifdef SUPPORT_PREALLOCATION
736   rprintf(F,"     --preallocate           allocate dest files before writing them\n");
737 #else
738   rprintf(F,"     --preallocate           pre-allocate dest files on remote receiver\n");
739 #endif
740   rprintf(F,"     --write-devices         write to devices as files (implies --inplace)\n");
741   rprintf(F," -n, --dry-run               perform a trial run with no changes made\n");
742   rprintf(F," -W, --whole-file            copy files whole (without delta-xfer algorithm)\n");
743   rprintf(F,"     --checksum-choice=STR   choose the checksum algorithms\n");
744   rprintf(F," -x, --one-file-system       don't cross filesystem boundaries\n");
745   rprintf(F," -B, --block-size=SIZE       force a fixed checksum block-size\n");
746   rprintf(F," -e, --rsh=COMMAND           specify the remote shell to use\n");
747   rprintf(F,"     --rsync-path=PROGRAM    specify the rsync to run on the remote machine\n");
748   rprintf(F,"     --existing              skip creating new files on receiver\n");
749   rprintf(F,"     --ignore-existing       skip updating files that already exist on receiver\n");
750   rprintf(F,"     --remove-source-files   sender removes synchronized files (non-dirs)\n");
751   rprintf(F,"     --del                   an alias for --delete-during\n");
752   rprintf(F,"     --delete                delete extraneous files from destination dirs\n");
753   rprintf(F,"     --delete-before         receiver deletes before transfer, not during\n");
754   rprintf(F,"     --delete-during         receiver deletes during the transfer\n");
755   rprintf(F,"     --delete-delay          find deletions during, delete after\n");
756   rprintf(F,"     --delete-after          receiver deletes after transfer, not during\n");
757   rprintf(F,"     --delete-excluded       also delete excluded files from destination dirs\n");
758   rprintf(F,"     --ignore-missing-args   ignore missing source args without error\n");
759   rprintf(F,"     --delete-missing-args   delete missing source args from destination\n");
760   rprintf(F,"     --ignore-errors         delete even if there are I/O errors\n");
761   rprintf(F,"     --force                 force deletion of directories even if not empty\n");
762   rprintf(F,"     --max-delete=NUM        don't delete more than NUM files\n");
763   rprintf(F,"     --max-size=SIZE         don't transfer any file larger than SIZE\n");
764   rprintf(F,"     --min-size=SIZE         don't transfer any file smaller than SIZE\n");
765   rprintf(F,"     --partial               keep partially transferred files\n");
766   rprintf(F,"     --partial-dir=DIR       put a partially transferred file into DIR\n");
767   rprintf(F,"     --delay-updates         put all updated files into place at transfer's end\n");
768   rprintf(F," -m, --prune-empty-dirs      prune empty directory chains from the file-list\n");
769   rprintf(F,"     --numeric-ids           don't map uid/gid values by user/group name\n");
770   rprintf(F,"     --usermap=STRING        custom username mapping\n");
771   rprintf(F,"     --groupmap=STRING       custom groupname mapping\n");
772   rprintf(F,"     --chown=USER:GROUP      simple username/groupname mapping\n");
773   rprintf(F,"     --timeout=SECONDS       set I/O timeout in seconds\n");
774   rprintf(F,"     --contimeout=SECONDS    set daemon connection timeout in seconds\n");
775   rprintf(F," -I, --ignore-times          don't skip files that match in size and mod-time\n");
776   rprintf(F," -M, --remote-option=OPTION  send OPTION to the remote side only\n");
777   rprintf(F,"     --size-only             skip files that match in size\n");
778   rprintf(F," -@, --modify-window=NUM     set the accuracy for mod-time comparisons\n");
779   rprintf(F," -T, --temp-dir=DIR          create temporary files in directory DIR\n");
780   rprintf(F," -y, --fuzzy                 find similar file for basis if no dest file\n");
781   rprintf(F,"     --compare-dest=DIR      also compare destination files relative to DIR\n");
782   rprintf(F,"     --copy-dest=DIR         ... and include copies of unchanged files\n");
783   rprintf(F,"     --link-dest=DIR         hardlink to files in DIR when unchanged\n");
784   rprintf(F," -z, --compress              compress file data during the transfer\n");
785   rprintf(F,"     --compress-level=NUM    explicitly set compression level\n");
786   rprintf(F,"     --skip-compress=LIST    skip compressing files with a suffix in LIST\n");
787   rprintf(F," -C, --cvs-exclude           auto-ignore files the same way CVS does\n");
788   rprintf(F," -f, --filter=RULE           add a file-filtering RULE\n");
789   rprintf(F," -F                          same as --filter='dir-merge /.rsync-filter'\n");
790   rprintf(F,"                             repeated: --filter='- .rsync-filter'\n");
791   rprintf(F,"     --exclude=PATTERN       exclude files matching PATTERN\n");
792   rprintf(F,"     --exclude-from=FILE     read exclude patterns from FILE\n");
793   rprintf(F,"     --include=PATTERN       don't exclude files matching PATTERN\n");
794   rprintf(F,"     --include-from=FILE     read include patterns from FILE\n");
795   rprintf(F,"     --files-from=FILE       read list of source-file names from FILE\n");
796   rprintf(F," -0, --from0                 all *-from/filter files are delimited by 0s\n");
797   rprintf(F," -s, --protect-args          no space-splitting; only wildcard special-chars\n");
798   rprintf(F,"     --copy-as=USER[:GROUP]  specify user & optional group for the copy\n");
799   rprintf(F,"     --address=ADDRESS       bind address for outgoing socket to daemon\n");
800   rprintf(F,"     --port=PORT             specify double-colon alternate port number\n");
801   rprintf(F,"     --sockopts=OPTIONS      specify custom TCP options\n");
802   rprintf(F,"     --blocking-io           use blocking I/O for the remote shell\n");
803   rprintf(F,"     --stats                 give some file-transfer stats\n");
804   rprintf(F," -8, --8-bit-output          leave high-bit chars unescaped in output\n");
805   rprintf(F," -h, --human-readable        output numbers in a human-readable format\n");
806   rprintf(F,"     --progress              show progress during transfer\n");
807   rprintf(F," -P                          same as --partial --progress\n");
808   rprintf(F," -i, --itemize-changes       output a change-summary for all updates\n");
809   rprintf(F,"     --out-format=FORMAT     output updates using the specified FORMAT\n");
810   rprintf(F,"     --log-file=FILE         log what we're doing to the specified FILE\n");
811   rprintf(F,"     --log-file-format=FMT   log updates using the specified FMT\n");
812   rprintf(F,"     --password-file=FILE    read daemon-access password from FILE\n");
813   rprintf(F,"     --list-only             list the files instead of copying them\n");
814   rprintf(F,"     --bwlimit=RATE          limit socket I/O bandwidth\n");
815 #ifdef HAVE_SETVBUF
816   rprintf(F,"     --outbuf=N|L|B          set output buffering to None, Line, or Block\n");
817 #endif
818   rprintf(F,"     --write-batch=FILE      write a batched update to FILE\n");
819   rprintf(F,"     --only-write-batch=FILE like --write-batch but w/o updating destination\n");
820   rprintf(F,"     --read-batch=FILE       read a batched update from FILE\n");
821   rprintf(F,"     --protocol=NUM          force an older protocol version to be used\n");
822 #ifdef ICONV_OPTION
823   rprintf(F,"     --iconv=CONVERT_SPEC    request charset conversion of filenames\n");
824 #endif
825   rprintf(F,"     --checksum-seed=NUM     set block/file checksum seed (advanced)\n");
826   rprintf(F," -4, --ipv4                  prefer IPv4\n");
827   rprintf(F," -6, --ipv6                  prefer IPv6\n");
828   rprintf(F,"     --version               print version number\n");
829   rprintf(F,"(-h) --help                  show this help (-h is --help only if used alone)\n");
830
831   rprintf(F,"\n");
832   rprintf(F,"Use \"rsync --daemon --help\" to see the daemon-mode command-line options.\n");
833   rprintf(F,"Please see the rsync(1) and rsyncd.conf(5) man pages for full documentation.\n");
834   rprintf(F,"See http://rsync.samba.org/ for updates, bug reports, and answers\n");
835 }
836
837 enum {OPT_VERSION = 1000, OPT_DAEMON, OPT_SENDER, OPT_EXCLUDE, OPT_EXCLUDE_FROM,
838       OPT_FILTER, OPT_COMPARE_DEST, OPT_COPY_DEST, OPT_LINK_DEST, OPT_HELP,
839       OPT_INCLUDE, OPT_INCLUDE_FROM, OPT_MODIFY_WINDOW, OPT_MIN_SIZE, OPT_CHMOD,
840       OPT_READ_BATCH, OPT_WRITE_BATCH, OPT_ONLY_WRITE_BATCH, OPT_MAX_SIZE,
841       OPT_NO_D, OPT_APPEND, OPT_NO_ICONV, OPT_INFO, OPT_DEBUG,
842       OPT_USERMAP, OPT_GROUPMAP, OPT_CHOWN, OPT_BWLIMIT,
843       OPT_SERVER, OPT_REFUSED_BASE = 9000};
844
845 static struct poptOption long_options[] = {
846   /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
847   {"help",             0,  POPT_ARG_NONE,   0, OPT_HELP, 0, 0 },
848   {"version",          0,  POPT_ARG_NONE,   0, OPT_VERSION, 0, 0},
849   {"verbose",         'v', POPT_ARG_NONE,   0, 'v', 0, 0 },
850   {"no-verbose",       0,  POPT_ARG_VAL,    &verbose, 0, 0, 0 },
851   {"no-v",             0,  POPT_ARG_VAL,    &verbose, 0, 0, 0 },
852   {"info",             0,  POPT_ARG_STRING, 0, OPT_INFO, 0, 0 },
853   {"debug",            0,  POPT_ARG_STRING, 0, OPT_DEBUG, 0, 0 },
854   {"msgs2stderr",      0,  POPT_ARG_NONE,   &msgs2stderr, 0, 0, 0 },
855   {"quiet",           'q', POPT_ARG_NONE,   0, 'q', 0, 0 },
856   {"motd",             0,  POPT_ARG_VAL,    &output_motd, 1, 0, 0 },
857   {"no-motd",          0,  POPT_ARG_VAL,    &output_motd, 0, 0, 0 },
858   {"stats",            0,  POPT_ARG_NONE,   &do_stats, 0, 0, 0 },
859   {"human-readable",  'h', POPT_ARG_NONE,   0, 'h', 0, 0},
860   {"no-human-readable",0,  POPT_ARG_VAL,    &human_readable, 0, 0, 0},
861   {"no-h",             0,  POPT_ARG_VAL,    &human_readable, 0, 0, 0},
862   {"dry-run",         'n', POPT_ARG_NONE,   &dry_run, 0, 0, 0 },
863   {"archive",         'a', POPT_ARG_NONE,   0, 'a', 0, 0 },
864   {"recursive",       'r', POPT_ARG_VAL,    &recurse, 2, 0, 0 },
865   {"no-recursive",     0,  POPT_ARG_VAL,    &recurse, 0, 0, 0 },
866   {"no-r",             0,  POPT_ARG_VAL,    &recurse, 0, 0, 0 },
867   {"inc-recursive",    0,  POPT_ARG_VAL,    &allow_inc_recurse, 1, 0, 0 },
868   {"no-inc-recursive", 0,  POPT_ARG_VAL,    &allow_inc_recurse, 0, 0, 0 },
869   {"i-r",              0,  POPT_ARG_VAL,    &allow_inc_recurse, 1, 0, 0 },
870   {"no-i-r",           0,  POPT_ARG_VAL,    &allow_inc_recurse, 0, 0, 0 },
871   {"dirs",            'd', POPT_ARG_VAL,    &xfer_dirs, 2, 0, 0 },
872   {"no-dirs",          0,  POPT_ARG_VAL,    &xfer_dirs, 0, 0, 0 },
873   {"no-d",             0,  POPT_ARG_VAL,    &xfer_dirs, 0, 0, 0 },
874   {"old-dirs",         0,  POPT_ARG_VAL,    &xfer_dirs, 4, 0, 0 },
875   {"old-d",            0,  POPT_ARG_VAL,    &xfer_dirs, 4, 0, 0 },
876   {"perms",           'p', POPT_ARG_VAL,    &preserve_perms, 1, 0, 0 },
877   {"no-perms",         0,  POPT_ARG_VAL,    &preserve_perms, 0, 0, 0 },
878   {"no-p",             0,  POPT_ARG_VAL,    &preserve_perms, 0, 0, 0 },
879   {"executability",   'E', POPT_ARG_NONE,   &preserve_executability, 0, 0, 0 },
880   {"acls",            'A', POPT_ARG_NONE,   0, 'A', 0, 0 },
881   {"no-acls",          0,  POPT_ARG_VAL,    &preserve_acls, 0, 0, 0 },
882   {"no-A",             0,  POPT_ARG_VAL,    &preserve_acls, 0, 0, 0 },
883   {"xattrs",          'X', POPT_ARG_NONE,   0, 'X', 0, 0 },
884   {"no-xattrs",        0,  POPT_ARG_VAL,    &preserve_xattrs, 0, 0, 0 },
885   {"no-X",             0,  POPT_ARG_VAL,    &preserve_xattrs, 0, 0, 0 },
886   {"times",           't', POPT_ARG_VAL,    &preserve_times, 1, 0, 0 },
887   {"no-times",         0,  POPT_ARG_VAL,    &preserve_times, 0, 0, 0 },
888   {"no-t",             0,  POPT_ARG_VAL,    &preserve_times, 0, 0, 0 },
889   {"atimes",          'U', POPT_ARG_NONE,   0, 'U', 0, 0 },
890   {"no-atimes",        0,  POPT_ARG_VAL,    &preserve_atimes, 0, 0, 0 },
891   {"no-U",             0,  POPT_ARG_VAL,    &preserve_atimes, 0, 0, 0 },
892   {"open-noatime",     0,  POPT_ARG_VAL,    &open_noatime, 1, 0, 0 },
893   {"no-open-noatime",  0,  POPT_ARG_VAL,    &open_noatime, 0, 0, 0 },
894   {"omit-dir-times",  'O', POPT_ARG_VAL,    &omit_dir_times, 1, 0, 0 },
895   {"no-omit-dir-times",0,  POPT_ARG_VAL,    &omit_dir_times, 0, 0, 0 },
896   {"no-O",             0,  POPT_ARG_VAL,    &omit_dir_times, 0, 0, 0 },
897   {"omit-link-times", 'J', POPT_ARG_VAL,    &omit_link_times, 1, 0, 0 },
898   {"no-omit-link-times",0, POPT_ARG_VAL,    &omit_link_times, 0, 0, 0 },
899   {"no-J",             0,  POPT_ARG_VAL,    &omit_link_times, 0, 0, 0 },
900   {"modify-window",   '@', POPT_ARG_INT,    &modify_window, OPT_MODIFY_WINDOW, 0, 0 },
901   {"super",            0,  POPT_ARG_VAL,    &am_root, 2, 0, 0 },
902   {"no-super",         0,  POPT_ARG_VAL,    &am_root, 0, 0, 0 },
903   {"fake-super",       0,  POPT_ARG_VAL,    &am_root, -1, 0, 0 },
904   {"owner",           'o', POPT_ARG_VAL,    &preserve_uid, 1, 0, 0 },
905   {"no-owner",         0,  POPT_ARG_VAL,    &preserve_uid, 0, 0, 0 },
906   {"no-o",             0,  POPT_ARG_VAL,    &preserve_uid, 0, 0, 0 },
907   {"group",           'g', POPT_ARG_VAL,    &preserve_gid, 1, 0, 0 },
908   {"no-group",         0,  POPT_ARG_VAL,    &preserve_gid, 0, 0, 0 },
909   {"no-g",             0,  POPT_ARG_VAL,    &preserve_gid, 0, 0, 0 },
910   {0,                 'D', POPT_ARG_NONE,   0, 'D', 0, 0 },
911   {"no-D",             0,  POPT_ARG_NONE,   0, OPT_NO_D, 0, 0 },
912   {"devices",          0,  POPT_ARG_VAL,    &preserve_devices, 1, 0, 0 },
913   {"no-devices",       0,  POPT_ARG_VAL,    &preserve_devices, 0, 0, 0 },
914   {"write-devices",    0,  POPT_ARG_VAL,    &write_devices, 1, 0, 0 },
915   {"no-write-devices", 0,  POPT_ARG_VAL,    &write_devices, 0, 0, 0 },
916   {"specials",         0,  POPT_ARG_VAL,    &preserve_specials, 1, 0, 0 },
917   {"no-specials",      0,  POPT_ARG_VAL,    &preserve_specials, 0, 0, 0 },
918   {"links",           'l', POPT_ARG_VAL,    &preserve_links, 1, 0, 0 },
919   {"no-links",         0,  POPT_ARG_VAL,    &preserve_links, 0, 0, 0 },
920   {"no-l",             0,  POPT_ARG_VAL,    &preserve_links, 0, 0, 0 },
921   {"copy-links",      'L', POPT_ARG_NONE,   &copy_links, 0, 0, 0 },
922   {"copy-unsafe-links",0,  POPT_ARG_NONE,   &copy_unsafe_links, 0, 0, 0 },
923   {"safe-links",       0,  POPT_ARG_NONE,   &safe_symlinks, 0, 0, 0 },
924   {"munge-links",      0,  POPT_ARG_VAL,    &munge_symlinks, 1, 0, 0 },
925   {"no-munge-links",   0,  POPT_ARG_VAL,    &munge_symlinks, 0, 0, 0 },
926   {"copy-dirlinks",   'k', POPT_ARG_NONE,   &copy_dirlinks, 0, 0, 0 },
927   {"keep-dirlinks",   'K', POPT_ARG_NONE,   &keep_dirlinks, 0, 0, 0 },
928   {"hard-links",      'H', POPT_ARG_NONE,   0, 'H', 0, 0 },
929   {"no-hard-links",    0,  POPT_ARG_VAL,    &preserve_hard_links, 0, 0, 0 },
930   {"no-H",             0,  POPT_ARG_VAL,    &preserve_hard_links, 0, 0, 0 },
931   {"relative",        'R', POPT_ARG_VAL,    &relative_paths, 1, 0, 0 },
932   {"no-relative",      0,  POPT_ARG_VAL,    &relative_paths, 0, 0, 0 },
933   {"no-R",             0,  POPT_ARG_VAL,    &relative_paths, 0, 0, 0 },
934   {"implied-dirs",     0,  POPT_ARG_VAL,    &implied_dirs, 1, 0, 0 },
935   {"no-implied-dirs",  0,  POPT_ARG_VAL,    &implied_dirs, 0, 0, 0 },
936   {"i-d",              0,  POPT_ARG_VAL,    &implied_dirs, 1, 0, 0 },
937   {"no-i-d",           0,  POPT_ARG_VAL,    &implied_dirs, 0, 0, 0 },
938   {"chmod",            0,  POPT_ARG_STRING, 0, OPT_CHMOD, 0, 0 },
939   {"ignore-times",    'I', POPT_ARG_NONE,   &ignore_times, 0, 0, 0 },
940   {"size-only",        0,  POPT_ARG_NONE,   &size_only, 0, 0, 0 },
941   {"one-file-system", 'x', POPT_ARG_NONE,   0, 'x', 0, 0 },
942   {"no-one-file-system",0, POPT_ARG_VAL,    &one_file_system, 0, 0, 0 },
943   {"no-x",             0,  POPT_ARG_VAL,    &one_file_system, 0, 0, 0 },
944   {"update",          'u', POPT_ARG_NONE,   &update_only, 0, 0, 0 },
945   {"existing",         0,  POPT_ARG_NONE,   &ignore_non_existing, 0, 0, 0 },
946   {"ignore-non-existing",0,POPT_ARG_NONE,   &ignore_non_existing, 0, 0, 0 },
947   {"ignore-existing",  0,  POPT_ARG_NONE,   &ignore_existing, 0, 0, 0 },
948   {"max-size",         0,  POPT_ARG_STRING, &max_size_arg, OPT_MAX_SIZE, 0, 0 },
949   {"min-size",         0,  POPT_ARG_STRING, &min_size_arg, OPT_MIN_SIZE, 0, 0 },
950   {"sparse",          'S', POPT_ARG_VAL,    &sparse_files, 1, 0, 0 },
951   {"no-sparse",        0,  POPT_ARG_VAL,    &sparse_files, 0, 0, 0 },
952   {"no-S",             0,  POPT_ARG_VAL,    &sparse_files, 0, 0, 0 },
953   {"preallocate",      0,  POPT_ARG_NONE,   &preallocate_files, 0, 0, 0},
954   {"inplace",          0,  POPT_ARG_VAL,    &inplace, 1, 0, 0 },
955   {"no-inplace",       0,  POPT_ARG_VAL,    &inplace, 0, 0, 0 },
956   {"append",           0,  POPT_ARG_NONE,   0, OPT_APPEND, 0, 0 },
957   {"append-verify",    0,  POPT_ARG_VAL,    &append_mode, 2, 0, 0 },
958   {"no-append",        0,  POPT_ARG_VAL,    &append_mode, 0, 0, 0 },
959   {"del",              0,  POPT_ARG_NONE,   &delete_during, 0, 0, 0 },
960   {"delete",           0,  POPT_ARG_NONE,   &delete_mode, 0, 0, 0 },
961   {"delete-before",    0,  POPT_ARG_NONE,   &delete_before, 0, 0, 0 },
962   {"delete-during",    0,  POPT_ARG_VAL,    &delete_during, 1, 0, 0 },
963   {"delete-delay",     0,  POPT_ARG_VAL,    &delete_during, 2, 0, 0 },
964   {"delete-after",     0,  POPT_ARG_NONE,   &delete_after, 0, 0, 0 },
965   {"delete-excluded",  0,  POPT_ARG_NONE,   &delete_excluded, 0, 0, 0 },
966   {"delete-missing-args",0,POPT_BIT_SET,    &missing_args, 2, 0, 0 },
967   {"ignore-missing-args",0,POPT_BIT_SET,    &missing_args, 1, 0, 0 },
968   {"remove-sent-files",0,  POPT_ARG_VAL,    &remove_source_files, 2, 0, 0 }, /* deprecated */
969   {"remove-source-files",0,POPT_ARG_VAL,    &remove_source_files, 1, 0, 0 },
970   {"force",            0,  POPT_ARG_VAL,    &force_delete, 1, 0, 0 },
971   {"no-force",         0,  POPT_ARG_VAL,    &force_delete, 0, 0, 0 },
972   {"ignore-errors",    0,  POPT_ARG_VAL,    &ignore_errors, 1, 0, 0 },
973   {"no-ignore-errors", 0,  POPT_ARG_VAL,    &ignore_errors, 0, 0, 0 },
974   {"max-delete",       0,  POPT_ARG_INT,    &max_delete, 0, 0, 0 },
975   {0,                 'F', POPT_ARG_NONE,   0, 'F', 0, 0 },
976   {"filter",          'f', POPT_ARG_STRING, 0, OPT_FILTER, 0, 0 },
977   {"exclude",          0,  POPT_ARG_STRING, 0, OPT_EXCLUDE, 0, 0 },
978   {"include",          0,  POPT_ARG_STRING, 0, OPT_INCLUDE, 0, 0 },
979   {"exclude-from",     0,  POPT_ARG_STRING, 0, OPT_EXCLUDE_FROM, 0, 0 },
980   {"include-from",     0,  POPT_ARG_STRING, 0, OPT_INCLUDE_FROM, 0, 0 },
981   {"cvs-exclude",     'C', POPT_ARG_NONE,   &cvs_exclude, 0, 0, 0 },
982   {"whole-file",      'W', POPT_ARG_VAL,    &whole_file, 1, 0, 0 },
983   {"no-whole-file",    0,  POPT_ARG_VAL,    &whole_file, 0, 0, 0 },
984   {"checksum-choice",  0,  POPT_ARG_STRING, &checksum_choice, 0, 0, 0 },
985   {"no-W",             0,  POPT_ARG_VAL,    &whole_file, 0, 0, 0 },
986   {"checksum",        'c', POPT_ARG_VAL,    &always_checksum, 1, 0, 0 },
987   {"no-checksum",      0,  POPT_ARG_VAL,    &always_checksum, 0, 0, 0 },
988   {"no-c",             0,  POPT_ARG_VAL,    &always_checksum, 0, 0, 0 },
989   {"block-size",      'B', POPT_ARG_LONG,   &block_size, 0, 0, 0 },
990   {"compare-dest",     0,  POPT_ARG_STRING, 0, OPT_COMPARE_DEST, 0, 0 },
991   {"copy-dest",        0,  POPT_ARG_STRING, 0, OPT_COPY_DEST, 0, 0 },
992   {"link-dest",        0,  POPT_ARG_STRING, 0, OPT_LINK_DEST, 0, 0 },
993   {"fuzzy",           'y', POPT_ARG_NONE,   0, 'y', 0, 0 },
994   {"no-fuzzy",         0,  POPT_ARG_VAL,    &fuzzy_basis, 0, 0, 0 },
995   {"no-y",             0,  POPT_ARG_VAL,    &fuzzy_basis, 0, 0, 0 },
996   {"compress",        'z', POPT_ARG_NONE,   0, 'z', 0, 0 },
997   {"old-compress",     0,  POPT_ARG_VAL,    &do_compression, 1, 0, 0 },
998   {"new-compress",     0,  POPT_ARG_VAL,    &do_compression, 2, 0, 0 },
999   {"no-compress",      0,  POPT_ARG_VAL,    &do_compression, 0, 0, 0 },
1000   {"no-z",             0,  POPT_ARG_VAL,    &do_compression, 0, 0, 0 },
1001   {"skip-compress",    0,  POPT_ARG_STRING, &skip_compress, 0, 0, 0 },
1002   {"compress-level",   0,  POPT_ARG_INT,    &def_compress_level, 0, 0, 0 },
1003   {0,                 'P', POPT_ARG_NONE,   0, 'P', 0, 0 },
1004   {"progress",         0,  POPT_ARG_VAL,    &do_progress, 1, 0, 0 },
1005   {"no-progress",      0,  POPT_ARG_VAL,    &do_progress, 0, 0, 0 },
1006   {"partial",          0,  POPT_ARG_VAL,    &keep_partial, 1, 0, 0 },
1007   {"no-partial",       0,  POPT_ARG_VAL,    &keep_partial, 0, 0, 0 },
1008   {"partial-dir",      0,  POPT_ARG_STRING, &partial_dir, 0, 0, 0 },
1009   {"delay-updates",    0,  POPT_ARG_VAL,    &delay_updates, 1, 0, 0 },
1010   {"no-delay-updates", 0,  POPT_ARG_VAL,    &delay_updates, 0, 0, 0 },
1011   {"prune-empty-dirs",'m', POPT_ARG_VAL,    &prune_empty_dirs, 1, 0, 0 },
1012   {"no-prune-empty-dirs",0,POPT_ARG_VAL,    &prune_empty_dirs, 0, 0, 0 },
1013   {"no-m",             0,  POPT_ARG_VAL,    &prune_empty_dirs, 0, 0, 0 },
1014   {"log-file",         0,  POPT_ARG_STRING, &logfile_name, 0, 0, 0 },
1015   {"log-file-format",  0,  POPT_ARG_STRING, &logfile_format, 0, 0, 0 },
1016   {"out-format",       0,  POPT_ARG_STRING, &stdout_format, 0, 0, 0 },
1017   {"log-format",       0,  POPT_ARG_STRING, &stdout_format, 0, 0, 0 }, /* DEPRECATED */
1018   {"itemize-changes", 'i', POPT_ARG_NONE,   0, 'i', 0, 0 },
1019   {"no-itemize-changes",0, POPT_ARG_VAL,    &itemize_changes, 0, 0, 0 },
1020   {"no-i",             0,  POPT_ARG_VAL,    &itemize_changes, 0, 0, 0 },
1021   {"bwlimit",          0,  POPT_ARG_STRING, &bwlimit_arg, OPT_BWLIMIT, 0, 0 },
1022   {"no-bwlimit",       0,  POPT_ARG_VAL,    &bwlimit, 0, 0, 0 },
1023   {"backup",          'b', POPT_ARG_VAL,    &make_backups, 1, 0, 0 },
1024   {"no-backup",        0,  POPT_ARG_VAL,    &make_backups, 0, 0, 0 },
1025   {"backup-dir",       0,  POPT_ARG_STRING, &backup_dir, 0, 0, 0 },
1026   {"suffix",           0,  POPT_ARG_STRING, &backup_suffix, 0, 0, 0 },
1027   {"list-only",        0,  POPT_ARG_VAL,    &list_only, 2, 0, 0 },
1028   {"read-batch",       0,  POPT_ARG_STRING, &batch_name, OPT_READ_BATCH, 0, 0 },
1029   {"write-batch",      0,  POPT_ARG_STRING, &batch_name, OPT_WRITE_BATCH, 0, 0 },
1030   {"only-write-batch", 0,  POPT_ARG_STRING, &batch_name, OPT_ONLY_WRITE_BATCH, 0, 0 },
1031   {"files-from",       0,  POPT_ARG_STRING, &files_from, 0, 0, 0 },
1032   {"from0",           '0', POPT_ARG_VAL,    &eol_nulls, 1, 0, 0},
1033   {"no-from0",         0,  POPT_ARG_VAL,    &eol_nulls, 0, 0, 0},
1034   {"protect-args",    's', POPT_ARG_VAL,    &protect_args, 1, 0, 0},
1035   {"no-protect-args",  0,  POPT_ARG_VAL,    &protect_args, 0, 0, 0},
1036   {"no-s",             0,  POPT_ARG_VAL,    &protect_args, 0, 0, 0},
1037   {"numeric-ids",      0,  POPT_ARG_VAL,    &numeric_ids, 1, 0, 0 },
1038   {"no-numeric-ids",   0,  POPT_ARG_VAL,    &numeric_ids, 0, 0, 0 },
1039   {"usermap",          0,  POPT_ARG_STRING, 0, OPT_USERMAP, 0, 0 },
1040   {"groupmap",         0,  POPT_ARG_STRING, 0, OPT_GROUPMAP, 0, 0 },
1041   {"chown",            0,  POPT_ARG_STRING, 0, OPT_CHOWN, 0, 0 },
1042   {"timeout",          0,  POPT_ARG_INT,    &io_timeout, 0, 0, 0 },
1043   {"no-timeout",       0,  POPT_ARG_VAL,    &io_timeout, 0, 0, 0 },
1044   {"contimeout",       0,  POPT_ARG_INT,    &connect_timeout, 0, 0, 0 },
1045   {"no-contimeout",    0,  POPT_ARG_VAL,    &connect_timeout, 0, 0, 0 },
1046   {"rsh",             'e', POPT_ARG_STRING, &shell_cmd, 0, 0, 0 },
1047   {"rsync-path",       0,  POPT_ARG_STRING, &rsync_path, 0, 0, 0 },
1048   {"temp-dir",        'T', POPT_ARG_STRING, &tmpdir, 0, 0, 0 },
1049 #ifdef ICONV_OPTION
1050   {"iconv",            0,  POPT_ARG_STRING, &iconv_opt, 0, 0, 0 },
1051   {"no-iconv",         0,  POPT_ARG_NONE,   0, OPT_NO_ICONV, 0, 0 },
1052 #endif
1053   {"ipv4",            '4', POPT_ARG_VAL,    &default_af_hint, AF_INET, 0, 0 },
1054   {"ipv6",            '6', POPT_ARG_VAL,    &default_af_hint, AF_INET6, 0, 0 },
1055   {"8-bit-output",    '8', POPT_ARG_VAL,    &allow_8bit_chars, 1, 0, 0 },
1056   {"no-8-bit-output",  0,  POPT_ARG_VAL,    &allow_8bit_chars, 0, 0, 0 },
1057   {"no-8",             0,  POPT_ARG_VAL,    &allow_8bit_chars, 0, 0, 0 },
1058   {"qsort",            0,  POPT_ARG_NONE,   &use_qsort, 0, 0, 0 },
1059   {"copy-as",          0,  POPT_ARG_STRING, &copy_as, 0, 0, 0 },
1060   {"address",          0,  POPT_ARG_STRING, &bind_address, 0, 0, 0 },
1061   {"port",             0,  POPT_ARG_INT,    &rsync_port, 0, 0, 0 },
1062   {"sockopts",         0,  POPT_ARG_STRING, &sockopts, 0, 0, 0 },
1063   {"password-file",    0,  POPT_ARG_STRING, &password_file, 0, 0, 0 },
1064   {"blocking-io",      0,  POPT_ARG_VAL,    &blocking_io, 1, 0, 0 },
1065   {"no-blocking-io",   0,  POPT_ARG_VAL,    &blocking_io, 0, 0, 0 },
1066 #ifdef HAVE_SETVBUF
1067   {"outbuf",           0,  POPT_ARG_STRING, &outbuf_mode, 0, 0, 0 },
1068 #endif
1069   {"remote-option",   'M', POPT_ARG_STRING, 0, 'M', 0, 0 },
1070   {"protocol",         0,  POPT_ARG_INT,    &protocol_version, 0, 0, 0 },
1071   {"checksum-seed",    0,  POPT_ARG_INT,    &checksum_seed, 0, 0, 0 },
1072   {"server",           0,  POPT_ARG_NONE,   0, OPT_SERVER, 0, 0 },
1073   {"sender",           0,  POPT_ARG_NONE,   0, OPT_SENDER, 0, 0 },
1074   /* All the following options switch us into daemon-mode option-parsing. */
1075   {"config",           0,  POPT_ARG_STRING, 0, OPT_DAEMON, 0, 0 },
1076   {"daemon",           0,  POPT_ARG_NONE,   0, OPT_DAEMON, 0, 0 },
1077   {"dparam",           0,  POPT_ARG_STRING, 0, OPT_DAEMON, 0, 0 },
1078   {"detach",           0,  POPT_ARG_NONE,   0, OPT_DAEMON, 0, 0 },
1079   {"no-detach",        0,  POPT_ARG_NONE,   0, OPT_DAEMON, 0, 0 },
1080   {0,0,0,0, 0, 0, 0}
1081 };
1082
1083 static void daemon_usage(enum logcode F)
1084 {
1085   print_rsync_version(F);
1086
1087   rprintf(F,"\n");
1088   rprintf(F,"Usage: rsync --daemon [OPTION]...\n");
1089   rprintf(F,"     --address=ADDRESS       bind to the specified address\n");
1090   rprintf(F,"     --bwlimit=RATE          limit socket I/O bandwidth\n");
1091   rprintf(F,"     --config=FILE           specify alternate rsyncd.conf file\n");
1092   rprintf(F," -M, --dparam=OVERRIDE       override global daemon config parameter\n");
1093   rprintf(F,"     --no-detach             do not detach from the parent\n");
1094   rprintf(F,"     --port=PORT             listen on alternate port number\n");
1095   rprintf(F,"     --log-file=FILE         override the \"log file\" setting\n");
1096   rprintf(F,"     --log-file-format=FMT   override the \"log format\" setting\n");
1097   rprintf(F,"     --sockopts=OPTIONS      specify custom TCP options\n");
1098   rprintf(F," -v, --verbose               increase verbosity\n");
1099   rprintf(F," -4, --ipv4                  prefer IPv4\n");
1100   rprintf(F," -6, --ipv6                  prefer IPv6\n");
1101   rprintf(F,"     --help                  show this help screen\n");
1102
1103   rprintf(F,"\n");
1104   rprintf(F,"If you were not trying to invoke rsync as a daemon, avoid using any of the\n");
1105   rprintf(F,"daemon-specific rsync options.  See also the rsyncd.conf(5) man page.\n");
1106 }
1107
1108 static struct poptOption long_daemon_options[] = {
1109   /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
1110   {"address",          0,  POPT_ARG_STRING, &bind_address, 0, 0, 0 },
1111   {"bwlimit",          0,  POPT_ARG_INT,    &daemon_bwlimit, 0, 0, 0 },
1112   {"config",           0,  POPT_ARG_STRING, &config_file, 0, 0, 0 },
1113   {"daemon",           0,  POPT_ARG_NONE,   &daemon_opt, 0, 0, 0 },
1114   {"dparam",          'M', POPT_ARG_STRING, 0, 'M', 0, 0 },
1115   {"ipv4",            '4', POPT_ARG_VAL,    &default_af_hint, AF_INET, 0, 0 },
1116   {"ipv6",            '6', POPT_ARG_VAL,    &default_af_hint, AF_INET6, 0, 0 },
1117   {"detach",           0,  POPT_ARG_VAL,    &no_detach, 0, 0, 0 },
1118   {"no-detach",        0,  POPT_ARG_VAL,    &no_detach, 1, 0, 0 },
1119   {"log-file",         0,  POPT_ARG_STRING, &logfile_name, 0, 0, 0 },
1120   {"log-file-format",  0,  POPT_ARG_STRING, &logfile_format, 0, 0, 0 },
1121   {"port",             0,  POPT_ARG_INT,    &rsync_port, 0, 0, 0 },
1122   {"sockopts",         0,  POPT_ARG_STRING, &sockopts, 0, 0, 0 },
1123   {"protocol",         0,  POPT_ARG_INT,    &protocol_version, 0, 0, 0 },
1124   {"server",           0,  POPT_ARG_NONE,   &am_server, 0, 0, 0 },
1125   {"temp-dir",        'T', POPT_ARG_STRING, &tmpdir, 0, 0, 0 },
1126   {"verbose",         'v', POPT_ARG_NONE,   0, 'v', 0, 0 },
1127   {"no-verbose",       0,  POPT_ARG_VAL,    &verbose, 0, 0, 0 },
1128   {"no-v",             0,  POPT_ARG_VAL,    &verbose, 0, 0, 0 },
1129   {"help",            'h', POPT_ARG_NONE,   0, 'h', 0, 0 },
1130   {0,0,0,0, 0, 0, 0}
1131 };
1132
1133
1134 static char err_buf[200];
1135
1136
1137 /**
1138  * Store the option error message, if any, so that we can log the
1139  * connection attempt (which requires parsing the options), and then
1140  * show the error later on.
1141  **/
1142 void option_error(void)
1143 {
1144         if (!err_buf[0]) {
1145                 strlcpy(err_buf, "Error parsing options: option may "
1146                         "be supported on client but not on server?\n",
1147                         sizeof err_buf);
1148         }
1149
1150         rprintf(FERROR, RSYNC_NAME ": %s", err_buf);
1151         io_flush(FULL_FLUSH);
1152         msleep(20);
1153 }
1154
1155
1156 static void parse_one_refuse_match(int negated, const char *ref, const struct poptOption *list_end)
1157 {
1158         struct poptOption *op;
1159         char shortName[2];
1160         int is_wild = strpbrk(ref, "*?[") != NULL;
1161         int found_match = 0;
1162
1163         shortName[1] = '\0';
1164
1165         if (strcmp("a", ref) == 0 || strcmp("archive", ref) == 0) {
1166                 ref = "[ardlptgoD]";
1167                 is_wild = 1;
1168         }
1169
1170         for (op = long_options; op != list_end; op++) {
1171                 *shortName = op->shortName;
1172                 if ((op->longName && wildmatch(ref, op->longName))
1173                  || (*shortName && wildmatch(ref, shortName))) {
1174                         if (op->descrip[1] == '*')
1175                                 op->descrip = negated ? "a*" : "r*";
1176                         else if (!is_wild)
1177                                 op->descrip = negated ? "a=" : "r=";
1178                         found_match = 1;
1179                         if (!is_wild)
1180                                 break;
1181                 }
1182         }
1183
1184         if (!found_match)
1185                 rprintf(FLOG, "No match for refuse-options string \"%s\"\n", ref);
1186 }
1187
1188
1189 /**
1190  * Tweak the option table to disable all options that the rsyncd.conf
1191  * file has told us to refuse.
1192  **/
1193 static void set_refuse_options(void)
1194 {
1195         struct poptOption *op, *list_end = NULL;
1196         char *cp, *ref = lp_refuse_options(module_id);
1197         int negated;
1198
1199         if (!ref)
1200                 ref = "";
1201
1202         if (!*ref && !am_daemon) /* A simple optimization */
1203                 return;
1204
1205         /* We abuse the descrip field in poptOption to make it easy to flag which options
1206          * are refused (since we don't use it otherwise).  Start by marking all options
1207          * as "a"ccepted with a few options also marked as non-wild. */
1208         for (op = long_options; ; op++) {
1209                 const char *longName = op->longName ? op->longName : "";
1210                 if (!op->longName && !op->shortName) {
1211                         list_end = op;
1212                         break;
1213                 }
1214                 if (op->shortName == 'e' /* Required for compatibility flags */
1215                  || op->shortName == '0' /* --from0 just modifies --files-from, so refuse that instead (or not) */
1216                  || op->shortName == 's' /* --protect-args is always OK */
1217                  || op->shortName == 'n' /* --dry-run is always OK */
1218                  || strcmp("iconv", longName) == 0
1219                  || strcmp("no-iconv", longName) == 0
1220                  || strcmp("checksum-seed", longName) == 0
1221                  || strcmp("write-devices", longName) == 0 /* disable wild-match (it gets refused below) */
1222                  || strcmp("log-format", longName) == 0 /* aka out-format (NOT log-file-format) */
1223                  || strcmp("sender", longName) == 0
1224                  || strcmp("server", longName) == 0)
1225                         op->descrip = "a="; /* exact-match only */
1226                 else
1227                         op->descrip = "a*"; /* wild-card-able */
1228         }
1229         assert(list_end != NULL);
1230
1231         if (am_daemon) /* Refused by default, but can be accepted via "!write-devices" */
1232                 parse_one_refuse_match(0, "write-devices", list_end);
1233
1234         while (1) {
1235                 while (*ref == ' ') ref++;
1236                 if (!*ref)
1237                         break;
1238                 if ((cp = strchr(ref, ' ')) != NULL)
1239                         *cp = '\0';
1240                 negated = *ref == '!';
1241                 if (negated && ref[1])
1242                         ref++;
1243                 parse_one_refuse_match(negated, ref, list_end);
1244                 if (!cp)
1245                         break;
1246                 *cp = ' ';
1247                 ref = cp + 1;
1248         }
1249
1250         if (am_daemon) {
1251 #ifdef ICONV_OPTION
1252                 if (!*lp_charset(module_id))
1253                         parse_one_refuse_match(0, "iconv", list_end);
1254 #endif
1255                 parse_one_refuse_match(0, "log-file*", list_end);
1256         }
1257
1258         /* Now we use the descrip values to actually mark the options for refusal. */
1259         for (op = long_options; op != list_end; op++) {
1260                 int refused = op->descrip[0] == 'r';
1261                 op->descrip = NULL;
1262                 if (!refused)
1263                         continue;
1264                 if (op->argInfo == POPT_ARG_VAL)
1265                         op->argInfo = POPT_ARG_NONE;
1266                 op->val = (op - long_options) + OPT_REFUSED_BASE;
1267                 /* The following flags are set to let us easily check an implied option later in the code. */
1268                 switch (op->shortName) {
1269                 case 'r': case 'd': case 'l': case 'p':
1270                 case 't': case 'g': case 'o': case 'D':
1271                         refused_archive_part = op->val;
1272                         break;
1273                 case 'z':
1274                         refused_compress = op->val;
1275                         break;
1276                 case '\0':
1277                         if (strcmp("delete", op->longName) == 0)
1278                                 refused_delete = op->val;
1279                         else if (strcmp("delete-before", op->longName) == 0)
1280                                 refused_delete_before = op->val;
1281                         else if (strcmp("delete-during", op->longName) == 0)
1282                                 refused_delete_during = op->val;
1283                         else if (strcmp("partial", op->longName) == 0)
1284                                 refused_partial = op->val;
1285                         else if (strcmp("progress", op->longName) == 0)
1286                                 refused_progress = op->val;
1287                         else if (strcmp("inplace", op->longName) == 0)
1288                                 refused_inplace = op->val;
1289                         else if (strcmp("no-iconv", op->longName) == 0)
1290                                 refused_no_iconv = op->val;
1291                         break;
1292                 }
1293         }
1294 }
1295
1296
1297 static int count_args(const char **argv)
1298 {
1299         int i = 0;
1300
1301         if (argv) {
1302                 while (argv[i] != NULL)
1303                         i++;
1304         }
1305
1306         return i;
1307 }
1308
1309
1310 static OFF_T parse_size_arg(char **size_arg, char def_suf)
1311 {
1312         int reps, mult, make_compatible = 0;
1313         const char *arg;
1314         OFF_T size = 1;
1315
1316         for (arg = *size_arg; isDigit(arg); arg++) {}
1317         if (*arg == '.')
1318                 for (arg++; isDigit(arg); arg++) {}
1319         switch (*arg && *arg != '+' && *arg != '-' ? *arg++ : def_suf) {
1320         case 'b': case 'B':
1321                 reps = 0;
1322                 break;
1323         case 'k': case 'K':
1324                 reps = 1;
1325                 break;
1326         case 'm': case 'M':
1327                 reps = 2;
1328                 break;
1329         case 'g': case 'G':
1330                 reps = 3;
1331                 break;
1332         default:
1333                 return -1;
1334         }
1335         if (*arg == 'b' || *arg == 'B')
1336                 mult = 1000, make_compatible = 1, arg++;
1337         else if (!*arg || *arg == '+' || *arg == '-')
1338                 mult = 1024;
1339         else if (strncasecmp(arg, "ib", 2) == 0)
1340                 mult = 1024, arg += 2;
1341         else
1342                 return -1;
1343         while (reps--)
1344                 size *= mult;
1345         size *= atof(*size_arg);
1346         if ((*arg == '+' || *arg == '-') && arg[1] == '1')
1347                 size += atoi(arg), make_compatible = 1, arg += 2;
1348         if (*arg)
1349                 return -1;
1350         if (size > 0 && make_compatible && def_suf == 'b') {
1351                 /* We convert this manually because we may need %lld precision,
1352                  * and that's not a portable sprintf() escape. */
1353                 char buf[128], *s = buf + sizeof buf - 1;
1354                 OFF_T num = size;
1355                 *s = '\0';
1356                 while (num) {
1357                         *--s = (char)(num % 10) + '0';
1358                         num /= 10;
1359                 }
1360                 if (!(*size_arg = strdup(s)))
1361                         out_of_memory("parse_size_arg");
1362         }
1363         return size;
1364 }
1365
1366
1367 static void create_refuse_error(int which)
1368 {
1369         /* The "which" value is the index + OPT_REFUSED_BASE. */
1370         struct poptOption *op = &long_options[which - OPT_REFUSED_BASE];
1371         int n = snprintf(err_buf, sizeof err_buf,
1372                          "The server is configured to refuse --%s\n",
1373                          op->longName) - 1;
1374         if (op->shortName) {
1375                 snprintf(err_buf + n, sizeof err_buf - n,
1376                          " (-%c)\n", op->shortName);
1377         }
1378 }
1379
1380 /* This is used to make sure that --daemon & --server cannot be aliased to
1381  * something else. These options have always disabled popt aliases for the
1382  * parsing of a daemon or server command-line, but we have to make sure that
1383  * these options cannot vanish so that the alias disabling can take effect. */
1384 static void popt_unalias(poptContext con, const char *opt)
1385 {
1386         struct poptAlias unalias;
1387
1388         unalias.longName = opt + 2; /* point past the leading "--" */
1389         unalias.shortName = '\0';
1390         unalias.argc = 1;
1391         unalias.argv = new_array(const char*, 1);
1392         unalias.argv[0] = strdup(opt);
1393
1394         poptAddAlias(con, unalias, 0);
1395 }
1396
1397 /**
1398  * Process command line arguments.  Called on both local and remote.
1399  *
1400  * @retval 1 if all options are OK; with globals set to appropriate
1401  * values
1402  *
1403  * @retval 0 on error, with err_buf containing an explanation
1404  **/
1405 int parse_arguments(int *argc_p, const char ***argv_p)
1406 {
1407         static poptContext pc;
1408         const char *arg, **argv = *argv_p;
1409         int argc = *argc_p;
1410         int opt;
1411         int orig_protect_args = protect_args;
1412
1413         if (argc == 0) {
1414                 strlcpy(err_buf, "argc is zero!\n", sizeof err_buf);
1415                 return 0;
1416         }
1417
1418         set_refuse_options();
1419
1420 #ifdef ICONV_OPTION
1421         if (!am_daemon && protect_args <= 0 && (arg = getenv("RSYNC_ICONV")) != NULL && *arg)
1422                 iconv_opt = strdup(arg);
1423 #endif
1424
1425         /* TODO: Call poptReadDefaultConfig; handle errors. */
1426
1427         /* The context leaks in case of an error, but if there's a
1428          * problem we always exit anyhow. */
1429         if (pc)
1430                 poptFreeContext(pc);
1431         pc = poptGetContext(RSYNC_NAME, argc, argv, long_options, 0);
1432         if (!am_server) {
1433                 poptReadDefaultConfig(pc, 0);
1434                 popt_unalias(pc, "--daemon");
1435                 popt_unalias(pc, "--server");
1436         }
1437
1438         while ((opt = poptGetNextOpt(pc)) != -1) {
1439                 /* most options are handled automatically by popt;
1440                  * only special cases are returned and listed here. */
1441
1442                 switch (opt) {
1443                 case OPT_VERSION:
1444                         print_rsync_version(FINFO);
1445                         exit_cleanup(0);
1446
1447                 case OPT_SERVER:
1448                         if (!am_server) {
1449                                 /* Disable popt aliases on the server side and
1450                                  * then start parsing the options again. */
1451                                 poptFreeContext(pc);
1452                                 pc = poptGetContext(RSYNC_NAME, argc, argv,
1453                                                     long_options, 0);
1454                                 am_server = 1;
1455                         }
1456 #ifdef ICONV_OPTION
1457                         iconv_opt = NULL;
1458 #endif
1459                         break;
1460
1461                 case OPT_SENDER:
1462                         if (!am_server) {
1463                                 usage(FERROR);
1464                                 exit_cleanup(RERR_SYNTAX);
1465                         }
1466                         am_sender = 1;
1467                         break;
1468
1469                 case OPT_DAEMON:
1470                         if (am_daemon) {
1471                                 strlcpy(err_buf,
1472                                         "Attempt to hack rsync thwarted!\n",
1473                                         sizeof err_buf);
1474                                 return 0;
1475                         }
1476 #ifdef ICONV_OPTION
1477                         iconv_opt = NULL;
1478 #endif
1479                         protect_args = 0;
1480                         poptFreeContext(pc);
1481                         pc = poptGetContext(RSYNC_NAME, argc, argv,
1482                                             long_daemon_options, 0);
1483                         while ((opt = poptGetNextOpt(pc)) != -1) {
1484                                 char **cpp;
1485                                 switch (opt) {
1486                                 case 'h':
1487                                         daemon_usage(FINFO);
1488                                         exit_cleanup(0);
1489
1490                                 case 'M':
1491                                         arg = poptGetOptArg(pc);
1492                                         if (!strchr(arg, '=')) {
1493                                                 rprintf(FERROR,
1494                                                     "--dparam value is missing an '=': %s\n",
1495                                                     arg);
1496                                                 goto daemon_error;
1497                                         }
1498                                         cpp = EXPAND_ITEM_LIST(&dparam_list, char *, 4);
1499                                         *cpp = strdup(arg);
1500                                         break;
1501
1502                                 case 'v':
1503                                         verbose++;
1504                                         break;
1505
1506                                 default:
1507                                         rprintf(FERROR,
1508                                             "rsync: %s: %s (in daemon mode)\n",
1509                                             poptBadOption(pc, POPT_BADOPTION_NOALIAS),
1510                                             poptStrerror(opt));
1511                                         goto daemon_error;
1512                                 }
1513                         }
1514
1515                         if (dparam_list.count && !set_dparams(1))
1516                                 exit_cleanup(RERR_SYNTAX);
1517
1518                         if (tmpdir && strlen(tmpdir) >= MAXPATHLEN - 10) {
1519                                 snprintf(err_buf, sizeof err_buf,
1520                                          "the --temp-dir path is WAY too long.\n");
1521                                 return 0;
1522                         }
1523
1524                         if (!daemon_opt) {
1525                                 rprintf(FERROR, "Daemon option(s) used without --daemon.\n");
1526                             daemon_error:
1527                                 rprintf(FERROR,
1528                                     "(Type \"rsync --daemon --help\" for assistance with daemon mode.)\n");
1529                                 exit_cleanup(RERR_SYNTAX);
1530                         }
1531
1532                         *argv_p = argv = poptGetArgs(pc);
1533                         *argc_p = argc = count_args(argv);
1534                         am_starting_up = 0;
1535                         daemon_opt = 0;
1536                         am_daemon = 1;
1537                         return 1;
1538
1539                 case OPT_MODIFY_WINDOW:
1540                         /* The value has already been set by popt, but
1541                          * we need to remember that we're using a
1542                          * non-default setting. */
1543                         modify_window_set = 1;
1544                         break;
1545
1546                 case OPT_FILTER:
1547                         parse_filter_str(&filter_list, poptGetOptArg(pc),
1548                                         rule_template(0), 0);
1549                         break;
1550
1551                 case OPT_EXCLUDE:
1552                         parse_filter_str(&filter_list, poptGetOptArg(pc),
1553                                         rule_template(0), XFLG_OLD_PREFIXES);
1554                         break;
1555
1556                 case OPT_INCLUDE:
1557                         parse_filter_str(&filter_list, poptGetOptArg(pc),
1558                                         rule_template(FILTRULE_INCLUDE), XFLG_OLD_PREFIXES);
1559                         break;
1560
1561                 case OPT_EXCLUDE_FROM:
1562                 case OPT_INCLUDE_FROM:
1563                         arg = poptGetOptArg(pc);
1564                         if (sanitize_paths)
1565                                 arg = sanitize_path(NULL, arg, NULL, 0, SP_DEFAULT);
1566                         if (daemon_filter_list.head) {
1567                                 int rej;
1568                                 char *cp = strdup(arg);
1569                                 if (!cp)
1570                                         out_of_memory("parse_arguments");
1571                                 if (!*cp)
1572                                         rej = 1;
1573                                 else {
1574                                         char *dir = cp + (*cp == '/' ? module_dirlen : 0);
1575                                         clean_fname(dir, CFN_COLLAPSE_DOT_DOT_DIRS);
1576                                         rej = check_filter(&daemon_filter_list, FLOG, dir, 0) < 0;
1577                                 }
1578                                 free(cp);
1579                                 if (rej)
1580                                         goto options_rejected;
1581                         }
1582                         parse_filter_file(&filter_list, arg,
1583                                 rule_template(opt == OPT_INCLUDE_FROM ? FILTRULE_INCLUDE : 0),
1584                                 XFLG_FATAL_ERRORS | XFLG_OLD_PREFIXES);
1585                         break;
1586
1587                 case 'a':
1588                         if (refused_archive_part) {
1589                                 create_refuse_error(refused_archive_part);
1590                                 return 0;
1591                         }
1592                         if (!recurse) /* preserve recurse == 2 */
1593                                 recurse = 1;
1594 #ifdef SUPPORT_LINKS
1595                         preserve_links = 1;
1596 #endif
1597                         preserve_perms = 1;
1598                         preserve_times = 1;
1599                         preserve_gid = 1;
1600                         preserve_uid = 1;
1601                         preserve_devices = 1;
1602                         preserve_specials = 1;
1603                         break;
1604
1605                 case 'D':
1606                         preserve_devices = preserve_specials = 1;
1607                         break;
1608
1609                 case OPT_NO_D:
1610                         preserve_devices = preserve_specials = 0;
1611                         break;
1612
1613                 case 'h':
1614                         human_readable++;
1615                         break;
1616
1617                 case 'H':
1618                         preserve_hard_links++;
1619                         break;
1620
1621                 case 'i':
1622                         itemize_changes++;
1623                         break;
1624
1625                 case 'U':
1626                         if (++preserve_atimes > 1)
1627                                 open_noatime = 1;
1628                         break;
1629
1630                 case 'v':
1631                         verbose++;
1632                         break;
1633
1634                 case 'y':
1635                         fuzzy_basis++;
1636                         break;
1637
1638                 case 'q':
1639                         quiet++;
1640                         break;
1641
1642                 case 'x':
1643                         one_file_system++;
1644                         break;
1645
1646                 case 'F':
1647                         switch (++F_option_cnt) {
1648                         case 1:
1649                                 parse_filter_str(&filter_list,": /.rsync-filter",rule_template(0),0);
1650                                 break;
1651                         case 2:
1652                                 parse_filter_str(&filter_list,"- .rsync-filter",rule_template(0),0);
1653                                 break;
1654                         }
1655                         break;
1656
1657                 case 'P':
1658                         if (refused_partial || refused_progress) {
1659                                 create_refuse_error(refused_partial
1660                                     ? refused_partial : refused_progress);
1661                                 return 0;
1662                         }
1663                         do_progress = 1;
1664                         keep_partial = 1;
1665                         break;
1666
1667                 case 'z':
1668                         do_compression++;
1669                         break;
1670
1671                 case 'M':
1672                         arg = poptGetOptArg(pc);
1673                         if (*arg != '-') {
1674                                 snprintf(err_buf, sizeof err_buf,
1675                                         "Remote option must start with a dash: %s\n", arg);
1676                                 return 0;
1677                         }
1678                         if (remote_option_cnt+2 >= remote_option_alloc) {
1679                                 remote_option_alloc += 16;
1680                                 remote_options = realloc_array(remote_options,
1681                                                         const char *, remote_option_alloc);
1682                                 if (!remote_options)
1683                                         out_of_memory("parse_arguments");
1684                                 if (!remote_option_cnt)
1685                                         remote_options[0] = "ARG0";
1686                         }
1687                         remote_options[++remote_option_cnt] = arg;
1688                         remote_options[remote_option_cnt+1] = NULL;
1689                         break;
1690
1691                 case OPT_WRITE_BATCH:
1692                         /* batch_name is already set */
1693                         write_batch = 1;
1694                         break;
1695
1696                 case OPT_ONLY_WRITE_BATCH:
1697                         /* batch_name is already set */
1698                         write_batch = -1;
1699                         break;
1700
1701                 case OPT_READ_BATCH:
1702                         /* batch_name is already set */
1703                         read_batch = 1;
1704                         break;
1705
1706                 case OPT_NO_ICONV:
1707 #ifdef ICONV_OPTION
1708                         iconv_opt = NULL;
1709 #endif
1710                         break;
1711
1712                 case OPT_MAX_SIZE:
1713                         if ((max_size = parse_size_arg(&max_size_arg, 'b')) < 0) {
1714                                 snprintf(err_buf, sizeof err_buf,
1715                                         "--max-size value is invalid: %s\n",
1716                                         max_size_arg);
1717                                 return 0;
1718                         }
1719                         break;
1720
1721                 case OPT_MIN_SIZE:
1722                         if ((min_size = parse_size_arg(&min_size_arg, 'b')) < 0) {
1723                                 snprintf(err_buf, sizeof err_buf,
1724                                         "--min-size value is invalid: %s\n",
1725                                         min_size_arg);
1726                                 return 0;
1727                         }
1728                         break;
1729
1730                 case OPT_BWLIMIT:
1731                         {
1732                                 OFF_T limit = parse_size_arg(&bwlimit_arg, 'K');
1733                                 if (limit < 0) {
1734                                         snprintf(err_buf, sizeof err_buf,
1735                                                 "--bwlimit value is invalid: %s\n", bwlimit_arg);
1736                                         return 0;
1737                                 }
1738                                 bwlimit = (limit + 512) / 1024;
1739                                 if (limit && !bwlimit) {
1740                                         snprintf(err_buf, sizeof err_buf,
1741                                                 "--bwlimit value is too small: %s\n", bwlimit_arg);
1742                                         return 0;
1743                                 }
1744                         }
1745                         break;
1746
1747                 case OPT_APPEND:
1748                         if (am_server)
1749                                 append_mode++;
1750                         else
1751                                 append_mode = 1;
1752                         break;
1753
1754                 case OPT_LINK_DEST:
1755 #ifdef SUPPORT_HARD_LINKS
1756                         link_dest = 1;
1757                         dest_option = "--link-dest";
1758                         goto set_dest_dir;
1759 #else
1760                         snprintf(err_buf, sizeof err_buf,
1761                                  "hard links are not supported on this %s\n",
1762                                  am_server ? "server" : "client");
1763                         return 0;
1764 #endif
1765
1766                 case OPT_COPY_DEST:
1767                         copy_dest = 1;
1768                         dest_option = "--copy-dest";
1769                         goto set_dest_dir;
1770
1771                 case OPT_COMPARE_DEST:
1772                         compare_dest = 1;
1773                         dest_option = "--compare-dest";
1774                 set_dest_dir:
1775                         if (basis_dir_cnt >= MAX_BASIS_DIRS) {
1776                                 snprintf(err_buf, sizeof err_buf,
1777                                         "ERROR: at most %d %s args may be specified\n",
1778                                         MAX_BASIS_DIRS, dest_option);
1779                                 return 0;
1780                         }
1781                         /* We defer sanitizing this arg until we know what
1782                          * our destination directory is going to be. */
1783                         basis_dir[basis_dir_cnt++] = (char *)poptGetOptArg(pc);
1784                         break;
1785
1786                 case OPT_CHMOD:
1787                         arg = poptGetOptArg(pc);
1788                         if (!parse_chmod(arg, &chmod_modes)) {
1789                                 snprintf(err_buf, sizeof err_buf,
1790                                     "Invalid argument passed to --chmod (%s)\n",
1791                                     arg);
1792                                 return 0;
1793                         }
1794                         break;
1795
1796                 case OPT_INFO:
1797                         arg = poptGetOptArg(pc);
1798                         parse_output_words(info_words, info_levels, arg, USER_PRIORITY);
1799                         break;
1800
1801                 case OPT_DEBUG:
1802                         arg = poptGetOptArg(pc);
1803                         parse_output_words(debug_words, debug_levels, arg, USER_PRIORITY);
1804                         break;
1805
1806                 case OPT_USERMAP:
1807                         if (usermap) {
1808                                 if (usermap_via_chown) {
1809                                         snprintf(err_buf, sizeof err_buf,
1810                                             "--usermap conflicts with prior --chown.\n");
1811                                         return 0;
1812                                 }
1813                                 snprintf(err_buf, sizeof err_buf,
1814                                     "You can only specify --usermap once.\n");
1815                                 return 0;
1816                         }
1817                         usermap = (char *)poptGetOptArg(pc);
1818                         usermap_via_chown = False;
1819                         break;
1820
1821                 case OPT_GROUPMAP:
1822                         if (groupmap) {
1823                                 if (groupmap_via_chown) {
1824                                         snprintf(err_buf, sizeof err_buf,
1825                                             "--groupmap conflicts with prior --chown.\n");
1826                                         return 0;
1827                                 }
1828                                 snprintf(err_buf, sizeof err_buf,
1829                                     "You can only specify --groupmap once.\n");
1830                                 return 0;
1831                         }
1832                         groupmap = (char *)poptGetOptArg(pc);
1833                         groupmap_via_chown = False;
1834                         break;
1835
1836                 case OPT_CHOWN: {
1837                         const char *chown = poptGetOptArg(pc);
1838                         int len;
1839                         if ((arg = strchr(chown, ':')) != NULL)
1840                                 len = arg++ - chown;
1841                         else
1842                                 len = strlen(chown);
1843                         if (len) {
1844                                 if (usermap) {
1845                                         if (!usermap_via_chown) {
1846                                                 snprintf(err_buf, sizeof err_buf,
1847                                                     "--chown conflicts with prior --usermap.\n");
1848                                                 return 0;
1849                                         }
1850                                         snprintf(err_buf, sizeof err_buf,
1851                                             "You can only specify a user-affecting --chown once.\n");
1852                                         return 0;
1853                                 }
1854                                 if (asprintf(&usermap, "*:%.*s", len, chown) < 0)
1855                                         out_of_memory("parse_arguments");
1856                                 usermap_via_chown = True;
1857                         }
1858                         if (arg && *arg) {
1859                                 if (groupmap) {
1860                                         if (!groupmap_via_chown) {
1861                                                 snprintf(err_buf, sizeof err_buf,
1862                                                     "--chown conflicts with prior --groupmap.\n");
1863                                                 return 0;
1864                                         }
1865                                         snprintf(err_buf, sizeof err_buf,
1866                                             "You can only specify a group-affecting --chown once.\n");
1867                                         return 0;
1868                                 }
1869                                 if (asprintf(&groupmap, "*:%s", arg) < 0)
1870                                         out_of_memory("parse_arguments");
1871                                 groupmap_via_chown = True;
1872                         }
1873                         break;
1874                 }
1875
1876                 case OPT_HELP:
1877                         usage(FINFO);
1878                         exit_cleanup(0);
1879
1880                 case 'A':
1881 #ifdef SUPPORT_ACLS
1882                         preserve_acls = 1;
1883                         preserve_perms = 1;
1884                         break;
1885 #else
1886                         /* FIXME: this should probably be ignored with a
1887                          * warning and then countermeasures taken to
1888                          * restrict group and other access in the presence
1889                          * of any more restrictive ACLs, but this is safe
1890                          * for now */
1891                         snprintf(err_buf,sizeof(err_buf),
1892                                  "ACLs are not supported on this %s\n",
1893                                  am_server ? "server" : "client");
1894                         return 0;
1895 #endif
1896
1897                 case 'X':
1898 #ifdef SUPPORT_XATTRS
1899                         preserve_xattrs++;
1900                         break;
1901 #else
1902                         snprintf(err_buf,sizeof(err_buf),
1903                                  "extended attributes are not supported on this %s\n",
1904                                  am_server ? "server" : "client");
1905                         return 0;
1906 #endif
1907
1908                 default:
1909                         /* A large opt value means that set_refuse_options()
1910                          * turned this option off. */
1911                         if (opt >= OPT_REFUSED_BASE) {
1912                                 create_refuse_error(opt);
1913                                 return 0;
1914                         }
1915                         snprintf(err_buf, sizeof err_buf, "%s%s: %s\n",
1916                                  am_server ? "on remote machine: " : "",
1917                                  poptBadOption(pc, POPT_BADOPTION_NOALIAS),
1918                                  poptStrerror(opt));
1919                         return 0;
1920                 }
1921         }
1922
1923         if (protect_args < 0) {
1924                 if (am_server)
1925                         protect_args = 0;
1926                 else if ((arg = getenv("RSYNC_PROTECT_ARGS")) != NULL && *arg)
1927                         protect_args = atoi(arg) ? 1 : 0;
1928                 else {
1929 #ifdef RSYNC_USE_PROTECTED_ARGS
1930                         protect_args = 1;
1931 #else
1932                         protect_args = 0;
1933 #endif
1934                 }
1935         }
1936
1937         if (checksum_choice && strcasecmp(checksum_choice, "auto") != 0 && strcasecmp(checksum_choice, "auto,auto") != 0) {
1938                 /* Call this early to verify the args and figure out if we need to force
1939                  * --whole-file. Note that the parse function will get called again later,
1940                  * just in case an "auto" choice needs to know the protocol_version. */
1941                 parse_checksum_choice(0);
1942         } else
1943                 checksum_choice = NULL;
1944
1945         if (human_readable > 1 && argc == 2 && !am_server) {
1946                 /* Allow the old meaning of 'h' (--help) on its own. */
1947                 usage(FINFO);
1948                 exit_cleanup(0);
1949         }
1950
1951         if (do_compression || def_compress_level != NOT_SPECIFIED) {
1952                 if (def_compress_level == NOT_SPECIFIED)
1953                         def_compress_level = Z_DEFAULT_COMPRESSION;
1954                 else if (def_compress_level < Z_DEFAULT_COMPRESSION || def_compress_level > Z_BEST_COMPRESSION) {
1955                         snprintf(err_buf, sizeof err_buf, "--compress-level value is invalid: %d\n",
1956                                  def_compress_level);
1957                         return 0;
1958                 } else if (def_compress_level == Z_NO_COMPRESSION)
1959                         do_compression = 0;
1960                 else if (!do_compression)
1961                         do_compression = 1;
1962                 if (do_compression && refused_compress) {
1963                         create_refuse_error(refused_compress);
1964                         return 0;
1965                 }
1966 #ifdef EXTERNAL_ZLIB
1967                 if (do_compression == 1) {
1968                         snprintf(err_buf, sizeof err_buf,
1969                                 "This rsync lacks old-style --compress due to its external zlib.  Try -zz.\n");
1970                         if (am_server)
1971                                 return 0;
1972                         fprintf(stderr, "%s" "Continuing without compression.\n\n", err_buf);
1973                         do_compression = 0;
1974                 }
1975 #endif
1976         }
1977
1978 #ifdef HAVE_SETVBUF
1979         if (outbuf_mode && !am_server) {
1980                 int mode = *(uchar *)outbuf_mode;
1981                 if (islower(mode))
1982                         mode = toupper(mode);
1983                 fflush(stdout); /* Just in case... */
1984                 switch (mode) {
1985                 case 'N': /* None */
1986                 case 'U': /* Unbuffered */
1987                         mode = _IONBF;
1988                         break;
1989                 case 'L': /* Line */
1990                         mode = _IOLBF;
1991                         break;
1992                 case 'B': /* Block */
1993                 case 'F': /* Full */
1994                         mode = _IOFBF;
1995                         break;
1996                 default:
1997                         snprintf(err_buf, sizeof err_buf,
1998                                 "Invalid --outbuf setting -- specify N, L, or B.\n");
1999                         return 0;
2000                 }
2001                 setvbuf(stdout, (char *)NULL, mode, 0);
2002         }
2003
2004         if (msgs2stderr) {
2005                 /* Make stderr line buffered for better sharing of the stream. */
2006                 fflush(stderr); /* Just in case... */
2007                 setvbuf(stderr, (char *)NULL, _IOLBF, 0);
2008         }
2009 #endif
2010
2011         set_output_verbosity(verbose, DEFAULT_PRIORITY);
2012
2013         if (do_stats) {
2014                 parse_output_words(info_words, info_levels,
2015                         verbose > 1 ? "stats3" : "stats2", DEFAULT_PRIORITY);
2016         }
2017
2018 #ifdef ICONV_OPTION
2019         if (iconv_opt && protect_args != 2) {
2020                 if (!am_server && strcmp(iconv_opt, "-") == 0)
2021                         iconv_opt = NULL;
2022                 else
2023                         need_unsorted_flist = 1;
2024         }
2025         if (refused_no_iconv && !iconv_opt) {
2026                 create_refuse_error(refused_no_iconv);
2027                 return 0;
2028         }
2029 #endif
2030
2031         if (fuzzy_basis > 1)
2032                 fuzzy_basis = basis_dir_cnt + 1;
2033
2034         /* Don't let the client reset protect_args if it was already processed */
2035         if (orig_protect_args == 2 && am_server)
2036                 protect_args = orig_protect_args;
2037
2038         if (protect_args == 1 && am_server)
2039                 return 1;
2040
2041         *argv_p = argv = poptGetArgs(pc);
2042         *argc_p = argc = count_args(argv);
2043
2044 #ifndef SUPPORT_LINKS
2045         if (preserve_links && !am_sender) {
2046                 snprintf(err_buf, sizeof err_buf,
2047                          "symlinks are not supported on this %s\n",
2048                          am_server ? "server" : "client");
2049                 return 0;
2050         }
2051 #endif
2052
2053 #ifndef SUPPORT_HARD_LINKS
2054         if (preserve_hard_links) {
2055                 snprintf(err_buf, sizeof err_buf,
2056                          "hard links are not supported on this %s\n",
2057                          am_server ? "server" : "client");
2058                 return 0;
2059         }
2060 #endif
2061
2062 #ifdef SUPPORT_XATTRS
2063         if (am_root < 0 && preserve_xattrs > 1) {
2064                 snprintf(err_buf, sizeof err_buf,
2065                          "--fake-super conflicts with -XX\n");
2066                 return 0;
2067         }
2068 #else
2069         if (am_root < 0) {
2070                 snprintf(err_buf, sizeof err_buf,
2071                          "--fake-super requires an rsync with extended attributes enabled\n");
2072                 return 0;
2073         }
2074 #endif
2075
2076         if (block_size) {
2077                 /* We may not know the real protocol_version at this point if this is the client
2078                  * option parsing, but we still want to check it so that the client can specify
2079                  * a --protocol=29 option with a larger block size. */
2080                 int32 max_blength = protocol_version < 30 ? OLD_MAX_BLOCK_SIZE : MAX_BLOCK_SIZE;
2081
2082                 if (block_size > max_blength) {
2083                         snprintf(err_buf, sizeof err_buf,
2084                                  "--block-size=%lu is too large (max: %u)\n", block_size, max_blength);
2085                         return 0;
2086                 }
2087         }
2088
2089         if (write_batch && read_batch) {
2090                 snprintf(err_buf, sizeof err_buf,
2091                         "--write-batch and --read-batch can not be used together\n");
2092                 return 0;
2093         }
2094         if (write_batch > 0 || read_batch) {
2095                 if (am_server) {
2096                         rprintf(FINFO,
2097                                 "ignoring --%s-batch option sent to server\n",
2098                                 write_batch ? "write" : "read");
2099                         /* We don't actually exit_cleanup(), so that we can
2100                          * still service older version clients that still send
2101                          * batch args to server. */
2102                         read_batch = write_batch = 0;
2103                         batch_name = NULL;
2104                 } else if (dry_run)
2105                         write_batch = 0;
2106         } else if (write_batch < 0 && dry_run)
2107                 write_batch = 0;
2108         if (read_batch && files_from) {
2109                 snprintf(err_buf, sizeof err_buf,
2110                         "--read-batch cannot be used with --files-from\n");
2111                 return 0;
2112         }
2113         if (read_batch && remove_source_files) {
2114                 snprintf(err_buf, sizeof err_buf,
2115                         "--read-batch cannot be used with --remove-%s-files\n",
2116                         remove_source_files == 1 ? "source" : "sent");
2117                 return 0;
2118         }
2119         if (batch_name && strlen(batch_name) > MAX_BATCH_NAME_LEN) {
2120                 snprintf(err_buf, sizeof err_buf,
2121                         "the batch-file name must be %d characters or less.\n",
2122                         MAX_BATCH_NAME_LEN);
2123                 return 0;
2124         }
2125
2126         if (tmpdir && strlen(tmpdir) >= MAXPATHLEN - 10) {
2127                 snprintf(err_buf, sizeof err_buf,
2128                          "the --temp-dir path is WAY too long.\n");
2129                 return 0;
2130         }
2131
2132         if (max_delete < 0 && max_delete != INT_MIN) {
2133                 /* Negative numbers are treated as "no deletions". */
2134                 max_delete = 0;
2135         }
2136
2137         if (compare_dest + copy_dest + link_dest > 1) {
2138                 snprintf(err_buf, sizeof err_buf,
2139                         "You may not mix --compare-dest, --copy-dest, and --link-dest.\n");
2140                 return 0;
2141         }
2142
2143         if (files_from) {
2144                 if (recurse == 1) /* preserve recurse == 2 */
2145                         recurse = 0;
2146                 if (xfer_dirs < 0)
2147                         xfer_dirs = 1;
2148         }
2149
2150         if (argc < 2 && !read_batch && !am_server)
2151                 list_only |= 1;
2152
2153         if (xfer_dirs >= 4) {
2154                 parse_filter_str(&filter_list, "- /*/*", rule_template(0), 0);
2155                 recurse = xfer_dirs = 1;
2156         } else if (recurse)
2157                 xfer_dirs = 1;
2158         else if (xfer_dirs < 0)
2159                 xfer_dirs = list_only ? 1 : 0;
2160
2161         if (relative_paths < 0)
2162                 relative_paths = files_from? 1 : 0;
2163         if (!relative_paths)
2164                 implied_dirs = 0;
2165
2166         if (delete_before + !!delete_during + delete_after > 1) {
2167                 snprintf(err_buf, sizeof err_buf,
2168                         "You may not combine multiple --delete-WHEN options.\n");
2169                 return 0;
2170         }
2171         if (delete_before || delete_during || delete_after)
2172                 delete_mode = 1;
2173         else if (delete_mode || delete_excluded) {
2174                 /* Only choose now between before & during if one is refused. */
2175                 if (refused_delete_before) {
2176                         if (!refused_delete_during)
2177                                 delete_during = 1;
2178                         else {
2179                                 create_refuse_error(refused_delete_before);
2180                                 return 0;
2181                         }
2182                 } else if (refused_delete_during)
2183                         delete_before = 1;
2184                 delete_mode = 1;
2185         }
2186         if (!xfer_dirs && delete_mode) {
2187                 snprintf(err_buf, sizeof err_buf,
2188                         "--delete does not work without --recursive (-r) or --dirs (-d).\n");
2189                 return 0;
2190         }
2191
2192         if (missing_args == 3) /* simplify if both options were specified */
2193                 missing_args = 2;
2194         if (refused_delete && (delete_mode || missing_args == 2)) {
2195                 create_refuse_error(refused_delete);
2196                 return 0;
2197         }
2198
2199         if (remove_source_files) {
2200                 /* We only want to infer this refusal of --remove-source-files
2201                  * via the refusal of "delete", not any of the "delete-FOO"
2202                  * options. */
2203                 if (refused_delete && am_sender) {
2204                         create_refuse_error(refused_delete);
2205                         return 0;
2206                 }
2207                 need_messages_from_generator = 1;
2208         }
2209
2210         if (munge_symlinks && !am_daemon) {
2211                 STRUCT_STAT st;
2212                 char prefix[SYMLINK_PREFIX_LEN]; /* NOT +1 ! */
2213                 strlcpy(prefix, SYMLINK_PREFIX, sizeof prefix); /* trim the trailing slash */
2214                 if (do_stat(prefix, &st) == 0 && S_ISDIR(st.st_mode)) {
2215                         rprintf(FERROR, "Symlink munging is unsafe when a %s directory exists.\n",
2216                                 prefix);
2217                         exit_cleanup(RERR_UNSUPPORTED);
2218                 }
2219         }
2220
2221         if (sanitize_paths) {
2222                 int i;
2223                 for (i = argc; i-- > 0; )
2224                         argv[i] = sanitize_path(NULL, argv[i], "", 0, SP_KEEP_DOT_DIRS);
2225                 if (tmpdir)
2226                         tmpdir = sanitize_path(NULL, tmpdir, NULL, 0, SP_DEFAULT);
2227                 if (backup_dir)
2228                         backup_dir = sanitize_path(NULL, backup_dir, NULL, 0, SP_DEFAULT);
2229         }
2230         if (daemon_filter_list.head && !am_sender) {
2231                 filter_rule_list *elp = &daemon_filter_list;
2232                 if (tmpdir) {
2233                         char *dir;
2234                         if (!*tmpdir)
2235                                 goto options_rejected;
2236                         dir = tmpdir + (*tmpdir == '/' ? module_dirlen : 0);
2237                         clean_fname(dir, CFN_COLLAPSE_DOT_DOT_DIRS);
2238                         if (check_filter(elp, FLOG, dir, 1) < 0)
2239                                 goto options_rejected;
2240                 }
2241                 if (backup_dir) {
2242                         char *dir;
2243                         if (!*backup_dir)
2244                                 goto options_rejected;
2245                         dir = backup_dir + (*backup_dir == '/' ? module_dirlen : 0);
2246                         clean_fname(dir, CFN_COLLAPSE_DOT_DOT_DIRS);
2247                         if (check_filter(elp, FLOG, dir, 1) < 0)
2248                                 goto options_rejected;
2249                 }
2250         }
2251
2252         if (!backup_suffix)
2253                 backup_suffix = backup_dir ? "" : BACKUP_SUFFIX;
2254         backup_suffix_len = strlen(backup_suffix);
2255         if (strchr(backup_suffix, '/') != NULL) {
2256                 snprintf(err_buf, sizeof err_buf,
2257                         "--suffix cannot contain slashes: %s\n",
2258                         backup_suffix);
2259                 return 0;
2260         }
2261         if (backup_dir) {
2262                 size_t len;
2263                 while (*backup_dir == '.' && backup_dir[1] == '/')
2264                         backup_dir += 2;
2265                 if (*backup_dir == '.' && backup_dir[1] == '\0')
2266                         backup_dir++;
2267                 len = strlcpy(backup_dir_buf, backup_dir, sizeof backup_dir_buf);
2268                 if (len > sizeof backup_dir_buf - 128) {
2269                         snprintf(err_buf, sizeof err_buf,
2270                                 "the --backup-dir path is WAY too long.\n");
2271                         return 0;
2272                 }
2273                 backup_dir_len = (int)len;
2274                 if (!backup_dir_len) {
2275                         backup_dir_len = -1;
2276                         backup_dir = NULL;
2277                 } else if (backup_dir_buf[backup_dir_len - 1] != '/') {
2278                         backup_dir_buf[backup_dir_len++] = '/';
2279                         backup_dir_buf[backup_dir_len] = '\0';
2280                 }
2281                 backup_dir_remainder = sizeof backup_dir_buf - backup_dir_len;
2282         }
2283         if (backup_dir) {
2284                 /* No need for a suffix or a protect rule. */
2285         } else if (!backup_suffix_len && (!am_server || !am_sender)) {
2286                 snprintf(err_buf, sizeof err_buf,
2287                         "--suffix cannot be empty %s\n", backup_dir_len < 0
2288                         ? "when --backup-dir is the same as the dest dir"
2289                         : "without a --backup-dir");
2290                 return 0;
2291         } else if (make_backups && delete_mode && !delete_excluded && !am_server) {
2292                 snprintf(backup_dir_buf, sizeof backup_dir_buf,
2293                         "P *%s", backup_suffix);
2294                 parse_filter_str(&filter_list, backup_dir_buf, rule_template(0), 0);
2295         }
2296
2297         if (preserve_times) {
2298                 preserve_times = PRESERVE_FILE_TIMES;
2299                 if (!omit_dir_times)
2300                         preserve_times |= PRESERVE_DIR_TIMES;
2301 #ifdef CAN_SET_SYMLINK_TIMES
2302                 if (!omit_link_times)
2303                         preserve_times |= PRESERVE_LINK_TIMES;
2304 #endif
2305         }
2306
2307         if (make_backups && !backup_dir) {
2308                 omit_dir_times = 0; /* Implied, so avoid -O to sender. */
2309                 preserve_times &= ~PRESERVE_DIR_TIMES;
2310         }
2311
2312         if (stdout_format) {
2313                 if (am_server && log_format_has(stdout_format, 'I'))
2314                         stdout_format_has_i = 2;
2315                 else if (log_format_has(stdout_format, 'i'))
2316                         stdout_format_has_i = itemize_changes | 1;
2317                 if (!log_format_has(stdout_format, 'b')
2318                  && !log_format_has(stdout_format, 'c')
2319                  && !log_format_has(stdout_format, 'C'))
2320                         log_before_transfer = !am_server;
2321         } else if (itemize_changes) {
2322                 stdout_format = "%i %n%L";
2323                 stdout_format_has_i = itemize_changes;
2324                 log_before_transfer = !am_server;
2325         }
2326
2327         if (do_progress && !am_server) {
2328                 if (!log_before_transfer && INFO_EQ(NAME, 0))
2329                         parse_output_words(info_words, info_levels, "name", DEFAULT_PRIORITY);
2330                 parse_output_words(info_words, info_levels, "flist2,progress", DEFAULT_PRIORITY);
2331         }
2332
2333         if (dry_run)
2334                 do_xfers = 0;
2335
2336         set_io_timeout(io_timeout);
2337
2338         if (INFO_GTE(NAME, 1) && !stdout_format) {
2339                 stdout_format = "%n%L";
2340                 log_before_transfer = !am_server;
2341         }
2342         if (stdout_format_has_i || log_format_has(stdout_format, 'o'))
2343                 stdout_format_has_o_or_i = 1;
2344
2345         if (logfile_name && !am_daemon) {
2346                 if (!logfile_format) {
2347                         logfile_format = "%i %n%L";
2348                         logfile_format_has_i = logfile_format_has_o_or_i = 1;
2349                 } else {
2350                         if (log_format_has(logfile_format, 'i'))
2351                                 logfile_format_has_i = 1;
2352                         if (logfile_format_has_i || log_format_has(logfile_format, 'o'))
2353                                 logfile_format_has_o_or_i = 1;
2354                 }
2355                 log_init(0);
2356         } else if (!am_daemon)
2357                 logfile_format = NULL;
2358
2359         if (daemon_bwlimit && (!bwlimit || bwlimit > daemon_bwlimit))
2360                 bwlimit = daemon_bwlimit;
2361         if (bwlimit) {
2362                 bwlimit_writemax = (size_t)bwlimit * 128;
2363                 if (bwlimit_writemax < 512)
2364                         bwlimit_writemax = 512;
2365         }
2366
2367         if (append_mode) {
2368                 if (whole_file > 0) {
2369                         snprintf(err_buf, sizeof err_buf,
2370                                  "--append cannot be used with --whole-file\n");
2371                         return 0;
2372                 }
2373                 if (refused_inplace) {
2374                         create_refuse_error(refused_inplace);
2375                         return 0;
2376                 }
2377                 inplace = 1;
2378         }
2379
2380         if (write_devices) {
2381                 if (refused_inplace) {
2382                         create_refuse_error(refused_inplace);
2383                         return 0;
2384                 }
2385                 inplace = 1;
2386         }
2387
2388         if (delay_updates && !partial_dir)
2389                 partial_dir = tmp_partialdir;
2390
2391         if (inplace) {
2392 #ifdef HAVE_FTRUNCATE
2393                 if (partial_dir) {
2394                         snprintf(err_buf, sizeof err_buf,
2395                                  "--%s cannot be used with --%s\n",
2396                                  append_mode ? "append" : "inplace",
2397                                  delay_updates ? "delay-updates" : "partial-dir");
2398                         return 0;
2399                 }
2400                 /* --inplace implies --partial for refusal purposes, but we
2401                  * clear the keep_partial flag for internal logic purposes. */
2402                 if (refused_partial) {
2403                         create_refuse_error(refused_partial);
2404                         return 0;
2405                 }
2406                 keep_partial = 0;
2407 #else
2408                 snprintf(err_buf, sizeof err_buf,
2409                          "--%s is not supported on this %s\n",
2410                          append_mode ? "append" : "inplace",
2411                          am_server ? "server" : "client");
2412                 return 0;
2413 #endif
2414         } else {
2415                 if (keep_partial && !partial_dir && !am_server) {
2416                         if ((arg = getenv("RSYNC_PARTIAL_DIR")) != NULL && *arg)
2417                                 partial_dir = strdup(arg);
2418                 }
2419                 if (partial_dir) {
2420                         if (*partial_dir)
2421                                 clean_fname(partial_dir, CFN_COLLAPSE_DOT_DOT_DIRS);
2422                         if (!*partial_dir || strcmp(partial_dir, ".") == 0)
2423                                 partial_dir = NULL;
2424                         if (!partial_dir && refused_partial) {
2425                                 create_refuse_error(refused_partial);
2426                                 return 0;
2427                         }
2428                         keep_partial = 1;
2429                 }
2430         }
2431
2432         if (files_from) {
2433                 char *h, *p;
2434                 int q;
2435                 if (argc > 2 || (!am_daemon && !am_server && argc == 1)) {
2436                         usage(FERROR);
2437                         exit_cleanup(RERR_SYNTAX);
2438                 }
2439                 if (strcmp(files_from, "-") == 0) {
2440                         filesfrom_fd = 0;
2441                         if (am_server)
2442                                 filesfrom_host = ""; /* reading from socket */
2443                 } else if ((p = check_for_hostspec(files_from, &h, &q)) != 0) {
2444                         if (am_server) {
2445                                 snprintf(err_buf, sizeof err_buf,
2446                                         "The --files-from sent to the server cannot specify a host.\n");
2447                                 return 0;
2448                         }
2449                         files_from = p;
2450                         filesfrom_host = h;
2451                         if (strcmp(files_from, "-") == 0) {
2452                                 snprintf(err_buf, sizeof err_buf,
2453                                         "Invalid --files-from remote filename\n");
2454                                 return 0;
2455                         }
2456                 } else {
2457                         if (sanitize_paths)
2458                                 files_from = sanitize_path(NULL, files_from, NULL, 0, SP_DEFAULT);
2459                         if (daemon_filter_list.head) {
2460                                 char *dir;
2461                                 if (!*files_from)
2462                                         goto options_rejected;
2463                                 dir = files_from + (*files_from == '/' ? module_dirlen : 0);
2464                                 clean_fname(dir, CFN_COLLAPSE_DOT_DOT_DIRS);
2465                                 if (check_filter(&daemon_filter_list, FLOG, dir, 0) < 0)
2466                                         goto options_rejected;
2467                         }
2468                         filesfrom_fd = open(files_from, O_RDONLY|O_BINARY);
2469                         if (filesfrom_fd < 0) {
2470                                 snprintf(err_buf, sizeof err_buf,
2471                                         "failed to open files-from file %s: %s\n",
2472                                         files_from, strerror(errno));
2473                                 return 0;
2474                         }
2475                 }
2476         }
2477
2478         am_starting_up = 0;
2479
2480         return 1;
2481
2482   options_rejected:
2483         snprintf(err_buf, sizeof err_buf,
2484                 "Your options have been rejected by the server.\n");
2485         return 0;
2486 }
2487
2488
2489 /**
2490  * Construct a filtered list of options to pass through from the
2491  * client to the server.
2492  *
2493  * This involves setting options that will tell the server how to
2494  * behave, and also filtering out options that are processed only
2495  * locally.
2496  **/
2497 void server_options(char **args, int *argc_p)
2498 {
2499         static char argstr[64];
2500         int ac = *argc_p;
2501         uchar where;
2502         char *arg;
2503         int i, x;
2504
2505         /* This should always remain first on the server's command-line. */
2506         args[ac++] = "--server";
2507
2508         if (daemon_over_rsh > 0) {
2509                 args[ac++] = "--daemon";
2510                 *argc_p = ac;
2511                 /* if we're passing --daemon, we're done */
2512                 return;
2513         }
2514
2515         if (!am_sender)
2516                 args[ac++] = "--sender";
2517
2518         x = 1;
2519         argstr[0] = '-';
2520
2521         if (protect_args)
2522                 argstr[x++] = 's';
2523
2524         for (i = 0; i < verbose; i++)
2525                 argstr[x++] = 'v';
2526
2527         /* the -q option is intentionally left out */
2528         if (make_backups)
2529                 argstr[x++] = 'b';
2530         if (update_only)
2531                 argstr[x++] = 'u';
2532         if (!do_xfers) /* Note: NOT "dry_run"! */
2533                 argstr[x++] = 'n';
2534         if (preserve_links)
2535                 argstr[x++] = 'l';
2536         if ((xfer_dirs >= 2 && xfer_dirs < 4)
2537          || (xfer_dirs && !recurse && (list_only || (delete_mode && am_sender))))
2538                 argstr[x++] = 'd';
2539         if (am_sender) {
2540                 if (keep_dirlinks)
2541                         argstr[x++] = 'K';
2542                 if (prune_empty_dirs)
2543                         argstr[x++] = 'm';
2544                 if (omit_dir_times)
2545                         argstr[x++] = 'O';
2546                 if (omit_link_times)
2547                         argstr[x++] = 'J';
2548                 if (fuzzy_basis) {
2549                         argstr[x++] = 'y';
2550                         if (fuzzy_basis > 1)
2551                                 argstr[x++] = 'y';
2552                 }
2553         } else {
2554                 if (copy_links)
2555                         argstr[x++] = 'L';
2556                 if (copy_dirlinks)
2557                         argstr[x++] = 'k';
2558         }
2559
2560         if (whole_file > 0)
2561                 argstr[x++] = 'W';
2562         /* We don't need to send --no-whole-file, because it's the
2563          * default for remote transfers, and in any case old versions
2564          * of rsync will not understand it. */
2565
2566         if (preserve_hard_links) {
2567                 argstr[x++] = 'H';
2568                 if (preserve_hard_links > 1)
2569                         argstr[x++] = 'H';
2570         }
2571         if (preserve_uid)
2572                 argstr[x++] = 'o';
2573         if (preserve_gid)
2574                 argstr[x++] = 'g';
2575         if (preserve_devices) /* ignore preserve_specials here */
2576                 argstr[x++] = 'D';
2577         if (preserve_times)
2578                 argstr[x++] = 't';
2579         if (preserve_atimes) {
2580                 argstr[x++] = 'U';
2581                 if (preserve_atimes > 1)
2582                         argstr[x++] = 'U';
2583         }
2584         if (preserve_perms)
2585                 argstr[x++] = 'p';
2586         else if (preserve_executability && am_sender)
2587                 argstr[x++] = 'E';
2588 #ifdef SUPPORT_ACLS
2589         if (preserve_acls)
2590                 argstr[x++] = 'A';
2591 #endif
2592 #ifdef SUPPORT_XATTRS
2593         if (preserve_xattrs) {
2594                 argstr[x++] = 'X';
2595                 if (preserve_xattrs > 1)
2596                         argstr[x++] = 'X';
2597         }
2598 #endif
2599         if (recurse)
2600                 argstr[x++] = 'r';
2601         if (always_checksum)
2602                 argstr[x++] = 'c';
2603         if (cvs_exclude)
2604                 argstr[x++] = 'C';
2605         if (ignore_times)
2606                 argstr[x++] = 'I';
2607         if (relative_paths)
2608                 argstr[x++] = 'R';
2609         if (one_file_system) {
2610                 argstr[x++] = 'x';
2611                 if (one_file_system > 1)
2612                         argstr[x++] = 'x';
2613         }
2614         if (sparse_files)
2615                 argstr[x++] = 'S';
2616         if (do_compression == 1)
2617                 argstr[x++] = 'z';
2618
2619         set_allow_inc_recurse();
2620
2621         /* We don't really know the actual protocol_version at this point,
2622          * but checking the pre-negotiated value allows the user to use a
2623          * --protocol=29 override to avoid the use of this -eFLAGS opt. */
2624         if (protocol_version >= 30) {
2625                 /* Use "eFlags" alias so that cull_options doesn't think that these are no-arg option letters. */
2626 #define eFlags argstr
2627                 /* We make use of the -e option to let the server know about
2628                  * any pre-release protocol version && some behavior flags. */
2629                 eFlags[x++] = 'e';
2630 #if SUBPROTOCOL_VERSION != 0
2631                 if (protocol_version == PROTOCOL_VERSION) {
2632                         x += snprintf(argstr+x, sizeof argstr - x,
2633                                       "%d.%d",
2634                                       PROTOCOL_VERSION, SUBPROTOCOL_VERSION);
2635                 } else
2636 #endif
2637                         eFlags[x++] = '.';
2638                 if (allow_inc_recurse)
2639                         eFlags[x++] = 'i';
2640 #ifdef CAN_SET_SYMLINK_TIMES
2641                 eFlags[x++] = 'L'; /* symlink time-setting support */
2642 #endif
2643 #ifdef ICONV_OPTION
2644                 eFlags[x++] = 's'; /* symlink iconv translation support */
2645 #endif
2646                 eFlags[x++] = 'f'; /* flist I/O-error safety support */
2647                 eFlags[x++] = 'x'; /* xattr hardlink optimization not desired */
2648                 eFlags[x++] = 'C'; /* support checksum seed order fix */
2649                 eFlags[x++] = 'I'; /* support inplace_partial behavior */
2650                 eFlags[x++] = 'v'; /* use varint for flist & compat flags; negotiate checksum */
2651                 /* NOTE: Avoid using 'V' -- it was the high bit of a write_byte() that became write_varint(). */
2652 #undef eFlags
2653         }
2654
2655         if (x >= (int)sizeof argstr) { /* Not possible... */
2656                 rprintf(FERROR, "argstr overflow in server_options().\n");
2657                 exit_cleanup(RERR_MALLOC);
2658         }
2659
2660         argstr[x] = '\0';
2661
2662         if (x > 1)
2663                 args[ac++] = argstr;
2664
2665 #ifdef ICONV_OPTION
2666         if (iconv_opt) {
2667                 char *set = strchr(iconv_opt, ',');
2668                 if (set)
2669                         set++;
2670                 else
2671                         set = iconv_opt;
2672                 if (asprintf(&arg, "--iconv=%s", set) < 0)
2673                         goto oom;
2674                 args[ac++] = arg;
2675         }
2676 #endif
2677
2678         if (protect_args && !local_server) /* unprotected args stop here */
2679                 args[ac++] = NULL;
2680
2681         if (list_only > 1)
2682                 args[ac++] = "--list-only";
2683
2684         /* This makes sure that the remote rsync can handle deleting with -d
2685          * sans -r because the --no-r option was added at the same time. */
2686         if (xfer_dirs && !recurse && delete_mode && am_sender)
2687                 args[ac++] = "--no-r";
2688
2689         if (do_compression && def_compress_level != Z_DEFAULT_COMPRESSION) {
2690                 if (asprintf(&arg, "--compress-level=%d", def_compress_level) < 0)
2691                         goto oom;
2692                 args[ac++] = arg;
2693         }
2694
2695         if (preserve_devices) {
2696                 /* Note: sending "--devices" would not be backward-compatible. */
2697                 if (!preserve_specials)
2698                         args[ac++] = "--no-specials"; /* -D is already set. */
2699         } else if (preserve_specials)
2700                 args[ac++] = "--specials";
2701
2702         /* The server side doesn't use our log-format, but in certain
2703          * circumstances they need to know a little about the option. */
2704         if (stdout_format && am_sender) {
2705                 /* Use --log-format, not --out-format, for compatibility. */
2706                 if (stdout_format_has_i > 1)
2707                         args[ac++] = "--log-format=%i%I";
2708                 else if (stdout_format_has_i)
2709                         args[ac++] = "--log-format=%i";
2710                 else if (stdout_format_has_o_or_i)
2711                         args[ac++] = "--log-format=%o";
2712                 else if (!verbose)
2713                         args[ac++] = "--log-format=X";
2714         }
2715
2716         if (block_size) {
2717                 if (asprintf(&arg, "-B%lu", block_size) < 0)
2718                         goto oom;
2719                 args[ac++] = arg;
2720         }
2721
2722         if (io_timeout) {
2723                 if (asprintf(&arg, "--timeout=%d", io_timeout) < 0)
2724                         goto oom;
2725                 args[ac++] = arg;
2726         }
2727
2728         if (bwlimit) {
2729                 if (asprintf(&arg, "--bwlimit=%d", bwlimit) < 0)
2730                         goto oom;
2731                 args[ac++] = arg;
2732         }
2733
2734         if (backup_dir) {
2735                 args[ac++] = "--backup-dir";
2736                 args[ac++] = backup_dir;
2737         }
2738
2739         /* Only send --suffix if it specifies a non-default value. */
2740         if (strcmp(backup_suffix, backup_dir ? "" : BACKUP_SUFFIX) != 0) {
2741                 /* We use the following syntax to avoid weirdness with '~'. */
2742                 if (asprintf(&arg, "--suffix=%s", backup_suffix) < 0)
2743                         goto oom;
2744                 args[ac++] = arg;
2745         }
2746
2747         if (checksum_choice) {
2748                 if (asprintf(&arg, "--checksum-choice=%s", checksum_choice) < 0)
2749                         goto oom;
2750                 args[ac++] = arg;
2751         }
2752
2753         if (am_sender) {
2754                 if (max_delete > 0) {
2755                         if (asprintf(&arg, "--max-delete=%d", max_delete) < 0)
2756                                 goto oom;
2757                         args[ac++] = arg;
2758                 } else if (max_delete == 0)
2759                         args[ac++] = "--max-delete=-1";
2760                 if (min_size >= 0) {
2761                         args[ac++] = "--min-size";
2762                         args[ac++] = min_size_arg;
2763                 }
2764                 if (max_size >= 0) {
2765                         args[ac++] = "--max-size";
2766                         args[ac++] = max_size_arg;
2767                 }
2768                 if (delete_before)
2769                         args[ac++] = "--delete-before";
2770                 else if (delete_during == 2)
2771                         args[ac++] = "--delete-delay";
2772                 else if (delete_during)
2773                         args[ac++] = "--delete-during";
2774                 else if (delete_after)
2775                         args[ac++] = "--delete-after";
2776                 else if (delete_mode && !delete_excluded)
2777                         args[ac++] = "--delete";
2778                 if (delete_excluded)
2779                         args[ac++] = "--delete-excluded";
2780                 if (force_delete)
2781                         args[ac++] = "--force";
2782                 if (write_batch < 0)
2783                         args[ac++] = "--only-write-batch=X";
2784                 if (am_root > 1)
2785                         args[ac++] = "--super";
2786                 if (size_only)
2787                         args[ac++] = "--size-only";
2788                 if (do_stats)
2789                         args[ac++] = "--stats";
2790         } else {
2791                 if (skip_compress) {
2792                         if (asprintf(&arg, "--skip-compress=%s", skip_compress) < 0)
2793                                 goto oom;
2794                         args[ac++] = arg;
2795                 }
2796         }
2797
2798         /* --delete-missing-args needs the cooperation of both sides, but
2799          * the sender can handle --ignore-missing-args by itself. */
2800         if (missing_args == 2)
2801                 args[ac++] = "--delete-missing-args";
2802         else if (missing_args == 1 && !am_sender)
2803                 args[ac++] = "--ignore-missing-args";
2804
2805         if (modify_window_set && am_sender) {
2806                 char *fmt = modify_window < 0 ? "-@%d" : "--modify-window=%d";
2807                 if (asprintf(&arg, fmt, modify_window) < 0)
2808                         goto oom;
2809                 args[ac++] = arg;
2810         }
2811
2812         if (checksum_seed) {
2813                 if (asprintf(&arg, "--checksum-seed=%d", checksum_seed) < 0)
2814                         goto oom;
2815                 args[ac++] = arg;
2816         }
2817
2818         if (partial_dir && am_sender) {
2819                 if (partial_dir != tmp_partialdir) {
2820                         args[ac++] = "--partial-dir";
2821                         args[ac++] = partial_dir;
2822                 }
2823                 if (delay_updates)
2824                         args[ac++] = "--delay-updates";
2825         } else if (keep_partial && am_sender)
2826                 args[ac++] = "--partial";
2827
2828         if (ignore_errors)
2829                 args[ac++] = "--ignore-errors";
2830
2831         if (copy_unsafe_links)
2832                 args[ac++] = "--copy-unsafe-links";
2833
2834         if (safe_symlinks)
2835                 args[ac++] = "--safe-links";
2836
2837         if (numeric_ids)
2838                 args[ac++] = "--numeric-ids";
2839
2840         if (use_qsort)
2841                 args[ac++] = "--use-qsort";
2842
2843         if (am_sender) {
2844                 if (usermap) {
2845                         if (asprintf(&arg, "--usermap=%s", usermap) < 0)
2846                                 goto oom;
2847                         args[ac++] = arg;
2848                 }
2849
2850                 if (groupmap) {
2851                         if (asprintf(&arg, "--groupmap=%s", groupmap) < 0)
2852                                 goto oom;
2853                         args[ac++] = arg;
2854                 }
2855
2856                 if (ignore_existing)
2857                         args[ac++] = "--ignore-existing";
2858
2859                 /* Backward compatibility: send --existing, not --ignore-non-existing. */
2860                 if (ignore_non_existing)
2861                         args[ac++] = "--existing";
2862
2863                 if (tmpdir) {
2864                         args[ac++] = "--temp-dir";
2865                         args[ac++] = tmpdir;
2866                 }
2867
2868                 if (basis_dir[0]) {
2869                         /* the server only needs this option if it is not the sender,
2870                          *   and it may be an older version that doesn't know this
2871                          *   option, so don't send it if client is the sender.
2872                          */
2873                         for (i = 0; i < basis_dir_cnt; i++) {
2874                                 args[ac++] = dest_option;
2875                                 args[ac++] = basis_dir[i];
2876                         }
2877                 }
2878         }
2879
2880         /* What flags do we need to send to the other side? */
2881         where = (am_server ? W_CLI : W_SRV) | (am_sender ? W_REC : W_SND);
2882         arg = make_output_option(info_words, info_levels, where);
2883         if (arg)
2884                 args[ac++] = arg;
2885
2886         arg = make_output_option(debug_words, debug_levels, where);
2887         if (arg)
2888                 args[ac++] = arg;
2889
2890         if (append_mode) {
2891                 if (append_mode > 1)
2892                         args[ac++] = "--append";
2893                 args[ac++] = "--append";
2894         } else if (inplace)
2895                 args[ac++] = "--inplace";
2896
2897         if (files_from && (!am_sender || filesfrom_host)) {
2898                 if (filesfrom_host) {
2899                         args[ac++] = "--files-from";
2900                         args[ac++] = files_from;
2901                         if (eol_nulls)
2902                                 args[ac++] = "--from0";
2903                 } else {
2904                         args[ac++] = "--files-from=-";
2905                         args[ac++] = "--from0";
2906                 }
2907                 if (!relative_paths)
2908                         args[ac++] = "--no-relative";
2909         }
2910         /* It's OK that this checks the upper-bound of the protocol_version. */
2911         if (relative_paths && !implied_dirs && (!am_sender || protocol_version >= 30))
2912                 args[ac++] = "--no-implied-dirs";
2913
2914         if (write_devices && am_sender)
2915                 args[ac++] = "--write-devices";
2916
2917         if (remove_source_files == 1)
2918                 args[ac++] = "--remove-source-files";
2919         else if (remove_source_files)
2920                 args[ac++] = "--remove-sent-files";
2921
2922         if (preallocate_files && am_sender)
2923                 args[ac++] = "--preallocate";
2924
2925         if (open_noatime && preserve_atimes <= 1)
2926                 args[ac++] = "--open-noatime";
2927
2928         if (ac > MAX_SERVER_ARGS) { /* Not possible... */
2929                 rprintf(FERROR, "argc overflow in server_options().\n");
2930                 exit_cleanup(RERR_MALLOC);
2931         }
2932
2933         if (do_compression > 1)
2934                 args[ac++] = "--new-compress";
2935
2936         if (remote_option_cnt) {
2937                 int j;
2938                 if (ac + remote_option_cnt > MAX_SERVER_ARGS) {
2939                         rprintf(FERROR, "too many remote options specified.\n");
2940                         exit_cleanup(RERR_SYNTAX);
2941                 }
2942                 for (j = 1; j <= remote_option_cnt; j++)
2943                         args[ac++] = (char*)remote_options[j];
2944         }
2945
2946         *argc_p = ac;
2947         return;
2948
2949     oom:
2950         out_of_memory("server_options");
2951 }
2952
2953 /* If str points to a valid hostspec, return allocated memory containing the
2954  * [USER@]HOST part of the string, and set the path_start_ptr to the part of
2955  * the string after the host part.  Otherwise, return NULL.  If port_ptr is
2956  * non-NULL, we must be parsing an rsync:// URL hostname, and we will set
2957  * *port_ptr if a port number is found.  Note that IPv6 IPs will have their
2958  * (required for parsing) [ and ] chars elided from the returned string. */
2959 static char *parse_hostspec(char *str, char **path_start_ptr, int *port_ptr)
2960 {
2961         char *s, *host_start = str;
2962         int hostlen = 0, userlen = 0;
2963         char *ret;
2964
2965         for (s = str; ; s++) {
2966                 if (!*s) {
2967                         /* It is only OK if we run out of string with rsync:// */
2968                         if (!port_ptr)
2969                                 return NULL;
2970                         if (!hostlen)
2971                                 hostlen = s - host_start;
2972                         break;
2973                 }
2974                 if (*s == ':' || *s == '/') {
2975                         if (!hostlen)
2976                                 hostlen = s - host_start;
2977                         if (*s++ == '/') {
2978                                 if (!port_ptr)
2979                                         return NULL;
2980                         } else if (port_ptr) {
2981                                 *port_ptr = atoi(s);
2982                                 while (isDigit(s)) s++;
2983                                 if (*s && *s++ != '/')
2984                                         return NULL;
2985                         }
2986                         break;
2987                 }
2988                 if (*s == '@') {
2989                         userlen = s - str + 1;
2990                         host_start = s + 1;
2991                 } else if (*s == '[') {
2992                         if (s != host_start++)
2993                                 return NULL;
2994                         while (*s && *s != ']' && *s != '/') s++; /*SHARED ITERATOR*/
2995                         hostlen = s - host_start;
2996                         if (*s != ']' || (s[1] && s[1] != '/' && s[1] != ':') || !hostlen)
2997                                 return NULL;
2998                 }
2999         }
3000
3001         *path_start_ptr = s;
3002         ret = new_array(char, userlen + hostlen + 1);
3003         if (userlen)
3004                 strlcpy(ret, str, userlen + 1);
3005         strlcpy(ret + userlen, host_start, hostlen + 1);
3006         return ret;
3007 }
3008
3009 /* Look for a HOST specification of the form "HOST:PATH", "HOST::PATH", or
3010  * "rsync://HOST:PORT/PATH".  If found, *host_ptr will be set to some allocated
3011  * memory with the HOST.  If a daemon-accessing spec was specified, the value
3012  * of *port_ptr will contain a non-0 port number, otherwise it will be set to
3013  * 0.  The return value is a pointer to the PATH.  Note that the HOST spec can
3014  * be an IPv6 literal address enclosed in '[' and ']' (such as "[::1]" or
3015  * "[::ffff:127.0.0.1]") which is returned without the '[' and ']'. */
3016 char *check_for_hostspec(char *s, char **host_ptr, int *port_ptr)
3017 {
3018         char *path;
3019
3020         if (port_ptr && strncasecmp(URL_PREFIX, s, strlen(URL_PREFIX)) == 0) {
3021                 *host_ptr = parse_hostspec(s + strlen(URL_PREFIX), &path, port_ptr);
3022                 if (*host_ptr) {
3023                         if (!*port_ptr)
3024                                 *port_ptr = -1; /* -1 indicates they want the default */
3025                         return path;
3026                 }
3027         }
3028
3029         *host_ptr = parse_hostspec(s, &path, NULL);
3030         if (!*host_ptr)
3031                 return NULL;
3032
3033         if (*path == ':') {
3034                 if (port_ptr && !*port_ptr)
3035                         *port_ptr = -1;
3036                 return path + 1;
3037         }
3038         if (port_ptr)
3039                 *port_ptr = 0;
3040
3041         return path;
3042 }