We only need one capability marked with a "*".

[rsync.git] / main.c

/*
 * The startup routines, including main(), for rsync.
 *
 * Copyright (C) 1996-2001 Andrew Tridgell <tridge@samba.org>
 * Copyright (C) 1996 Paul Mackerras
 * Copyright (C) 2001, 2002 Martin Pool <mbp@samba.org>
 * Copyright (C) 2003-2020 Wayne Davison
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, visit the http://fsf.org website.
 */

#include "rsync.h"
#include "inums.h"
#include "io.h"
#if defined CONFIG_LOCALE && defined HAVE_LOCALE_H
#include <locale.h>
#endif
#include <popt.h>

extern int dry_run;
extern int list_only;
extern int io_timeout;
extern int am_root;
extern int am_server;
extern int am_sender;
extern int am_daemon;
extern int inc_recurse;
extern int blocking_io;
extern int always_checksum;
extern int remove_source_files;
extern int output_needs_newline;
extern int called_from_signal_handler;
extern int need_messages_from_generator;
extern int kluge_around_eof;
extern int got_xfer_error;
extern int msgs2stderr;
extern int module_id;
extern int read_only;
extern int copy_links;
extern int copy_dirlinks;
extern int copy_unsafe_links;
extern int keep_dirlinks;
extern int preserve_hard_links;
extern int protocol_version;
extern int file_total;
extern int recurse;
extern int xfer_dirs;
extern int protect_args;
extern int relative_paths;
extern int sanitize_paths;
extern int curr_dir_depth;
extern int curr_dir_len;
extern int module_id;
extern int rsync_port;
extern int whole_file;
extern int read_batch;
extern int write_batch;
extern int batch_fd;
extern int sock_f_in;
extern int sock_f_out;
extern int filesfrom_fd;
extern int connect_timeout;
extern int send_msgs_to_gen;
extern dev_t filesystem_dev;
extern pid_t cleanup_child_pid;
extern size_t bwlimit_writemax;
extern unsigned int module_dirlen;
extern BOOL flist_receiving_enabled;
extern BOOL want_progress_now;
extern BOOL shutting_down;
extern int backup_dir_len;
extern int basis_dir_cnt;
extern int default_af_hint;
extern struct stats stats;
extern char *stdout_format;
extern char *logfile_format;
extern char *filesfrom_host;
extern char *partial_dir;
extern char *rsync_path;
extern char *shell_cmd;
extern char *password_file;
extern char *backup_dir;
extern char *copy_as;
extern char curr_dir[MAXPATHLEN];
extern char backup_dir_buf[MAXPATHLEN];
extern char *basis_dir[MAX_BASIS_DIRS+1];
extern struct file_list *first_flist;
extern filter_rule_list daemon_filter_list;

uid_t our_uid;
gid_t our_gid;
int am_receiver = 0;  /* Only set to 1 after the receiver/generator fork. */
int am_generator = 0; /* Only set to 1 after the receiver/generator fork. */
int local_server = 0;
int daemon_over_rsh = 0;
mode_t orig_umask = 0;
int batch_gen_fd = -1;
int sender_keeps_checksum = 0;
int raw_argc, cooked_argc;
char **raw_argv, **cooked_argv;

/* There's probably never more than at most 2 outstanding child processes,
 * but set it higher, just in case. */
#define MAXCHILDPROCS 7

#ifdef HAVE_SIGACTION
# ifdef HAVE_SIGPROCMASK
#  define SIGACTMASK(n,h) SIGACTION(n,h), sigaddset(&sigmask,(n))
# else
#  define SIGACTMASK(n,h) SIGACTION(n,h)
# endif
static struct sigaction sigact;
#endif

struct pid_status {
        pid_t pid;
        int status;
} pid_stat_table[MAXCHILDPROCS];

static time_t starttime, endtime;
static int64 total_read, total_written;

static void show_malloc_stats(void);

/* Works like waitpid(), but if we already harvested the child pid in our
 * remember_children(), we succeed instead of returning an error. */
pid_t wait_process(pid_t pid, int *status_ptr, int flags)
{
        pid_t waited_pid;

        do {
                waited_pid = waitpid(pid, status_ptr, flags);
        } while (waited_pid == -1 && errno == EINTR);

        if (waited_pid == -1 && errno == ECHILD) {
                /* Status of requested child no longer available:  check to
                 * see if it was processed by remember_children(). */
                int cnt;
                for (cnt = 0; cnt < MAXCHILDPROCS; cnt++) {
                        if (pid == pid_stat_table[cnt].pid) {
                                *status_ptr = pid_stat_table[cnt].status;
                                pid_stat_table[cnt].pid = 0;
                                return pid;
                        }
                }
        }

        return waited_pid;
}

int shell_exec(const char *cmd)
{
        char *shell = getenv("RSYNC_SHELL");
        int status;
        pid_t pid;

        if (!shell)
                return system(cmd);

        if ((pid = fork()) < 0)
                return -1;

        if (pid == 0) {
                execlp(shell, shell, "-c", cmd, NULL);
                _exit(1);
        }

        int ret = wait_process(pid, &status, 0);
        return ret < 0 ? -1 : status;
}

/* Wait for a process to exit, calling io_flush while waiting. */
static void wait_process_with_flush(pid_t pid, int *exit_code_ptr)
{
        pid_t waited_pid;
        int status;

        while ((waited_pid = wait_process(pid, &status, WNOHANG)) == 0) {
                msleep(20);
                io_flush(FULL_FLUSH);
        }

        /* TODO: If the child exited on a signal, then log an
         * appropriate error message.  Perhaps we should also accept a
         * message describing the purpose of the child.  Also indicate
         * this to the caller so that they know something went wrong. */
        if (waited_pid < 0) {
                rsyserr(FERROR, errno, "waitpid");
                *exit_code_ptr = RERR_WAITCHILD;
        } else if (!WIFEXITED(status)) {
#ifdef WCOREDUMP
                if (WCOREDUMP(status))
                        *exit_code_ptr = RERR_CRASHED;
                else
#endif
                if (WIFSIGNALED(status))
                        *exit_code_ptr = RERR_TERMINATED;
                else
                        *exit_code_ptr = RERR_WAITCHILD;
        } else
                *exit_code_ptr = WEXITSTATUS(status);
}

void write_del_stats(int f)
{
        if (read_batch)
                write_int(f, NDX_DEL_STATS);
        else
                write_ndx(f, NDX_DEL_STATS);
        write_varint(f, stats.deleted_files - stats.deleted_dirs
                      - stats.deleted_symlinks - stats.deleted_devices
                      - stats.deleted_specials);
        write_varint(f, stats.deleted_dirs);
        write_varint(f, stats.deleted_symlinks);
        write_varint(f, stats.deleted_devices);
        write_varint(f, stats.deleted_specials);
}

void read_del_stats(int f)
{
        stats.deleted_files = read_varint(f);
        stats.deleted_files += stats.deleted_dirs = read_varint(f);
        stats.deleted_files += stats.deleted_symlinks = read_varint(f);
        stats.deleted_files += stats.deleted_devices = read_varint(f);
        stats.deleted_files += stats.deleted_specials = read_varint(f);
}

