2 * The socket based protocol for setting up a connection with rsyncd.
4 * Copyright (C) 1998-2001 Andrew Tridgell <tridge@samba.org>
5 * Copyright (C) 2001-2002 Martin Pool <mbp@samba.org>
6 * Copyright (C) 2002, 2003, 2004, 2005, 2006 Wayne Davison
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.
32 extern int rsync_port;
33 extern int kluge_around_eof;
34 extern int daemon_over_rsh;
35 extern int sanitize_paths;
36 extern int filesfrom_fd;
37 extern int remote_protocol;
38 extern int protocol_version;
39 extern int io_timeout;
41 extern int default_af_hint;
42 extern int logfile_format_has_i;
43 extern int logfile_format_has_o_or_i;
44 extern mode_t orig_umask;
45 extern char *bind_address;
46 extern char *sockopts;
47 extern char *config_file;
48 extern char *logfile_format;
49 extern char *files_from;
51 extern struct chmod_mode_struct *chmod_modes;
52 extern struct filter_list_struct server_filter_list;
57 struct chmod_mode_struct *daemon_chmod_modes;
59 /* Length of lp_path() string when in daemon mode & not chrooted, else 0. */
60 unsigned int module_dirlen = 0;
63 static struct sigaction sigact;
67 * Run a client connected to an rsyncd. The alternative to this
68 * function for remote-shell connections is do_cmd().
70 * After negotiating which module to use and reading the server's
71 * motd, this hands over to client_run(). Telling the server the
72 * module will cause it to chroot/setuid/etc.
74 * Instead of doing a transfer, the client may at this stage instead
75 * get a listing of remote modules and exit.
77 * @return -1 for error in startup, or the result of client_run().
78 * Either way, it eventually gets passed to exit_cleanup().
80 int start_socket_client(char *host, char *path, int argc, char *argv[])
83 char *p, *user = NULL;
85 /* This is redundant with code in start_inband_exchange(), but this
86 * short-circuits a problem in the client before we open a socket,
87 * and the extra check won't hurt. */
90 "ERROR: The remote path must start with a module name not a /\n");
94 if ((p = strrchr(host, '@')) != NULL) {
100 fd = open_socket_out_wrapped(host, rsync_port, bind_address,
103 exit_cleanup(RERR_SOCKETIO);
105 set_socket_options(fd, sockopts);
107 ret = start_inband_exchange(user, path, fd, fd, argc);
109 return ret ? ret : client_run(fd, fd, -1, argc, argv);
112 int start_inband_exchange(char *user, char *path, int f_in, int f_out,
116 char *sargs[MAX_ARGS];
118 char line[BIGPATHBUFLEN];
121 if (argc == 0 && !am_sender)
126 "ERROR: The remote path must start with a module name\n");
131 user = getenv("USER");
133 user = getenv("LOGNAME");
135 io_printf(f_out, "@RSYNCD: %d\n", protocol_version);
137 if (!read_line(f_in, line, sizeof line - 1)) {
138 rprintf(FERROR, "rsync: did not see server greeting\n");
142 if (sscanf(line,"@RSYNCD: %d", &remote_protocol) != 1) {
143 /* note that read_line strips of \n or \r */
144 rprintf(FERROR, "rsync: server sent \"%s\" rather than greeting\n",
148 if (protocol_version > remote_protocol)
149 protocol_version = remote_protocol;
151 if (list_only && protocol_version >= 29)
154 /* set daemon_over_rsh to false since we need to build the
155 * true set of args passed through the rsh/ssh connection;
156 * this is a no-op for direct-socket-connection mode */
158 server_options(sargs, &sargc);
160 sargs[sargc++] = ".";
163 sargs[sargc++] = path;
168 print_child_argv(sargs);
170 p = strchr(path,'/');
172 io_printf(f_out, "%s\n", path);
175 /* Old servers may just drop the connection here,
176 rather than sending a proper EXIT command. Yuck. */
177 kluge_around_eof = list_only && protocol_version < 25 ? 1 : 0;
180 if (!read_line(f_in, line, sizeof line - 1)) {
181 rprintf(FERROR, "rsync: didn't get server startup line\n");
185 if (strncmp(line,"@RSYNCD: AUTHREQD ",18) == 0) {
186 auth_client(f_out, user, line+18);
190 if (strcmp(line,"@RSYNCD: OK") == 0)
193 if (strcmp(line,"@RSYNCD: EXIT") == 0) {
194 /* This is sent by recent versions of the
195 * server to terminate the listing of modules.
196 * We don't want to go on and transfer
197 * anything; just exit. */
201 if (strncmp(line, "@ERROR", 6) == 0) {
202 rprintf(FERROR, "%s\n", line);
203 /* This is always fatal; the server will now
204 * close the socket. */
208 rprintf(FINFO, "%s\n", line);
210 kluge_around_eof = 0;
212 for (i = 0; i < sargc; i++) {
213 io_printf(f_out, "%s\n", sargs[i]);
215 io_printf(f_out, "\n");
217 if (protocol_version < 23) {
218 if (protocol_version == 22 || !am_sender)
219 io_start_multiplex_in();
225 static char *finish_pre_exec(pid_t pid, int fd, char *request,
226 int argc, char *argv[])
231 write_buf(fd, request, strlen(request)+1);
232 for (j = 0; j < argc; j++)
233 write_buf(fd, argv[j], strlen(argv[j])+1);
240 if (wait_process(pid, &status, 0) < 0
241 || !WIFEXITED(status) || WEXITSTATUS(status) != 0) {
243 if (asprintf(&e, "pre-xfer exec returned failure (%d)\n", status) < 0)
244 out_of_memory("finish_pre_exec");
250 static int read_arg_from_pipe(int fd, char *buf, int limit)
252 char *bp = buf, *eob = buf + limit - 1;
255 if (read(fd, bp, 1) != 1)
267 static int rsync_module(int f_in, int f_out, int i, char *addr, char *host)
272 char line[BIGPATHBUFLEN];
273 uid_t uid = (uid_t)-2; /* canonically "nobody" */
274 gid_t gid = (gid_t)-2;
275 char *p, *err_msg = NULL;
276 char *name = lp_name(i);
277 int use_chroot = lp_use_chroot(i);
279 int ret, pre_exec_fd = -1;
280 pid_t pre_exec_pid = 0;
281 char *request = NULL;
283 if (!allow_access(addr, host, lp_hosts_allow(i), lp_hosts_deny(i))) {
284 rprintf(FLOG, "rsync denied on module %s from %s (%s)\n",
287 io_printf(f_out, "@ERROR: Unknown module '%s'\n", name);
290 "@ERROR: access denied to %s from %s (%s)\n",
296 if (am_daemon && am_server) {
297 rprintf(FLOG, "rsync allowed access on module %s from %s (%s)\n",
301 if (!claim_connection(lp_lock_file(i), lp_max_connections(i))) {
303 rsyserr(FLOG, errno, "failed to open lock file %s",
305 io_printf(f_out, "@ERROR: failed to open lock file\n");
307 rprintf(FLOG, "max connections (%d) reached\n",
308 lp_max_connections(i));
309 io_printf(f_out, "@ERROR: max connections (%d) reached -- try again later\n",
310 lp_max_connections(i));
315 auth_user = auth_server(f_in, f_out, i, host, addr, "@RSYNCD: AUTHREQD ");
318 io_printf(f_out, "@ERROR: auth failed on module %s\n", name);
327 if (lp_transfer_logging(i)) {
328 logfile_format = lp_log_format(i);
329 if (log_format_has(logfile_format, 'i'))
330 logfile_format_has_i = 1;
331 if (logfile_format_has_i
332 || log_format_has(logfile_format, 'o'))
333 logfile_format_has_o_or_i = 1;
336 am_root = (MY_UID() == 0);
340 if (!name_to_uid(p, &uid)) {
341 if (!isdigit(*(unsigned char *)p)) {
342 rprintf(FLOG, "Invalid uid %s\n", p);
343 io_printf(f_out, "@ERROR: invalid uid %s\n", p);
350 if (!name_to_gid(p, &gid)) {
351 if (!isdigit(*(unsigned char *)p)) {
352 rprintf(FLOG, "Invalid gid %s\n", p);
353 io_printf(f_out, "@ERROR: invalid gid %s\n", p);
360 /* TODO: If we're not root, but the configuration requests
361 * that we change to some uid other than the current one, then
364 /* TODO: Perhaps take a list of gids, and make them into the
365 * supplementary groups. */
367 if (use_chroot || (module_dirlen = strlen(lp_path(i))) == 1) {
369 set_filter_dir("/", 1);
371 set_filter_dir(lp_path(i), module_dirlen);
374 parse_rule(&server_filter_list, p, MATCHFLG_WORD_SPLIT,
377 p = lp_include_from(i);
378 parse_filter_file(&server_filter_list, p, MATCHFLG_INCLUDE,
379 XFLG_ABS_IF_SLASH | XFLG_OLD_PREFIXES | XFLG_FATAL_ERRORS);
382 parse_rule(&server_filter_list, p,
383 MATCHFLG_INCLUDE | MATCHFLG_WORD_SPLIT,
384 XFLG_ABS_IF_SLASH | XFLG_OLD_PREFIXES);
386 p = lp_exclude_from(i);
387 parse_filter_file(&server_filter_list, p, 0,
388 XFLG_ABS_IF_SLASH | XFLG_OLD_PREFIXES | XFLG_FATAL_ERRORS);
391 parse_rule(&server_filter_list, p, MATCHFLG_WORD_SPLIT,
392 XFLG_ABS_IF_SLASH | XFLG_OLD_PREFIXES);
397 if (*lp_prexfer_exec(i) || *lp_postxfer_exec(i)) {
398 char *modname, *modpath, *hostaddr, *hostname, *username;
400 if (asprintf(&modname, "RSYNC_MODULE_NAME=%s", name) < 0
401 || asprintf(&modpath, "RSYNC_MODULE_PATH=%s", lp_path(i)) < 0
402 || asprintf(&hostaddr, "RSYNC_HOST_ADDR=%s", addr) < 0
403 || asprintf(&hostname, "RSYNC_HOST_NAME=%s", host) < 0
404 || asprintf(&username, "RSYNC_USER_NAME=%s", auth_user) < 0)
405 out_of_memory("rsync_module");
412 /* For post-xfer exec, fork a new process to run the rsync
413 * daemon while this process waits for the exit status and
414 * runs the indicated command at that point. */
415 if (*lp_postxfer_exec(i)) {
418 rsyserr(FLOG, errno, "fork failed");
419 io_printf(f_out, "@ERROR: fork failed\n");
424 if (wait_process(pid, &status, 0) < 0)
426 if (asprintf(&ret1, "RSYNC_RAW_STATUS=%d", status) > 0)
428 if (WIFEXITED(status))
429 status = WEXITSTATUS(status);
432 if (asprintf(&ret2, "RSYNC_EXIT_STATUS=%d", status) > 0)
434 system(lp_postxfer_exec(i));
438 /* For pre-xfer exec, fork a child process to run the indicated
439 * command, though it first waits for the parent process to
440 * send us the user's request via a pipe. */
441 if (*lp_prexfer_exec(i)) {
443 if (pipe(fds) < 0 || (pre_exec_pid = fork()) < 0) {
444 rsyserr(FLOG, errno, "pre-xfer exec preparation failed");
445 io_printf(f_out, "@ERROR: pre-xfer exec preparation failed\n");
448 if (pre_exec_pid == 0) {
449 char buf[BIGPATHBUFLEN];
452 set_blocking(fds[0]);
453 len = read_arg_from_pipe(fds[0], buf, BIGPATHBUFLEN);
456 if (asprintf(&p, "RSYNC_REQUEST=%s", buf) < 0)
457 out_of_memory("rsync_module");
460 len = read_arg_from_pipe(fds[0], buf,
467 if (asprintf(&p, "RSYNC_ARG%d=%s", j, buf) < 0)
468 out_of_memory("rsync_module");
473 close(STDOUT_FILENO);
474 status = system(lp_prexfer_exec(i));
475 if (!WIFEXITED(status))
477 _exit(WEXITSTATUS(status));
480 set_blocking(fds[1]);
481 pre_exec_fd = fds[1];
489 * XXX: The 'use chroot' flag is a fairly reliable
490 * source of confusion, because it fails under two
491 * important circumstances: running as non-root,
492 * running on Win32 (or possibly others). On the
493 * other hand, if you are running as root, then it
494 * might be better to always use chroot.
496 * So, perhaps if we can't chroot we should just issue
497 * a warning, unless a "require chroot" flag is set,
498 * in which case we fail.
500 if (chroot(lp_path(i))) {
501 rsyserr(FLOG, errno, "chroot %s failed",
503 io_printf(f_out, "@ERROR: chroot failed\n");
507 if (!push_dir("/")) {
508 rsyserr(FLOG, errno, "chdir %s failed\n",
510 io_printf(f_out, "@ERROR: chdir failed\n");
515 if (!push_dir(lp_path(i))) {
516 rsyserr(FLOG, errno, "chdir %s failed\n",
518 io_printf(f_out, "@ERROR: chdir failed\n");
525 /* XXXX: You could argue that if the daemon is started
526 * by a non-root user and they explicitly specify a
527 * gid, then we should try to change to that gid --
528 * this could be possible if it's already in their
529 * supplementary groups. */
531 /* TODO: Perhaps we need to document that if rsyncd is
532 * started by somebody other than root it will inherit
533 * all their supplementary groups. */
536 rsyserr(FLOG, errno, "setgid %d failed", (int)gid);
537 io_printf(f_out, "@ERROR: setgid failed\n");
540 #ifdef HAVE_SETGROUPS
541 /* Get rid of any supplementary groups this process
542 * might have inheristed. */
543 if (setgroups(1, &gid)) {
544 rsyserr(FLOG, errno, "setgroups failed");
545 io_printf(f_out, "@ERROR: setgroups failed\n");
551 rsyserr(FLOG, errno, "setuid %d failed", (int)uid);
552 io_printf(f_out, "@ERROR: setuid failed\n");
556 am_root = (MY_UID() == 0);
559 if (lp_temp_dir(i) && *lp_temp_dir(i)) {
560 tmpdir = lp_temp_dir(i);
561 if (strlen(tmpdir) >= MAXPATHLEN - 10) {
563 "the 'temp dir' value for %s is WAY too long -- ignoring.\n",
569 io_printf(f_out, "@RSYNCD: OK\n");
572 if (!(argv = new_array(char *, maxargs)))
573 out_of_memory("rsync_module");
574 argv[argc++] = "rsyncd";
577 if (!read_line(f_in, line, sizeof line - 1))
585 if (argc == maxargs) {
587 if (!(argv = realloc_array(argv, char *, maxargs)))
588 out_of_memory("rsync_module");
590 if (!(argv[argc] = strdup(p)))
591 out_of_memory("rsync_module");
593 switch (start_glob) {
596 if (strcmp(line, ".") == 0)
601 err_msg = finish_pre_exec(pre_exec_pid,
611 glob_expand(name, &argv, &argc, &maxargs);
617 err_msg = finish_pre_exec(pre_exec_pid, pre_exec_fd, request,
621 verbose = 0; /* future verbosity is controlled by client options */
622 ret = parse_arguments(&argc, (const char ***) &argv, 0);
623 quiet = 0; /* Don't let someone try to be tricky. */
625 if (filesfrom_fd == 0)
630 rprintf(FLOG, "rsync %s %s from %s@%s (%s)\n",
631 am_sender ? "on" : "to",
632 request, auth_user, host, addr);
634 rprintf(FLOG, "rsync %s %s from %s (%s)\n",
635 am_sender ? "on" : "to",
636 request, host, addr);
642 /* don't allow the logs to be flooded too fast */
643 if (verbose > lp_max_verbosity(i))
644 verbose = lp_max_verbosity(i);
647 if (protocol_version < 23
648 && (protocol_version == 22 || am_sender))
649 io_start_multiplex_out();
650 else if (!ret || err_msg) {
651 /* We have to get I/O multiplexing started so that we can
652 * get the error back to the client. This means getting
653 * the protocol setup finished first in later versions. */
654 setup_protocol(f_out, f_in);
656 /* Since we failed in our option parsing, we may not
657 * have finished parsing that the client sent us a
658 * --files-from option, so look for it manually.
659 * Without this, the socket would be in the wrong
660 * state for the upcoming error message. */
663 for (i = 0; i < argc; i++) {
664 if (strncmp(argv[i], "--files-from", 12) == 0) {
671 write_byte(f_out, 0);
673 io_start_multiplex_out();
676 if (!ret || err_msg) {
678 rprintf(FERROR, err_msg);
682 exit_cleanup(RERR_UNSUPPORTED);
685 if (lp_timeout(i) && lp_timeout(i) > io_timeout)
686 set_io_timeout(lp_timeout(i));
688 /* If we have some incoming/outgoing chmod changes, append them to
689 * any user-specified changes (making our changes have priority).
690 * We also get a pointer to just our changes so that a receiver
691 * process can use them separately if --perms wasn't specified. */
693 p = lp_outgoing_chmod(i);
695 p = lp_incoming_chmod(i);
696 if (*p && !(daemon_chmod_modes = parse_chmod(p, &chmod_modes))) {
697 rprintf(FLOG, "Invalid \"%sing chmod\" directive: %s\n",
698 am_sender ? "outgo" : "incom", p);
701 start_server(f_in, f_out, argc, argv);
706 /* send a list of available modules to the client. Don't list those
707 with "list = False". */
708 static void send_listing(int fd)
710 int n = lp_numservices();
713 for (i = 0; i < n; i++) {
715 io_printf(fd, "%-15s\t%s\n", lp_name(i), lp_comment(i));
718 if (protocol_version >= 25)
719 io_printf(fd,"@RSYNCD: EXIT\n");
722 /* this is called when a connection is established to a client
723 and we want to start talking. The setup of the system is done from
725 int start_daemon(int f_in, int f_out)
728 char *motd, *addr, *host;
731 io_set_sock_fds(f_in, f_out);
733 /* We must load the config file before calling any function that
734 * might cause log-file output to occur. This ensures that the
735 * "log file" param gets honored for the 2 non-forked use-cases
736 * (when rsync is run by init and run by a remote shell). */
737 if (!lp_load(config_file, 0))
738 exit_cleanup(RERR_SYNTAX);
740 addr = client_addr(f_in);
741 host = client_name(f_in);
742 rprintf(FLOG, "connect from %s (%s)\n", host, addr);
745 set_socket_options(f_in, "SO_KEEPALIVE");
747 set_socket_options(f_in, sockopts);
749 set_socket_options(f_in, lp_socket_options());
750 set_nonblocking(f_in);
753 io_printf(f_out, "@RSYNCD: %d\n", protocol_version);
755 motd = lp_motd_file();
757 FILE *f = fopen(motd,"r");
758 while (f && !feof(f)) {
759 int len = fread(line, 1, sizeof line - 1, f);
762 io_printf(f_out, "%s", line);
767 io_printf(f_out, "\n");
770 if (!read_line(f_in, line, sizeof line - 1))
773 if (sscanf(line,"@RSYNCD: %d", &remote_protocol) != 1) {
774 io_printf(f_out, "@ERROR: protocol startup error\n");
777 if (protocol_version > remote_protocol)
778 protocol_version = remote_protocol;
781 if (!read_line(f_in, line, sizeof line - 1))
784 if (!*line || strcmp(line, "#list") == 0) {
785 rprintf(FLOG, "module-list request from %s (%s)\n",
792 /* it's some sort of command that I don't understand */
793 io_printf(f_out, "@ERROR: Unknown command '%s'\n", line);
797 if ((i = lp_number(line)) < 0) {
798 rprintf(FLOG, "unknown module '%s' tried from %s (%s)\n",
800 io_printf(f_out, "@ERROR: Unknown module '%s'\n", line);
804 #ifdef HAVE_SIGACTION
805 sigact.sa_flags = SA_NOCLDSTOP;
807 SIGACTION(SIGCHLD, remember_children);
809 return rsync_module(f_in, f_out, i, addr, host);
812 int daemon_main(void)
816 if (is_a_socket(STDIN_FILENO)) {
819 /* we are running via inetd - close off stdout and
820 * stderr so that library functions (and getopt) don't
821 * try to use them. Redirect them to /dev/null */
822 for (i = 1; i < 3; i++) {
824 open("/dev/null", O_RDWR);
827 return start_daemon(STDIN_FILENO, STDIN_FILENO);
833 if (!lp_load(config_file, 1))
834 exit_cleanup(RERR_SYNTAX);
836 if (rsync_port == 0 && (rsync_port = lp_rsync_port()) == 0)
837 rsync_port = RSYNC_PORT;
838 if (bind_address == NULL && *lp_bind_address())
839 bind_address = lp_bind_address();
843 rprintf(FLOG, "rsyncd version %s starting, listening on port %d\n",
844 RSYNC_VERSION, rsync_port);
845 /* TODO: If listening on a particular address, then show that
846 * address too. In fact, why not just do inet_ntop on the
847 * local address??? */
849 if (((pid_file = lp_pid_file()) != NULL) && (*pid_file != '\0')) {
852 pid_t pid = getpid();
853 cleanup_set_pid(pid);
854 if ((fd = do_open(lp_pid_file(), O_WRONLY|O_CREAT|O_TRUNC,
855 0666 & ~orig_umask)) == -1) {
857 rsyserr(FLOG, errno, "failed to create pid file %s",
859 exit_cleanup(RERR_FILEIO);
861 snprintf(pidbuf, sizeof pidbuf, "%ld\n", (long)pid);
862 write(fd, pidbuf, strlen(pidbuf));
866 start_accept_loop(rsync_port, start_daemon);