Improved some I/O comments.
[rsync/rsync.git] / main.c
CommitLineData
0f78b815
WD
1/*
2 * The startup routines, including main(), for rsync.
3 *
4 * Copyright (C) 1996-2001 Andrew Tridgell <tridge@samba.org>
5 * Copyright (C) 1996 Paul Mackerras
6 * Copyright (C) 2001, 2002 Martin Pool <mbp@samba.org>
b3bf9b9d 7 * Copyright (C) 2003-2009 Wayne Davison
0f78b815
WD
8 *
9 * This program is free software; you can redistribute it and/or modify
8e41b68e
WD
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 3 of the License, or
12 * (at your option) any later version.
0f78b815
WD
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
e7c67065 19 * You should have received a copy of the GNU General Public License along
4fd842f9 20 * with this program; if not, visit the http://fsf.org website.
0f78b815 21 */
c627d613
AT
22
23#include "rsync.h"
5dd14f0c 24#include "inums.h"
a72ba0cf 25#include "io.h"
d9401514
WD
26#if defined CONFIG_LOCALE && defined HAVE_LOCALE_H
27#include <locale.h>
28#endif
c627d613 29
50839b4b
WD
30extern int dry_run;
31extern int list_only;
a0f1ed55 32extern int io_timeout;
32eda096 33extern int am_root;
d9c7edf6
WD
34extern int am_server;
35extern int am_sender;
36extern int am_daemon;
3ea6e0e7 37extern int inc_recurse;
32eda096 38extern int blocking_io;
886df221 39extern int always_checksum;
47c11975 40extern int remove_source_files;
951e826b 41extern int output_needs_newline;
bf26aa22 42extern int need_messages_from_generator;
051182cb 43extern int kluge_around_eof;
3f0211b6 44extern int got_xfer_error;
eabc85ef 45extern int msgs2stderr;
32eda096 46extern int module_id;
d7205694 47extern int read_only;
bb6721dc 48extern int copy_links;
a695b379 49extern int copy_dirlinks;
01103e18 50extern int copy_unsafe_links;
83926d3c 51extern int keep_dirlinks;
32eda096 52extern int preserve_hard_links;
d04e9c51 53extern int protocol_version;
f3d6d480 54extern int file_total;
32eda096 55extern int recurse;
26bbb6aa 56extern int xfer_dirs;
f7e5068d 57extern int protect_args;
32eda096 58extern int relative_paths;
7c58c991 59extern int sanitize_paths;
c2a2147a 60extern int curr_dir_depth;
615a5415 61extern int curr_dir_len;
7c58c991 62extern int module_id;
32eda096 63extern int rsync_port;
b1df18d7 64extern int whole_file;
32eda096
WD
65extern int read_batch;
66extern int write_batch;
b9f592fb 67extern int batch_fd;
41000dff
WD
68extern int sock_f_in;
69extern int sock_f_out;
32eda096 70extern int filesfrom_fd;
ba22c9e2 71extern int connect_timeout;
20caffd2 72extern int send_msgs_to_gen;
32eda096 73extern pid_t cleanup_child_pid;
20caffd2 74extern size_t bwlimit_writemax;
a1018691 75extern unsigned int module_dirlen;
2885270b 76extern BOOL flist_receiving_enabled;
0c2e8f93 77extern BOOL shutting_down;
50839b4b 78extern struct stats stats;
886df221
WD
79extern char *stdout_format;
80extern char *logfile_format;
860236bf 81extern char *filesfrom_host;
c2c8db91 82extern char *partial_dir;
ce27f36d 83extern char *dest_option;
32eda096
WD
84extern char *rsync_path;
85extern char *shell_cmd;
9b3318b0 86extern char *batch_name;
a39da29a 87extern char *password_file;
3696674b 88extern char *backup_dir;
615a5415 89extern char curr_dir[MAXPATHLEN];
3696674b 90extern char backup_dir_buf[MAXPATHLEN];
b791d680 91extern char *basis_dir[MAX_BASIS_DIRS+1];
da131912 92extern struct file_list *first_flist;
7b6c5c77 93extern filter_rule_list daemon_filter_list;
57dee64e 94
19284e2e 95uid_t our_uid;
3b83a220 96gid_t our_gid;
93465f51 97int am_generator = 0;
57dee64e 98int local_server = 0;
e208631a 99int daemon_over_rsh = 0;
05278935 100mode_t orig_umask = 0;
f3d6d480 101int batch_gen_fd = -1;
886df221 102int sender_keeps_checksum = 0;
c627d613 103
91c5833b
WD
104/* There's probably never more than at most 2 outstanding child processes,
105 * but set it higher, just in case. */
84e6d6fd 106#define MAXCHILDPROCS 7
ee7118a8 107
8261af74
WD
108#ifdef HAVE_SIGACTION
109# ifdef HAVE_SIGPROCMASK
110# define SIGACTMASK(n,h) SIGACTION(n,h), sigaddset(&sigmask,(n))
111# else
112# define SIGACTMASK(n,h) SIGACTION(n,h)
113# endif
60ee01f5
WD
114static struct sigaction sigact;
115#endif
116
ee7118a8
DD
117struct pid_status {
118 pid_t pid;
84e6d6fd 119 int status;
ee7118a8
DD
120} pid_stat_table[MAXCHILDPROCS];
121
33c4b445
WD
122static time_t starttime, endtime;
123static int64 total_read, total_written;
124
e5a2b854 125static void show_malloc_stats(void);
82980a23 126
97d8e709 127/* Works like waitpid(), but if we already harvested the child pid in our
6d59ac19 128 * remember_children(), we succeed instead of returning an error. */
97d8e709 129pid_t wait_process(pid_t pid, int *status_ptr, int flags)
82980a23 130{
d365e229
WD
131 pid_t waited_pid;
132
133 do {
134 waited_pid = waitpid(pid, status_ptr, flags);
135 } while (waited_pid == -1 && errno == EINTR);
d9c7edf6 136
6fb812f7 137 if (waited_pid == -1 && errno == ECHILD) {
97d8e709 138 /* Status of requested child no longer available: check to
6d59ac19 139 * see if it was processed by remember_children(). */
97d8e709 140 int cnt;
84e6d6fd 141 for (cnt = 0; cnt < MAXCHILDPROCS; cnt++) {
ee7118a8 142 if (pid == pid_stat_table[cnt].pid) {
97d8e709 143 *status_ptr = pid_stat_table[cnt].status;
ee7118a8 144 pid_stat_table[cnt].pid = 0;
97d8e709 145 return pid;
ee7118a8
DD
146 }
147 }
148 }
149
97d8e709
WD
150 return waited_pid;
151}
152
153/* Wait for a process to exit, calling io_flush while waiting. */
84e6d6fd 154static void wait_process_with_flush(pid_t pid, int *exit_code_ptr)
97d8e709
WD
155{
156 pid_t waited_pid;
157 int status;
158
159 while ((waited_pid = wait_process(pid, &status, WNOHANG)) == 0) {
160 msleep(20);
161 io_flush(FULL_FLUSH);
162 }
163
d9c7edf6
WD
164 /* TODO: If the child exited on a signal, then log an
165 * appropriate error message. Perhaps we should also accept a
166 * message describing the purpose of the child. Also indicate
dbefb6b4 167 * this to the caller so that they know something went wrong. */
84e6d6fd
WD
168 if (waited_pid < 0) {
169 rsyserr(FERROR, errno, "waitpid");
170 *exit_code_ptr = RERR_WAITCHILD;
171 } else if (!WIFEXITED(status)) {
40e6752f 172#ifdef WCOREDUMP
dbefb6b4 173 if (WCOREDUMP(status))
84e6d6fd 174 *exit_code_ptr = RERR_CRASHED;
40e6752f
WD
175 else
176#endif
177 if (WIFSIGNALED(status))
84e6d6fd 178 *exit_code_ptr = RERR_TERMINATED;
dbefb6b4 179 else
84e6d6fd 180 *exit_code_ptr = RERR_WAITCHILD;
dbefb6b4 181 } else
84e6d6fd 182 *exit_code_ptr = WEXITSTATUS(status);
82980a23
AT
183}
184
e366e530
WD
185void write_del_stats(int f)
186{
bc40a305
WD
187 if (read_batch)
188 write_int(f, NDX_DEL_STATS);
189 else
20caffd2 190 write_ndx(f, NDX_DEL_STATS);
e366e530
WD
191 write_varint(f, stats.deleted_files - stats.deleted_dirs
192 - stats.deleted_symlinks - stats.deleted_devices
193 - stats.deleted_specials);
194 write_varint(f, stats.deleted_dirs);
195 write_varint(f, stats.deleted_symlinks);
196 write_varint(f, stats.deleted_devices);
197 write_varint(f, stats.deleted_specials);
198}
199
200void read_del_stats(int f)
201{
e366e530
WD
202 stats.deleted_files = read_varint(f);
203 stats.deleted_files += stats.deleted_dirs = read_varint(f);
204 stats.deleted_files += stats.deleted_symlinks = read_varint(f);
205 stats.deleted_files += stats.deleted_devices = read_varint(f);
206 stats.deleted_files += stats.deleted_specials = read_varint(f);
207}
208
b9f592fb
WD
209/* This function gets called from all 3 processes. We want the client side
210 * to actually output the text, but the sender is the only process that has
211 * all the stats we need. So, if we're a client sender, we do the report.
212 * If we're a server sender, we write the stats on the supplied fd. If
213 * we're the client receiver we read the stats from the supplied fd and do
214 * the report. All processes might also generate a set of debug stats, if
215 * the verbose level is high enough (this is the only thing that the
216 * generator process and the server receiver ever do here). */
33c4b445 217static void handle_stats(int f)
c627d613 218{
33c4b445
WD
219 endtime = time(NULL);
220
b9f592fb 221 /* Cache two stats because the read/write code can change it. */
33c4b445
WD
222 total_read = stats.total_read;
223 total_written = stats.total_written;
7a6421fa 224
951e826b 225 if (INFO_GTE(STATS, 3)) {
5c15e29f 226 /* These come out from every process */
7bb7058e 227 show_malloc_stats();
86943126 228 show_flist_stats();
5c15e29f
MP
229 }
230
e5fbaa71
S
231 if (am_generator)
232 return;
233
248fbb8c 234 if (am_daemon) {
83926d3c
WD
235 if (f == -1 || !am_sender)
236 return;
248fbb8c
AT
237 }
238
e19452a9 239 if (am_server) {
3e491682 240 if (am_sender) {
a72ba0cf
WD
241 write_varlong30(f, total_read, 3);
242 write_varlong30(f, total_written, 3);
243 write_varlong30(f, stats.total_size, 3);
f0f7e760 244 if (protocol_version >= 29) {
a72ba0cf
WD
245 write_varlong30(f, stats.flist_buildtime, 3);
246 write_varlong30(f, stats.flist_xfertime, 3);
f0f7e760 247 }
e19452a9 248 }
7a6421fa
AT
249 return;
250 }
e19452a9
DD
251
252 /* this is the client */
d9c7edf6 253
9d19f8a5 254 if (f < 0 && !am_sender) /* e.g. when we got an empty file list. */
0f78b815 255 ;
9d19f8a5 256 else if (!am_sender) {
58c5c245
WD
257 /* Read the first two in opposite order because the meaning of
258 * read/write swaps when switching from sender to receiver. */
a72ba0cf
WD
259 total_written = read_varlong30(f, 3);
260 total_read = read_varlong30(f, 3);
261 stats.total_size = read_varlong30(f, 3);
f0f7e760 262 if (protocol_version >= 29) {
a72ba0cf
WD
263 stats.flist_buildtime = read_varlong30(f, 3);
264 stats.flist_xfertime = read_varlong30(f, 3);
f0f7e760 265 }
e4676bb5 266 } else if (write_batch) {
b9f592fb
WD
267 /* The --read-batch process is going to be a client
268 * receiver, so we need to give it the stats. */
a72ba0cf
WD
269 write_varlong30(batch_fd, total_read, 3);
270 write_varlong30(batch_fd, total_written, 3);
271 write_varlong30(batch_fd, stats.total_size, 3);
f0f7e760 272 if (protocol_version >= 29) {
a72ba0cf
WD
273 write_varlong30(batch_fd, stats.flist_buildtime, 3);
274 write_varlong30(batch_fd, stats.flist_xfertime, 3);
f0f7e760 275 }
e366e530
WD
276 }
277}
278
279static void output_itemized_counts(const char *prefix, int *counts)
280{
281 static char *labels[] = { "reg", "dir", "link", "dev", "special" };
282 char buf[1024], *pre = " (";
283 int j, len = 0;
284 int total = counts[0];
285 if (total) {
286 counts[0] -= counts[1] + counts[2] + counts[3] + counts[4];
287 for (j = 0; j < 5; j++) {
288 if (counts[j]) {
289 len += snprintf(buf+len, sizeof buf - len - 2,
290 "%s%s: %s",
291 pre, labels[j], comma_num(counts[j]));
292 pre = ", ";
293 }
294 }
295 buf[len++] = ')';
a800434a 296 }
e366e530
WD
297 buf[len] = '\0';
298 rprintf(FINFO, "%s: %s%s\n", prefix, comma_num(total), buf);
e4676bb5 299}
a800434a 300
e4676bb5
WD
301static void output_summary(void)
302{
951e826b 303 if (INFO_GTE(STATS, 2)) {
b64ee91a 304 rprintf(FCLIENT, "\n");
e366e530
WD
305 output_itemized_counts("Number of files", &stats.num_files);
306 if (protocol_version >= 29)
307 output_itemized_counts("Number of created files", &stats.created_files);
308 if (protocol_version >= 31)
309 output_itemized_counts("Number of deleted files", &stats.deleted_files);
310 rprintf(FINFO,"Number of regular files transferred: %s\n",
311 comma_num(stats.xferred_files));
60613dc8 312 rprintf(FINFO,"Total file size: %s bytes\n",
adc2476f 313 human_num(stats.total_size));
60613dc8 314 rprintf(FINFO,"Total transferred file size: %s bytes\n",
adc2476f 315 human_num(stats.total_transferred_size));
60613dc8 316 rprintf(FINFO,"Literal data: %s bytes\n",
adc2476f 317 human_num(stats.literal_data));
60613dc8 318 rprintf(FINFO,"Matched data: %s bytes\n",
adc2476f 319 human_num(stats.matched_data));
eb0144d7 320 rprintf(FINFO,"File list size: %s\n",
adc2476f 321 human_num(stats.flist_size));
f0f7e760
WD
322 if (stats.flist_buildtime) {
323 rprintf(FINFO,
adc2476f
WD
324 "File list generation time: %s seconds\n",
325 comma_dnum((double)stats.flist_buildtime / 1000, 3));
f0f7e760 326 rprintf(FINFO,
adc2476f
WD
327 "File list transfer time: %s seconds\n",
328 comma_dnum((double)stats.flist_xfertime / 1000, 3));
f0f7e760 329 }
60613dc8 330 rprintf(FINFO,"Total bytes sent: %s\n",
adc2476f 331 human_num(total_written));
60613dc8 332 rprintf(FINFO,"Total bytes received: %s\n",
adc2476f 333 human_num(total_read));
7a6421fa 334 }
d9c7edf6 335
951e826b 336 if (INFO_GTE(STATS, 1)) {
b64ee91a 337 rprintf(FCLIENT, "\n");
b9f592fb 338 rprintf(FINFO,
b64ee91a 339 "sent %s bytes received %s bytes %s bytes/sec\n",
adc2476f 340 human_num(total_written), human_num(total_read),
60613dc8 341 human_dnum((total_written + total_read)/(0.5 + (endtime - starttime)), 2));
adc2476f
WD
342 rprintf(FINFO, "total size is %s speedup is %s%s\n",
343 human_num(stats.total_size),
344 comma_dnum((double)stats.total_size / (total_written+total_read), 2),
641dc0c5 345 write_batch < 0 ? " (BATCH ONLY)" : dry_run ? " (DRY RUN)" : "");
e19452a9 346 }
fc8a6b97
AT
347
348 fflush(stdout);
349 fflush(stderr);
c627d613
AT
350}
351
352
e5a2b854
MP
353/**
354 * If our C library can get malloc statistics, then show them to FINFO
355 **/
356static void show_malloc_stats(void)
357{
4f5b0756 358#ifdef HAVE_MALLINFO
e5a2b854
MP
359 struct mallinfo mi;
360
361 mi = mallinfo();
362
b64ee91a
WD
363 rprintf(FCLIENT, "\n");
364 rprintf(FINFO, RSYNC_NAME "[%d] (%s%s%s) heap statistics:\n",
f846a9bf
WD
365 getpid(), am_server ? "server " : "",
366 am_daemon ? "daemon " : "", who_am_i());
367 rprintf(FINFO, " arena: %10ld (bytes from sbrk)\n",
368 (long)mi.arena);
369 rprintf(FINFO, " ordblks: %10ld (chunks not in use)\n",
370 (long)mi.ordblks);
371 rprintf(FINFO, " smblks: %10ld\n",
372 (long)mi.smblks);
373 rprintf(FINFO, " hblks: %10ld (chunks from mmap)\n",
374 (long)mi.hblks);
375 rprintf(FINFO, " hblkhd: %10ld (bytes from mmap)\n",
376 (long)mi.hblkhd);
377 rprintf(FINFO, " allmem: %10ld (bytes from sbrk + mmap)\n",
378 (long)mi.arena + mi.hblkhd);
379 rprintf(FINFO, " usmblks: %10ld\n",
380 (long)mi.usmblks);
381 rprintf(FINFO, " fsmblks: %10ld\n",
382 (long)mi.fsmblks);
383 rprintf(FINFO, " uordblks: %10ld (bytes used)\n",
384 (long)mi.uordblks);
385 rprintf(FINFO, " fordblks: %10ld (bytes free)\n",
386 (long)mi.fordblks);
387 rprintf(FINFO, " keepcost: %10ld (bytes in releasable chunk)\n",
388 (long)mi.keepcost);
e5a2b854
MP
389#endif /* HAVE_MALLINFO */
390}
391
392
0882faa2 393/* Start the remote shell. cmd may be NULL to use the default. */
f7e5068d
WD
394static pid_t do_cmd(char *cmd, char *machine, char *user, char **remote_argv, int remote_argc,
395 int *f_in_p, int *f_out_p)
c627d613 396{
6c2e5b56 397 int i, argc = 0;
f8e1fa62 398 char *args[MAX_ARGS], *need_to_free = NULL;
53936ef9 399 pid_t pid;
bb4aa89c 400 int dash_l_set = 0;
366345fe 401
088aac85 402 if (!read_batch && !local_server) {
82f0c63e 403 char *t, *f, in_quote = '\0';
9af87151 404 char *rsh_env = getenv(RSYNC_RSH_ENV);
366345fe 405 if (!cmd)
9af87151 406 cmd = rsh_env;
366345fe
AT
407 if (!cmd)
408 cmd = RSYNC_RSH;
f8e1fa62 409 cmd = need_to_free = strdup(cmd);
d9c7edf6 410 if (!cmd)
366345fe
AT
411 goto oom;
412
82f0c63e
WD
413 for (t = f = cmd; *f; f++) {
414 if (*f == ' ')
415 continue;
e7a392c7 416 /* Comparison leaves rooms for server_options(). */
f7e5068d
WD
417 if (argc >= MAX_ARGS - MAX_SERVER_ARGS)
418 goto arg_overflow;
82f0c63e
WD
419 args[argc++] = t;
420 while (*f != ' ' || in_quote) {
421 if (!*f) {
422 if (in_quote) {
423 rprintf(FERROR,
424 "Missing trailing-%c in remote-shell command.\n",
425 in_quote);
426 exit_cleanup(RERR_SYNTAX);
427 }
428 f--;
429 break;
430 }
431 if (*f == '\'' || *f == '"') {
432 if (!in_quote) {
433 in_quote = *f++;
434 continue;
435 }
436 if (*f == in_quote && *++f != in_quote) {
437 in_quote = '\0';
438 continue;
439 }
440 }
441 *t++ = *f++;
442 }
443 *t++ = '\0';
887e553f 444 }
c627d613 445
d9c7edf6 446 /* check to see if we've already been given '-l user' in
9af87151 447 * the remote-shell command */
bb4aa89c
WD
448 for (i = 0; i < argc-1; i++) {
449 if (!strcmp(args[i], "-l") && args[i+1][0] != '-')
450 dash_l_set = 1;
451 }
452
4f5b0756 453#ifdef HAVE_REMSH
366345fe
AT
454 /* remsh (on HPUX) takes the arguments the other way around */
455 args[argc++] = machine;
bb4aa89c 456 if (user && !(daemon_over_rsh && dash_l_set)) {
366345fe
AT
457 args[argc++] = "-l";
458 args[argc++] = user;
459 }
7b8356d0 460#else
bb4aa89c 461 if (user && !(daemon_over_rsh && dash_l_set)) {
366345fe
AT
462 args[argc++] = "-l";
463 args[argc++] = user;
464 }
465 args[argc++] = machine;
7b8356d0 466#endif
c627d613 467
366345fe 468 args[argc++] = rsync_path;
c627d613 469
9af87151 470 if (blocking_io < 0) {
90e22f4b
WD
471 char *cp;
472 if ((cp = strrchr(cmd, '/')) != NULL)
473 cp++;
474 else
475 cp = cmd;
476 if (strcmp(cp, "rsh") == 0 || strcmp(cp, "remsh") == 0)
477 blocking_io = 1;
66b71163 478 }
e384bfbd 479
93689aa5 480 server_options(args,&argc);
e7a392c7 481
f7e5068d
WD
482 if (argc >= MAX_ARGS - 2)
483 goto arg_overflow;
366345fe 484 }
c627d613 485
366345fe 486 args[argc++] = ".";
76076c4b 487
f7e5068d
WD
488 if (!daemon_over_rsh) {
489 while (remote_argc > 0) {
490 if (argc >= MAX_ARGS - 1) {
491 arg_overflow:
492 rprintf(FERROR, "internal: args[] overflowed in do_cmd()\n");
493 exit_cleanup(RERR_SYNTAX);
494 }
495 args[argc++] = *remote_argv++;
496 remote_argc--;
497 }
498 }
c627d613 499
366345fe 500 args[argc] = NULL;
c627d613 501
951e826b 502 if (DEBUG_GTE(CMD, 2)) {
e7a392c7 503 for (i = 0; i < argc; i++)
b64ee91a
WD
504 rprintf(FCLIENT, "cmd[%d]=%s ", i, args[i]);
505 rprintf(FCLIENT, "\n");
366345fe
AT
506 }
507
c0d8e84c
WD
508 if (read_batch) {
509 int from_gen_pipe[2];
ea4e8cf8 510 set_allow_inc_recurse();
c0d8e84c
WD
511 if (fd_pair(from_gen_pipe) < 0) {
512 rsyserr(FERROR, errno, "pipe");
513 exit_cleanup(RERR_IPC);
514 }
515 batch_gen_fd = from_gen_pipe[0];
f7e5068d
WD
516 *f_out_p = from_gen_pipe[1];
517 *f_in_p = batch_fd;
53936ef9 518 pid = (pid_t)-1; /* no child pid */
44c4492a 519#ifdef ICONV_CONST
b61665d5 520 setup_iconv();
44c4492a 521#endif
c0d8e84c 522 } else if (local_server) {
b1df18d7
WD
523 /* If the user didn't request --[no-]whole-file, force
524 * it on, but only if we're not batch processing. */
c0d8e84c 525 if (whole_file < 0 && !write_batch)
b1df18d7 526 whole_file = 1;
ea4e8cf8 527 set_allow_inc_recurse();
53936ef9 528 pid = local_child(argc, args, f_in_p, f_out_p, child_main);
44c4492a 529#ifdef ICONV_CONST
b61665d5 530 setup_iconv();
44c4492a 531#endif
f7e5068d 532 } else {
53936ef9 533 pid = piped_child(args, f_in_p, f_out_p);
44c4492a 534#ifdef ICONV_CONST
b61665d5 535 setup_iconv();
44c4492a 536#endif
d8e8ef32 537 if (protect_args && !daemon_over_rsh)
53936ef9 538 send_protected_args(*f_out_p, args);
f7e5068d 539 }
c627d613 540
f8e1fa62
WD
541 if (need_to_free)
542 free(need_to_free);
543
53936ef9 544 return pid;
c627d613 545
acee11fc 546 oom:
366345fe
AT
547 out_of_memory("do_cmd");
548 return 0; /* not reached */
c627d613
AT
549}
550
eb598fac
WD
551/* The receiving side operates in one of two modes:
552 *
cc8c5057
WD
553 * 1. it receives any number of files into a destination directory,
554 * placing them according to their names in the file-list.
eb598fac
WD
555 *
556 * 2. it receives a single file and saves it using the name in the
557 * destination path instead of its file-list name. This requires a
558 * "local name" for writing out the destination file.
559 *
a7d461fc
WD
560 * So, our task is to figure out what mode/local-name we need.
561 * For mode 1, we change into the destination directory and return NULL.
562 * For mode 2, we change into the directory containing the destination
563 * file (if we aren't already there) and return the local-name. */
eb598fac 564static char *get_local_name(struct file_list *flist, char *dest_path)
c627d613 565{
7a6421fa 566 STRUCT_STAT st;
a7d461fc 567 int statret;
eb598fac 568 char *cp;
c627d613 569
951e826b 570 if (DEBUG_GTE(RECV, 1)) {
eb598fac 571 rprintf(FINFO, "get_local_name count=%d %s\n",
f3d6d480 572 file_total, NS(dest_path));
eb598fac 573 }
1f0610ef 574
ee8e2b15 575 if (!dest_path || list_only)
1f0610ef 576 return NULL;
c95da96a 577
311676ed
WD
578 if (daemon_filter_list.head) {
579 char *slash = strrchr(dest_path, '/');
164cb66a 580 if (slash && (slash[1] == '\0' || (slash[1] == '.' && slash[2] == '\0')))
311676ed
WD
581 *slash = '\0';
582 else
583 slash = NULL;
164cb66a
WD
584 if ((*dest_path != '.' || dest_path[1] != '\0')
585 && (check_filter(&daemon_filter_list, FLOG, dest_path, 0) < 0
586 || check_filter(&daemon_filter_list, FLOG, dest_path, 1) < 0)) {
311676ed
WD
587 rprintf(FERROR, "skipping daemon-excluded destination \"%s\"\n",
588 dest_path);
589 exit_cleanup(RERR_FILESELECT);
590 }
591 if (slash)
592 *slash = '/';
99c3e591
WD
593 }
594
a7d461fc 595 /* See what currently exists at the destination. */
1a7f3d99 596 if ((statret = do_stat(dest_path, &st)) == 0) {
a7d461fc 597 /* If the destination is a dir, enter it and use mode 1. */
1ff5450d 598 if (S_ISDIR(st.st_mode)) {
29a89172
WD
599 if (!change_dir(dest_path, CD_NORMAL)) {
600 rsyserr(FERROR, errno, "change_dir#1 %s failed",
eb598fac 601 full_fname(dest_path));
65417579 602 exit_cleanup(RERR_FILESELECT);
1ff5450d
AT
603 }
604 return NULL;
605 }
f3d6d480 606 if (file_total > 1) {
eb598fac
WD
607 rprintf(FERROR,
608 "ERROR: destination must be a directory when"
609 " copying more than 1 file\n");
65417579 610 exit_cleanup(RERR_FILESELECT);
1ff5450d 611 }
f3d6d480 612 if (file_total == 1 && S_ISDIR(flist->files[0]->mode)) {
44c26bf2
WD
613 rprintf(FERROR,
614 "ERROR: cannot overwrite non-directory"
615 " with a directory\n");
616 exit_cleanup(RERR_FILESELECT);
617 }
cc8c5057 618 } else if (errno != ENOENT) {
a7d461fc
WD
619 /* If we don't know what's at the destination, fail. */
620 rsyserr(FERROR, errno, "ERROR: cannot stat destination %s",
cc8c5057
WD
621 full_fname(dest_path));
622 exit_cleanup(RERR_FILESELECT);
1ff5450d
AT
623 }
624
eb598fac
WD
625 cp = strrchr(dest_path, '/');
626
a7d461fc
WD
627 /* If we need a destination directory because the transfer is not
628 * of a single non-directory or the user has requested one via a
629 * destination path ending in a slash, create one and use mode 1. */
f3d6d480 630 if (file_total > 1 || (cp && !cp[1])) {
eb598fac
WD
631 /* Lop off the final slash (if any). */
632 if (cp && !cp[1])
633 *cp = '\0';
634
a7d461fc
WD
635 if (statret == 0) {
636 rprintf(FERROR,
637 "ERROR: destination path is not a directory\n");
638 exit_cleanup(RERR_SYNTAX);
639 }
640
05278935 641 if (mkdir_defmode(dest_path) != 0) {
eb598fac
WD
642 rsyserr(FERROR, errno, "mkdir %s failed",
643 full_fname(dest_path));
644 exit_cleanup(RERR_FILEIO);
645 }
1ff5450d 646
7341ee2d
WD
647 if (flist->high >= flist->low
648 && strcmp(flist->files[flist->low]->basename, ".") == 0)
288b12ee 649 flist->files[0]->flags |= FLAG_DIR_CREATED;
2a94207a 650
951e826b 651 if (INFO_GTE(NAME, 1))
eb598fac
WD
652 rprintf(FINFO, "created directory %s\n", dest_path);
653
654 if (dry_run) {
615a5415 655 /* Indicate that dest dir doesn't really exist. */
eb598fac 656 dry_run++;
eb598fac
WD
657 }
658
29a89172
WD
659 if (!change_dir(dest_path, dry_run > 1 ? CD_SKIP_CHDIR : CD_NORMAL)) {
660 rsyserr(FERROR, errno, "change_dir#2 %s failed",
eb598fac
WD
661 full_fname(dest_path));
662 exit_cleanup(RERR_FILESELECT);
663 }
e5a96f0f 664
e5a96f0f 665 return NULL;
1ff5450d
AT
666 }
667
eb598fac
WD
668 /* Otherwise, we are writing a single file, possibly on top of an
669 * existing non-directory. Change to the item's parent directory
670 * (if it has a path component), return the basename of the
671 * destination file as the local name, and use mode 2. */
672 if (!cp)
673 return dest_path;
674
675 if (cp == dest_path)
676 dest_path = "/";
677
678 *cp = '\0';
29a89172
WD
679 if (!change_dir(dest_path, CD_NORMAL)) {
680 rsyserr(FERROR, errno, "change_dir#3 %s failed",
eb598fac 681 full_fname(dest_path));
65417579 682 exit_cleanup(RERR_FILESELECT);
1ff5450d 683 }
eb598fac 684 *cp = '/';
1ff5450d 685
eb598fac 686 return cp + 1;
c627d613
AT
687}
688
ce27f36d
WD
689/* This function checks on our alternate-basis directories. If we're in
690 * dry-run mode and the destination dir does not yet exist, we'll try to
691 * tweak any dest-relative paths to make them work for a dry-run (the
692 * destination dir must be in curr_dir[] when this function is called).
42a28d9d 693 * We also warn about any arg that is non-existent or not a directory. */
ce27f36d 694static void check_alt_basis_dirs(void)
615a5415 695{
ce27f36d
WD
696 STRUCT_STAT st;
697 char **dir_p, *slash = strrchr(curr_dir, '/');
698
699 for (dir_p = basis_dir; *dir_p; dir_p++) {
700 if (dry_run > 1 && **dir_p != '/') {
701 int len = curr_dir_len + 1 + strlen(*dir_p) + 1;
702 char *new = new_array(char, len);
703 if (!new)
704 out_of_memory("check_alt_basis_dirs");
705 if (slash && strncmp(*dir_p, "../", 3) == 0) {
706 /* We want to remove only one leading "../" prefix for
707 * the directory we couldn't create in dry-run mode:
708 * this ensures that any other ".." references get
709 * evaluated the same as they would for a live copy. */
710 *slash = '\0';
711 pathjoin(new, len, curr_dir, *dir_p + 3);
712 *slash = '/';
713 } else
714 pathjoin(new, len, curr_dir, *dir_p);
715 *dir_p = new;
716 }
717 if (do_stat(*dir_p, &st) < 0) {
718 rprintf(FWARNING, "%s arg does not exist: %s\n",
719 dest_option, *dir_p);
720 } else if (!S_ISDIR(st.st_mode)) {
721 rprintf(FWARNING, "%s arg is not a dir: %s\n",
722 dest_option, *dir_p);
723 }
615a5415
WD
724 }
725}
c627d613 726
1a8e5c97 727/* This is only called by the sender. */
bc40a305 728static void read_final_goodbye(int f_in, int f_out)
4e0fcd85 729{
f3d6d480
WD
730 int i, iflags, xlen;
731 uchar fnamecmp_type;
732 char xname[MAXPATHLEN];
1a8e5c97 733
0c2e8f93
WD
734 shutting_down = True;
735
1a8e5c97
WD
736 if (protocol_version < 29)
737 i = read_int(f_in);
738 else {
20caffd2 739 i = read_ndx_and_attrs(f_in, f_out, &iflags, &fnamecmp_type, xname, &xlen);
bc40a305
WD
740 if (protocol_version >= 31 && i == NDX_DONE) {
741 if (am_sender)
742 write_ndx(f_out, NDX_DONE);
743 else {
744 if (batch_gen_fd >= 0) {
745 while (read_int(batch_gen_fd) != NDX_DEL_STATS) {}
746 read_del_stats(batch_gen_fd);
747 }
20caffd2 748 write_int(f_out, NDX_DONE);
bc40a305 749 }
20caffd2 750 i = read_ndx_and_attrs(f_in, f_out, &iflags, &fnamecmp_type, xname, &xlen);
bc40a305 751 }
4e0fcd85
WD
752 }
753
82ad07c4 754 if (i != NDX_DONE) {
c7791b8c
WD
755 rprintf(FERROR, "Invalid packet at end of run (%d) [%s]\n",
756 i, who_am_i());
1a8e5c97 757 exit_cleanup(RERR_PROTOCOL);
4e0fcd85
WD
758 }
759}
760
eb598fac 761static void do_server_sender(int f_in, int f_out, int argc, char *argv[])
c627d613 762{
7a6421fa
AT
763 struct file_list *flist;
764 char *dir = argv[0];
c627d613 765
951e826b 766 if (DEBUG_GTE(SEND, 1)) {
45e08edb
WD
767 rprintf(FINFO, "server_sender starting pid=%ld\n",
768 (long)getpid());
769 }
d9c7edf6 770
2adbcdc7 771 if (am_daemon && lp_write_only(module_id)) {
7a92ded3
WD
772 rprintf(FERROR, "ERROR: module is write only\n");
773 exit_cleanup(RERR_SYNTAX);
774 return;
775 }
d7205694 776 if (am_daemon && read_only && remove_source_files) {
bf26aa22 777 rprintf(FERROR,
044ccbaa 778 "ERROR: --remove-%s-files cannot be used with a read-only module\n",
47c11975 779 remove_source_files == 1 ? "source" : "sent");
bf26aa22
WD
780 exit_cleanup(RERR_SYNTAX);
781 return;
782 }
7a92ded3 783
582c1589 784 if (!relative_paths) {
29a89172
WD
785 if (!change_dir(dir, CD_NORMAL)) {
786 rsyserr(FERROR, errno, "change_dir#3 %s failed",
582c1589
WD
787 full_fname(dir));
788 exit_cleanup(RERR_FILESELECT);
789 }
7a6421fa
AT
790 }
791 argc--;
792 argv++;
d9c7edf6 793
e844a4a8 794 if (argc == 0 && (recurse || xfer_dirs || list_only)) {
e1f67417 795 argc = 1;
7a6421fa
AT
796 argv--;
797 argv[0] = ".";
798 }
d9c7edf6 799
7a6421fa 800 flist = send_file_list(f_out,argc,argv);
9decb4d2 801 if (!flist || flist->used == 0)
8d9dc9f9 802 exit_cleanup(0);
8d9dc9f9 803
f3d6d480 804 io_start_buffering_in(f_in);
da3478b2 805
f3d6d480 806 send_files(f_in, f_out);
f1e3656e 807 io_flush(FULL_FLUSH);
33c4b445 808 handle_stats(f_out);
4e0fcd85 809 if (protocol_version >= 24)
bc40a305 810 read_final_goodbye(f_in, f_out);
f1e3656e 811 io_flush(FULL_FLUSH);
7a6421fa 812 exit_cleanup(0);
c627d613
AT
813}
814
815
f3d6d480 816static int do_recv(int f_in, int f_out, char *local_name)
dc5ddbcc 817{
d186eb1a 818 int pid;
84e6d6fd 819 int exit_code = 0;
c70e07d9 820 int error_pipe[2];
dc5ddbcc 821
bb6721dc
WD
822 /* The receiving side mustn't obey this, or an existing symlink that
823 * points to an identical file won't be replaced by the referent. */
01103e18 824 copy_links = copy_dirlinks = copy_unsafe_links = 0;
bb6721dc 825
1e1ca253 826#ifdef SUPPORT_HARD_LINKS
d4d6646a 827 if (preserve_hard_links && !inc_recurse)
da131912 828 match_hard_links(first_flist);
1e1ca253 829#endif
dc5ddbcc 830
c70e07d9 831 if (fd_pair(error_pipe) < 0) {
ab759cd2 832 rsyserr(FERROR, errno, "pipe failed in do_recv");
c8f2f857 833 exit_cleanup(RERR_IPC);
554e0a8d 834 }
d9c7edf6 835
3696674b
WD
836 if (backup_dir) {
837 int ret = make_path(backup_dir_buf, MKP_DROP_NAME); /* drops trailing slash */
838 if (ret < 0)
839 exit_cleanup(RERR_SYNTAX);
840 if (ret)
841 rprintf(FINFO, "Created backup_dir %s\n", backup_dir_buf);
4e9c7fae
WD
842 else if (INFO_GTE(BACKUP, 1))
843 rprintf(FINFO, "backup_dir is %s\n", backup_dir_buf);
3696674b
WD
844 }
845
20caffd2 846 io_flush(FULL_FLUSH);
c6e7fcb4 847
ba449e44 848 if ((pid = do_fork()) == -1) {
c8f2f857 849 rsyserr(FERROR, errno, "fork failed in do_recv");
ba449e44
WD
850 exit_cleanup(RERR_IPC);
851 }
852
853 if (pid == 0) {
20caffd2
WD
854 send_msgs_to_gen = am_server;
855
554e0a8d 856 close(error_pipe[0]);
20caffd2
WD
857
858 /* We can't let two processes write to the socket at one time. */
705132bc 859 io_end_multiplex_out(MPLX_SWITCHING);
3a69fad0
WD
860 if (f_in != f_out)
861 close(f_out);
41000dff 862 sock_f_out = -1;
20caffd2 863 f_out = error_pipe[1];
e08c9610 864
20caffd2 865 bwlimit_writemax = 0; /* receiver doesn't need to do this */
554e0a8d 866
20caffd2
WD
867 if (read_batch)
868 io_start_buffering_in(f_in);
869 io_start_multiplex_out(f_out);
554e0a8d 870
20caffd2 871 recv_files(f_in, f_out, local_name);
f1e3656e 872 io_flush(FULL_FLUSH);
33c4b445 873 handle_stats(f_in);
e08c9610 874
951e826b
WD
875 if (output_needs_newline) {
876 fputc('\n', stdout);
877 output_needs_newline = 0;
878 }
879
20caffd2
WD
880 write_int(f_out, NDX_DONE);
881 send_msg(MSG_STATS, (char*)&stats.total_read, sizeof stats.total_read, 0);
f1e3656e 882 io_flush(FULL_FLUSH);
4e0fcd85 883
40df65fd
WD
884 /* Handle any keep-alive packets from the post-processing work
885 * that the generator does. */
4e0fcd85 886 if (protocol_version >= 29) {
051182cb 887 kluge_around_eof = -1;
1a8e5c97
WD
888
889 /* This should only get stopped via a USR2 signal. */
bc40a305 890 read_final_goodbye(f_in, f_out);
1a8e5c97 891
3485ae83
WD
892 rprintf(FERROR, "Invalid packet at end of run [%s]\n",
893 who_am_i());
1a8e5c97 894 exit_cleanup(RERR_PROTOCOL);
4e0fcd85
WD
895 }
896
9e0582f9
WD
897 /* Finally, we go to sleep until our parent kills us with a
898 * USR2 signal. We sleep for a short time, as on some OSes
899 * a signal won't interrupt a sleep! */
f1e3656e
WD
900 while (1)
901 msleep(20);
d186eb1a 902 }
dc5ddbcc 903
b695f242 904 am_generator = 1;
2885270b 905 flist_receiving_enabled = True;
f3d6d480 906
705132bc 907 io_end_multiplex_in(MPLX_SWITCHING);
e8a96e27 908 if (write_batch && !am_server)
b9f592fb 909 stop_write_batch();
b695f242 910
554e0a8d 911 close(error_pipe[1]);
3a69fad0
WD
912 if (f_in != f_out)
913 close(f_in);
41000dff 914 sock_f_in = -1;
20caffd2 915 f_in = error_pipe[0];
e1b3d5c4 916
f3d6d480 917 io_start_buffering_out(f_out);
20caffd2 918 io_start_multiplex_in(f_in);
554e0a8d 919
da131912
WD
920#ifdef SUPPORT_HARD_LINKS
921 if (preserve_hard_links && inc_recurse) {
922 struct file_list *flist;
923 for (flist = first_flist; flist; flist = flist->next)
924 match_hard_links(flist);
925 }
926#endif
927
f3d6d480 928 generate_files(f_out, local_name);
8d9dc9f9 929
33c4b445 930 handle_stats(-1);
f1e3656e 931 io_flush(FULL_FLUSH);
0c2e8f93 932 shutting_down = True;
d04e9c51 933 if (protocol_version >= 24) {
8ada7518 934 /* send a final goodbye message */
9ae7a2cd 935 write_ndx(f_out, NDX_DONE);
8ada7518 936 }
f1e3656e 937 io_flush(FULL_FLUSH);
8ada7518 938
089a2435 939 kill(pid, SIGUSR2);
84e6d6fd
WD
940 wait_process_with_flush(pid, &exit_code);
941 return exit_code;
dc5ddbcc
AT
942}
943
f3d6d480 944static void do_server_recv(int f_in, int f_out, int argc, char *argv[])
c627d613 945{
84e6d6fd 946 int exit_code;
7a6421fa 947 struct file_list *flist;
6c2e5b56 948 char *local_name = NULL;
951e826b 949 int negated_levels;
07bff66f 950
20caffd2 951 if (filesfrom_fd >= 0 && !msgs2stderr && protocol_version < 31) {
07bff66f 952 /* We can't mix messages with files-from data on the socket,
951e826b
WD
953 * so temporarily turn off info/debug messages. */
954 negate_output_levels();
955 negated_levels = 1;
956 } else
957 negated_levels = 0;
f0fca04e 958
951e826b 959 if (DEBUG_GTE(RECV, 1)) {
45e08edb
WD
960 rprintf(FINFO, "server_recv(%d) starting pid=%ld\n",
961 argc, (long)getpid());
962 }
09b7f5db 963
d7205694 964 if (am_daemon && read_only) {
09b7f5db
AT
965 rprintf(FERROR,"ERROR: module is read only\n");
966 exit_cleanup(RERR_SYNTAX);
967 return;
968 }
969
7a6421fa 970 if (argc > 0) {
a1018691 971 char *dir = argv[0];
7a6421fa
AT
972 argc--;
973 argv++;
29a89172
WD
974 if (!am_daemon && !change_dir(dir, CD_NORMAL)) {
975 rsyserr(FERROR, errno, "change_dir#4 %s failed",
982e05bb 976 full_fname(dir));
65417579 977 exit_cleanup(RERR_FILESELECT);
d9c7edf6 978 }
7a6421fa 979 }
c627d613 980
f3d6d480 981 if (protocol_version >= 30)
d8587b46 982 io_start_multiplex_in(f_in);
f3d6d480
WD
983 else
984 io_start_buffering_in(f_in);
57dee64e 985 recv_filter_list(f_in);
c627d613 986
7c2a9e76 987 if (filesfrom_fd >= 0) {
07bff66f
WD
988 /* We need to send the files-from names to the sender at the
989 * same time that we receive the file-list from them, so we
990 * need the IO routines to automatically write out the names
991 * onto our f_out socket as we read the file-list. This
992 * avoids both deadlock and extra delays/buffers. */
20caffd2 993 start_filesfrom_forwarding(filesfrom_fd);
7c2a9e76
WD
994 filesfrom_fd = -1;
995 }
996
b9f592fb 997 flist = recv_file_list(f_in);
4c36a13e
AT
998 if (!flist) {
999 rprintf(FERROR,"server_recv: recv_file_list error\n");
65417579 1000 exit_cleanup(RERR_FILESELECT);
7a6421fa 1001 }
3ea6e0e7 1002 if (inc_recurse && file_total == 1)
f3d6d480 1003 recv_additional_file_list(f_in);
951e826b
WD
1004
1005 if (negated_levels)
1006 negate_output_levels();
d9c7edf6 1007
29fad7a3 1008 if (argc > 0)
7a6421fa 1009 local_name = get_local_name(flist,argv[0]);
c627d613 1010
7c58c991
WD
1011 /* Now that we know what our destination directory turned out to be,
1012 * we can sanitize the --link-/copy-/compare-dest args correctly. */
1013 if (sanitize_paths) {
ce27f36d
WD
1014 char **dir_p;
1015 for (dir_p = basis_dir; *dir_p; dir_p++)
d48810ba 1016 *dir_p = sanitize_path(NULL, *dir_p, NULL, curr_dir_depth, SP_DEFAULT);
ce27f36d 1017 if (partial_dir)
d48810ba 1018 partial_dir = sanitize_path(NULL, partial_dir, NULL, curr_dir_depth, SP_DEFAULT);
c2c8db91 1019 }
ce27f36d 1020 check_alt_basis_dirs();
615a5415 1021
819bfe45 1022 if (daemon_filter_list.head) {
a1018691 1023 char **dir_p;
7b6c5c77 1024 filter_rule_list *elp = &daemon_filter_list;
c2c8db91 1025
a1018691
WD
1026 for (dir_p = basis_dir; *dir_p; dir_p++) {
1027 char *dir = *dir_p;
1028 if (*dir == '/')
1029 dir += module_dirlen;
1df02d13 1030 if (check_filter(elp, FLOG, dir, 1) < 0)
c2c8db91
WD
1031 goto options_rejected;
1032 }
1033 if (partial_dir && *partial_dir == '/'
1df02d13 1034 && check_filter(elp, FLOG, partial_dir + module_dirlen, 1) < 0) {
c2c8db91
WD
1035 options_rejected:
1036 rprintf(FERROR,
1037 "Your options have been rejected by the server.\n");
1038 exit_cleanup(RERR_SYNTAX);
1039 }
7c58c991
WD
1040 }
1041
f3d6d480 1042 exit_code = do_recv(f_in, f_out, local_name);
84e6d6fd 1043 exit_cleanup(exit_code);
c627d613
AT
1044}
1045
1046
734a94a2 1047int child_main(int argc, char *argv[])
25d34a5c
MP
1048{
1049 start_server(STDIN_FILENO, STDOUT_FILENO, argc, argv);
734a94a2 1050 return 0;
25d34a5c
MP
1051}
1052
1053
9486289c 1054void start_server(int f_in, int f_out, int argc, char *argv[])
366345fe 1055{
f0359dd0
AT
1056 set_nonblocking(f_in);
1057 set_nonblocking(f_out);
1058
da3478b2
WD
1059 io_set_sock_fds(f_in, f_out);
1060 setup_protocol(f_out, f_in);
1061
d04e9c51 1062 if (protocol_version >= 23)
d8587b46 1063 io_start_multiplex_out(f_out);
a0f1ed55
WD
1064 if (am_daemon && io_timeout && protocol_version >= 31)
1065 send_msg_int(MSG_IO_TIMEOUT, io_timeout);
7a6421fa 1066
7a6421fa 1067 if (am_sender) {
83926d3c 1068 keep_dirlinks = 0; /* Must be disabled on the sender. */
bf26aa22 1069 if (need_messages_from_generator)
d8587b46 1070 io_start_multiplex_in(f_in);
705132bc
WD
1071 else
1072 io_start_buffering_in(f_in);
7842418b 1073 recv_filter_list(f_in);
7a6421fa 1074 do_server_sender(f_in, f_out, argc, argv);
07613def 1075 } else
7a6421fa 1076 do_server_recv(f_in, f_out, argc, argv);
7a6421fa 1077 exit_cleanup(0);
366345fe
AT
1078}
1079
20caffd2
WD
1080/* This is called once the connection has been negotiated. It is used
1081 * for rsyncd, remote-shell, and local connections. */
19b27a48 1082int client_run(int f_in, int f_out, pid_t pid, int argc, char *argv[])
9486289c 1083{
088aac85 1084 struct file_list *flist = NULL;
84e6d6fd 1085 int exit_code = 0, exit_code2 = 0;
9486289c 1086 char *local_name = NULL;
19b27a48
AT
1087
1088 cleanup_child_pid = pid;
67a28eb2 1089 if (!read_batch) {
b9f592fb
WD
1090 set_nonblocking(f_in);
1091 set_nonblocking(f_out);
1092 }
f0359dd0 1093
da3478b2 1094 io_set_sock_fds(f_in, f_out);
6d7b6081
AT
1095 setup_protocol(f_out,f_in);
1096
18882701
WD
1097 /* We set our stderr file handle to blocking because ssh might have
1098 * set it to non-blocking. This can be particularly troublesome if
1099 * stderr is a clone of stdout, because ssh would have set our stdout
1100 * to non-blocking at the same time (which can easily cause us to lose
1101 * output from our print statements). This kluge shouldn't cause ssh
1102 * any problems for how we use it. Note also that we delayed setting
1103 * this until after the above protocol setup so that we know for sure
1104 * that ssh is done twiddling its file descriptors. */
1105 set_blocking(STDERR_FILENO);
1106
9486289c 1107 if (am_sender) {
83926d3c 1108 keep_dirlinks = 0; /* Must be disabled on the sender. */
886df221
WD
1109
1110 if (always_checksum
1111 && (log_format_has(stdout_format, 'C')
1112 || log_format_has(logfile_format, 'C')))
1113 sender_keeps_checksum = 1;
1114
f3d6d480 1115 if (protocol_version >= 30)
d8587b46 1116 io_start_multiplex_out(f_out);
f3d6d480
WD
1117 else
1118 io_start_buffering_out(f_out);
20caffd2
WD
1119 if (protocol_version >= 31 || (!filesfrom_host && protocol_version >= 23))
1120 io_start_multiplex_in(f_in);
705132bc
WD
1121 else
1122 io_start_buffering_in(f_in);
57dee64e 1123 send_filter_list(f_out);
860236bf 1124 if (filesfrom_host)
7c2a9e76 1125 filesfrom_fd = f_in;
b9f592fb 1126
e8a96e27 1127 if (write_batch && !am_server)
b9f592fb 1128 start_write_batch(f_out);
a00628b3 1129 flist = send_file_list(f_out, argc, argv);
951e826b 1130 if (DEBUG_GTE(FLIST, 3))
9486289c 1131 rprintf(FINFO,"file list sent\n");
f3d6d480 1132
20caffd2 1133 if (protocol_version < 31 && filesfrom_host && protocol_version >= 23)
d8587b46 1134 io_start_multiplex_in(f_in);
e1b3d5c4 1135
f1e3656e 1136 io_flush(NORMAL_FLUSH);
f3d6d480 1137 send_files(f_in, f_out);
f1e3656e 1138 io_flush(FULL_FLUSH);
33c4b445 1139 handle_stats(-1);
4e0fcd85 1140 if (protocol_version >= 24)
bc40a305 1141 read_final_goodbye(f_in, f_out);
9486289c 1142 if (pid != -1) {
951e826b 1143 if (DEBUG_GTE(EXIT, 2))
08a740ff 1144 rprintf(FINFO,"client_run waiting on %d\n", (int) pid);
f1e3656e 1145 io_flush(FULL_FLUSH);
84e6d6fd 1146 wait_process_with_flush(pid, &exit_code);
9486289c 1147 }
33c4b445 1148 output_summary();
c87ae64a 1149 io_flush(FULL_FLUSH);
84e6d6fd 1150 exit_cleanup(exit_code);
9486289c 1151 }
f7632fc6 1152
f3d6d480
WD
1153 if (!read_batch) {
1154 if (protocol_version >= 23)
d8587b46 1155 io_start_multiplex_in(f_in);
f3d6d480 1156 if (need_messages_from_generator)
d8587b46 1157 io_start_multiplex_out(f_out);
705132bc
WD
1158 else
1159 io_start_buffering_out(f_out);
f3d6d480 1160 }
bf26aa22 1161
57dee64e 1162 send_filter_list(read_batch ? -1 : f_out);
d9c7edf6 1163
7c2a9e76 1164 if (filesfrom_fd >= 0) {
20caffd2 1165 start_filesfrom_forwarding(filesfrom_fd);
7c2a9e76
WD
1166 filesfrom_fd = -1;
1167 }
1168
e8a96e27 1169 if (write_batch && !am_server)
b9f592fb 1170 start_write_batch(f_in);
9486289c 1171 flist = recv_file_list(f_in);
3ea6e0e7 1172 if (inc_recurse && file_total == 1)
f3d6d480 1173 recv_additional_file_list(f_in);
d9c7edf6 1174
9decb4d2 1175 if (flist && flist->used > 0) {
9d19f8a5 1176 local_name = get_local_name(flist, argv[0]);
d9c7edf6 1177
ce27f36d 1178 check_alt_basis_dirs();
615a5415 1179
f3d6d480 1180 exit_code2 = do_recv(f_in, f_out, local_name);
9d19f8a5
WD
1181 } else {
1182 handle_stats(-1);
1183 output_summary();
1184 }
d9c7edf6 1185
9486289c 1186 if (pid != -1) {
951e826b 1187 if (DEBUG_GTE(RECV, 1))
08a740ff 1188 rprintf(FINFO,"client_run2 waiting on %d\n", (int) pid);
f1e3656e 1189 io_flush(FULL_FLUSH);
84e6d6fd 1190 wait_process_with_flush(pid, &exit_code);
9486289c 1191 }
d9c7edf6 1192
84e6d6fd 1193 return MAX(exit_code, exit_code2);
9486289c
AT
1194}
1195
07613def 1196static int copy_argv(char *argv[])
7169bb4a
MP
1197{
1198 int i;
1199
1200 for (i = 0; argv[i]; i++) {
1201 if (!(argv[i] = strdup(argv[i]))) {
1202 rprintf (FERROR, "out of memory at %s(%d)\n",
1203 __FILE__, __LINE__);
1204 return RERR_MALLOC;
1205 }
1206 }
1207
1208 return 0;
1209}
1210
1211
20caffd2 1212/* Start a client for either type of remote connection. Work out
0ba48136
MP
1213 * whether the arguments request a remote shell or rsyncd connection,
1214 * and call the appropriate connection function, then run_client.
0b4af330
MP
1215 *
1216 * Calls either start_socket_client (for sockets) or do_cmd and
20caffd2 1217 * client_run (for ssh). */
fc8a6b97 1218static int start_client(int argc, char *argv[])
5d6bcd44 1219{
f7e5068d
WD
1220 char *p, *shell_machine = NULL, *shell_user = NULL;
1221 char **remote_argv;
1222 int remote_argc;
1223 int f_in, f_out;
19b27a48
AT
1224 int ret;
1225 pid_t pid;
7169bb4a
MP
1226
1227 /* Don't clobber argv[] so that ps(1) can still show the right
d9c7edf6 1228 * command line. */
f7e5068d
WD
1229 if ((ret = copy_argv(argv)) != 0)
1230 return ret;
5d6bcd44 1231
d16c245f 1232 if (!read_batch) { /* for read_batch, NO source is specified */
f7e5068d
WD
1233 char *path = check_for_hostspec(argv[0], &shell_machine, &rsync_port);
1234 if (path) { /* source is remote */
a960239f
WD
1235 char *dummy_host;
1236 int dummy_port = 0;
f7e5068d
WD
1237 *argv = path;
1238 remote_argv = argv;
1239 remote_argc = argc;
1240 argv += argc - 1;
1241 if (argc == 1 || **argv == ':')
1242 argc = 0; /* no dest arg */
a960239f 1243 else if (check_for_hostspec(*argv, &dummy_host, &dummy_port)) {
9425918d
WD
1244 rprintf(FERROR,
1245 "The source and destination cannot both be remote.\n");
1246 exit_cleanup(RERR_SYNTAX);
f7e5068d
WD
1247 } else {
1248 remote_argc--; /* don't count dest */
1249 argc = 1;
9425918d 1250 }
860236bf
WD
1251 if (filesfrom_host && *filesfrom_host
1252 && strcmp(filesfrom_host, shell_machine) != 0) {
7c2a9e76 1253 rprintf(FERROR,
50b31539 1254 "--files-from hostname is not the same as the transfer hostname\n");
7c2a9e76
WD
1255 exit_cleanup(RERR_SYNTAX);
1256 }
42ccb4c0 1257 am_sender = 0;
e208631a
WD
1258 if (rsync_port)
1259 daemon_over_rsh = shell_cmd ? 1 : -1;
42ccb4c0
WD
1260 } else { /* source is local, check dest arg */
1261 am_sender = 1;
1262
f7e5068d 1263 if (argc > 1) {
ee8e2b15 1264 p = argv[--argc];
f7e5068d
WD
1265 remote_argv = argv + argc;
1266 } else {
1267 static char *dotarg[1] = { "." };
1268 p = dotarg[0];
1269 remote_argv = dotarg;
d9c7edf6 1270 }
f7e5068d 1271 remote_argc = 1;
a125c82a 1272
f7e5068d
WD
1273 path = check_for_hostspec(p, &shell_machine, &rsync_port);
1274 if (path && filesfrom_host && *filesfrom_host
860236bf 1275 && strcmp(filesfrom_host, shell_machine) != 0) {
7c2a9e76 1276 rprintf(FERROR,
50b31539 1277 "--files-from hostname is not the same as the transfer hostname\n");
7c2a9e76
WD
1278 exit_cleanup(RERR_SYNTAX);
1279 }
f7e5068d 1280 if (!path) { /* no hostspec found, so src & dest are local */
d9c7edf6 1281 local_server = 1;
860236bf 1282 if (filesfrom_host) {
7c2a9e76 1283 rprintf(FERROR,
50b31539 1284 "--files-from cannot be remote when the transfer is local\n");
7c2a9e76
WD
1285 exit_cleanup(RERR_SYNTAX);
1286 }
860236bf 1287 shell_machine = NULL;
f7e5068d
WD
1288 } else { /* hostspec was found, so dest is remote */
1289 argv[argc] = path;
1290 if (rsync_port)
1291 daemon_over_rsh = shell_cmd ? 1 : -1;
1292 }
5d6bcd44 1293 }
d16c245f 1294 } else { /* read_batch */
d9c7edf6 1295 local_server = 1;
f7e5068d 1296 if (check_for_hostspec(argv[argc-1], &shell_machine, &rsync_port)) {
b9f592fb
WD
1297 rprintf(FERROR, "remote destination is not allowed with --read-batch\n");
1298 exit_cleanup(RERR_SYNTAX);
1299 }
0a23e336
WD
1300 remote_argv = argv += argc - 1;
1301 remote_argc = argc = 1;
6902ed17
MP
1302 }
1303
f7e5068d 1304 if (am_sender) {
a960239f
WD
1305 char *dummy_host;
1306 int dummy_port = rsync_port;
f7e5068d
WD
1307 int i;
1308 /* For local source, extra source args must not have hostspec. */
1309 for (i = 1; i < argc; i++) {
a960239f 1310 if (check_for_hostspec(argv[i], &dummy_host, &dummy_port)) {
f7e5068d
WD
1311 rprintf(FERROR, "Unexpected remote arg: %s\n", argv[i]);
1312 exit_cleanup(RERR_SYNTAX);
1313 }
1314 }
1315 } else {
a960239f
WD
1316 char *dummy_host;
1317 int dummy_port = rsync_port;
f7e5068d 1318 int i;
a960239f
WD
1319 /* For remote source, any extra source args must have either
1320 * the same hostname or an empty hostname. */
f7e5068d 1321 for (i = 1; i < remote_argc; i++) {
a960239f
WD
1322 char *arg = check_for_hostspec(remote_argv[i], &dummy_host, &dummy_port);
1323 if (!arg) {
f7e5068d
WD
1324 rprintf(FERROR, "Unexpected local arg: %s\n", remote_argv[i]);
1325 rprintf(FERROR, "If arg is a remote file/dir, prefix it with a colon (:).\n");
1326 exit_cleanup(RERR_SYNTAX);
1327 }
a960239f
WD
1328 if (*dummy_host && strcmp(dummy_host, shell_machine) != 0) {
1329 rprintf(FERROR, "All source args must come from the same machine.\n");
1330 exit_cleanup(RERR_SYNTAX);
1331 }
1332 if (rsync_port != dummy_port) {
1333 if (!rsync_port || !dummy_port)
1334 rprintf(FERROR, "All source args must use the same hostspec format.\n");
1335 else
1336 rprintf(FERROR, "All source args must use the same port number.\n");
1337 exit_cleanup(RERR_SYNTAX);
1338 }
1339 remote_argv[i] = arg;
f7e5068d 1340 }
e208631a
WD
1341 }
1342
1343 if (daemon_over_rsh < 0)
f7e5068d 1344 return start_socket_client(shell_machine, remote_argc, remote_argv, argc, argv);
e208631a 1345
a39da29a 1346 if (password_file && !daemon_over_rsh) {
327c559a
WD
1347 rprintf(FERROR, "The --password-file option may only be "
1348 "used when accessing an rsync daemon.\n");
a39da29a
WD
1349 exit_cleanup(RERR_SYNTAX);
1350 }
1351
ba22c9e2
WD
1352 if (connect_timeout) {
1353 rprintf(FERROR, "The --contimeout option may only be "
1354 "used when connecting to an rsync daemon.\n");
1355 exit_cleanup(RERR_SYNTAX);
1356 }
1357
5d6bcd44 1358 if (shell_machine) {
6fc048f4 1359 p = strrchr(shell_machine,'@');
5d6bcd44
AT
1360 if (p) {
1361 *p = 0;
1362 shell_user = shell_machine;
1363 shell_machine = p+1;
1364 }
1365 }
1366
951e826b 1367 if (DEBUG_GTE(CMD, 2)) {
9486289c 1368 rprintf(FINFO,"cmd=%s machine=%s user=%s path=%s\n",
f7e5068d 1369 NS(shell_cmd), NS(shell_machine), NS(shell_user),
7d0fe4da 1370 NS(remote_argv[0]));
5d6bcd44 1371 }
d9c7edf6 1372
f7e5068d
WD
1373 pid = do_cmd(shell_cmd, shell_machine, shell_user, remote_argv, remote_argc,
1374 &f_in, &f_out);
75aeac44
WD
1375
1376 /* if we're running an rsync server on the remote host over a
9af87151 1377 * remote shell command, we need to do the RSYNCD protocol first */
75aeac44
WD
1378 if (daemon_over_rsh) {
1379 int tmpret;
f7e5068d 1380 tmpret = start_inband_exchange(f_in, f_out, shell_user, remote_argc, remote_argv);
75aeac44
WD
1381 if (tmpret < 0)
1382 return tmpret;
1383 }
1384
fc8a6b97
AT
1385 ret = client_run(f_in, f_out, pid, argc, argv);
1386
1387 fflush(stdout);
1388 fflush(stderr);
1389
1390 return ret;
5d6bcd44
AT
1391}
1392
366345fe 1393
067669da
WD
1394static RETSIGTYPE sigusr1_handler(UNUSED(int val))
1395{
6bf32edb 1396 exit_cleanup(RERR_SIGNAL1);
82306bf6
AT
1397}
1398
067669da
WD
1399static RETSIGTYPE sigusr2_handler(UNUSED(int val))
1400{
33c4b445
WD
1401 if (!am_server)
1402 output_summary();
40df65fd 1403 close_all();
3f0211b6 1404 if (got_xfer_error)
33c4b445 1405 _exit(RERR_PARTIAL);
8b35435f
AT
1406 _exit(0);
1407}
1408
6d59ac19 1409RETSIGTYPE remember_children(UNUSED(int val))
067669da 1410{
029c1713 1411#ifdef WNOHANG
ee7118a8
DD
1412 int cnt, status;
1413 pid_t pid;
1414 /* An empty waitpid() loop was put here by Tridge and we could never
d9c7edf6 1415 * get him to explain why he put it in, so rather than taking it
ee7118a8
DD
1416 * out we're instead saving the child exit statuses for later use.
1417 * The waitpid() loop presumably eliminates all possibility of leaving
97d8e709 1418 * zombie children, maybe that's why he did it. */
ee7118a8 1419 while ((pid = waitpid(-1, &status, WNOHANG)) > 0) {
9af87151
WD
1420 /* save the child's exit status */
1421 for (cnt = 0; cnt < MAXCHILDPROCS; cnt++) {
1422 if (pid_stat_table[cnt].pid == 0) {
1423 pid_stat_table[cnt].pid = pid;
1424 pid_stat_table[cnt].status = status;
1425 break;
1426 }
1427 }
ee7118a8 1428 }
029c1713 1429#endif
8261af74 1430#ifndef HAVE_SIGACTION
6d59ac19 1431 signal(SIGCHLD, remember_children);
60ee01f5 1432#endif
19b27a48
AT
1433}
1434
c0531332
MP
1435
1436/**
1437 * This routine catches signals and tries to send them to gdb.
1438 *
1439 * Because it's called from inside a signal handler it ought not to
1440 * use too many library routines.
1441 *
1442 * @todo Perhaps use "screen -X" instead/as well, to help people
1443 * debugging without easy access to X. Perhaps use an environment
1444 * variable, or just call a script?
1445 *
1446 * @todo The /proc/ magic probably only works on Linux (and
1447 * Solaris?) Can we be more portable?
1448 **/
1449#ifdef MAINTAINER_MODE
4fdc39dd
MP
1450const char *get_panic_action(void)
1451{
1452 const char *cmd_fmt = getenv("RSYNC_PANIC_ACTION");
1453
1454 if (cmd_fmt)
1455 return cmd_fmt;
1456 else
1457 return "xterm -display :0 -T Panic -n Panic "
1458 "-e gdb /proc/%d/exe %d";
1459}
1460
1461
9fb3f7a9
MP
1462/**
1463 * Handle a fatal signal by launching a debugger, controlled by $RSYNC_PANIC_ACTION.
1464 *
1465 * This signal handler is only installed if we were configured with
1466 * --enable-maintainer-mode. Perhaps it should always be on and we
1467 * should just look at the environment variable, but I'm a bit leery
1468 * of a signal sending us into a busy loop.
1469 **/
067669da 1470static RETSIGTYPE rsync_panic_handler(UNUSED(int whatsig))
c0531332
MP
1471{
1472 char cmd_buf[300];
1473 int ret;
4fdc39dd 1474
83078af5
WD
1475 snprintf(cmd_buf, sizeof cmd_buf, get_panic_action(),
1476 getpid(), getpid());
c0531332
MP
1477
1478 /* Unless we failed to execute gdb, we allow the process to
1479 * continue. I'm not sure if that's right. */
1480 ret = system(cmd_buf);
1481 if (ret)
1482 _exit(ret);
1483}
1484#endif
1485
1486
5d6bcd44 1487int main(int argc,char *argv[])
d9c7edf6 1488{
ff81e809 1489 int ret;
66a9dc96
WD
1490 int orig_argc = argc;
1491 char **orig_argv = argv;
8261af74
WD
1492#ifdef HAVE_SIGACTION
1493# ifdef HAVE_SIGPROCMASK
60ee01f5 1494 sigset_t sigmask;
5d6bcd44 1495
60ee01f5 1496 sigemptyset(&sigmask);
8261af74 1497# endif
60ee01f5
WD
1498 sigact.sa_flags = SA_NOCLDSTOP;
1499#endif
1500 SIGACTMASK(SIGUSR1, sigusr1_handler);
1501 SIGACTMASK(SIGUSR2, sigusr2_handler);
6d59ac19 1502 SIGACTMASK(SIGCHLD, remember_children);
c0531332 1503#ifdef MAINTAINER_MODE
60ee01f5
WD
1504 SIGACTMASK(SIGSEGV, rsync_panic_handler);
1505 SIGACTMASK(SIGFPE, rsync_panic_handler);
1506 SIGACTMASK(SIGABRT, rsync_panic_handler);
1507 SIGACTMASK(SIGBUS, rsync_panic_handler);
1508#endif
5d6bcd44 1509
7a6421fa 1510 starttime = time(NULL);
19284e2e 1511 our_uid = MY_UID();
3b83a220 1512 our_gid = MY_GID();
19284e2e 1513 am_root = our_uid == 0;
c627d613 1514
a800434a
AT
1515 memset(&stats, 0, sizeof(stats));
1516
df5e03da
AT
1517 if (argc < 2) {
1518 usage(FERROR);
65417579 1519 exit_cleanup(RERR_SYNTAX);
df5e03da
AT
1520 }
1521
7a6421fa 1522 /* we set a 0 umask so that correct file permissions can be
9af87151 1523 * carried across */
05278935 1524 orig_umask = umask(0);
5d6bcd44 1525
eb598fac
WD
1526#if defined CONFIG_LOCALE && defined HAVE_SETLOCALE
1527 setlocale(LC_CTYPE, "");
1528#endif
1529
53936ef9 1530 if (!parse_arguments(&argc, (const char ***) &argv)) {
d9c7edf6
WD
1531 /* FIXME: We ought to call the same error-handling
1532 * code here, rather than relying on getopt. */
50135767 1533 option_error();
65417579 1534 exit_cleanup(RERR_SYNTAX);
b11ed3b1 1535 }
5d6bcd44 1536
60ee01f5
WD
1537 SIGACTMASK(SIGINT, sig_int);
1538 SIGACTMASK(SIGHUP, sig_int);
1539 SIGACTMASK(SIGTERM, sig_int);
1540#if defined HAVE_SIGACTION && HAVE_SIGPROCMASK
1541 sigprocmask(SIG_UNBLOCK, &sigmask, NULL);
1542#endif
6b83141d 1543
34758d5c
MP
1544 /* Ignore SIGPIPE; we consistently check error codes and will
1545 * see the EPIPE. */
60ee01f5 1546 SIGACTION(SIGPIPE, SIG_IGN);
55e54e46
WD
1547#ifdef SIGXFSZ
1548 SIGACTION(SIGXFSZ, SIG_IGN);
1549#endif
34758d5c 1550
29a89172 1551 /* Initialize change_dir() here because on some old systems getcwd
9af87151
WD
1552 * (implemented by forking "pwd" and reading its output) doesn't
1553 * work when there are other child processes. Also, on all systems
1554 * that implement getcwd that way "pwd" can't be found after chroot. */
29a89172 1555 change_dir(NULL, CD_NORMAL);
c226b7c2 1556
44e9e221
WD
1557 init_flist();
1558
e8a96e27 1559 if ((write_batch || read_batch) && !am_server) {
b9f592fb 1560 if (write_batch)
66a9dc96 1561 write_batch_shell_file(orig_argc, orig_argv, argc);
b9f592fb 1562
dbbab0c4
WD
1563 if (read_batch && strcmp(batch_name, "-") == 0)
1564 batch_fd = STDIN_FILENO;
1565 else {
1566 batch_fd = do_open(batch_name,
b9f592fb
WD
1567 write_batch ? O_WRONLY | O_CREAT | O_TRUNC
1568 : O_RDONLY, S_IRUSR | S_IWUSR);
dbbab0c4 1569 }
b9f592fb
WD
1570 if (batch_fd < 0) {
1571 rsyserr(FERROR, errno, "Batch file %s open error",
71903f60 1572 full_fname(batch_name));
b9f592fb
WD
1573 exit_cleanup(RERR_FILEIO);
1574 }
9459290a
WD
1575 if (read_batch)
1576 read_stream_flags(batch_fd);
e10664c5
WD
1577 else
1578 write_stream_flags(batch_fd);
6902ed17 1579 }
e8a96e27
WD
1580 if (write_batch < 0)
1581 dry_run = 1;
6902ed17 1582
44c4492a
WD
1583 if (am_server) {
1584#ifdef ICONV_CONST
b61665d5 1585 setup_iconv();
44c4492a
WD
1586#endif
1587 } else if (am_daemon)
7a6421fa 1588 return daemon_main();
f0fca04e 1589
f7e5068d
WD
1590 if (am_server && protect_args) {
1591 char buf[MAXPATHLEN];
71605b0f 1592 protect_args = 2;
f7e5068d 1593 read_args(STDIN_FILENO, NULL, buf, sizeof buf, 1, &argv, &argc, NULL);
53936ef9 1594 if (!parse_arguments(&argc, (const char ***) &argv)) {
f7e5068d
WD
1595 option_error();
1596 exit_cleanup(RERR_SYNTAX);
1597 }
1598 }
1599
08ac228f
AT
1600 if (argc < 1) {
1601 usage(FERROR);
65417579 1602 exit_cleanup(RERR_SYNTAX);
08ac228f
AT
1603 }
1604
7a6421fa 1605 if (am_server) {
f0359dd0
AT
1606 set_nonblocking(STDIN_FILENO);
1607 set_nonblocking(STDOUT_FILENO);
75aeac44
WD
1608 if (am_daemon)
1609 return start_daemon(STDIN_FILENO, STDOUT_FILENO);
7a6421fa
AT
1610 start_server(STDIN_FILENO, STDOUT_FILENO, argc, argv);
1611 }
c627d613 1612
ff81e809 1613 ret = start_client(argc, argv);
d9c7edf6 1614 if (ret == -1)
9098bbf3 1615 exit_cleanup(RERR_STARTCLIENT);
088aac85 1616 else
9098bbf3
MP
1617 exit_cleanup(ret);
1618
0f5a04e3 1619 return ret;
c627d613 1620}