static void become_copy_as_user()
{
        char *gname;
        uid_t uid;
        gid_t gid;

        if (!copy_as)
                return;

        if (DEBUG_GTE(CMD, 2))
                rprintf(FINFO, "[%s] copy_as=%s\n", who_am_i(), copy_as);

        if ((gname = strchr(copy_as, ':')) != NULL)
                *gname++ = '\0';

        if (!user_to_uid(copy_as, &uid, True)) {
                rprintf(FERROR, "Invalid copy-as user: %s\n", copy_as);
                exit_cleanup(RERR_SYNTAX);
        }

        if (gname) {
                if (!group_to_gid(gname, &gid, True)) {
                        rprintf(FERROR, "Invalid copy-as group: %s\n", gname);
                        exit_cleanup(RERR_SYNTAX);
                }
        } else {
                struct passwd *pw;
                if ((pw = getpwuid(uid)) == NULL) {
                        rsyserr(FERROR, errno, "getpwuid failed");
                        exit_cleanup(RERR_SYNTAX);
                }
                gid = pw->pw_gid;
        }

        if (setgid(gid) < 0) {
                rsyserr(FERROR, errno, "setgid failed");
                exit_cleanup(RERR_SYNTAX);
        }
#ifdef HAVE_SETGROUPS
        if (setgroups(1, &gid)) {
                rsyserr(FERROR, errno, "setgroups failed");
                exit_cleanup(RERR_SYNTAX);
        }
#endif
#ifdef HAVE_INITGROUPS
        if (!gname && initgroups(copy_as, gid) < 0) {
                rsyserr(FERROR, errno, "initgroups failed");
                exit_cleanup(RERR_SYNTAX);
        }
#endif

        if (setuid(uid) < 0
#ifdef HAVE_SETEUID
         || seteuid(uid) < 0
#endif
        ) {
                rsyserr(FERROR, errno, "setuid failed");
                exit_cleanup(RERR_SYNTAX);
        }

        our_uid = MY_UID();
        our_gid = MY_GID();
        am_root = (our_uid == 0);

        if (gname)
                gname[-1] = ':';
}

/* This function gets called from all 3 processes.  We want the client side
 * to actually output the text, but the sender is the only process that has
 * all the stats we need.  So, if we're a client sender, we do the report.
 * If we're a server sender, we write the stats on the supplied fd.  If
 * we're the client receiver we read the stats from the supplied fd and do
 * the report.  All processes might also generate a set of debug stats, if
 * the verbose level is high enough (this is the only thing that the
 * generator process and the server receiver ever do here). */
static void handle_stats(int f)
{
        endtime = time(NULL);

        /* Cache two stats because the read/write code can change it. */
        total_read = stats.total_read;
        total_written = stats.total_written;

        if (INFO_GTE(STATS, 3)) {
                /* These come out from every process */
                show_malloc_stats();
                show_flist_stats();
        }

        if (am_generator)
                return;

        if (am_daemon) {
                if (f == -1 || !am_sender)
                        return;
        }

        if (am_server) {
                if (am_sender) {
                        write_varlong30(f, total_read, 3);
                        write_varlong30(f, total_written, 3);
                        write_varlong30(f, stats.total_size, 3);
                        if (protocol_version >= 29) {
                                write_varlong30(f, stats.flist_buildtime, 3);
                                write_varlong30(f, stats.flist_xfertime, 3);
                        }
                }
                return;
        }

        /* this is the client */

        if (f < 0 && !am_sender) /* e.g. when we got an empty file list. */
                ;
        else if (!am_sender) {
                /* Read the first two in opposite order because the meaning of
                 * read/write swaps when switching from sender to receiver. */
                total_written = read_varlong30(f, 3);
                total_read = read_varlong30(f, 3);
                stats.total_size = read_varlong30(f, 3);
                if (protocol_version >= 29) {
                        stats.flist_buildtime = read_varlong30(f, 3);
                        stats.flist_xfertime = read_varlong30(f, 3);
                }
        } else if (write_batch) {
                /* The --read-batch process is going to be a client
                 * receiver, so we need to give it the stats. */
                write_varlong30(batch_fd, total_read, 3);
                write_varlong30(batch_fd, total_written, 3);
                write_varlong30(batch_fd, stats.total_size, 3);
                if (protocol_version >= 29) {
                        write_varlong30(batch_fd, stats.flist_buildtime, 3);
                        write_varlong30(batch_fd, stats.flist_xfertime, 3);
                }
        }
}

static void output_itemized_counts(const char *prefix, int *counts)
{
        static char *labels[] = { "reg", "dir", "link", "dev", "special" };
        char buf[1024], *pre = " (";
        int j, len = 0;
        int total = counts[0];
        if (total) {
                counts[0] -= counts[1] + counts[2] + counts[3] + counts[4];
                for (j = 0; j < 5; j++) {
                        if (counts[j]) {
                                len += snprintf(buf+len, sizeof buf - len - 2,
                                        "%s%s: %s",
                                        pre, labels[j], comma_num(counts[j]));
                                pre = ", ";
                        }
                }
                buf[len++] = ')';
        }
        buf[len] = '\0';
        rprintf(FINFO, "%s: %s%s\n", prefix, comma_num(total), buf);
}

static const char *bytes_per_sec_human_dnum(void)
{
        if (starttime == (time_t)-1 || endtime == (time_t)-1)
                return "UNKNOWN";
        return human_dnum((total_written + total_read) / (0.5 + (endtime - starttime)), 2);
}

static void output_summary(void)
{
        if (INFO_GTE(STATS, 2)) {
                rprintf(FCLIENT, "\n");
                output_itemized_counts("Number of files", &stats.num_files);
                if (protocol_version >= 29)
                        output_itemized_counts("Number of created files", &stats.created_files);
                if (protocol_version >= 31)
                        output_itemized_counts("Number of deleted files", &stats.deleted_files);
                rprintf(FINFO,"Number of regular files transferred: %s\n",
                        comma_num(stats.xferred_files));
                rprintf(FINFO,"Total file size: %s bytes\n",
                        human_num(stats.total_size));
                rprintf(FINFO,"Total transferred file size: %s bytes\n",
                        human_num(stats.total_transferred_size));
                rprintf(FINFO,"Literal data: %s bytes\n",
                        human_num(stats.literal_data));
                rprintf(FINFO,"Matched data: %s bytes\n",
                        human_num(stats.matched_data));
                rprintf(FINFO,"File list size: %s\n",
                        human_num(stats.flist_size));
                if (stats.flist_buildtime) {
                        rprintf(FINFO,
                                "File list generation time: %s seconds\n",
                                comma_dnum((double)stats.flist_buildtime / 1000, 3));
                        rprintf(FINFO,
                                "File list transfer time: %s seconds\n",
                                comma_dnum((double)stats.flist_xfertime / 1000, 3));
                }
                rprintf(FINFO,"Total bytes sent: %s\n",
                        human_num(total_written));
                rprintf(FINFO,"Total bytes received: %s\n",
                        human_num(total_read));
        }

        if (INFO_GTE(STATS, 1)) {
                rprintf(FCLIENT, "\n");
                rprintf(FINFO,
                        "sent %s bytes  received %s bytes  %s bytes/sec\n",
                        human_num(total_written), human_num(total_read),
                        bytes_per_sec_human_dnum());
                rprintf(FINFO, "total size is %s  speedup is %s%s\n",
                        human_num(stats.total_size),
                        comma_dnum((double)stats.total_size / (total_written+total_read), 2),
                        write_batch < 0 ? " (BATCH ONLY)" : dry_run ? " (DRY RUN)" : "");
        }

        fflush(stdout);
        fflush(stderr);
}


/**
 * If our C library can get malloc statistics, then show them to FINFO
 **/
