Doc.
[rsync/rsync.git] / options.c
CommitLineData
7a24c346 1/* -*- c-file-style: "linux" -*-
dafe63ca
MP
2 *
3 * Copyright (C) 1998-2001 by Andrew Tridgell <tridge@samba.org>
4 * Copyright (C) 2000, 2001, 2002 by Martin Pool <mbp@samba.org>
5 *
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.
10 *
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.
15 *
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.
19 */
7a6421fa 20
7a6421fa 21#include "rsync.h"
2855f61f 22#include "popt.h"
7a6421fa
AT
23
24int make_backups = 0;
1bfbf40b
MP
25
26/**
dafe63ca
MP
27 * If True, send the whole file as literal data rather than trying to
28 * create an incremental diff.
1bfbf40b 29 *
bceec82f
MP
30 * If both are 0, then look at whether we're local or remote and go by
31 * that.
dafe63ca
MP
32 *
33 * @sa disable_deltas_p()
1bfbf40b 34 **/
bceec82f
MP
35int whole_file = 0;
36int no_whole_file = 0;
1bfbf40b 37
7a6421fa
AT
38int copy_links = 0;
39int preserve_links = 0;
40int preserve_hard_links = 0;
41int preserve_perms = 0;
42int preserve_devices = 0;
43int preserve_uid = 0;
44int preserve_gid = 0;
45int preserve_times = 0;
46int update_only = 0;
47int cvs_exclude = 0;
48int dry_run=0;
49int local_server=0;
50int ignore_times=0;
51int delete_mode=0;
b33b791e 52int delete_excluded=0;
7a6421fa
AT
53int one_file_system=0;
54int remote_version=0;
55int sparse_files=0;
56int do_compression=0;
57int am_root=0;
58int orig_umask=0;
59int relative_paths=0;
60int numeric_ids = 0;
61int force_delete = 0;
62int io_timeout = 0;
63int io_error = 0;
64int read_only = 0;
65int module_id = -1;
66int am_server = 0;
30ce7e8a 67int am_sender = 0;
7a6421fa
AT
68int recurse = 0;
69int am_daemon=0;
a800434a 70int do_stats=0;
eb86d661 71int do_progress=0;
c95da96a 72int keep_partial=0;
d853783f 73int safe_symlinks=0;
b5313607 74int copy_unsafe_links=0;
7a6421fa 75int block_size=BLOCK_SIZE;
f83f0548 76int size_only=0;
ef5d23eb 77int bwlimit=0;
57df171b 78int delete_after=0;
1347d512 79int only_existing=0;
3d6feada 80int opt_ignore_existing=0;
0b73ca12 81int max_delete=0;
ef55c686 82int ignore_errors=0;
5b56cc19
AT
83#ifdef _WIN32
84int modify_window=2;
85#else
86int modify_window=0;
87#endif
93689aa5 88int blocking_io=-1;
7a6421fa 89
b35d0d8e 90
13e29995 91/** Network address family. **/
6ab6d4bf 92#ifdef INET6
13e29995 93int default_af_hint = 0; /* Any protocol */
6ab6d4bf 94#else
13e29995 95int default_af_hint = AF_INET; /* Must use IPv4 */
6ab6d4bf 96#endif
06963d0f 97
13e29995
MP
98/** Do not go into the background when run as --daemon. Good
99 * for debugging and required for running as a service on W32,
100 * or under Unix process-monitors. **/
101int no_detach = 0;
102
088aac85
DD
103int write_batch = 0;
104int read_batch = 0;
6902ed17 105
7a6421fa
AT
106char *backup_suffix = BACKUP_SUFFIX;
107char *tmpdir = NULL;
375a4556 108char *compare_dest = NULL;
7a6421fa
AT
109char *config_file = RSYNCD_CONF;
110char *shell_cmd = NULL;
b6062654 111char *log_format = NULL;
65575e96 112char *password_file = NULL;
41bd28fe 113char *rsync_path = RSYNC_PATH;
66203a98 114char *backup_dir = NULL;
7a6421fa
AT
115int rsync_port = RSYNC_PORT;
116
117int verbose = 0;
b86f0cef 118int quiet = 0;
7a6421fa 119int always_checksum = 0;
f7632fc6 120int list_only = 0;
7a6421fa 121
088aac85 122char *batch_prefix = NULL;
6902ed17 123
5b56cc19
AT
124static int modify_window_set;
125
06963d0f
MP
126/** Local address to bind. As a character string because it's
127 * interpreted by the IPv6 layer: should be a numeric IP4 or ip6
128 * address, or a hostname. **/
129char *bind_address;
5c9730a4 130
7a24c346 131
27a12348 132static void print_rsync_version(enum logcode f)
7a24c346 133{
0c80cd8e 134 char const *got_socketpair = "no ";
2855f61f
MP
135 char const *hardlinks = "no ";
136 char const *links = "no ";
a358449a 137 char const *ipv6 = "no ";
736a6a29 138 STRUCT_STAT *dumstat;
0c80cd8e
MP
139
140#ifdef HAVE_SOCKETPAIR
141 got_socketpair = "";
142#endif
2855f61f
MP
143
144#if SUPPORT_HARD_LINKS
145 hardlinks = "";
146#endif
147
148#if SUPPORT_LINKS
149 links = "";
150#endif
151
a358449a
MP
152#if INET6
153 ipv6 = "";
154#endif
155
2855f61f 156 rprintf(f, "%s version %s protocol version %d\n",
a358449a 157 RSYNC_NAME, RSYNC_VERSION, PROTOCOL_VERSION);
2855f61f 158 rprintf(f,
0413e160 159 "Copyright (C) 1996-2002 by Andrew Tridgell and others\n");
3b4b1984 160 rprintf(f, "<http://rsync.samba.org/>\n");
2855f61f 161 rprintf(f, "Capabilities: %d-bit files, %ssocketpairs, "
7a52790b 162 "%shard links, %ssymlinks, batchfiles, \n",
30ce7e8a 163 (int) (sizeof(OFF_T) * 8),
7a52790b 164 got_socketpair, hardlinks, links);
2855f61f 165
736a6a29
MP
166 /* Note that this field may not have type ino_t. It depends
167 * on the complicated interaction between largefile feature
168 * macros. */
7a52790b
MP
169 rprintf(f, " %sIPv6, %d-bit system inums, %d-bit internal inums\n",
170 ipv6,
736a6a29 171 (int) (sizeof(dumstat->st_ino) * 8),
6abd193f 172 (int) (sizeof(INO64_T) * 8));
fc0302cf
MP
173#ifdef MAINTAINER_MODE
174 rprintf(f, " panic action: \"%s\"\n",
175 get_panic_action());
176#endif
736a6a29 177
7a24c346 178#ifdef NO_INT64
4db41492 179 rprintf(f, "WARNING: no 64-bit integers on this platform!\n");
7a24c346 180#endif
7b329a2d
MP
181
182 rprintf(f,
183"\n"
184"rsync comes with ABSOLUTELY NO WARRANTY. This is free software, and you\n"
185"are welcome to redistribute it under certain conditions. See the GNU\n"
186"General Public Licence for details.\n"
187 );
7a24c346
MP
188}
189
190
0f3203c3 191void usage(enum logcode F)
7a6421fa 192{
2855f61f 193 print_rsync_version(F);
704f908e 194
3ff984d7 195 rprintf(F,"\nrsync is a file transfer program capable of efficient remote update\nvia a fast differencing algorithm.\n\n");
704f908e 196
9ef53907 197 rprintf(F,"Usage: rsync [OPTION]... SRC [SRC]... [USER@]HOST:DEST\n");
704f908e 198 rprintf(F," or rsync [OPTION]... [USER@]HOST:SRC DEST\n");
9ef53907 199 rprintf(F," or rsync [OPTION]... SRC [SRC]... DEST\n");
14d43f1f 200 rprintf(F," or rsync [OPTION]... [USER@]HOST::SRC [DEST]\n");
9ef53907 201 rprintf(F," or rsync [OPTION]... SRC [SRC]... [USER@]HOST::DEST\n");
14d43f1f 202 rprintf(F," or rsync [OPTION]... rsync://[USER@]HOST[:PORT]/SRC [DEST]\n");
9ef53907
DD
203 rprintf(F,"SRC on single-colon remote HOST will be expanded by remote shell\n");
204 rprintf(F,"SRC on server remote HOST may contain shell wildcards or multiple\n");
205 rprintf(F," sources separated by space as long as they have same top-level\n");
704f908e
AT
206 rprintf(F,"\nOptions\n");
207 rprintf(F," -v, --verbose increase verbosity\n");
b86f0cef 208 rprintf(F," -q, --quiet decrease verbosity\n");
704f908e
AT
209 rprintf(F," -c, --checksum always checksum\n");
210 rprintf(F," -a, --archive archive mode\n");
211 rprintf(F," -r, --recursive recurse into directories\n");
212 rprintf(F," -R, --relative use relative path names\n");
9ef53907 213 rprintf(F," -b, --backup make backups (default %s suffix)\n",BACKUP_SUFFIX);
e20c5e95 214 rprintf(F," --backup-dir make backups into this directory\n");
9ef53907 215 rprintf(F," --suffix=SUFFIX override backup suffix\n");
704f908e 216 rprintf(F," -u, --update update only (don't overwrite newer files)\n");
13e29995
MP
217 rprintf(F," -l, --links copy symlinks as symlinks\n");
218 rprintf(F," -L, --copy-links copy the referent of symlinks\n");
b5313607 219 rprintf(F," --copy-unsafe-links copy links outside the source tree\n");
d853783f 220 rprintf(F," --safe-links ignore links outside the destination tree\n");
704f908e
AT
221 rprintf(F," -H, --hard-links preserve hard links\n");
222 rprintf(F," -p, --perms preserve permissions\n");
223 rprintf(F," -o, --owner preserve owner (root only)\n");
224 rprintf(F," -g, --group preserve group\n");
225 rprintf(F," -D, --devices preserve devices (root only)\n");
226 rprintf(F," -t, --times preserve times\n");
227 rprintf(F," -S, --sparse handle sparse files efficiently\n");
228 rprintf(F," -n, --dry-run show what would have been transferred\n");
229 rprintf(F," -W, --whole-file copy whole files, no incremental checks\n");
93689aa5 230 rprintf(F," --no-whole-file turn off --whole-file\n");
704f908e 231 rprintf(F," -x, --one-file-system don't cross filesystem boundaries\n");
9ef53907 232 rprintf(F," -B, --block-size=SIZE checksum blocking size (default %d)\n",BLOCK_SIZE);
704f908e
AT
233 rprintf(F," -e, --rsh=COMMAND specify rsh replacement\n");
234 rprintf(F," --rsync-path=PATH specify path to rsync on the remote machine\n");
235 rprintf(F," -C, --cvs-exclude auto ignore files in the same way CVS does\n");
1347d512 236 rprintf(F," --existing only update files that already exist\n");
3d6feada 237 rprintf(F," --ignore-existing ignore files that already exist on the receiving side\n");
704f908e 238 rprintf(F," --delete delete files that don't exist on the sending side\n");
b33b791e 239 rprintf(F," --delete-excluded also delete excluded files on the receiving side\n");
57df171b 240 rprintf(F," --delete-after delete after transferring, not before\n");
ef55c686 241 rprintf(F," --ignore-errors delete even if there are IO errors\n");
0b73ca12 242 rprintf(F," --max-delete=NUM don't delete more than NUM files\n");
c95da96a 243 rprintf(F," --partial keep partially transferred files\n");
704f908e
AT
244 rprintf(F," --force force deletion of directories even if not empty\n");
245 rprintf(F," --numeric-ids don't map uid/gid values by user/group name\n");
246 rprintf(F," --timeout=TIME set IO timeout in seconds\n");
247 rprintf(F," -I, --ignore-times don't exclude files that match length and time\n");
f83f0548 248 rprintf(F," --size-only only use file size when determining if a file should be transferred\n");
5b56cc19 249 rprintf(F," --modify-window=NUM Timestamp window (seconds) for file match (default=%d)\n",modify_window);
704f908e 250 rprintf(F," -T --temp-dir=DIR create temporary files in directory DIR\n");
375a4556 251 rprintf(F," --compare-dest=DIR also compare destination files relative to DIR\n");
d9fcc198 252 rprintf(F," -P equivalent to --partial --progress\n");
704f908e 253 rprintf(F," -z, --compress compress file data\n");
2acf81eb 254 rprintf(F," --exclude=PATTERN exclude files matching PATTERN\n");
858fb9eb 255 rprintf(F," --exclude-from=FILE exclude patterns listed in FILE\n");
2acf81eb 256 rprintf(F," --include=PATTERN don't exclude files matching PATTERN\n");
858fb9eb 257 rprintf(F," --include-from=FILE don't exclude patterns listed in FILE\n");
704f908e
AT
258 rprintf(F," --version print version number\n");
259 rprintf(F," --daemon run as a rsync daemon\n");
a538066d 260 rprintf(F," --no-detach do not detach from the parent\n");
2a951cd2 261 rprintf(F," --address=ADDRESS bind to the specified address\n");
704f908e
AT
262 rprintf(F," --config=FILE specify alternate rsyncd.conf file\n");
263 rprintf(F," --port=PORT specify alternate rsyncd port number\n");
c80ccabb 264 rprintf(F," --blocking-io use blocking IO for the remote shell\n");
93689aa5 265 rprintf(F," --no-blocking-io turn off --blocking-io\n");
704f908e 266 rprintf(F," --stats give some file transfer stats\n");
eb86d661 267 rprintf(F," --progress show progress during transfer\n");
b6062654 268 rprintf(F," --log-format=FORMAT log file transfers using specified format\n");
65575e96 269 rprintf(F," --password-file=FILE get password from FILE\n");
ef5d23eb 270 rprintf(F," --bwlimit=KBPS limit I/O bandwidth, KBytes per second\n");
088aac85
DD
271 rprintf(F," --write-batch=PREFIX write batch fileset starting with PREFIX\n");
272 rprintf(F," --read-batch=PREFIX read batch fileset starting with PREFIX\n");
704f908e 273 rprintf(F," -h, --help show this help screen\n");
06963d0f
MP
274#ifdef INET6
275 rprintf(F," -4 prefer IPv4\n");
276 rprintf(F," -6 prefer IPv6\n");
277#endif
7a6421fa
AT
278
279 rprintf(F,"\n");
b72f24c7
AT
280
281 rprintf(F,"\nPlease see the rsync(1) and rsyncd.conf(5) man pages for full documentation\n");
2855f61f 282 rprintf(F,"See http://rsync.samba.org/ for updates, bug reports, and answers\n");
7a6421fa
AT
283}
284
2855f61f 285enum {OPT_VERSION = 1000, OPT_SUFFIX, OPT_SENDER, OPT_SERVER, OPT_EXCLUDE,
b33b791e
DD
286 OPT_EXCLUDE_FROM, OPT_DELETE, OPT_DELETE_EXCLUDED, OPT_NUMERIC_IDS,
287 OPT_RSYNC_PATH, OPT_FORCE, OPT_TIMEOUT, OPT_DAEMON, OPT_CONFIG, OPT_PORT,
d853783f 288 OPT_INCLUDE, OPT_INCLUDE_FROM, OPT_STATS, OPT_PARTIAL, OPT_PROGRESS,
b5313607 289 OPT_COPY_UNSAFE_LINKS, OPT_SAFE_LINKS, OPT_COMPARE_DEST,
57df171b 290 OPT_LOG_FORMAT, OPT_PASSWORD_FILE, OPT_SIZE_ONLY, OPT_ADDRESS,
ef55c686 291 OPT_DELETE_AFTER, OPT_EXISTING, OPT_MAX_DELETE, OPT_BACKUP_DIR,
5b56cc19 292 OPT_IGNORE_ERRORS, OPT_BWLIMIT, OPT_BLOCKING_IO,
b8709f50 293 OPT_NO_BLOCKING_IO, OPT_WHOLE_FILE, OPT_NO_WHOLE_FILE,
3d6feada 294 OPT_MODIFY_WINDOW, OPT_READ_BATCH, OPT_WRITE_BATCH, OPT_IGNORE_EXISTING};
7a6421fa 295
2855f61f
MP
296static struct poptOption long_options[] = {
297 /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
8b54f004
MP
298 {"version", 0, POPT_ARG_NONE, 0, OPT_VERSION, 0, 0},
299 {"suffix", 0, POPT_ARG_STRING, &backup_suffix, 0, 0, 0 },
300 {"rsync-path", 0, POPT_ARG_STRING, &rsync_path, 0, 0, 0 },
301 {"password-file", 0, POPT_ARG_STRING, &password_file, 0, 0, 0 },
302 {"ignore-times", 'I', POPT_ARG_NONE, &ignore_times , 0, 0, 0 },
303 {"size-only", 0, POPT_ARG_NONE, &size_only , 0, 0, 0 },
304 {"modify-window", 0, POPT_ARG_INT, &modify_window, OPT_MODIFY_WINDOW, 0, 0 },
305 {"one-file-system", 'x', POPT_ARG_NONE, &one_file_system , 0, 0, 0 },
306 {"delete", 0, POPT_ARG_NONE, &delete_mode , 0, 0, 0 },
307 {"existing", 0, POPT_ARG_NONE, &only_existing , 0, 0, 0 },
308 {"ignore-existing", 0, POPT_ARG_NONE, &opt_ignore_existing , 0, 0, 0 },
309 {"delete-after", 0, POPT_ARG_NONE, &delete_after , 0, 0, 0 },
310 {"delete-excluded", 0, POPT_ARG_NONE, 0, OPT_DELETE_EXCLUDED, 0, 0 },
311 {"force", 0, POPT_ARG_NONE, &force_delete , 0, 0, 0 },
312 {"numeric-ids", 0, POPT_ARG_NONE, &numeric_ids , 0, 0, 0 },
313 {"exclude", 0, POPT_ARG_STRING, 0, OPT_EXCLUDE, 0, 0 },
314 {"include", 0, POPT_ARG_STRING, 0, OPT_INCLUDE, 0, 0 },
315 {"exclude-from", 0, POPT_ARG_STRING, 0, OPT_EXCLUDE_FROM, 0, 0 },
316 {"include-from", 0, POPT_ARG_STRING, 0, OPT_INCLUDE_FROM, 0, 0 },
317 {"safe-links", 0, POPT_ARG_NONE, &safe_symlinks , 0, 0, 0 },
318 {"help", 'h', POPT_ARG_NONE, 0, 'h', 0, 0 },
319 {"backup", 'b', POPT_ARG_NONE, &make_backups , 0, 0, 0 },
320 {"dry-run", 'n', POPT_ARG_NONE, &dry_run , 0, 0, 0 },
321 {"sparse", 'S', POPT_ARG_NONE, &sparse_files , 0, 0, 0 },
322 {"cvs-exclude", 'C', POPT_ARG_NONE, &cvs_exclude , 0, 0, 0 },
323 {"update", 'u', POPT_ARG_NONE, &update_only , 0, 0, 0 },
324 {"links", 'l', POPT_ARG_NONE, &preserve_links , 0, 0, 0 },
325 {"copy-links", 'L', POPT_ARG_NONE, &copy_links , 0, 0, 0 },
b8709f50
DD
326 {"whole-file", 'W', POPT_ARG_NONE, 0, OPT_WHOLE_FILE, 0, 0 },
327 {"no-whole-file", 0, POPT_ARG_NONE, 0, OPT_NO_WHOLE_FILE, 0, 0 },
8b54f004
MP
328 {"copy-unsafe-links", 0, POPT_ARG_NONE, &copy_unsafe_links , 0, 0, 0 },
329 {"perms", 'p', POPT_ARG_NONE, &preserve_perms , 0, 0, 0 },
330 {"owner", 'o', POPT_ARG_NONE, &preserve_uid , 0, 0, 0 },
331 {"group", 'g', POPT_ARG_NONE, &preserve_gid , 0, 0, 0 },
332 {"devices", 'D', POPT_ARG_NONE, &preserve_devices , 0, 0, 0 },
333 {"times", 't', POPT_ARG_NONE, &preserve_times , 0, 0, 0 },
334 {"checksum", 'c', POPT_ARG_NONE, &always_checksum , 0, 0, 0 },
335 {"verbose", 'v', POPT_ARG_NONE, 0, 'v', 0, 0 },
336 {"quiet", 'q', POPT_ARG_NONE, 0, 'q', 0, 0 },
337 {"archive", 'a', POPT_ARG_NONE, 0, 'a', 0, 0 },
338 {"server", 0, POPT_ARG_NONE, &am_server , 0, 0, 0 },
339 {"sender", 0, POPT_ARG_NONE, 0, OPT_SENDER, 0, 0 },
340 {"recursive", 'r', POPT_ARG_NONE, &recurse , 0, 0, 0 },
341 {"relative", 'R', POPT_ARG_NONE, &relative_paths , 0, 0, 0 },
342 {"rsh", 'e', POPT_ARG_STRING, &shell_cmd , 0, 0, 0 },
343 {"block-size", 'B', POPT_ARG_INT, &block_size , 0, 0, 0 },
344 {"max-delete", 0, POPT_ARG_INT, &max_delete , 0, 0, 0 },
345 {"timeout", 0, POPT_ARG_INT, &io_timeout , 0, 0, 0 },
346 {"temp-dir", 'T', POPT_ARG_STRING, &tmpdir , 0, 0, 0 },
347 {"compare-dest", 0, POPT_ARG_STRING, &compare_dest , 0, 0, 0 },
2855f61f 348 /* TODO: Should this take an optional int giving the compression level? */
8b54f004
MP
349 {"compress", 'z', POPT_ARG_NONE, &do_compression , 0, 0, 0 },
350 {"daemon", 0, POPT_ARG_NONE, &am_daemon , 0, 0, 0 },
351 {"no-detach", 0, POPT_ARG_NONE, &no_detach , 0, 0, 0 },
352 {"stats", 0, POPT_ARG_NONE, &do_stats , 0, 0, 0 },
353 {"progress", 0, POPT_ARG_NONE, &do_progress , 0, 0, 0 },
354 {"partial", 0, POPT_ARG_NONE, &keep_partial , 0, 0, 0 },
355 {"ignore-errors", 0, POPT_ARG_NONE, &ignore_errors , 0, 0, 0 },
356 {"blocking-io", 0, POPT_ARG_NONE, &blocking_io , 0, 0, 0 },
357 {"no-blocking-io", 0, POPT_ARG_NONE, 0, OPT_NO_BLOCKING_IO, 0, 0 },
358 {0, 'P', POPT_ARG_NONE, 0, 'P', 0, 0 },
359 {"config", 0, POPT_ARG_STRING, &config_file , 0, 0, 0 },
360 {"port", 0, POPT_ARG_INT, &rsync_port , 0, 0, 0 },
361 {"log-format", 0, POPT_ARG_STRING, &log_format , 0, 0, 0 },
362 {"bwlimit", 0, POPT_ARG_INT, &bwlimit , 0, 0, 0 },
363 {"address", 0, POPT_ARG_STRING, &bind_address, 0, 0, 0 },
364 {"backup-dir", 0, POPT_ARG_STRING, &backup_dir , 0, 0, 0 },
365 {"hard-links", 'H', POPT_ARG_NONE, &preserve_hard_links , 0, 0, 0 },
366 {"read-batch", 0, POPT_ARG_STRING, &batch_prefix, OPT_READ_BATCH, 0, 0 },
367 {"write-batch", 0, POPT_ARG_STRING, &batch_prefix, OPT_WRITE_BATCH, 0, 0 },
06963d0f 368#ifdef INET6
8b54f004
MP
369 {0, '4', POPT_ARG_VAL, &default_af_hint, AF_INET , 0, 0 },
370 {0, '6', POPT_ARG_VAL, &default_af_hint, AF_INET6 , 0, 0 },
06963d0f 371#endif
8b54f004 372 {0,0,0,0, 0, 0, 0}
2855f61f 373};
7a6421fa 374
06963d0f 375
cd8185f2
AT
376static char err_buf[100];
377
2855f61f 378
dafe63ca
MP
379/**
380 * Store the option error message, if any, so that we can log the
381 * connection attempt (which requires parsing the options), and then
382 * show the error later on.
383 **/
cd8185f2
AT
384void option_error(void)
385{
386 if (err_buf[0]) {
2855f61f
MP
387 rprintf(FLOG, "%s", err_buf);
388 rprintf(FERROR, "%s: %s", RSYNC_NAME, err_buf);
cd8185f2 389 } else {
add7e8fb
MP
390 rprintf (FERROR, "Error parsing options: "
391 "option may be supported on client but not on server?\n");
392 rprintf (FERROR, RSYNC_NAME ": Error parsing options: "
393 "option may be supported on client but not on server?\n");
cd8185f2 394 }
cd8185f2
AT
395}
396
dafe63ca
MP
397
398/**
399 * Check to see if we should refuse this option
400 **/
cd8185f2
AT
401static int check_refuse_options(char *ref, int opt)
402{
403 int i, len;
404 char *p;
405 const char *name;
406
2855f61f 407 for (i=0; long_options[i].longName; i++) {
cd8185f2
AT
408 if (long_options[i].val == opt) break;
409 }
410
2855f61f 411 if (!long_options[i].longName) return 0;
cd8185f2 412
2855f61f 413 name = long_options[i].longName;
cd8185f2
AT
414 len = strlen(name);
415
416 while ((p = strstr(ref,name))) {
055af776
AT
417 if ((p==ref || p[-1]==' ') &&
418 (p[len] == ' ' || p[len] == 0)) {
8950ac03 419 snprintf(err_buf,sizeof(err_buf),
cd8185f2
AT
420 "The '%s' option is not supported by this server\n", name);
421 return 1;
422 }
423 ref += len;
424 }
425 return 0;
426}
427
428
2855f61f
MP
429static int count_args(char const **argv)
430{
431 int i = 0;
432
433 while (argv[i] != NULL)
434 i++;
435
436 return i;
437}
438
439
dafe63ca
MP
440/**
441 * Process command line arguments. Called on both local and remote.
442 *
443 * @retval 1 if all options are OK; with globals set to appropriate
444 * values
445 *
446 * @retval 0 on error, with err_buf containing an explanation
447 **/
2855f61f 448int parse_arguments(int *argc, const char ***argv, int frommain)
7a6421fa 449{
d853783f 450 int opt;
cd8185f2 451 char *ref = lp_refuse_options(module_id);
2855f61f 452 poptContext pc;
d853783f 453
2855f61f 454 /* TODO: Call poptReadDefaultConfig; handle errors. */
cd8185f2 455
2855f61f
MP
456 /* The context leaks in case of an error, but if there's a
457 * problem we always exit anyhow. */
4db41492 458 pc = poptGetContext(RSYNC_NAME, *argc, *argv, long_options, 0);
2855f61f
MP
459
460 while ((opt = poptGetNextOpt(pc)) != -1) {
cd8185f2
AT
461 if (ref) {
462 if (check_refuse_options(ref, opt)) return 0;
463 }
464
2855f61f
MP
465 /* most options are handled automatically by popt;
466 * only special cases are returned and listed here. */
467
d853783f
AT
468 switch (opt) {
469 case OPT_VERSION:
2855f61f 470 print_rsync_version(FINFO);
d853783f
AT
471 exit_cleanup(0);
472
5b56cc19 473 case OPT_MODIFY_WINDOW:
2855f61f
MP
474 /* The value has already been set by popt, but
475 * we need to remember that we're using a
476 * non-default setting. */
5b56cc19
AT
477 modify_window_set = 1;
478 break;
479
b33b791e
DD
480 case OPT_DELETE_EXCLUDED:
481 delete_excluded = 1;
482 delete_mode = 1;
483 break;
484
d853783f 485 case OPT_EXCLUDE:
2855f61f 486 add_exclude(poptGetOptArg(pc), 0);
d853783f
AT
487 break;
488
489 case OPT_INCLUDE:
2855f61f 490 add_exclude(poptGetOptArg(pc), 1);
d853783f
AT
491 break;
492
493 case OPT_EXCLUDE_FROM:
2855f61f 494 add_exclude_file(poptGetOptArg(pc), 1, 0);
d853783f
AT
495 break;
496
93695764
DD
497 case OPT_INCLUDE_FROM:
498 add_exclude_file(poptGetOptArg(pc), 1, 1);
499 break;
500
b8709f50
DD
501 case OPT_WHOLE_FILE:
502 whole_file = 1;
503 no_whole_file = 0;
504 break;
505
506 case OPT_NO_WHOLE_FILE:
507 no_whole_file = 1;
508 whole_file = 0;
509 break;
510
93689aa5
DD
511 case OPT_NO_BLOCKING_IO:
512 blocking_io = 0;
d853783f
AT
513 break;
514
515 case 'h':
516 usage(FINFO);
517 exit_cleanup(0);
518
d853783f 519 case 'H':
7a6421fa 520#if SUPPORT_HARD_LINKS
d853783f 521 preserve_hard_links=1;
2855f61f
MP
522#else
523 /* FIXME: Don't say "server" if this is
524 * happening on the client. */
525 /* FIXME: Why do we have the duplicated
526 * rprintf? Everybody who gets this message
527 * ought to send it to the client and also to
528 * the logs. */
8950ac03 529 snprintf(err_buf,sizeof(err_buf),
2855f61f
MP
530 "hard links are not supported on this %s\n",
531 am_server ? "server" : "client");
d853783f 532 rprintf(FERROR,"ERROR: hard links not supported on this platform\n");
b11ed3b1 533 return 0;
2855f61f 534#endif /* SUPPORT_HARD_LINKS */
d853783f 535 break;
7a6421fa 536
d853783f
AT
537 case 'v':
538 verbose++;
539 break;
7a6421fa 540
b86f0cef
DD
541 case 'q':
542 if (frommain) quiet++;
543 break;
544
d853783f
AT
545 case 'a':
546 recurse=1;
7a6421fa 547#if SUPPORT_LINKS
d853783f 548 preserve_links=1;
7a6421fa 549#endif
d853783f
AT
550 preserve_perms=1;
551 preserve_times=1;
552 preserve_gid=1;
e20c5e95
AT
553 preserve_uid=1;
554 preserve_devices=1;
d853783f
AT
555 break;
556
d853783f
AT
557 case OPT_SENDER:
558 if (!am_server) {
559 usage(FERROR);
65417579 560 exit_cleanup(RERR_SYNTAX);
d853783f
AT
561 }
562 am_sender = 1;
563 break;
564
d9fcc198
AT
565 case 'P':
566 do_progress = 1;
567 keep_partial = 1;
568 break;
569
088aac85
DD
570 case OPT_WRITE_BATCH:
571 /* popt stores the filename in batch_prefix for us */
572 write_batch = 1;
573 break;
574
76f79ba7 575 case OPT_READ_BATCH:
088aac85 576 /* popt stores the filename in batch_prefix for us */
6902ed17
MP
577 read_batch = 1;
578 break;
579
d853783f 580 default:
2855f61f
MP
581 /* FIXME: If --daemon is specified, then errors for later
582 * parameters seem to disappear. */
8950ac03 583 snprintf(err_buf, sizeof(err_buf),
2855f61f
MP
584 "%s%s: %s\n",
585 am_server ? "on remote machine: " : "",
586 poptBadOption(pc, POPT_BADOPTION_NOALIAS),
587 poptStrerror(opt));
588 return 0;
d853783f 589 }
7a6421fa 590 }
2855f61f 591
088aac85
DD
592 if (write_batch && read_batch) {
593 snprintf(err_buf,sizeof(err_buf),
594 "write-batch and read-batch can not be used together\n");
595 rprintf(FERROR,"ERROR: write-batch and read-batch"
596 " can not be used together\n");
597 return 0;
598 }
599
600 if (do_compression && (write_batch || read_batch)) {
601 snprintf(err_buf,sizeof(err_buf),
602 "compress can not be used with write-batch or read-batch\n");
603 rprintf(FERROR,"ERROR: compress can not be used with"
604 " write-batch or read-batch\n");
605 return 0;
606 }
607
2855f61f
MP
608 *argv = poptGetArgs(pc);
609 if (*argv)
610 *argc = count_args(*argv);
611 else
612 *argc = 0;
613
b11ed3b1 614 return 1;
7a6421fa
AT
615}
616
617
dafe63ca
MP
618/**
619 * Construct a filtered list of options to pass through from the
620 * client to the server.
621 *
622 * This involves setting options that will tell the server how to
623 * behave, and also filtering out options that are processed only
624 * locally.
625 **/
7a6421fa
AT
626void server_options(char **args,int *argc)
627{
d853783f
AT
628 int ac = *argc;
629 static char argstr[50];
630 static char bsize[30];
631 static char iotime[30];
0b73ca12 632 static char mdelete[30];
5b56cc19 633 static char mwindow[30];
ef5d23eb 634 static char bw[50];
088aac85
DD
635 /* Leave room for ``--(write|read)-batch='' */
636 static char fext[MAXPATHLEN + 15];
ef5d23eb 637
d853783f
AT
638 int i, x;
639
93689aa5
DD
640 if (blocking_io == -1)
641 blocking_io = 0;
642
d853783f
AT
643 args[ac++] = "--server";
644
645 if (!am_sender)
646 args[ac++] = "--sender";
647
648 x = 1;
649 argstr[0] = '-';
650 for (i=0;i<verbose;i++)
651 argstr[x++] = 'v';
f0b36a48 652
b86f0cef 653 /* the -q option is intentionally left out */
d853783f
AT
654 if (make_backups)
655 argstr[x++] = 'b';
656 if (update_only)
657 argstr[x++] = 'u';
658 if (dry_run)
659 argstr[x++] = 'n';
660 if (preserve_links)
661 argstr[x++] = 'l';
662 if (copy_links)
663 argstr[x++] = 'L';
1bfbf40b 664
8469faef 665 assert(whole_file == 0 || whole_file == 1);
d853783f
AT
666 if (whole_file)
667 argstr[x++] = 'W';
bceec82f
MP
668 /* We don't need to send --no-whole-file, because it's the
669 * default for remote transfers, and in any case old versions
670 * of rsync will not understand it. */
1bfbf40b 671
d853783f
AT
672 if (preserve_hard_links)
673 argstr[x++] = 'H';
674 if (preserve_uid)
675 argstr[x++] = 'o';
676 if (preserve_gid)
677 argstr[x++] = 'g';
678 if (preserve_devices)
679 argstr[x++] = 'D';
680 if (preserve_times)
681 argstr[x++] = 't';
682 if (preserve_perms)
683 argstr[x++] = 'p';
684 if (recurse)
685 argstr[x++] = 'r';
686 if (always_checksum)
687 argstr[x++] = 'c';
688 if (cvs_exclude)
689 argstr[x++] = 'C';
690 if (ignore_times)
691 argstr[x++] = 'I';
692 if (relative_paths)
693 argstr[x++] = 'R';
694 if (one_file_system)
695 argstr[x++] = 'x';
696 if (sparse_files)
697 argstr[x++] = 'S';
698 if (do_compression)
699 argstr[x++] = 'z';
f0b36a48
AT
700
701 /* this is a complete hack - blame Rusty
702
703 this is a hack to make the list_only (remote file list)
704 more useful */
705 if (list_only && !recurse)
706 argstr[x++] = 'r';
707
d853783f
AT
708 argstr[x] = 0;
709
710 if (x != 1) args[ac++] = argstr;
711
712 if (block_size != BLOCK_SIZE) {
8950ac03 713 snprintf(bsize,sizeof(bsize),"-B%d",block_size);
d853783f
AT
714 args[ac++] = bsize;
715 }
716
0b73ca12 717 if (max_delete && am_sender) {
8950ac03 718 snprintf(mdelete,sizeof(mdelete),"--max-delete=%d",max_delete);
0b73ca12
AT
719 args[ac++] = mdelete;
720 }
6902ed17 721
088aac85
DD
722 if (batch_prefix != NULL) {
723 char *fmt = "";
724 if (write_batch)
725 fmt = "--write-batch=%s";
726 else
727 if (read_batch)
728 fmt = "--read-batch=%s";
729 snprintf(fext,sizeof(fext),fmt,batch_prefix);
6902ed17
MP
730 args[ac++] = fext;
731 }
0b73ca12 732
d853783f 733 if (io_timeout) {
8950ac03 734 snprintf(iotime,sizeof(iotime),"--timeout=%d",io_timeout);
d853783f
AT
735 args[ac++] = iotime;
736 }
737
ef5d23eb 738 if (bwlimit) {
8950ac03 739 snprintf(bw,sizeof(bw),"--bwlimit=%d",bwlimit);
ef5d23eb
DD
740 args[ac++] = bw;
741 }
742
d853783f
AT
743 if (strcmp(backup_suffix, BACKUP_SUFFIX)) {
744 args[ac++] = "--suffix";
745 args[ac++] = backup_suffix;
746 }
747
b33b791e 748 if (delete_mode && !delete_excluded)
d853783f
AT
749 args[ac++] = "--delete";
750
b33b791e
DD
751 if (delete_excluded)
752 args[ac++] = "--delete-excluded";
753
f83f0548
AT
754 if (size_only)
755 args[ac++] = "--size-only";
756
5b56cc19 757 if (modify_window_set) {
8950ac03 758 snprintf(mwindow,sizeof(mwindow),"--modify-window=%d",
5b56cc19
AT
759 modify_window);
760 args[ac++] = mwindow;
761 }
762
d853783f
AT
763 if (keep_partial)
764 args[ac++] = "--partial";
765
766 if (force_delete)
767 args[ac++] = "--force";
768
57df171b
AT
769 if (delete_after)
770 args[ac++] = "--delete-after";
771
ef55c686
AT
772 if (ignore_errors)
773 args[ac++] = "--ignore-errors";
774
b5313607
DD
775 if (copy_unsafe_links)
776 args[ac++] = "--copy-unsafe-links";
777
d853783f
AT
778 if (safe_symlinks)
779 args[ac++] = "--safe-links";
780
781 if (numeric_ids)
782 args[ac++] = "--numeric-ids";
783
0b73ca12 784 if (only_existing && am_sender)
1347d512
AT
785 args[ac++] = "--existing";
786
3d6feada
MP
787 if (opt_ignore_existing && am_sender)
788 args[ac++] = "--ignore-existing";
789
d853783f
AT
790 if (tmpdir) {
791 args[ac++] = "--temp-dir";
792 args[ac++] = tmpdir;
793 }
794
66203a98
AT
795 if (backup_dir && am_sender) {
796 /* only the receiver needs this option, if we are the sender
797 * then we need to send it to the receiver.
798 */
799 args[ac++] = "--backup-dir";
800 args[ac++] = backup_dir;
801 }
802
375a4556
DD
803 if (compare_dest && am_sender) {
804 /* the server only needs this option if it is not the sender,
805 * and it may be an older version that doesn't know this
806 * option, so don't send it if client is the sender.
807 */
808 args[ac++] = "--compare-dest";
809 args[ac++] = compare_dest;
810 }
811
d853783f 812 *argc = ac;
7a6421fa
AT
813}
814