1 /* -*- c-file-style: "linux" -*-
3 * Copyright (C) 1998-2001 by Andrew Tridgell <tridge@samba.org>
4 * Copyright (C) 2000, 2001, 2002 by Martin Pool <mbp@samba.org>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 extern int sanitize_paths;
25 extern int select_timeout;
26 extern struct exclude_list_struct exclude_list;
27 extern struct exclude_list_struct server_exclude_list;
32 * If 1, send the whole file as literal data rather than trying to
33 * create an incremental diff.
35 * If -1, then look at whether we're local or remote and go by that.
37 * @sa disable_deltas_p()
42 int keep_dirlinks = 0;
44 int preserve_links = 0;
45 int preserve_hard_links = 0;
46 int preserve_perms = 0;
47 int preserve_devices = 0;
50 int preserve_times = 0;
57 int delete_excluded = 0;
58 int one_file_system = 0;
59 int protocol_version = PROTOCOL_VERSION;
61 int do_compression = 0;
64 int relative_paths = -1;
74 char *files_from = NULL;
75 int filesfrom_fd = -1;
76 char *remote_filesfrom_file = NULL;
81 int daemon_over_rsh = 0;
85 int safe_symlinks = 0;
86 int copy_unsafe_links = 0;
88 int daemon_bwlimit = 0;
90 size_t bwlimit_writemax = 0;
92 int only_existing = 0;
93 int opt_ignore_existing = 0;
96 int ignore_errors = 0;
97 int modify_window = 0;
99 int checksum_seed = 0;
101 long block_size = 0; /* "long" because popt can't set an int32. */
104 /** Network address family. **/
106 int default_af_hint = 0; /* Any protocol */
108 int default_af_hint = AF_INET; /* Must use IPv4 */
111 /** Do not go into the background when run as --daemon. Good
112 * for debugging and required for running as a service on W32,
113 * or under Unix process-monitors. **/
118 int backup_dir_len = 0;
119 int backup_suffix_len;
120 unsigned int backup_dir_remainder;
122 char *backup_suffix = NULL;
124 char *partial_dir = NULL;
125 char *basis_dir[MAX_BASIS_DIRS+1];
126 char *config_file = NULL;
127 char *shell_cmd = NULL;
128 char *log_format = NULL;
129 char *password_file = NULL;
130 char *rsync_path = RSYNC_PATH;
131 char *backup_dir = NULL;
132 char backup_dir_buf[MAXPATHLEN];
134 int compare_dest = 0;
137 int basis_dir_cnt = 0;
141 int always_checksum = 0;
144 #define MAX_BATCH_NAME_LEN 256 /* Must be less than MAXPATHLEN-13 */
145 char *batch_name = NULL;
147 static int daemon_opt; /* sets am_daemon after option error-reporting */
148 static int modify_window_set;
149 static char *dest_option = NULL;
150 static char *max_size_arg;
152 /** Local address to bind. As a character string because it's
153 * interpreted by the IPv6 layer: should be a numeric IP4 or IP6
154 * address, or a hostname. **/
158 static void print_rsync_version(enum logcode f)
160 char const *got_socketpair = "no ";
161 char const *have_inplace = "no ";
162 char const *hardlinks = "no ";
163 char const *links = "no ";
164 char const *ipv6 = "no ";
165 STRUCT_STAT *dumstat;
167 #ifdef HAVE_SOCKETPAIR
175 #if SUPPORT_HARD_LINKS
187 rprintf(f, "%s version %s protocol version %d\n",
188 RSYNC_NAME, RSYNC_VERSION, PROTOCOL_VERSION);
190 "Copyright (C) 1996-2004 by Andrew Tridgell and others\n");
191 rprintf(f, "<http://rsync.samba.org/>\n");
192 rprintf(f, "Capabilities: %d-bit files, %ssocketpairs, "
193 "%shard links, %ssymlinks, batchfiles, \n",
194 (int) (sizeof (OFF_T) * 8),
195 got_socketpair, hardlinks, links);
197 /* Note that this field may not have type ino_t. It depends
198 * on the complicated interaction between largefile feature
200 rprintf(f, " %sinplace, %sIPv6, %d-bit system inums, %d-bit internal inums\n",
202 (int) (sizeof dumstat->st_ino * 8),
203 (int) (sizeof (uint64) * 8));
204 #ifdef MAINTAINER_MODE
205 rprintf(f, " panic action: \"%s\"\n",
209 #ifdef INT64_IS_OFF_T
210 if (sizeof (int64) < 8)
211 rprintf(f, "WARNING: no 64-bit integers on this platform!\n");
216 "rsync comes with ABSOLUTELY NO WARRANTY. This is free software, and you\n"
217 "are welcome to redistribute it under certain conditions. See the GNU\n"
218 "General Public Licence for details.\n"
223 void usage(enum logcode F)
225 print_rsync_version(F);
227 rprintf(F,"\nrsync is a file transfer program capable of efficient remote update\nvia a fast differencing algorithm.\n\n");
229 rprintf(F,"Usage: rsync [OPTION]... SRC [SRC]... [USER@]HOST:DEST\n");
230 rprintf(F," or rsync [OPTION]... [USER@]HOST:SRC DEST\n");
231 rprintf(F," or rsync [OPTION]... SRC [SRC]... DEST\n");
232 rprintf(F," or rsync [OPTION]... [USER@]HOST::SRC [DEST]\n");
233 rprintf(F," or rsync [OPTION]... SRC [SRC]... [USER@]HOST::DEST\n");
234 rprintf(F," or rsync [OPTION]... rsync://[USER@]HOST[:PORT]/SRC [DEST]\n");
235 rprintf(F," or rsync [OPTION]... SRC [SRC]... rsync://[USER@]HOST[:PORT]/DEST\n");
236 rprintf(F,"SRC on single-colon remote HOST will be expanded by remote shell\n");
237 rprintf(F,"SRC on server remote HOST may contain shell wildcards or multiple\n");
238 rprintf(F," sources separated by space as long as they have same top-level\n");
239 rprintf(F,"\nOptions\n");
240 rprintf(F," -v, --verbose increase verbosity\n");
241 rprintf(F," -q, --quiet decrease verbosity\n");
242 rprintf(F," -c, --checksum always checksum\n");
243 rprintf(F," -a, --archive archive mode, equivalent to -rlptgoD (no -H)\n");
244 rprintf(F," -r, --recursive recurse into directories\n");
245 rprintf(F," -R, --relative use relative path names\n");
246 rprintf(F," --no-relative turn off --relative\n");
247 rprintf(F," --no-implied-dirs don't send implied dirs with -R\n");
248 rprintf(F," -b, --backup make backups (see --suffix & --backup-dir)\n");
249 rprintf(F," --backup-dir make backups into this directory\n");
250 rprintf(F," --suffix=SUFFIX backup suffix (default %s w/o --backup-dir)\n",BACKUP_SUFFIX);
251 rprintf(F," -u, --update update only (don't overwrite newer files)\n");
252 rprintf(F," --inplace update destination files in-place (SEE MAN PAGE)\n");
253 rprintf(F," -K, --keep-dirlinks treat symlinked dir on receiver as dir\n");
254 rprintf(F," -l, --links copy symlinks as symlinks\n");
255 rprintf(F," -L, --copy-links copy the referent of all symlinks\n");
256 rprintf(F," --copy-unsafe-links copy the referent of \"unsafe\" symlinks\n");
257 rprintf(F," --safe-links ignore \"unsafe\" symlinks\n");
258 rprintf(F," -H, --hard-links preserve hard links\n");
259 rprintf(F," -p, --perms preserve permissions\n");
260 rprintf(F," -o, --owner preserve owner (root only)\n");
261 rprintf(F," -g, --group preserve group\n");
262 rprintf(F," -D, --devices preserve devices (root only)\n");
263 rprintf(F," -t, --times preserve times\n");
264 rprintf(F," -S, --sparse handle sparse files efficiently\n");
265 rprintf(F," -n, --dry-run show what would have been transferred\n");
266 rprintf(F," -W, --whole-file copy whole files, no incremental checks\n");
267 rprintf(F," --no-whole-file turn off --whole-file\n");
268 rprintf(F," -x, --one-file-system don't cross filesystem boundaries\n");
269 rprintf(F," -B, --block-size=SIZE force a fixed checksum block-size\n");
270 rprintf(F," -e, --rsh=COMMAND specify the remote shell\n");
271 rprintf(F," --rsync-path=PATH specify path to rsync on the remote machine\n");
272 rprintf(F," --existing only update files that already exist\n");
273 rprintf(F," --ignore-existing ignore files that already exist on receiving side\n");
274 rprintf(F," --delete delete files that don't exist on the sending side\n");
275 rprintf(F," --delete-excluded also delete excluded files on the receiving side\n");
276 rprintf(F," --delete-after receiver deletes after transferring, not before\n");
277 rprintf(F," --ignore-errors delete even if there are I/O errors\n");
278 rprintf(F," --max-delete=NUM don't delete more than NUM files\n");
279 rprintf(F," --max-size=SIZE don't transfer any file larger than SIZE\n");
280 rprintf(F," --partial keep partially transferred files\n");
281 rprintf(F," --partial-dir=DIR put a partially transferred file into DIR\n");
282 rprintf(F," --force force deletion of directories even if not empty\n");
283 rprintf(F," --numeric-ids don't map uid/gid values by user/group name\n");
284 rprintf(F," --timeout=TIME set I/O timeout in seconds\n");
285 rprintf(F," -I, --ignore-times turn off mod time & file size quick check\n");
286 rprintf(F," --size-only ignore mod time for quick check (use size)\n");
287 rprintf(F," --modify-window=NUM compare mod times with reduced accuracy\n");
288 rprintf(F," -T, --temp-dir=DIR create temporary files in directory DIR\n");
289 rprintf(F," --compare-dest=DIR also compare destination files relative to DIR\n");
290 rprintf(F," --copy-dest=DIR ... and include copies of unchanged files\n");
291 rprintf(F," --link-dest=DIR hardlink to files in DIR when unchanged\n");
292 rprintf(F," -P equivalent to --partial --progress\n");
293 rprintf(F," -z, --compress compress file data\n");
294 rprintf(F," -C, --cvs-exclude auto ignore files in the same way CVS does\n");
295 rprintf(F," --exclude=PATTERN exclude files matching PATTERN\n");
296 rprintf(F," --exclude-from=FILE exclude patterns listed in FILE\n");
297 rprintf(F," --include=PATTERN don't exclude files matching PATTERN\n");
298 rprintf(F," --include-from=FILE don't exclude patterns listed in FILE\n");
299 rprintf(F," --files-from=FILE read FILE for list of source-file names\n");
300 rprintf(F," -0, --from0 all *-from file lists are delimited by nulls\n");
301 rprintf(F," --version print version number\n");
302 rprintf(F," --port=PORT specify double-colon alternate port number\n");
303 rprintf(F," --blocking-io use blocking I/O for the remote shell\n");
304 rprintf(F," --no-blocking-io turn off --blocking-io\n");
305 rprintf(F," --stats give some file transfer stats\n");
306 rprintf(F," --progress show progress during transfer\n");
307 rprintf(F," --log-format=FORMAT log file transfers using specified format\n");
308 rprintf(F," --password-file=FILE get password from FILE\n");
309 rprintf(F," --bwlimit=KBPS limit I/O bandwidth, KBytes per second\n");
310 rprintf(F," --write-batch=FILE write a batch to FILE\n");
311 rprintf(F," --read-batch=FILE read a batch from FILE\n");
313 rprintf(F," -4, --ipv4 prefer IPv4\n");
314 rprintf(F," -6, --ipv6 prefer IPv6\n");
316 rprintf(F," -h, --help show this help screen\n");
318 rprintf(F,"\nUse \"rsync --daemon --help\" to see the daemon-mode command-line options.\n");
319 rprintf(F,"Please see the rsync(1) and rsyncd.conf(5) man pages for full documentation.\n");
320 rprintf(F,"See http://rsync.samba.org/ for updates, bug reports, and answers\n");
323 enum {OPT_VERSION = 1000, OPT_DAEMON, OPT_SENDER, OPT_EXCLUDE, OPT_EXCLUDE_FROM,
324 OPT_DELETE_AFTER, OPT_DELETE_EXCLUDED,
325 OPT_COMPARE_DEST, OPT_COPY_DEST, OPT_LINK_DEST,
326 OPT_INCLUDE, OPT_INCLUDE_FROM, OPT_MODIFY_WINDOW,
327 OPT_READ_BATCH, OPT_WRITE_BATCH, OPT_TIMEOUT, OPT_MAX_SIZE,
328 OPT_REFUSED_BASE = 9000};
330 static struct poptOption long_options[] = {
331 /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
332 {"version", 0, POPT_ARG_NONE, 0, OPT_VERSION, 0, 0},
333 {"suffix", 0, POPT_ARG_STRING, &backup_suffix, 0, 0, 0 },
334 {"rsync-path", 0, POPT_ARG_STRING, &rsync_path, 0, 0, 0 },
335 {"password-file", 0, POPT_ARG_STRING, &password_file, 0, 0, 0 },
336 {"ignore-times", 'I', POPT_ARG_NONE, &ignore_times, 0, 0, 0 },
337 {"size-only", 0, POPT_ARG_NONE, &size_only, 0, 0, 0 },
338 {"modify-window", 0, POPT_ARG_INT, &modify_window, OPT_MODIFY_WINDOW, 0, 0 },
339 {"one-file-system", 'x', POPT_ARG_NONE, &one_file_system, 0, 0, 0 },
340 {"delete", 0, POPT_ARG_NONE, &delete_mode, 0, 0, 0 },
341 {"existing", 0, POPT_ARG_NONE, &only_existing, 0, 0, 0 },
342 {"ignore-existing", 0, POPT_ARG_NONE, &opt_ignore_existing, 0, 0, 0 },
343 {"delete-after", 0, POPT_ARG_NONE, 0, OPT_DELETE_AFTER, 0, 0 },
344 {"delete-excluded", 0, POPT_ARG_NONE, 0, OPT_DELETE_EXCLUDED, 0, 0 },
345 {"force", 0, POPT_ARG_NONE, &force_delete, 0, 0, 0 },
346 {"numeric-ids", 0, POPT_ARG_NONE, &numeric_ids, 0, 0, 0 },
347 {"exclude", 0, POPT_ARG_STRING, 0, OPT_EXCLUDE, 0, 0 },
348 {"include", 0, POPT_ARG_STRING, 0, OPT_INCLUDE, 0, 0 },
349 {"exclude-from", 0, POPT_ARG_STRING, 0, OPT_EXCLUDE_FROM, 0, 0 },
350 {"include-from", 0, POPT_ARG_STRING, 0, OPT_INCLUDE_FROM, 0, 0 },
351 {"safe-links", 0, POPT_ARG_NONE, &safe_symlinks, 0, 0, 0 },
352 {"help", 'h', POPT_ARG_NONE, 0, 'h', 0, 0 },
353 {"backup", 'b', POPT_ARG_NONE, &make_backups, 0, 0, 0 },
354 {"dry-run", 'n', POPT_ARG_NONE, &dry_run, 0, 0, 0 },
355 {"sparse", 'S', POPT_ARG_NONE, &sparse_files, 0, 0, 0 },
356 {"cvs-exclude", 'C', POPT_ARG_NONE, &cvs_exclude, 0, 0, 0 },
357 {"update", 'u', POPT_ARG_NONE, &update_only, 0, 0, 0 },
358 {"inplace", 0, POPT_ARG_NONE, &inplace, 0, 0, 0 },
359 {"keep-dirlinks", 'K', POPT_ARG_NONE, &keep_dirlinks, 0, 0, 0 },
360 {"links", 'l', POPT_ARG_NONE, &preserve_links, 0, 0, 0 },
361 {"copy-links", 'L', POPT_ARG_NONE, ©_links, 0, 0, 0 },
362 {"whole-file", 'W', POPT_ARG_VAL, &whole_file, 1, 0, 0 },
363 {"no-whole-file", 0, POPT_ARG_VAL, &whole_file, 0, 0, 0 },
364 {"copy-unsafe-links", 0, POPT_ARG_NONE, ©_unsafe_links, 0, 0, 0 },
365 {"perms", 'p', POPT_ARG_NONE, &preserve_perms, 0, 0, 0 },
366 {"owner", 'o', POPT_ARG_NONE, &preserve_uid, 0, 0, 0 },
367 {"group", 'g', POPT_ARG_NONE, &preserve_gid, 0, 0, 0 },
368 {"devices", 'D', POPT_ARG_NONE, &preserve_devices, 0, 0, 0 },
369 {"times", 't', POPT_ARG_NONE, &preserve_times, 0, 0, 0 },
370 {"checksum", 'c', POPT_ARG_NONE, &always_checksum, 0, 0, 0 },
371 {"verbose", 'v', POPT_ARG_NONE, 0, 'v', 0, 0 },
372 {"quiet", 'q', POPT_ARG_NONE, 0, 'q', 0, 0 },
373 {"archive", 'a', POPT_ARG_NONE, &archive_mode, 0, 0, 0 },
374 {"server", 0, POPT_ARG_NONE, &am_server, 0, 0, 0 },
375 {"sender", 0, POPT_ARG_NONE, 0, OPT_SENDER, 0, 0 },
376 {"recursive", 'r', POPT_ARG_NONE, &recurse, 0, 0, 0 },
377 {"relative", 'R', POPT_ARG_VAL, &relative_paths, 1, 0, 0 },
378 {"no-relative", 0, POPT_ARG_VAL, &relative_paths, 0, 0, 0 },
379 {"rsh", 'e', POPT_ARG_STRING, &shell_cmd, 0, 0, 0 },
380 {"block-size", 'B', POPT_ARG_LONG, &block_size, 0, 0, 0 },
381 {"max-delete", 0, POPT_ARG_INT, &max_delete, 0, 0, 0 },
382 {"max-size", 0, POPT_ARG_STRING, &max_size_arg, OPT_MAX_SIZE, 0, 0 },
383 {"timeout", 0, POPT_ARG_INT, &io_timeout, OPT_TIMEOUT, 0, 0 },
384 {"temp-dir", 'T', POPT_ARG_STRING, &tmpdir, 0, 0, 0 },
385 {"compare-dest", 0, POPT_ARG_STRING, 0, OPT_COMPARE_DEST, 0, 0 },
386 {"copy-dest", 0, POPT_ARG_STRING, 0, OPT_COPY_DEST, 0, 0 },
387 {"link-dest", 0, POPT_ARG_STRING, 0, OPT_LINK_DEST, 0, 0 },
388 /* TODO: Should this take an optional int giving the compression level? */
389 {"compress", 'z', POPT_ARG_NONE, &do_compression, 0, 0, 0 },
390 {"stats", 0, POPT_ARG_NONE, &do_stats, 0, 0, 0 },
391 {"progress", 0, POPT_ARG_NONE, &do_progress, 0, 0, 0 },
392 {"partial", 0, POPT_ARG_NONE, &keep_partial, 0, 0, 0 },
393 {"partial-dir", 0, POPT_ARG_STRING, &partial_dir, 0, 0, 0 },
394 {"ignore-errors", 0, POPT_ARG_NONE, &ignore_errors, 0, 0, 0 },
395 {"blocking-io", 0, POPT_ARG_VAL, &blocking_io, 1, 0, 0 },
396 {"no-blocking-io", 0, POPT_ARG_VAL, &blocking_io, 0, 0, 0 },
397 {0, 'P', POPT_ARG_NONE, 0, 'P', 0, 0 },
398 {"port", 0, POPT_ARG_INT, &rsync_port, 0, 0, 0 },
399 {"log-format", 0, POPT_ARG_STRING, &log_format, 0, 0, 0 },
400 {"bwlimit", 0, POPT_ARG_INT, &bwlimit, 0, 0, 0 },
401 {"backup-dir", 0, POPT_ARG_STRING, &backup_dir, 0, 0, 0 },
402 {"hard-links", 'H', POPT_ARG_NONE, &preserve_hard_links, 0, 0, 0 },
403 {"read-batch", 0, POPT_ARG_STRING, &batch_name, OPT_READ_BATCH, 0, 0 },
404 {"write-batch", 0, POPT_ARG_STRING, &batch_name, OPT_WRITE_BATCH, 0, 0 },
405 {"files-from", 0, POPT_ARG_STRING, &files_from, 0, 0, 0 },
406 {"from0", '0', POPT_ARG_NONE, &eol_nulls, 0, 0, 0},
407 {"no-implied-dirs", 0, POPT_ARG_VAL, &implied_dirs, 0, 0, 0 },
408 {"protocol", 0, POPT_ARG_INT, &protocol_version, 0, 0, 0 },
409 {"checksum-seed", 0, POPT_ARG_INT, &checksum_seed, 0, 0, 0 },
411 {"ipv4", '4', POPT_ARG_VAL, &default_af_hint, AF_INET, 0, 0 },
412 {"ipv6", '6', POPT_ARG_VAL, &default_af_hint, AF_INET6, 0, 0 },
414 /* All these options switch us into daemon-mode option-parsing. */
415 {"address", 0, POPT_ARG_STRING, 0, OPT_DAEMON, 0, 0 },
416 {"config", 0, POPT_ARG_STRING, 0, OPT_DAEMON, 0, 0 },
417 {"daemon", 0, POPT_ARG_NONE, 0, OPT_DAEMON, 0, 0 },
418 {"no-detach", 0, POPT_ARG_NONE, 0, OPT_DAEMON, 0, 0 },
422 static void daemon_usage(enum logcode F)
424 print_rsync_version(F);
426 rprintf(F,"\nUsage: rsync --daemon [OPTION]...\n");
427 rprintf(F," --address=ADDRESS bind to the specified address\n");
428 rprintf(F," --bwlimit=KBPS limit I/O bandwidth, KBytes per second\n");
429 rprintf(F," --config=FILE specify alternate rsyncd.conf file\n");
430 rprintf(F," --no-detach do not detach from the parent\n");
431 rprintf(F," --port=PORT specify alternate rsyncd port number\n");
433 rprintf(F," -4, --ipv4 prefer IPv4\n");
434 rprintf(F," -6, --ipv6 prefer IPv6\n");
436 rprintf(F," -h, --help show this help screen\n");
438 rprintf(F,"\nIf you were not trying to invoke rsync as a daemon, avoid using any of the\n");
439 rprintf(F,"daemon-specific rsync options. See also the rsyncd.conf(5) man page.\n");
442 static struct poptOption long_daemon_options[] = {
443 /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
444 {"address", 0, POPT_ARG_STRING, &bind_address, 0, 0, 0 },
445 {"bwlimit", 0, POPT_ARG_INT, &daemon_bwlimit, 0, 0, 0 },
446 {"config", 0, POPT_ARG_STRING, &config_file, 0, 0, 0 },
447 {"daemon", 0, POPT_ARG_NONE, &daemon_opt, 0, 0, 0 },
449 {"ipv4", '4', POPT_ARG_VAL, &default_af_hint, AF_INET, 0, 0 },
450 {"ipv6", '6', POPT_ARG_VAL, &default_af_hint, AF_INET6, 0, 0 },
452 {"no-detach", 0, POPT_ARG_NONE, &no_detach, 0, 0, 0 },
453 {"port", 0, POPT_ARG_INT, &rsync_port, 0, 0, 0 },
454 {"protocol", 0, POPT_ARG_INT, &protocol_version, 0, 0, 0 },
455 {"server", 0, POPT_ARG_NONE, &am_server, 0, 0, 0 },
456 {"help", 'h', POPT_ARG_NONE, 0, 'h', 0, 0 },
461 static char err_buf[200];
465 * Store the option error message, if any, so that we can log the
466 * connection attempt (which requires parsing the options), and then
467 * show the error later on.
469 void option_error(void)
472 strcpy(err_buf, "Error parsing options: "
473 "option may be supported on client but not on server?\n");
476 rprintf(FERROR, RSYNC_NAME ": %s", err_buf);
481 * Tweak the option table to disable all options that the rsyncd.conf
482 * file has told us to refuse.
484 static void set_refuse_options(char *bp)
486 struct poptOption *op;
487 char *cp, shortname[2];
488 int is_wild, found_match;
493 while (*bp == ' ') bp++;
496 if ((cp = strchr(bp, ' ')) != NULL)
498 /* If they specify "delete", reject all delete options. */
499 if (strcmp(bp, "delete") == 0)
501 is_wild = strpbrk(bp, "*?[") != NULL;
503 for (op = long_options; ; op++) {
504 *shortname = op->shortName;
505 if (!op->longName && !*shortname)
507 if ((op->longName && wildmatch(bp, op->longName))
508 || (*shortname && wildmatch(bp, shortname))) {
509 op->val = (op - long_options) + OPT_REFUSED_BASE;
516 rprintf(FLOG, "No match for refuse-options string \"%s\"\n",
527 static int count_args(const char **argv)
532 while (argv[i] != NULL)
541 * Process command line arguments. Called on both local and remote.
543 * @retval 1 if all options are OK; with globals set to appropriate
546 * @retval 0 on error, with err_buf containing an explanation
548 int parse_arguments(int *argc, const char ***argv, int frommain)
551 char *ref = lp_refuse_options(module_id);
556 set_refuse_options(ref);
558 /* TODO: Call poptReadDefaultConfig; handle errors. */
560 /* The context leaks in case of an error, but if there's a
561 * problem we always exit anyhow. */
562 pc = poptGetContext(RSYNC_NAME, *argc, *argv, long_options, 0);
563 poptReadDefaultConfig(pc, 0);
565 while ((opt = poptGetNextOpt(pc)) != -1) {
566 /* most options are handled automatically by popt;
567 * only special cases are returned and listed here. */
571 print_rsync_version(FINFO);
576 strcpy(err_buf, "Attempt to hack rsync thwarted!\n");
580 pc = poptGetContext(RSYNC_NAME, *argc, *argv,
581 long_daemon_options, 0);
582 while ((opt = poptGetNextOpt(pc)) != -1) {
590 "rsync: %s: %s (in daemon mode)\n",
591 poptBadOption(pc, POPT_BADOPTION_NOALIAS),
597 rprintf(FERROR, "Daemon option(s) used without --daemon.\n");
600 "(Type \"rsync --daemon --help\" for assistance with daemon mode.)\n");
601 exit_cleanup(RERR_SYNTAX);
603 *argv = poptGetArgs(pc);
604 *argc = count_args(*argv);
609 case OPT_MODIFY_WINDOW:
610 /* The value has already been set by popt, but
611 * we need to remember that we're using a
612 * non-default setting. */
613 modify_window_set = 1;
616 case OPT_DELETE_AFTER:
621 case OPT_DELETE_EXCLUDED:
627 add_exclude(&exclude_list, poptGetOptArg(pc), 0);
631 add_exclude(&exclude_list, poptGetOptArg(pc),
635 case OPT_EXCLUDE_FROM:
636 case OPT_INCLUDE_FROM:
637 arg = poptGetOptArg(pc);
639 arg = sanitize_path(NULL, arg, NULL, 0);
640 if (server_exclude_list.head) {
641 char *cp = (char *)arg;
643 if (check_exclude(&server_exclude_list, cp, 0) < 0)
644 goto options_rejected;
646 add_exclude_file(&exclude_list, arg, XFLG_FATAL_ERRORS
647 | (opt == OPT_INCLUDE_FROM
648 ? XFLG_DEF_INCLUDE : 0));
667 exit_cleanup(RERR_SYNTAX);
677 case OPT_WRITE_BATCH:
678 /* batch_name is already set */
683 /* batch_name is already set */
688 for (arg = max_size_arg; isdigit(*arg); arg++) {}
690 for (arg++; isdigit(*arg); arg++) {}
693 max_size = atof(max_size_arg) * 1024;
696 max_size = atof(max_size_arg) * 1024*1024;
699 max_size = atof(max_size_arg) * 1024*1024*1024;
702 max_size = atof(max_size_arg);
709 snprintf(err_buf, sizeof err_buf,
710 "--max-size value is invalid: %s\n",
717 if (io_timeout && io_timeout < select_timeout)
718 select_timeout = io_timeout;
724 dest_option = "--link-dest";
727 snprintf(err_buf, sizeof err_buf,
728 "hard links are not supported on this %s\n",
729 am_server ? "server" : "client");
735 dest_option = "--copy-dest";
738 case OPT_COMPARE_DEST:
740 dest_option = "--compare-dest";
742 if (basis_dir_cnt >= MAX_BASIS_DIRS) {
743 snprintf(err_buf, sizeof err_buf,
744 "ERROR: at most %d %s args may be specified\n",
745 MAX_BASIS_DIRS, dest_option);
748 arg = poptGetOptArg(pc);
750 arg = sanitize_path(NULL, arg, NULL, 0);
751 basis_dir[basis_dir_cnt++] = (char *)arg;
755 /* A large opt value means that set_refuse_options()
756 * turned this option off (opt-BASE is its index). */
757 if (opt >= OPT_REFUSED_BASE) {
758 struct poptOption *op =
759 &long_options[opt-OPT_REFUSED_BASE];
760 int n = snprintf(err_buf, sizeof err_buf,
761 "The server is configured to refuse --%s\n",
764 snprintf(err_buf+n, sizeof err_buf-n,
765 " (-%c)\n", op->shortName);
768 snprintf(err_buf, sizeof err_buf, "%s%s: %s\n",
769 am_server ? "on remote machine: " : "",
770 poptBadOption(pc, POPT_BADOPTION_NOALIAS),
778 if (preserve_links && !am_sender) {
779 snprintf(err_buf, sizeof err_buf,
780 "symlinks are not supported on this %s\n",
781 am_server ? "server" : "client");
786 #if !SUPPORT_HARD_LINKS
787 if (preserve_hard_links) {
788 snprintf(err_buf, sizeof err_buf,
789 "hard links are not supported on this %s\n",
790 am_server ? "server" : "client");
795 if (write_batch && read_batch) {
796 snprintf(err_buf, sizeof err_buf,
797 "--write-batch and --read-batch can not be used together\n");
800 if (write_batch || read_batch) {
802 snprintf(err_buf, sizeof err_buf,
803 "--%s-batch cannot be used with --dry_run (-n)\n",
804 write_batch ? "write" : "read");
809 "ignoring --%s-batch option sent to server\n",
810 write_batch ? "write" : "read");
811 /* We don't actually exit_cleanup(), so that we can
812 * still service older version clients that still send
813 * batch args to server. */
814 read_batch = write_batch = 0;
818 if (read_batch && files_from) {
819 snprintf(err_buf, sizeof err_buf,
820 "--read-batch cannot be used with --files-from\n");
823 if (batch_name && strlen(batch_name) > MAX_BATCH_NAME_LEN) {
824 snprintf(err_buf, sizeof err_buf,
825 "the batch-file name must be %d characters or less.\n",
830 if (tmpdir && strlen(tmpdir) >= MAXPATHLEN - 10) {
831 snprintf(err_buf, sizeof err_buf,
832 "the --temp-dir path is WAY too long.\n");
836 if (compare_dest + copy_dest + link_dest > 1) {
837 snprintf(err_buf, sizeof err_buf,
838 "You may not mix --compare-dest, --copy-dest, and --link-dest.\n");
852 preserve_devices = 1;
858 if (relative_paths < 0)
859 relative_paths = files_from? 1 : 0;
863 *argv = poptGetArgs(pc);
864 *argc = count_args(*argv);
866 if (sanitize_paths) {
868 for (i = *argc; i-- > 0; )
869 (*argv)[i] = sanitize_path(NULL, (*argv)[i], "", 0);
871 tmpdir = sanitize_path(NULL, tmpdir, NULL, 0);
873 partial_dir = sanitize_path(NULL, partial_dir, NULL, 0);
875 backup_dir = sanitize_path(NULL, backup_dir, NULL, 0);
877 files_from = sanitize_path(NULL, files_from, NULL, 0);
879 if (server_exclude_list.head && !am_sender) {
880 struct exclude_list_struct *elp = &server_exclude_list;
883 clean_fname(tmpdir, 1);
884 if (check_exclude(elp, tmpdir, 1) < 0)
885 goto options_rejected;
888 clean_fname(partial_dir, 1);
889 if (check_exclude(elp, partial_dir, 1) < 0)
890 goto options_rejected;
892 for (i = 0; i < basis_dir_cnt; i++) {
893 clean_fname(basis_dir[i], 1);
894 if (check_exclude(elp, basis_dir[i], 1) < 0)
895 goto options_rejected;
898 clean_fname(backup_dir, 1);
899 if (check_exclude(elp, backup_dir, 1) < 0)
900 goto options_rejected;
903 if (server_exclude_list.head && files_from) {
904 clean_fname(files_from, 1);
905 if (check_exclude(&server_exclude_list, files_from, 0) < 0) {
907 snprintf(err_buf, sizeof err_buf,
908 "Your options have been rejected by the server.\n");
914 backup_suffix = backup_dir ? "" : BACKUP_SUFFIX;
915 backup_suffix_len = strlen(backup_suffix);
916 if (strchr(backup_suffix, '/') != NULL) {
917 snprintf(err_buf, sizeof err_buf,
918 "--suffix cannot contain slashes: %s\n",
923 backup_dir_len = strlcpy(backup_dir_buf, backup_dir, sizeof backup_dir_buf);
924 backup_dir_remainder = sizeof backup_dir_buf - backup_dir_len;
925 if (backup_dir_remainder < 32) {
926 snprintf(err_buf, sizeof err_buf,
927 "the --backup-dir path is WAY too long.\n");
930 if (backup_dir_buf[backup_dir_len - 1] != '/') {
931 backup_dir_buf[backup_dir_len++] = '/';
932 backup_dir_buf[backup_dir_len] = '\0';
934 if (verbose > 1 && !am_sender)
935 rprintf(FINFO, "backup_dir is %s\n", backup_dir_buf);
936 } else if (!backup_suffix_len && (!am_server || !am_sender)) {
937 snprintf(err_buf, sizeof err_buf,
938 "--suffix cannot be a null string without --backup-dir\n");
942 if (do_progress && !verbose)
945 if (daemon_bwlimit && (!bwlimit || bwlimit > daemon_bwlimit))
946 bwlimit = daemon_bwlimit;
948 bwlimit_writemax = (size_t)bwlimit * 128;
949 if (bwlimit_writemax < 512)
950 bwlimit_writemax = 512;
956 snprintf(err_buf, sizeof err_buf,
957 "--inplace cannot be used with --partial-dir\n");
962 snprintf(err_buf, sizeof err_buf,
963 "--inplace is not supported on this %s\n",
964 am_server ? "server" : "client");
968 if (keep_partial && !partial_dir)
969 partial_dir = getenv("RSYNC_PARTIAL_DIR");
971 if (!*partial_dir || strcmp(partial_dir, ".") == 0)
973 else if (*partial_dir != '/') {
974 add_exclude(&exclude_list, partial_dir,
983 if (*argc > 2 || (!am_daemon && *argc == 1)) {
985 exit_cleanup(RERR_SYNTAX);
987 if (strcmp(files_from, "-") == 0) {
990 remote_filesfrom_file = "-";
992 else if ((colon = find_colon(files_from)) != 0) {
995 exit_cleanup(RERR_SYNTAX);
997 remote_filesfrom_file = colon+1 + (colon[1] == ':');
998 if (strcmp(remote_filesfrom_file, "-") == 0) {
999 snprintf(err_buf, sizeof err_buf,
1000 "Invalid --files-from remote filename\n");
1004 filesfrom_fd = open(files_from, O_RDONLY|O_BINARY);
1005 if (filesfrom_fd < 0) {
1006 snprintf(err_buf, sizeof err_buf,
1007 "failed to open files-from file %s: %s\n",
1008 files_from, strerror(errno));
1020 * Construct a filtered list of options to pass through from the
1021 * client to the server.
1023 * This involves setting options that will tell the server how to
1024 * behave, and also filtering out options that are processed only
1027 void server_options(char **args,int *argc)
1029 static char argstr[50+MAX_BASIS_DIRS*2];
1035 if (blocking_io == -1)
1038 args[ac++] = "--server";
1040 if (daemon_over_rsh) {
1041 args[ac++] = "--daemon";
1043 /* if we're passing --daemon, we're done */
1048 args[ac++] = "--sender";
1052 for (i = 0; i < verbose; i++)
1055 /* the -q option is intentionally left out */
1066 if (keep_dirlinks && am_sender)
1071 /* We don't need to send --no-whole-file, because it's the
1072 * default for remote transfers, and in any case old versions
1073 * of rsync will not understand it. */
1075 if (preserve_hard_links)
1081 if (preserve_devices)
1089 if (always_checksum)
1097 if (one_file_system)
1104 /* this is a complete hack - blame Rusty
1106 this is a hack to make the list_only (remote file list)
1108 if (list_only && !recurse)
1114 args[ac++] = argstr;
1117 if (asprintf(&arg, "-B%lu", block_size) < 0)
1122 if (max_delete && am_sender) {
1123 if (asprintf(&arg, "--max-delete=%d", max_delete) < 0)
1128 if (max_size && am_sender) {
1129 args[ac++] = "--max-size";
1130 args[ac++] = max_size_arg;
1134 if (asprintf(&arg, "--timeout=%d", io_timeout) < 0)
1140 if (asprintf(&arg, "--bwlimit=%d", bwlimit) < 0)
1146 args[ac++] = "--backup-dir";
1147 args[ac++] = backup_dir;
1150 /* Only send --suffix if it specifies a non-default value. */
1151 if (strcmp(backup_suffix, backup_dir ? "" : BACKUP_SUFFIX) != 0) {
1152 /* We use the following syntax to avoid weirdness with '~'. */
1153 if (asprintf(&arg, "--suffix=%s", backup_suffix) < 0)
1159 if (delete_excluded)
1160 args[ac++] = "--delete-excluded";
1161 else if (delete_mode)
1162 args[ac++] = "--delete";
1165 args[ac++] = "--delete-after";
1168 args[ac++] = "--force";
1172 args[ac++] = "--size-only";
1174 if (modify_window_set) {
1175 if (asprintf(&arg, "--modify-window=%d", modify_window) < 0)
1180 if (checksum_seed) {
1181 if (asprintf(&arg, "--checksum-seed=%d", checksum_seed) < 0)
1186 if (partial_dir && am_sender) {
1187 args[ac++] = "--partial-dir";
1188 args[ac++] = partial_dir;
1189 } else if (keep_partial)
1190 args[ac++] = "--partial";
1193 args[ac++] = "--ignore-errors";
1195 if (copy_unsafe_links)
1196 args[ac++] = "--copy-unsafe-links";
1199 args[ac++] = "--safe-links";
1202 args[ac++] = "--numeric-ids";
1204 if (only_existing && am_sender)
1205 args[ac++] = "--existing";
1207 if (opt_ignore_existing && am_sender)
1208 args[ac++] = "--ignore-existing";
1211 args[ac++] = "--inplace";
1214 args[ac++] = "--temp-dir";
1215 args[ac++] = tmpdir;
1218 if (basis_dir[0] && am_sender) {
1219 /* the server only needs this option if it is not the sender,
1220 * and it may be an older version that doesn't know this
1221 * option, so don't send it if client is the sender.
1224 for (i = 0; i < basis_dir_cnt; i++) {
1225 args[ac++] = dest_option;
1226 args[ac++] = basis_dir[i];
1230 if (files_from && (!am_sender || remote_filesfrom_file)) {
1231 if (remote_filesfrom_file) {
1232 args[ac++] = "--files-from";
1233 args[ac++] = remote_filesfrom_file;
1235 args[ac++] = "--from0";
1237 args[ac++] = "--files-from=-";
1238 args[ac++] = "--from0";
1240 if (!relative_paths)
1241 args[ac++] = "--no-relative";
1243 if (relative_paths && !implied_dirs && !am_sender)
1244 args[ac++] = "--no-implied-dirs";
1250 out_of_memory("server_options");
1254 * Return the position of a ':' IF it is not part of a filename (i.e. as
1255 * long as it doesn't occur after a slash.
1257 char *find_colon(char *s)
1265 /* now check to see if there is a / in the string before the : - if there is then
1266 discard the colon on the assumption that the : is part of a filename */