static void show_malloc_stats(void)
{
#ifdef HAVE_MALLINFO
        struct mallinfo mi;

        mi = mallinfo();

        rprintf(FCLIENT, "\n");
        rprintf(FINFO, RSYNC_NAME "[%d] (%s%s%s) heap statistics:\n",
                (int)getpid(), am_server ? "server " : "",
                am_daemon ? "daemon " : "", who_am_i());
        rprintf(FINFO, "  arena:     %10ld   (bytes from sbrk)\n",
                (long)mi.arena);
        rprintf(FINFO, "  ordblks:   %10ld   (chunks not in use)\n",
                (long)mi.ordblks);
        rprintf(FINFO, "  smblks:    %10ld\n",
                (long)mi.smblks);
        rprintf(FINFO, "  hblks:     %10ld   (chunks from mmap)\n",
                (long)mi.hblks);
        rprintf(FINFO, "  hblkhd:    %10ld   (bytes from mmap)\n",
                (long)mi.hblkhd);
        rprintf(FINFO, "  allmem:    %10ld   (bytes from sbrk + mmap)\n",
                (long)mi.arena + mi.hblkhd);
        rprintf(FINFO, "  usmblks:   %10ld\n",
                (long)mi.usmblks);
        rprintf(FINFO, "  fsmblks:   %10ld\n",
                (long)mi.fsmblks);
        rprintf(FINFO, "  uordblks:  %10ld   (bytes used)\n",
                (long)mi.uordblks);
        rprintf(FINFO, "  fordblks:  %10ld   (bytes free)\n",
                (long)mi.fordblks);
        rprintf(FINFO, "  keepcost:  %10ld   (bytes in releasable chunk)\n",
                (long)mi.keepcost);
#endif /* HAVE_MALLINFO */
}


/* Start the remote shell.   cmd may be NULL to use the default. */
static pid_t do_cmd(char *cmd, char *machine, char *user, char **remote_argv, int remote_argc,
                    int *f_in_p, int *f_out_p)
{
        int i, argc = 0;
        char *args[MAX_ARGS], *need_to_free = NULL;
        pid_t pid;
        int dash_l_set = 0;

        if (!read_batch && !local_server) {
                char *t, *f, in_quote = '\0';
                char *rsh_env = getenv(RSYNC_RSH_ENV);
                if (!cmd)
                        cmd = rsh_env;
                if (!cmd)
                        cmd = RSYNC_RSH;
                cmd = need_to_free = strdup(cmd);
                if (!cmd)
                        goto oom;

                for (t = f = cmd; *f; f++) {
                        if (*f == ' ')
                                continue;
                        /* Comparison leaves rooms for server_options(). */
                        if (argc >= MAX_ARGS - MAX_SERVER_ARGS)
                                goto arg_overflow;
                        args[argc++] = t;
                        while (*f != ' ' || in_quote) {
                                if (!*f) {
                                        if (in_quote) {
                                                rprintf(FERROR,
                                                        "Missing trailing-%c in remote-shell command.\n",
                                                        in_quote);
                                                exit_cleanup(RERR_SYNTAX);
                                        }
                                        f--;
                                        break;
                                }
                                if (*f == '\'' || *f == '"') {
                                        if (!in_quote) {
                                                in_quote = *f++;
                                                continue;
                                        }
                                        if (*f == in_quote && *++f != in_quote) {
                                                in_quote = '\0';
                                                continue;
                                        }
                                }
                                *t++ = *f++;
                        }
                        *t++ = '\0';
                }

                /* NOTE: must preserve t == start of command name until the end of the args handling! */
                if ((t = strrchr(cmd, '/')) != NULL)
                        t++;
                else
                        t = cmd;

                /* Check to see if we've already been given '-l user' in the remote-shell command. */
                for (i = 0; i < argc-1; i++) {
                        if (!strcmp(args[i], "-l") && args[i+1][0] != '-')
                                dash_l_set = 1;
                }

#ifdef HAVE_REMSH
                /* remsh (on HPUX) takes the arguments the other way around */
                args[argc++] = machine;
                if (user && !(daemon_over_rsh && dash_l_set)) {
                        args[argc++] = "-l";
                        args[argc++] = user;
                }
#else
                if (user && !(daemon_over_rsh && dash_l_set)) {
                        args[argc++] = "-l";
                        args[argc++] = user;
                }
#ifdef AF_INET
                if (default_af_hint == AF_INET && strcmp(t, "ssh") == 0)
                        args[argc++] = "-4"; /* we're using ssh so we can add a -4 option */
#endif
#ifdef AF_INET6
                if (default_af_hint == AF_INET6 && strcmp(t, "ssh") == 0)
                        args[argc++] = "-6"; /* we're using ssh so we can add a -6 option */
#endif
                args[argc++] = machine;
#endif

                args[argc++] = rsync_path;

                if (blocking_io < 0 && (strcmp(t, "rsh") == 0 || strcmp(t, "remsh") == 0))
                        blocking_io = 1;

                server_options(args, &argc);

                if (argc >= MAX_ARGS - 2)
                        goto arg_overflow;
        }

        args[argc++] = ".";

        if (!daemon_over_rsh) {
                while (remote_argc > 0) {
                        if (argc >= MAX_ARGS - 1) {
                          arg_overflow:
                                rprintf(FERROR, "internal: args[] overflowed in do_cmd()\n");
                                exit_cleanup(RERR_SYNTAX);
                        }
                        if (**remote_argv == '-') {
                                if (asprintf(args + argc++, "./%s", *remote_argv++) < 0)
                                        out_of_memory("do_cmd");
                        } else
                                args[argc++] = *remote_argv++;
                        remote_argc--;
                }
        }

        args[argc] = NULL;

        if (DEBUG_GTE(CMD, 2)) {
                for (i = 0; i < argc; i++)
                        rprintf(FCLIENT, "cmd[%d]=%s ", i, args[i]);
                rprintf(FCLIENT, "\n");
        }

        if (read_batch) {
                int from_gen_pipe[2];
                set_allow_inc_recurse();
                if (fd_pair(from_gen_pipe) < 0) {
                        rsyserr(FERROR, errno, "pipe");
                        exit_cleanup(RERR_IPC);
                }
                batch_gen_fd = from_gen_pipe[0];
                *f_out_p = from_gen_pipe[1];
                *f_in_p = batch_fd;
                pid = (pid_t)-1; /* no child pid */
#ifdef ICONV_CONST
                setup_iconv();
#endif
        } else if (local_server) {
                /* If the user didn't request --[no-]whole-file, force
                 * it on, but only if we're not batch processing. */
                if (whole_file < 0 && !write_batch)
                        whole_file = 1;
                set_allow_inc_recurse();
                pid = local_child(argc, args, f_in_p, f_out_p, child_main);
#ifdef ICONV_CONST
                setup_iconv();
#endif
        } else {
                pid = piped_child(args, f_in_p, f_out_p);
#ifdef ICONV_CONST
                setup_iconv();
#endif
                if (protect_args && !daemon_over_rsh)
                        send_protected_args(*f_out_p, args);
        }

        if (need_to_free)
                free(need_to_free);

        return pid;

  oom:
        out_of_memory("do_cmd");
        return 0; /* not reached */
}

/* The receiving side operates in one of two modes:
 *
 * 1. it receives any number of files into a destination directory,
 * placing them according to their names in the file-list.
 *
 * 2. it receives a single file and saves it using the name in the
 * destination path instead of its file-list name.  This requires a
 * "local name" for writing out the destination file.
 *
 * So, our task is to figure out what mode/local-name we need.
 * For mode 1, we change into the destination directory and return NULL.
 * For mode 2, we change into the directory containing the destination
 * file (if we aren't already there) and return the local-name. */
static char *get_local_name(struct file_list *flist, char *dest_path)
{
        STRUCT_STAT st;
        int statret;
        char *cp;

        if (DEBUG_GTE(RECV, 1)) {
                rprintf(FINFO, "get_local_name count=%d %s\n",
                        file_total, NS(dest_path));
        }

        if (!dest_path || list_only)
                return NULL;

        /* Treat an empty string as a copy into the current directory. */
        if (!*dest_path)
                dest_path = ".";

        if (daemon_filter_list.head) {
                char *slash = strrchr(dest_path, '/');
                if (slash && (slash[1] == '\0' || (slash[1] == '.' && slash[2] == '\0')))
                        *slash = '\0';
                else
                        slash = NULL;
                if ((*dest_path != '.' || dest_path[1] != '\0')
                 && (check_filter(&daemon_filter_list, FLOG, dest_path, 0) < 0
                  || check_filter(&daemon_filter_list, FLOG, dest_path, 1) < 0)) {
                        rprintf(FERROR, "ERROR: daemon has excluded destination \"%s\"\n",
                                dest_path);
                        exit_cleanup(RERR_FILESELECT);
                }
                if (slash)
                        *slash = '/';
        }

        /* See what currently exists at the destination. */
        if ((statret = do_stat(dest_path, &st)) == 0) {
                /* If the destination is a dir, enter it and use mode 1. */
                if (S_ISDIR(st.st_mode)) {
                        if (!change_dir(dest_path, CD_NORMAL)) {
                                rsyserr(FERROR, errno, "change_dir#1 %s failed",
                                        full_fname(dest_path));
                                exit_cleanup(RERR_FILESELECT);
                        }
                        filesystem_dev = st.st_dev; /* ensures --force works right w/-x */
                        return NULL;
                }
                if (file_total > 1) {
                        rprintf(FERROR,
                                "ERROR: destination must be a directory when"
                                " copying more than 1 file\n");
                        exit_cleanup(RERR_FILESELECT);
                }
                if (file_total == 1 && S_ISDIR(flist->files[0]->mode)) {
                        rprintf(FERROR,
                                "ERROR: cannot overwrite non-directory"
                                " with a directory\n");
                        exit_cleanup(RERR_FILESELECT);
                }
        } else if (errno != ENOENT) {
                /* If we don't know what's at the destination, fail. */
                rsyserr(FERROR, errno, "ERROR: cannot stat destination %s",
                        full_fname(dest_path));
                exit_cleanup(RERR_FILESELECT);
        }

        cp = strrchr(dest_path, '/');

        /* If we need a destination directory because the transfer is not
         * of a single non-directory or the user has requested one via a
         * destination path ending in a slash, create one and use mode 1. */
        if (file_total > 1 || (cp && !cp[1])) {
                /* Lop off the final slash (if any). */
                if (cp && !cp[1])
                        *cp = '\0';

                if (statret == 0) {
                        rprintf(FERROR, "ERROR: destination path is not a directory\n");
                        exit_cleanup(RERR_SYNTAX);
                }

                if (do_mkdir(dest_path, ACCESSPERMS) != 0) {
                        rsyserr(FERROR, errno, "mkdir %s failed",
                                full_fname(dest_path));
                        exit_cleanup(RERR_FILEIO);
                }

                if (flist->high >= flist->low
                 && strcmp(flist->files[flist->low]->basename, ".") == 0)
                        flist->files[0]->flags |= FLAG_DIR_CREATED;

                if (INFO_GTE(NAME, 1))
                        rprintf(FINFO, "created directory %s\n", dest_path);

                if (dry_run) {
                        /* Indicate that dest dir doesn't really exist. */
                        dry_run++;
                }

                if (!change_dir(dest_path, dry_run > 1 ? CD_SKIP_CHDIR : CD_NORMAL)) {
                        rsyserr(FERROR, errno, "change_dir#2 %s failed",
                                full_fname(dest_path));
                        exit_cleanup(RERR_FILESELECT);
                }

                return NULL;
        }

        /* Otherwise, we are writing a single file, possibly on top of an
         * existing non-directory.  Change to the item's parent directory
         * (if it has a path component), return the basename of the
         * destination file as the local name, and use mode 2. */
        if (!cp)
                return dest_path;

        if (cp == dest_path)
                dest_path = "/";

        *cp = '\0';
        if (!change_dir(dest_path, CD_NORMAL)) {
                rsyserr(FERROR, errno, "change_dir#3 %s failed",
                        full_fname(dest_path));
                exit_cleanup(RERR_FILESELECT);
        }
        *cp = '/';

        return cp + 1;
}

/* This function checks on our alternate-basis directories.  If we're in
 * dry-run mode and the destination dir does not yet exist, we'll try to
 * tweak any dest-relative paths to make them work for a dry-run (the
 * destination dir must be in curr_dir[] when this function is called).
 * We also warn about any arg that is non-existent or not a directory. */
static void check_alt_basis_dirs(void)
{
        STRUCT_STAT st;
        char *slash = strrchr(curr_dir, '/');
        int j;

        for (j = 0; j < basis_dir_cnt; j++) {
                char *bdir = basis_dir[j];
                int bd_len = strlen(bdir);
                if (bd_len > 1 && bdir[bd_len-1] == '/')
                        bdir[--bd_len] = '\0';
                if (dry_run > 1 && *bdir != '/') {
                        int len = curr_dir_len + 1 + bd_len + 1;
                        char *new = new_array(char, len);
                        if (!new)
                                out_of_memory("check_alt_basis_dirs");
                        if (slash && strncmp(bdir, "../", 3) == 0) {
                                /* We want to remove only one leading "../" prefix for
                                 * the directory we couldn't create in dry-run mode:
                                 * this ensures that any other ".." references get
                                 * evaluated the same as they would for a live copy. */
                                *slash = '\0';
                                pathjoin(new, len, curr_dir, bdir + 3);
                                *slash = '/';
                        } else
                                pathjoin(new, len, curr_dir, bdir);
                        basis_dir[j] = bdir = new;
                }
                if (do_stat(bdir, &st) < 0)
                        rprintf(FWARNING, "%s arg does not exist: %s\n", alt_dest_opt(0), bdir);
                else if (!S_ISDIR(st.st_mode))
                        rprintf(FWARNING, "%s arg is not a dir: %s\n", alt_dest_opt(0), bdir);
        }
}

/* This is only called by the sender. */
static void read_final_goodbye(int f_in, int f_out)
{
        int i, iflags, xlen;
        uchar fnamecmp_type;
        char xname[MAXPATHLEN];

        shutting_down = True;

        if (protocol_version < 29)
                i = read_int(f_in);
        else {
                i = read_ndx_and_attrs(f_in, f_out, &iflags, &fnamecmp_type, xname, &xlen);
                if (protocol_version >= 31 && i == NDX_DONE) {
                        if (am_sender)
                                write_ndx(f_out, NDX_DONE);
                        else {
                                if (batch_gen_fd >= 0) {
                                        while (read_int(batch_gen_fd) != NDX_DEL_STATS) {}
                                        read_del_stats(batch_gen_fd);
                                }
                                write_int(f_out, NDX_DONE);
                        }
                        i = read_ndx_and_attrs(f_in, f_out, &iflags, &fnamecmp_type, xname, &xlen);
                }
        }

        if (i != NDX_DONE) {
                rprintf(FERROR, "Invalid packet at end of run (%d) [%s]\n",
                        i, who_am_i());
                exit_cleanup(RERR_PROTOCOL);
        }
}

static void do_server_sender(int f_in, int f_out, int argc, char *argv[])
{
        struct file_list *flist;
        char *dir;

        if (DEBUG_GTE(SEND, 1))
                rprintf(FINFO, "server_sender starting pid=%d\n", (int)getpid());

        if (am_daemon && lp_write_only(module_id)) {
                rprintf(FERROR, "ERROR: module is write only\n");
                exit_cleanup(RERR_SYNTAX);
        }
        if (am_daemon && read_only && remove_source_files) {
                rprintf(FERROR,
                        "ERROR: --remove-%s-files cannot be used with a read-only module\n",
                        remove_source_files == 1 ? "source" : "sent");
                exit_cleanup(RERR_SYNTAX);
        }
        if (argc < 1) {
                rprintf(FERROR, "ERROR: do_server_sender called without args\n");
                exit_cleanup(RERR_SYNTAX);
        }

        become_copy_as_user();

        dir = argv[0];
        if (!relative_paths) {
                if (!change_dir(dir, CD_NORMAL)) {
                        rsyserr(FERROR, errno, "change_dir#3 %s failed",
                                full_fname(dir));
                        exit_cleanup(RERR_FILESELECT);
                }
        }
        argc--;
        argv++;

        if (argc == 0 && (recurse || xfer_dirs || list_only)) {
                argc = 1;
                argv--;
                argv[0] = ".";
        }

        flist = send_file_list(f_out,argc,argv);
        if (!flist || flist->used == 0) {
                /* Make sure input buffering is off so we can't hang in noop_io_until_death(). */
                io_end_buffering_in(0);
                /* TODO:  we should really exit in a more controlled manner. */
                exit_cleanup(0);
        }

        io_start_buffering_in(f_in);

        send_files(f_in, f_out);
        io_flush(FULL_FLUSH);
        handle_stats(f_out);
        if (protocol_version >= 24)
                read_final_goodbye(f_in, f_out);
        io_flush(FULL_FLUSH);
        exit_cleanup(0);
}


static int do_recv(int f_in, int f_out, char *local_name)
{
        int pid;
        int exit_code = 0;
        int error_pipe[2];

        /* The receiving side mustn't obey this, or an existing symlink that
         * points to an identical file won't be replaced by the referent. */
        copy_links = copy_dirlinks = copy_unsafe_links = 0;

#ifdef SUPPORT_HARD_LINKS
        if (preserve_hard_links && !inc_recurse)
                match_hard_links(first_flist);
#endif

        if (fd_pair(error_pipe) < 0) {
                rsyserr(FERROR, errno, "pipe failed in do_recv");
                exit_cleanup(RERR_IPC);
        }

        if (backup_dir) {
                STRUCT_STAT st;
                int ret;
                if (backup_dir_len > 1)
                        backup_dir_buf[backup_dir_len-1] = '\0';
                ret = do_stat(backup_dir_buf, &st);
                if (ret != 0 || !S_ISDIR(st.st_mode)) {
                        if (ret == 0) {
                                rprintf(FERROR, "The backup-dir is not a directory: %s\n", backup_dir_buf);
                                exit_cleanup(RERR_SYNTAX);
                        }
                        if (errno != ENOENT) {
                                rprintf(FERROR, "Failed to stat %s: %s\n", backup_dir_buf, strerror(errno));
                                exit_cleanup(RERR_FILEIO);
                        }
                        if (INFO_GTE(BACKUP, 1))
                                rprintf(FINFO, "(new) backup_dir is %s\n", backup_dir_buf);
                } else if (INFO_GTE(BACKUP, 1))
                        rprintf(FINFO, "backup_dir is %s\n", backup_dir_buf);
                if (backup_dir_len > 1)
                        backup_dir_buf[backup_dir_len-1] = '/';
        }

        io_flush(FULL_FLUSH);

        if ((pid = do_fork()) == -1) {
                rsyserr(FERROR, errno, "fork failed in do_recv");
                exit_cleanup(RERR_IPC);
        }

        if (pid == 0) {
                am_receiver = 1;
                send_msgs_to_gen = am_server;

                close(error_pipe[0]);

                /* We can't let two processes write to the socket at one time. */
                io_end_multiplex_out(MPLX_SWITCHING);
                if (f_in != f_out)
                        close(f_out);
                sock_f_out = -1;
                f_out = error_pipe[1];

                bwlimit_writemax = 0; /* receiver doesn't need to do this */

                if (read_batch)
                        io_start_buffering_in(f_in);
                io_start_multiplex_out(f_out);

                recv_files(f_in, f_out, local_name);
                io_flush(FULL_FLUSH);
                handle_stats(f_in);

                if (output_needs_newline) {
                        fputc('\n', stdout);
                        output_needs_newline = 0;
                }

                write_int(f_out, NDX_DONE);
                send_msg(MSG_STATS, (char*)&stats.total_read, sizeof stats.total_read, 0);
                io_flush(FULL_FLUSH);

                /* Handle any keep-alive packets from the post-processing work
                 * that the generator does. */
                if (protocol_version >= 29) {
                        kluge_around_eof = -1;

                        /* This should only get stopped via a USR2 signal. */
                        read_final_goodbye(f_in, f_out);

                        rprintf(FERROR, "Invalid packet at end of run [%s]\n",
                                who_am_i());
                        exit_cleanup(RERR_PROTOCOL);
                }

                /* Finally, we go to sleep until our parent kills us with a
                 * USR2 signal.  We sleep for a short time, as on some OSes
                 * a signal won't interrupt a sleep! */
                while (1)
                        msleep(20);
        }

        am_generator = 1;
        flist_receiving_enabled = True;

        io_end_multiplex_in(MPLX_SWITCHING);
        if (write_batch && !am_server)
                stop_write_batch();

        close(error_pipe[1]);
        if (f_in != f_out)
                close(f_in);
        sock_f_in = -1;
        f_in = error_pipe[0];

        io_start_buffering_out(f_out);
        io_start_multiplex_in(f_in);

#ifdef SUPPORT_HARD_LINKS
        if (preserve_hard_links && inc_recurse) {
                struct file_list *flist;
                for (flist = first_flist; flist; flist = flist->next)
                        match_hard_links(flist);
        }
#endif

        generate_files(f_out, local_name);

        handle_stats(-1);
        io_flush(FULL_FLUSH);
        shutting_down = True;
        if (protocol_version >= 24) {
                /* send a final goodbye message */
                write_ndx(f_out, NDX_DONE);
        }
        io_flush(FULL_FLUSH);

        kill(pid, SIGUSR2);
        wait_process_with_flush(pid, &exit_code);
        return exit_code;
}

static void do_server_recv(int f_in, int f_out, int argc, char *argv[])
{
        int exit_code;
        struct file_list *flist;
        char *local_name = NULL;
        int negated_levels;

        if (filesfrom_fd >= 0 && !msgs2stderr && protocol_version < 31) {
                /* We can't mix messages with files-from data on the socket,
                 * so temporarily turn off info/debug messages. */
                negate_output_levels();
                negated_levels = 1;
        } else
                negated_levels = 0;

        if (DEBUG_GTE(RECV, 1))
                rprintf(FINFO, "server_recv(%d) starting pid=%d\n", argc, (int)getpid());

        if (am_daemon && read_only) {
                rprintf(FERROR,"ERROR: module is read only\n");
                exit_cleanup(RERR_SYNTAX);
                return;
        }

        become_copy_as_user();

        if (argc > 0) {
                char *dir = argv[0];
                argc--;
                argv++;
                if (!am_daemon && !change_dir(dir, CD_NORMAL)) {
                        rsyserr(FERROR, errno, "change_dir#4 %s failed",
                                full_fname(dir));
                        exit_cleanup(RERR_FILESELECT);
                }
        }

        if (protocol_version >= 30)
                io_start_multiplex_in(f_in);
        else
                io_start_buffering_in(f_in);
        recv_filter_list(f_in);

        if (filesfrom_fd >= 0) {
                /* We need to send the files-from names to the sender at the
                 * same time that we receive the file-list from them, so we
                 * need the IO routines to automatically write out the names
                 * onto our f_out socket as we read the file-list.  This
                 * avoids both deadlock and extra delays/buffers. */
                start_filesfrom_forwarding(filesfrom_fd);
                filesfrom_fd = -1;
        }

        flist = recv_file_list(f_in, -1);
        if (!flist) {
                rprintf(FERROR,"server_recv: recv_file_list error\n");
                exit_cleanup(RERR_FILESELECT);
        }
        if (inc_recurse && file_total == 1)
                recv_additional_file_list(f_in);

        if (negated_levels)
                negate_output_levels();

        if (argc > 0)
                local_name = get_local_name(flist,argv[0]);

        /* Now that we know what our destination directory turned out to be,
         * we can sanitize the --link-/copy-/compare-dest args correctly. */
        if (sanitize_paths) {
                char **dir_p;
                for (dir_p = basis_dir; *dir_p; dir_p++)
                        *dir_p = sanitize_path(NULL, *dir_p, NULL, curr_dir_depth, SP_DEFAULT);
                if (partial_dir)
                        partial_dir = sanitize_path(NULL, partial_dir, NULL, curr_dir_depth, SP_DEFAULT);
        }
        check_alt_basis_dirs();

        if (daemon_filter_list.head) {
                char **dir_p;
                filter_rule_list *elp = &daemon_filter_list;

                for (dir_p = basis_dir; *dir_p; dir_p++) {
                        char *dir = *dir_p;
                        if (*dir == '/')
                                dir += module_dirlen;
                        if (check_filter(elp, FLOG, dir, 1) < 0)
                                goto options_rejected;
                }
                if (partial_dir && *partial_dir == '/'
                 && check_filter(elp, FLOG, partial_dir + module_dirlen, 1) < 0) {
                    options_rejected:
                        rprintf(FERROR, "Your options have been rejected by the server.\n");
                        exit_cleanup(RERR_SYNTAX);
                }
        }

        exit_code = do_recv(f_in, f_out, local_name);
        exit_cleanup(exit_code);
}


int child_main(int argc, char *argv[])
{
        start_server(STDIN_FILENO, STDOUT_FILENO, argc, argv);
        return 0;
}


void start_server(int f_in, int f_out, int argc, char *argv[])
{
        set_nonblocking(f_in);
        set_nonblocking(f_out);

        io_set_sock_fds(f_in, f_out);
        setup_protocol(f_out, f_in);

        if (protocol_version >= 23)
                io_start_multiplex_out(f_out);
        if (am_daemon && io_timeout && protocol_version >= 31)
                send_msg_int(MSG_IO_TIMEOUT, io_timeout);

        if (am_sender) {
                keep_dirlinks = 0; /* Must be disabled on the sender. */
                if (need_messages_from_generator)
                        io_start_multiplex_in(f_in);
                else
                        io_start_buffering_in(f_in);
                recv_filter_list(f_in);
                do_server_sender(f_in, f_out, argc, argv);
        } else
                do_server_recv(f_in, f_out, argc, argv);
        exit_cleanup(0);
}

/* This is called once the connection has been negotiated.  It is used
 * for rsyncd, remote-shell, and local connections. */
int client_run(int f_in, int f_out, pid_t pid, int argc, char *argv[])
{
        struct file_list *flist = NULL;
        int exit_code = 0, exit_code2 = 0;
        char *local_name = NULL;

        cleanup_child_pid = pid;
        if (!read_batch) {
                set_nonblocking(f_in);
                set_nonblocking(f_out);
        }

        io_set_sock_fds(f_in, f_out);
        setup_protocol(f_out,f_in);

        /* We set our stderr file handle to blocking because ssh might have
         * set it to non-blocking.  This can be particularly troublesome if
         * stderr is a clone of stdout, because ssh would have set our stdout
         * to non-blocking at the same time (which can easily cause us to lose
         * output from our print statements).  This kluge shouldn't cause ssh
         * any problems for how we use it.  Note also that we delayed setting
         * this until after the above protocol setup so that we know for sure
         * that ssh is done twiddling its file descriptors.  */
        set_blocking(STDERR_FILENO);

        if (am_sender) {
                keep_dirlinks = 0; /* Must be disabled on the sender. */

                if (always_checksum
                 && (log_format_has(stdout_format, 'C')
                  || log_format_has(logfile_format, 'C')))
                        sender_keeps_checksum = 1;

                if (protocol_version >= 30)
                        io_start_multiplex_out(f_out);
                else
                        io_start_buffering_out(f_out);
                if (protocol_version >= 31 || (!filesfrom_host && protocol_version >= 23))
                        io_start_multiplex_in(f_in);
                else
                        io_start_buffering_in(f_in);
                send_filter_list(f_out);
                if (filesfrom_host)
                        filesfrom_fd = f_in;

                if (write_batch && !am_server)
                        start_write_batch(f_out);

                become_copy_as_user();

                flist = send_file_list(f_out, argc, argv);
                if (DEBUG_GTE(FLIST, 3))
                        rprintf(FINFO,"file list sent\n");

                if (protocol_version < 31 && filesfrom_host && protocol_version >= 23)
                        io_start_multiplex_in(f_in);

                io_flush(NORMAL_FLUSH);
                send_files(f_in, f_out);
                io_flush(FULL_FLUSH);
                handle_stats(-1);
                if (protocol_version >= 24)
                        read_final_goodbye(f_in, f_out);
                if (pid != -1) {
                        if (DEBUG_GTE(EXIT, 2))
                                rprintf(FINFO,"client_run waiting on %d\n", (int) pid);
                        io_flush(FULL_FLUSH);
                        wait_process_with_flush(pid, &exit_code);
                }
                output_summary();
                io_flush(FULL_FLUSH);
                exit_cleanup(exit_code);
        }

        if (!read_batch) {
                if (protocol_version >= 23)
                        io_start_multiplex_in(f_in);
                if (need_messages_from_generator)
                        io_start_multiplex_out(f_out);
                else
                        io_start_buffering_out(f_out);
        }

        become_copy_as_user();

        send_filter_list(read_batch ? -1 : f_out);

        if (filesfrom_fd >= 0) {
                start_filesfrom_forwarding(filesfrom_fd);
                filesfrom_fd = -1;
        }

        if (write_batch && !am_server)
                start_write_batch(f_in);
        flist = recv_file_list(f_in, -1);
        if (inc_recurse && file_total == 1)
                recv_additional_file_list(f_in);

        if (flist && flist->used > 0) {
                local_name = get_local_name(flist, argv[0]);

                check_alt_basis_dirs();

                exit_code2 = do_recv(f_in, f_out, local_name);
        } else {
                handle_stats(-1);
                output_summary();
        }

        if (pid != -1) {
                if (DEBUG_GTE(RECV, 1))
                        rprintf(FINFO,"client_run2 waiting on %d\n", (int) pid);
                io_flush(FULL_FLUSH);
                wait_process_with_flush(pid, &exit_code);
        }

        return MAX(exit_code, exit_code2);
}

static int copy_argv(char *argv[])
{
        int i;

        for (i = 0; argv[i]; i++) {
                if (!(argv[i] = strdup(argv[i]))) {
                        rprintf (FERROR, "out of memory at %s(%d)\n",
                                 __FILE__, __LINE__);
                        return RERR_MALLOC;
                }
        }

        return 0;
}


/* Start a client for either type of remote connection.  Work out
 * whether the arguments request a remote shell or rsyncd connection,
 * and call the appropriate connection function, then run_client.
 *
 * Calls either start_socket_client (for sockets) or do_cmd and
 * client_run (for ssh). */
static int start_client(int argc, char *argv[])
{
        char *p, *shell_machine = NULL, *shell_user = NULL;
        char **remote_argv;
        int remote_argc, env_port = rsync_port;
        int f_in, f_out;
        int ret;
        pid_t pid;

        /* Don't clobber argv[] so that ps(1) can still show the right
         * command line. */
        if ((ret = copy_argv(argv)) != 0)
                return ret;

        if (!read_batch) { /* for read_batch, NO source is specified */
                char *path = check_for_hostspec(argv[0], &shell_machine, &rsync_port);
                if (path) { /* source is remote */
                        char *dummy_host;
                        int dummy_port = 0;
                        *argv = path;
                        remote_argv = argv;
                        remote_argc = argc;
                        argv += argc - 1;
                        if (argc == 1 || **argv == ':')
                                argc = 0; /* no dest arg */
                        else if (check_for_hostspec(*argv, &dummy_host, &dummy_port)) {
                                rprintf(FERROR,
                                        "The source and destination cannot both be remote.\n");
                                exit_cleanup(RERR_SYNTAX);
                        } else {
                                remote_argc--; /* don't count dest */
                                argc = 1;
                        }
                        if (filesfrom_host && *filesfrom_host && strcmp(filesfrom_host, shell_machine) != 0) {
                                rprintf(FERROR,
                                        "--files-from hostname is not the same as the transfer hostname\n");
                                exit_cleanup(RERR_SYNTAX);
                        }
                        am_sender = 0;
                        if (rsync_port)
                                daemon_over_rsh = shell_cmd ? 1 : -1;
                } else { /* source is local, check dest arg */
                        am_sender = 1;

                        if (argc > 1) {
                                p = argv[--argc];
                                remote_argv = argv + argc;
                        } else {
                                static char *dotarg[1] = { "." };
                                p = dotarg[0];
                                remote_argv = dotarg;
                        }
                        remote_argc = 1;

                        path = check_for_hostspec(p, &shell_machine, &rsync_port);
                        if (path && filesfrom_host && *filesfrom_host && strcmp(filesfrom_host, shell_machine) != 0) {
                                rprintf(FERROR,
                                        "--files-from hostname is not the same as the transfer hostname\n");
                                exit_cleanup(RERR_SYNTAX);
                        }
                        if (!path) { /* no hostspec found, so src & dest are local */
                                local_server = 1;
                                if (filesfrom_host) {
                                        rprintf(FERROR,
                                                "--files-from cannot be remote when the transfer is local\n");
                                        exit_cleanup(RERR_SYNTAX);
                                }
                                shell_machine = NULL;
                                rsync_port = 0;
                        } else { /* hostspec was found, so dest is remote */
                                argv[argc] = path;
                                if (rsync_port)
                                        daemon_over_rsh = shell_cmd ? 1 : -1;
                        }
                }
        } else {  /* read_batch */
                local_server = 1;
                if (check_for_hostspec(argv[argc-1], &shell_machine, &rsync_port)) {
                        rprintf(FERROR, "remote destination is not allowed with --read-batch\n");
                        exit_cleanup(RERR_SYNTAX);
                }
                remote_argv = argv += argc - 1;
                remote_argc = argc = 1;
                rsync_port = 0;
        }

        if (!rsync_port && remote_argc && !**remote_argv) /* Turn an empty arg into a dot dir. */
                *remote_argv = ".";

        if (am_sender) {
                char *dummy_host;
                int dummy_port = rsync_port;
                int i;
                /* For local source, extra source args must not have hostspec. */
                for (i = 1; i < argc; i++) {
                        if (check_for_hostspec(argv[i], &dummy_host, &dummy_port)) {
                                rprintf(FERROR, "Unexpected remote arg: %s\n", argv[i]);
                                exit_cleanup(RERR_SYNTAX);
                        }
                }
        } else {
                char *dummy_host;
                int dummy_port = rsync_port;
                int i;
                /* For remote source, any extra source args must have either
                 * the same hostname or an empty hostname. */
                for (i = 1; i < remote_argc; i++) {
                        char *arg = check_for_hostspec(remote_argv[i], &dummy_host, &dummy_port);
                        if (!arg) {
                                rprintf(FERROR, "Unexpected local arg: %s\n", remote_argv[i]);
                                rprintf(FERROR, "If arg is a remote file/dir, prefix it with a colon (:).\n");
                                exit_cleanup(RERR_SYNTAX);
                        }
                        if (*dummy_host && strcmp(dummy_host, shell_machine) != 0) {
                                rprintf(FERROR, "All source args must come from the same machine.\n");
                                exit_cleanup(RERR_SYNTAX);
                        }
                        if (rsync_port != dummy_port) {
                                if (!rsync_port || !dummy_port)
                                        rprintf(FERROR, "All source args must use the same hostspec format.\n");
                                else
                                        rprintf(FERROR, "All source args must use the same port number.\n");
                                exit_cleanup(RERR_SYNTAX);
                        }
                        if (!rsync_port && !*arg) /* Turn an empty arg into a dot dir. */
                                arg = ".";
                        remote_argv[i] = arg;
                }
        }

        if (rsync_port < 0)
                rsync_port = RSYNC_PORT;
        else
                env_port = rsync_port;

        if (daemon_over_rsh < 0)
                return start_socket_client(shell_machine, remote_argc, remote_argv, argc, argv);

        if (password_file && !daemon_over_rsh) {
                rprintf(FERROR, "The --password-file option may only be "
                                "used when accessing an rsync daemon.\n");
                exit_cleanup(RERR_SYNTAX);
        }

        if (connect_timeout) {
                rprintf(FERROR, "The --contimeout option may only be "
                                "used when connecting to an rsync daemon.\n");
                exit_cleanup(RERR_SYNTAX);
        }

        if (shell_machine) {
                p = strrchr(shell_machine,'@');
                if (p) {
                        *p = 0;
                        shell_user = shell_machine;
                        shell_machine = p+1;
                }
        }

        if (DEBUG_GTE(CMD, 2)) {
                rprintf(FINFO,"cmd=%s machine=%s user=%s path=%s\n",
                        NS(shell_cmd), NS(shell_machine), NS(shell_user),
                        NS(remote_argv[0]));
        }

#ifdef HAVE_PUTENV
        if (daemon_over_rsh)
                set_env_num("RSYNC_PORT", env_port);
#endif

        pid = do_cmd(shell_cmd, shell_machine, shell_user, remote_argv, remote_argc, &f_in, &f_out);

        /* if we're running an rsync server on the remote host over a
         * remote shell command, we need to do the RSYNCD protocol first */
        if (daemon_over_rsh) {
                int tmpret;
                tmpret = start_inband_exchange(f_in, f_out, shell_user, remote_argc, remote_argv);
                if (tmpret < 0)
                        return tmpret;
        }

        ret = client_run(f_in, f_out, pid, argc, argv);

        fflush(stdout);
        fflush(stderr);

        return ret;
}


static void sigusr1_handler(UNUSED(int val))
{
        called_from_signal_handler = 1;
        exit_cleanup(RERR_SIGNAL1);
}

static void sigusr2_handler(UNUSED(int val))
{
        if (!am_server)
                output_summary();
        close_all();
        if (got_xfer_error)
                _exit(RERR_PARTIAL);
        _exit(0);
}

static void siginfo_handler(UNUSED(int val))
{
        if (!am_server && !INFO_GTE(PROGRESS, 1))
                want_progress_now = True;
}

void remember_children(UNUSED(int val))
{
#ifdef WNOHANG
        int cnt, status;
        pid_t pid;
        /* An empty waitpid() loop was put here by Tridge and we could never
         * get him to explain why he put it in, so rather than taking it
         * out we're instead saving the child exit statuses for later use.
         * The waitpid() loop presumably eliminates all possibility of leaving
         * zombie children, maybe that's why he did it. */
        while ((pid = waitpid(-1, &status, WNOHANG)) > 0) {
                /* save the child's exit status */
                for (cnt = 0; cnt < MAXCHILDPROCS; cnt++) {
                        if (pid_stat_table[cnt].pid == 0) {
                                pid_stat_table[cnt].pid = pid;
                                pid_stat_table[cnt].status = status;
                                break;
                        }
                }
        }
#endif
#ifndef HAVE_SIGACTION
        signal(SIGCHLD, remember_children);
#endif
}


/**
 * This routine catches signals and tries to send them to gdb.
 *
 * Because it's called from inside a signal handler it ought not to
 * use too many library routines.
 *
 * @todo Perhaps use "screen -X" instead/as well, to help people
 * debugging without easy access to X.  Perhaps use an environment
 * variable, or just call a script?
 *
 * @todo The /proc/ magic probably only works on Linux (and
 * Solaris?)  Can we be more portable?
 **/
#ifdef MAINTAINER_MODE
const char *get_panic_action(void)
{
        const char *cmd_fmt = getenv("RSYNC_PANIC_ACTION");

        if (cmd_fmt)
                return cmd_fmt;
        return "xterm -display :0 -T Panic -n Panic -e gdb /proc/%d/exe %d";
}


/**
 * Handle a fatal signal by launching a debugger, controlled by $RSYNC_PANIC_ACTION.
 *
 * This signal handler is only installed if we were configured with
 * --enable-maintainer-mode.  Perhaps it should always be on and we
 * should just look at the environment variable, but I'm a bit leery
 * of a signal sending us into a busy loop.
 **/
static void rsync_panic_handler(UNUSED(int whatsig))
{
        char cmd_buf[300];
        int ret, pid_int = getpid();

        snprintf(cmd_buf, sizeof cmd_buf, get_panic_action(), pid_int, pid_int);

        /* Unless we failed to execute gdb, we allow the process to
         * continue.  I'm not sure if that's right. */
        ret = shell_exec(cmd_buf);
        if (ret)
                _exit(ret);
}
#endif


int main(int argc,char *argv[])
{
        int ret;

        raw_argc = argc;
        raw_argv = argv;

#ifdef HAVE_SIGACTION
# ifdef HAVE_SIGPROCMASK
        sigset_t sigmask;

        sigemptyset(&sigmask);
# endif
        sigact.sa_flags = SA_NOCLDSTOP;
#endif
        SIGACTMASK(SIGUSR1, sigusr1_handler);
        SIGACTMASK(SIGUSR2, sigusr2_handler);
        SIGACTMASK(SIGCHLD, remember_children);
#ifdef MAINTAINER_MODE
        SIGACTMASK(SIGSEGV, rsync_panic_handler);
        SIGACTMASK(SIGFPE, rsync_panic_handler);
        SIGACTMASK(SIGABRT, rsync_panic_handler);
        SIGACTMASK(SIGBUS, rsync_panic_handler);
#endif
#ifdef SIGINFO
        SIGACTMASK(SIGINFO, siginfo_handler);
#endif
#ifdef SIGVTALRM
        SIGACTMASK(SIGVTALRM, siginfo_handler);
#endif

        starttime = time(NULL);
        our_uid = MY_UID();
        our_gid = MY_GID();
        am_root = our_uid == 0;

        memset(&stats, 0, sizeof(stats));

        /* Even a non-daemon runs needs the default config values to be set, e.g.
         * lp_dont_compress() is queried when no --skip-compress option is set. */
        reset_daemon_vars();

        if (argc < 2) {
                usage(FERROR);
                exit_cleanup(RERR_SYNTAX);
        }

        /* Get the umask for use in permission calculations.  We no longer set
         * it to zero; that is ugly and pointless now that all the callers that
         * relied on it have been reeducated to work with default ACLs. */
        umask(orig_umask = umask(0));

#if defined CONFIG_LOCALE && defined HAVE_SETLOCALE
        setlocale(LC_CTYPE, "");
#endif

        if (!parse_arguments(&argc, (const char ***) &argv)) {
                option_error();
                exit_cleanup(RERR_SYNTAX);
        }
        if (write_batch
         && poptDupArgv(argc, (const char **)argv, &cooked_argc, (const char ***)&cooked_argv) != 0)
                out_of_memory("main");

        SIGACTMASK(SIGINT, sig_int);
        SIGACTMASK(SIGHUP, sig_int);
        SIGACTMASK(SIGTERM, sig_int);
#if defined HAVE_SIGACTION && HAVE_SIGPROCMASK
        sigprocmask(SIG_UNBLOCK, &sigmask, NULL);
#endif

        /* Ignore SIGPIPE; we consistently check error codes and will
         * see the EPIPE. */
        SIGACTION(SIGPIPE, SIG_IGN);
#ifdef SIGXFSZ
        SIGACTION(SIGXFSZ, SIG_IGN);
#endif

        /* Initialize change_dir() here because on some old systems getcwd
         * (implemented by forking "pwd" and reading its output) doesn't
         * work when there are other child processes.  Also, on all systems
         * that implement getcwd that way "pwd" can't be found after chroot. */
        change_dir(NULL, CD_NORMAL);

        if ((write_batch || read_batch) && !am_server) {
                open_batch_files(); /* sets batch_fd */
                if (read_batch)
                        read_stream_flags(batch_fd);
                else
                        write_stream_flags(batch_fd);
        }
        if (write_batch < 0)
                dry_run = 1;

        if (am_server) {
#ifdef ICONV_CONST
                setup_iconv();
#endif
        } else if (am_daemon)
                return daemon_main();

        if (am_server && protect_args) {
                char buf[MAXPATHLEN];
                protect_args = 2;
                read_args(STDIN_FILENO, NULL, buf, sizeof buf, 1, &argv, &argc, NULL);
                if (!parse_arguments(&argc, (const char ***) &argv)) {
                        option_error();
                        exit_cleanup(RERR_SYNTAX);
                }
        }

        if (argc < 1) {
                usage(FERROR);
                exit_cleanup(RERR_SYNTAX);
        }

        if (am_server) {
                set_nonblocking(STDIN_FILENO);
                set_nonblocking(STDOUT_FILENO);
                if (am_daemon)
                        return start_daemon(STDIN_FILENO, STDOUT_FILENO);
                start_server(STDIN_FILENO, STDOUT_FILENO, argc, argv);
        }

        ret = start_client(argc, argv);
        if (ret == -1)
                exit_cleanup(RERR_STARTCLIENT);
        else
                exit_cleanup(ret);

        return ret;
}