2 * scp.c - Scp (Secure Copy) client for PuTTY.
3 * Joris van Rantwijk, Simon Tatham
5 * This is mainly based on ssh-1.2.26/scp.c by Timo Rinne & Tatu Ylonen.
6 * They, in turn, used stuff from BSD rcp.
8 * (SGT, 2001-09-10: Joris van Rantwijk assures me that although
9 * this file as originally submitted was inspired by, and
10 * _structurally_ based on, ssh-1.2.26's scp.c, there wasn't any
11 * actual code duplicated, so the above comment shouldn't give rise
12 * to licensing issues.)
22 #define PUTTY_DO_GLOBALS
30 static int verbose = 0;
31 static int recursive = 0;
32 static int preserve = 0;
33 static int targetshouldbedirectory = 0;
34 static int statistics = 1;
35 static int prev_stats_len = 0;
36 static int scp_unsafe_mode = 0;
38 static int gui_mode = 0;
39 static int try_scp = 1;
40 static int try_sftp = 1;
41 static int main_cmd_is_sftp = 0;
42 static int fallback_cmd_is_sftp = 0;
43 static int using_sftp = 0;
46 static void *backhandle;
49 static void source(char *src);
50 static void rsource(char *src);
51 static void sink(char *targ, char *src);
54 * The maximum amount of queued data we accept before we stop and
55 * wait for the server to process some.
57 #define MAX_SCP_BUFSIZE 16384
59 void ldisc_send(void *handle, char *buf, int len, int interactive)
62 * This is only here because of the calls to ldisc_send(NULL,
63 * 0) in ssh.c. Nothing in PSCP actually needs to use the ldisc
64 * as an ldisc. So if we get called with any real data, I want
70 static void tell_char(FILE * stream, char c)
75 gui_send_char(stream == stderr, c);
78 static void tell_str(FILE * stream, char *str)
82 for (i = 0; i < strlen(str); ++i)
83 tell_char(stream, str[i]);
86 static void tell_user(FILE * stream, char *fmt, ...)
91 str = dupvprintf(fmt, ap);
93 str2 = dupcat(str, "\n", NULL);
95 tell_str(stream, str2);
100 * Print an error message and perform a fatal exit.
102 void fatalbox(char *fmt, ...)
107 str = dupvprintf(fmt, ap);
108 str2 = dupcat("Fatal: ", str, "\n", NULL);
111 tell_str(stderr, str2);
116 gui_send_errcount(list, errs);
120 void modalfatalbox(char *fmt, ...)
125 str = dupvprintf(fmt, ap);
126 str2 = dupcat("Fatal: ", str, "\n", NULL);
129 tell_str(stderr, str2);
134 gui_send_errcount(list, errs);
138 void connection_fatal(void *frontend, char *fmt, ...)
143 str = dupvprintf(fmt, ap);
144 str2 = dupcat("Fatal: ", str, "\n", NULL);
147 tell_str(stderr, str2);
152 gui_send_errcount(list, errs);
158 * In pscp, all agent requests should be synchronous, so this is a
161 void agent_schedule_callback(void (*callback)(void *, void *, int),
162 void *callback_ctx, void *data, int len)
164 assert(!"We shouldn't be here");
168 * Receive a block of data from the SSH link. Block until all data
171 * To do this, we repeatedly call the SSH protocol module, with our
172 * own trap in from_backend() to catch the data that comes back. We
173 * do this until we have enough data.
176 static unsigned char *outptr; /* where to put the data */
177 static unsigned outlen; /* how much data required */
178 static unsigned char *pending = NULL; /* any spare data */
179 static unsigned pendlen = 0, pendsize = 0; /* length and phys. size of buffer */
180 int from_backend(void *frontend, int is_stderr, const char *data, int datalen)
182 unsigned char *p = (unsigned char *) data;
183 unsigned len = (unsigned) datalen;
186 * stderr data is just spouted to local stderr and otherwise
191 fwrite(data, 1, len, stderr);
196 * If this is before the real session begins, just return.
201 if ((outlen > 0) && (len > 0)) {
202 unsigned used = outlen;
205 memcpy(outptr, p, used);
213 if (pendsize < pendlen + len) {
214 pendsize = pendlen + len + 4096;
215 pending = sresize(pending, pendsize, unsigned char);
217 memcpy(pending + pendlen, p, len);
223 int from_backend_untrusted(void *frontend_handle, const char *data, int len)
226 * No "untrusted" output should get here (the way the code is
227 * currently, it's all diverted by FLAG_STDERR).
229 assert(!"Unexpected call to from_backend_untrusted()");
230 return 0; /* not reached */
232 static int ssh_scp_recv(unsigned char *buf, int len)
238 * See if the pending-input block contains some of what we
242 unsigned pendused = pendlen;
243 if (pendused > outlen)
245 memcpy(outptr, pending, pendused);
246 memmove(pending, pending + pendused, pendlen - pendused);
260 if (ssh_sftp_loop_iteration() < 0)
268 * Loop through the ssh connection and authentication process.
270 static void ssh_scp_init(void)
272 while (!back->sendok(backhandle)) {
273 if (ssh_sftp_loop_iteration() < 0)
277 /* Work out which backend we ended up using. */
278 if (!ssh_fallback_cmd(backhandle))
279 using_sftp = main_cmd_is_sftp;
281 using_sftp = fallback_cmd_is_sftp;
285 tell_user(stderr, "Using SFTP");
287 tell_user(stderr, "Using SCP1");
292 * Print an error message and exit after closing the SSH link.
294 static void bump(char *fmt, ...)
299 str = dupvprintf(fmt, ap);
301 str2 = dupcat(str, "\n", NULL);
303 tell_str(stderr, str2);
307 if (back != NULL && back->socket(backhandle) != NULL) {
309 back->special(backhandle, TS_EOF);
310 ssh_scp_recv((unsigned char *) &ch, 1);
314 gui_send_errcount(list, errs);
320 * Open an SSH connection to user@host and execute cmd.
322 static void do_cmd(char *host, char *user, char *cmd)
328 if (host == NULL || host[0] == '\0')
329 bump("Empty host name");
332 * Remove fiddly bits of address: remove a colon suffix, and
333 * the square brackets around an IPv6 literal address.
335 if (host[0] == '[') {
337 host[strcspn(host, "]")] = '\0';
339 host[strcspn(host, ":")] = '\0';
343 * If we haven't loaded session details already (e.g., from -load),
344 * try looking for a session called "host".
346 if (!loaded_session) {
347 /* Try to load settings for `host' into a temporary config */
350 do_defaults(host, &cfg2);
351 if (cfg2.host[0] != '\0') {
352 /* Settings present and include hostname */
353 /* Re-load data into the real config. */
354 do_defaults(host, &cfg);
356 /* Session doesn't exist or mention a hostname. */
357 /* Use `host' as a bare hostname. */
358 strncpy(cfg.host, host, sizeof(cfg.host) - 1);
359 cfg.host[sizeof(cfg.host) - 1] = '\0';
362 /* Patch in hostname `host' to session details. */
363 strncpy(cfg.host, host, sizeof(cfg.host) - 1);
364 cfg.host[sizeof(cfg.host) - 1] = '\0';
368 * Force use of SSH. (If they got the protocol wrong we assume the
369 * port is useless too.)
371 if (cfg.protocol != PROT_SSH) {
372 cfg.protocol = PROT_SSH;
377 * Enact command-line overrides.
379 cmdline_run_saved(&cfg);
382 * Trim leading whitespace off the hostname if it's there.
385 int space = strspn(cfg.host, " \t");
386 memmove(cfg.host, cfg.host+space, 1+strlen(cfg.host)-space);
389 /* See if host is of the form user@host */
390 if (cfg.host[0] != '\0') {
391 char *atsign = strrchr(cfg.host, '@');
392 /* Make sure we're not overflowing the user field */
394 if (atsign - cfg.host < sizeof cfg.username) {
395 strncpy(cfg.username, cfg.host, atsign - cfg.host);
396 cfg.username[atsign - cfg.host] = '\0';
398 memmove(cfg.host, atsign + 1, 1 + strlen(atsign + 1));
403 * Remove any remaining whitespace from the hostname.
407 while (cfg.host[p2] != '\0') {
408 if (cfg.host[p2] != ' ' && cfg.host[p2] != '\t') {
409 cfg.host[p1] = cfg.host[p2];
418 if (user != NULL && user[0] != '\0') {
419 strncpy(cfg.username, user, sizeof(cfg.username) - 1);
420 cfg.username[sizeof(cfg.username) - 1] = '\0';
421 } else if (cfg.username[0] == '\0') {
422 user = get_username();
424 bump("Empty user name");
427 tell_user(stderr, "Guessing user name: %s", user);
428 strncpy(cfg.username, user, sizeof(cfg.username) - 1);
429 cfg.username[sizeof(cfg.username) - 1] = '\0';
435 * Disable scary things which shouldn't be enabled for simple
436 * things like SCP and SFTP: agent forwarding, port forwarding,
441 cfg.portfwd[0] = cfg.portfwd[1] = '\0';
444 * Set up main and possibly fallback command depending on
445 * options specified by user.
446 * Attempt to start the SFTP subsystem as a first choice,
447 * falling back to the provided scp command if that fails.
449 cfg.remote_cmd_ptr2 = NULL;
451 /* First choice is SFTP subsystem. */
452 main_cmd_is_sftp = 1;
453 strcpy(cfg.remote_cmd, "sftp");
454 cfg.ssh_subsys = TRUE;
456 /* Fallback is to use the provided scp command. */
457 fallback_cmd_is_sftp = 0;
458 cfg.remote_cmd_ptr2 = cmd;
459 cfg.ssh_subsys2 = FALSE;
461 /* Since we're not going to try SCP, we may as well try
462 * harder to find an SFTP server, since in the current
463 * implementation we have a spare slot. */
464 fallback_cmd_is_sftp = 1;
465 /* see psftp.c for full explanation of this kludge */
466 cfg.remote_cmd_ptr2 =
467 "test -x /usr/lib/sftp-server && exec /usr/lib/sftp-server\n"
468 "test -x /usr/local/lib/sftp-server && exec /usr/local/lib/sftp-server\n"
470 cfg.ssh_subsys2 = FALSE;
473 /* Don't try SFTP at all; just try the scp command. */
474 main_cmd_is_sftp = 0;
475 cfg.remote_cmd_ptr = cmd;
476 cfg.ssh_subsys = FALSE;
482 err = back->init(NULL, &backhandle, &cfg, cfg.host, cfg.port, &realhost,
483 0, cfg.tcp_keepalives);
485 bump("ssh_init: %s", err);
486 logctx = log_init(NULL, &cfg);
487 back->provide_logctx(backhandle, logctx);
488 console_provide_logctx(logctx);
490 if (verbose && realhost != NULL)
491 tell_user(stderr, "Connected to %s\n", realhost);
496 * Update statistic information about current file.
498 static void print_stats(char *name, unsigned long size, unsigned long done,
499 time_t start, time_t now)
508 elap = (unsigned long) difftime(now, start);
511 ratebs = (float) done / elap;
513 ratebs = (float) done;
518 eta = (unsigned long) ((size - done) / ratebs);
519 etastr = dupprintf("%02ld:%02ld:%02ld",
520 eta / 3600, (eta % 3600) / 60, eta % 60);
522 pct = (int) (100 * (done * 1.0 / size));
525 gui_update_stats(name, size, pct, elap, done, eta,
526 (unsigned long) ratebs);
528 len = printf("\r%-25.25s | %10ld kB | %5.1f kB/s | ETA: %8s | %3d%%",
529 name, done / 1024, ratebs / 1024.0, etastr, pct);
530 if (len < prev_stats_len)
531 printf("%*s", prev_stats_len - len, "");
532 prev_stats_len = len;
544 * Find a colon in str and return a pointer to the colon.
545 * This is used to separate hostname from filename.
547 static char *colon(char *str)
549 /* We ignore a leading colon, since the hostname cannot be
550 empty. We also ignore a colon as second character because
551 of filenames like f:myfile.txt. */
552 if (str[0] == '\0' || str[0] == ':' ||
553 (str[0] != '[' && str[1] == ':'))
555 while (*str != '\0' && *str != ':' && *str != '/' && *str != '\\') {
557 /* Skip over IPv6 literal addresses
558 * (eg: 'jeroen@[2001:db8::1]:myfile.txt') */
559 char *ipv6_end = strchr(str, ']');
573 * Return a pointer to the portion of str that comes after the last
574 * slash (or backslash or colon, if `local' is TRUE).
576 static char *stripslashes(char *str, int local)
581 p = strchr(str, ':');
585 p = strrchr(str, '/');
589 p = strrchr(str, '\\');
597 * Determine whether a string is entirely composed of dots.
599 static int is_dots(char *str)
601 return str[strspn(str, ".")] == '\0';
605 * Wait for a response from the other side.
606 * Return 0 if ok, -1 if error.
608 static int response(void)
610 char ch, resp, rbuf[2048];
613 if (ssh_scp_recv((unsigned char *) &resp, 1) <= 0)
614 bump("Lost connection");
624 case 2: /* fatal error */
626 if (ssh_scp_recv((unsigned char *) &ch, 1) <= 0)
627 bump("Protocol error: Lost connection");
629 } while (p < sizeof(rbuf) && ch != '\n');
632 tell_user(stderr, "%s\n", rbuf);
640 int sftp_recvdata(char *buf, int len)
642 return ssh_scp_recv((unsigned char *) buf, len);
644 int sftp_senddata(char *buf, int len)
646 back->send(backhandle, buf, len);
650 /* ----------------------------------------------------------------------
651 * sftp-based replacement for the hacky `pscp -ls'.
653 static int sftp_ls_compare(const void *av, const void *bv)
655 const struct fxp_name *a = (const struct fxp_name *) av;
656 const struct fxp_name *b = (const struct fxp_name *) bv;
657 return strcmp(a->filename, b->filename);
659 void scp_sftp_listdir(char *dirname)
661 struct fxp_handle *dirh;
662 struct fxp_names *names;
663 struct fxp_name *ournames;
664 struct sftp_packet *pktin;
665 struct sftp_request *req, *rreq;
666 int nnames, namesize;
670 tell_user(stderr, "unable to initialise SFTP: %s", fxp_error());
675 printf("Listing directory %s\n", dirname);
677 sftp_register(req = fxp_opendir_send(dirname));
678 rreq = sftp_find_request(pktin = sftp_recv());
680 dirh = fxp_opendir_recv(pktin, rreq);
683 printf("Unable to open %s: %s\n", dirname, fxp_error());
685 nnames = namesize = 0;
690 sftp_register(req = fxp_readdir_send(dirh));
691 rreq = sftp_find_request(pktin = sftp_recv());
693 names = fxp_readdir_recv(pktin, rreq);
696 if (fxp_error_type() == SSH_FX_EOF)
698 printf("Reading directory %s: %s\n", dirname, fxp_error());
701 if (names->nnames == 0) {
702 fxp_free_names(names);
706 if (nnames + names->nnames >= namesize) {
707 namesize += names->nnames + 128;
708 ournames = sresize(ournames, namesize, struct fxp_name);
711 for (i = 0; i < names->nnames; i++)
712 ournames[nnames++] = names->names[i];
713 names->nnames = 0; /* prevent free_names */
714 fxp_free_names(names);
716 sftp_register(req = fxp_close_send(dirh));
717 rreq = sftp_find_request(pktin = sftp_recv());
719 fxp_close_recv(pktin, rreq);
722 * Now we have our filenames. Sort them by actual file
723 * name, and then output the longname parts.
725 qsort(ournames, nnames, sizeof(*ournames), sftp_ls_compare);
730 for (i = 0; i < nnames; i++)
731 printf("%s\n", ournames[i].longname);
735 /* ----------------------------------------------------------------------
736 * Helper routines that contain the actual SCP protocol elements,
737 * implemented both as SCP1 and SFTP.
740 static struct scp_sftp_dirstack {
741 struct scp_sftp_dirstack *next;
742 struct fxp_name *names;
743 int namepos, namelen;
746 int matched_something; /* wildcard match set was non-empty */
747 } *scp_sftp_dirstack_head;
748 static char *scp_sftp_remotepath, *scp_sftp_currentname;
749 static char *scp_sftp_wildcard;
750 static int scp_sftp_targetisdir, scp_sftp_donethistarget;
751 static int scp_sftp_preserve, scp_sftp_recursive;
752 static unsigned long scp_sftp_mtime, scp_sftp_atime;
753 static int scp_has_times;
754 static struct fxp_handle *scp_sftp_filehandle;
755 static struct fxp_xfer *scp_sftp_xfer;
756 static uint64 scp_sftp_fileoffset;
758 int scp_source_setup(char *target, int shouldbedir)
762 * Find out whether the target filespec is in fact a
765 struct sftp_packet *pktin;
766 struct sftp_request *req, *rreq;
767 struct fxp_attrs attrs;
771 tell_user(stderr, "unable to initialise SFTP: %s", fxp_error());
776 sftp_register(req = fxp_stat_send(target));
777 rreq = sftp_find_request(pktin = sftp_recv());
779 ret = fxp_stat_recv(pktin, rreq, &attrs);
781 if (!ret || !(attrs.flags & SSH_FILEXFER_ATTR_PERMISSIONS))
782 scp_sftp_targetisdir = 0;
784 scp_sftp_targetisdir = (attrs.permissions & 0040000) != 0;
786 if (shouldbedir && !scp_sftp_targetisdir) {
787 bump("pscp: remote filespec %s: not a directory\n", target);
790 scp_sftp_remotepath = dupstr(target);
799 int scp_send_errmsg(char *str)
802 /* do nothing; we never need to send our errors to the server */
804 back->send(backhandle, "\001", 1);/* scp protocol error prefix */
805 back->send(backhandle, str, strlen(str));
807 return 0; /* can't fail */
810 int scp_send_filetimes(unsigned long mtime, unsigned long atime)
813 scp_sftp_mtime = mtime;
814 scp_sftp_atime = atime;
819 sprintf(buf, "T%lu 0 %lu 0\n", mtime, atime);
820 back->send(backhandle, buf, strlen(buf));
825 int scp_send_filename(char *name, unsigned long size, int modes)
829 struct sftp_packet *pktin;
830 struct sftp_request *req, *rreq;
832 if (scp_sftp_targetisdir) {
833 fullname = dupcat(scp_sftp_remotepath, "/", name, NULL);
835 fullname = dupstr(scp_sftp_remotepath);
838 sftp_register(req = fxp_open_send(fullname, SSH_FXF_WRITE |
839 SSH_FXF_CREAT | SSH_FXF_TRUNC));
840 rreq = sftp_find_request(pktin = sftp_recv());
842 scp_sftp_filehandle = fxp_open_recv(pktin, rreq);
844 if (!scp_sftp_filehandle) {
845 tell_user(stderr, "pscp: unable to open %s: %s",
846 fullname, fxp_error());
850 scp_sftp_fileoffset = uint64_make(0, 0);
851 scp_sftp_xfer = xfer_upload_init(scp_sftp_filehandle,
852 scp_sftp_fileoffset);
857 sprintf(buf, "C%04o %lu ", modes, size);
858 back->send(backhandle, buf, strlen(buf));
859 back->send(backhandle, name, strlen(name));
860 back->send(backhandle, "\n", 1);
865 int scp_send_filedata(char *data, int len)
869 struct sftp_packet *pktin;
871 if (!scp_sftp_filehandle) {
875 while (!xfer_upload_ready(scp_sftp_xfer)) {
877 ret = xfer_upload_gotpkt(scp_sftp_xfer, pktin);
879 tell_user(stderr, "error while writing: %s\n", fxp_error());
885 xfer_upload_data(scp_sftp_xfer, data, len);
887 scp_sftp_fileoffset = uint64_add32(scp_sftp_fileoffset, len);
890 int bufsize = back->send(backhandle, data, len);
893 * If the network transfer is backing up - that is, the
894 * remote site is not accepting data as fast as we can
895 * produce it - then we must loop on network events until
896 * we have space in the buffer again.
898 while (bufsize > MAX_SCP_BUFSIZE) {
899 if (ssh_sftp_loop_iteration() < 0)
901 bufsize = back->sendbuffer(backhandle);
908 int scp_send_finish(void)
911 struct fxp_attrs attrs;
912 struct sftp_packet *pktin;
913 struct sftp_request *req, *rreq;
916 while (!xfer_done(scp_sftp_xfer)) {
918 xfer_upload_gotpkt(scp_sftp_xfer, pktin);
920 xfer_cleanup(scp_sftp_xfer);
922 if (!scp_sftp_filehandle) {
926 attrs.flags = SSH_FILEXFER_ATTR_ACMODTIME;
927 attrs.atime = scp_sftp_atime;
928 attrs.mtime = scp_sftp_mtime;
929 sftp_register(req = fxp_fsetstat_send(scp_sftp_filehandle, attrs));
930 rreq = sftp_find_request(pktin = sftp_recv());
932 ret = fxp_fsetstat_recv(pktin, rreq);
934 tell_user(stderr, "unable to set file times: %s\n", fxp_error());
938 sftp_register(req = fxp_close_send(scp_sftp_filehandle));
939 rreq = sftp_find_request(pktin = sftp_recv());
941 fxp_close_recv(pktin, rreq);
945 back->send(backhandle, "", 1);
950 char *scp_save_remotepath(void)
953 return scp_sftp_remotepath;
958 void scp_restore_remotepath(char *data)
961 scp_sftp_remotepath = data;
964 int scp_send_dirname(char *name, int modes)
969 struct fxp_attrs attrs;
970 struct sftp_packet *pktin;
971 struct sftp_request *req, *rreq;
974 if (scp_sftp_targetisdir) {
975 fullname = dupcat(scp_sftp_remotepath, "/", name, NULL);
977 fullname = dupstr(scp_sftp_remotepath);
981 * We don't worry about whether we managed to create the
982 * directory, because if it exists already it's OK just to
983 * use it. Instead, we will stat it afterwards, and if it
984 * exists and is a directory we will assume we were either
985 * successful or it didn't matter.
987 sftp_register(req = fxp_mkdir_send(fullname));
988 rreq = sftp_find_request(pktin = sftp_recv());
990 ret = fxp_mkdir_recv(pktin, rreq);
995 err = "server reported no error";
997 sftp_register(req = fxp_stat_send(fullname));
998 rreq = sftp_find_request(pktin = sftp_recv());
1000 ret = fxp_stat_recv(pktin, rreq, &attrs);
1002 if (!ret || !(attrs.flags & SSH_FILEXFER_ATTR_PERMISSIONS) ||
1003 !(attrs.permissions & 0040000)) {
1004 tell_user(stderr, "unable to create directory %s: %s",
1010 scp_sftp_remotepath = fullname;
1015 sprintf(buf, "D%04o 0 ", modes);
1016 back->send(backhandle, buf, strlen(buf));
1017 back->send(backhandle, name, strlen(name));
1018 back->send(backhandle, "\n", 1);
1023 int scp_send_enddir(void)
1026 sfree(scp_sftp_remotepath);
1029 back->send(backhandle, "E\n", 2);
1035 * Yes, I know; I have an scp_sink_setup _and_ an scp_sink_init.
1036 * That's bad. The difference is that scp_sink_setup is called once
1037 * right at the start, whereas scp_sink_init is called to
1038 * initialise every level of recursion in the protocol.
1040 int scp_sink_setup(char *source, int preserve, int recursive)
1046 tell_user(stderr, "unable to initialise SFTP: %s", fxp_error());
1051 * It's possible that the source string we've been given
1052 * contains a wildcard. If so, we must split the directory
1053 * away from the wildcard itself (throwing an error if any
1054 * wildcardness comes before the final slash) and arrange
1055 * things so that a dirstack entry will be set up.
1057 newsource = snewn(1+strlen(source), char);
1058 if (!wc_unescape(newsource, source)) {
1059 /* Yes, here we go; it's a wildcard. Bah. */
1060 char *dupsource, *lastpart, *dirpart, *wildcard;
1061 dupsource = dupstr(source);
1062 lastpart = stripslashes(dupsource, 0);
1063 wildcard = dupstr(lastpart);
1065 if (*dupsource && dupsource[1]) {
1067 * The remains of dupsource are at least two
1068 * characters long, meaning the pathname wasn't
1069 * empty or just `/'. Hence, we remove the trailing
1072 lastpart[-1] = '\0';
1073 } else if (!*dupsource) {
1075 * The remains of dupsource are _empty_ - the whole
1076 * pathname was a wildcard. Hence we need to
1077 * replace it with ".".
1080 dupsource = dupstr(".");
1084 * Now we have separated our string into dupsource (the
1085 * directory part) and wildcard. Both of these will
1086 * need freeing at some point. Next step is to remove
1087 * wildcard escapes from the directory part, throwing
1088 * an error if it contains a real wildcard.
1090 dirpart = snewn(1+strlen(dupsource), char);
1091 if (!wc_unescape(dirpart, dupsource)) {
1092 tell_user(stderr, "%s: multiple-level wildcards unsupported",
1102 * Now we have dirpart (unescaped, ie a valid remote
1103 * path), and wildcard (a wildcard). This will be
1104 * sufficient to arrange a dirstack entry.
1106 scp_sftp_remotepath = dirpart;
1107 scp_sftp_wildcard = wildcard;
1110 scp_sftp_remotepath = newsource;
1111 scp_sftp_wildcard = NULL;
1113 scp_sftp_preserve = preserve;
1114 scp_sftp_recursive = recursive;
1115 scp_sftp_donethistarget = 0;
1116 scp_sftp_dirstack_head = NULL;
1121 int scp_sink_init(void)
1124 back->send(backhandle, "", 1);
1129 #define SCP_SINK_FILE 1
1130 #define SCP_SINK_DIR 2
1131 #define SCP_SINK_ENDDIR 3
1132 #define SCP_SINK_RETRY 4 /* not an action; just try again */
1133 struct scp_sink_action {
1134 int action; /* FILE, DIR, ENDDIR */
1135 char *buf; /* will need freeing after use */
1136 char *name; /* filename or dirname (not ENDDIR) */
1137 int mode; /* access mode (not ENDDIR) */
1138 unsigned long size; /* file size (not ENDDIR) */
1139 int settime; /* 1 if atime and mtime are filled */
1140 unsigned long atime, mtime; /* access times for the file */
1143 int scp_get_sink_action(struct scp_sink_action *act)
1147 int must_free_fname;
1148 struct fxp_attrs attrs;
1149 struct sftp_packet *pktin;
1150 struct sftp_request *req, *rreq;
1153 if (!scp_sftp_dirstack_head) {
1154 if (!scp_sftp_donethistarget) {
1156 * Simple case: we are only dealing with one file.
1158 fname = scp_sftp_remotepath;
1159 must_free_fname = 0;
1160 scp_sftp_donethistarget = 1;
1163 * Even simpler case: one file _which we've done_.
1164 * Return 1 (finished).
1170 * We're now in the middle of stepping through a list
1171 * of names returned from fxp_readdir(); so let's carry
1174 struct scp_sftp_dirstack *head = scp_sftp_dirstack_head;
1175 while (head->namepos < head->namelen &&
1176 (is_dots(head->names[head->namepos].filename) ||
1178 !wc_match(head->wildcard,
1179 head->names[head->namepos].filename))))
1180 head->namepos++; /* skip . and .. */
1181 if (head->namepos < head->namelen) {
1182 head->matched_something = 1;
1183 fname = dupcat(head->dirpath, "/",
1184 head->names[head->namepos++].filename,
1186 must_free_fname = 1;
1189 * We've come to the end of the list; pop it off
1190 * the stack and return an ENDDIR action (or RETRY
1191 * if this was a wildcard match).
1193 if (head->wildcard) {
1194 act->action = SCP_SINK_RETRY;
1195 if (!head->matched_something) {
1196 tell_user(stderr, "pscp: wildcard '%s' matched "
1197 "no files", head->wildcard);
1200 sfree(head->wildcard);
1203 act->action = SCP_SINK_ENDDIR;
1206 sfree(head->dirpath);
1208 scp_sftp_dirstack_head = head->next;
1216 * Now we have a filename. Stat it, and see if it's a file
1219 sftp_register(req = fxp_stat_send(fname));
1220 rreq = sftp_find_request(pktin = sftp_recv());
1221 assert(rreq == req);
1222 ret = fxp_stat_recv(pktin, rreq, &attrs);
1224 if (!ret || !(attrs.flags & SSH_FILEXFER_ATTR_PERMISSIONS)) {
1225 tell_user(stderr, "unable to identify %s: %s", fname,
1226 ret ? "file type not supplied" : fxp_error());
1231 if (attrs.permissions & 0040000) {
1232 struct scp_sftp_dirstack *newitem;
1233 struct fxp_handle *dirhandle;
1234 int nnames, namesize;
1235 struct fxp_name *ournames;
1236 struct fxp_names *names;
1239 * It's a directory. If we're not in recursive mode,
1240 * this merits a complaint (which is fatal if the name
1241 * was specified directly, but not if it was matched by
1244 * We skip this complaint completely if
1245 * scp_sftp_wildcard is set, because that's an
1246 * indication that we're not actually supposed to
1247 * _recursively_ transfer the dir, just scan it for
1248 * things matching the wildcard.
1250 if (!scp_sftp_recursive && !scp_sftp_wildcard) {
1251 tell_user(stderr, "pscp: %s: is a directory", fname);
1253 if (must_free_fname) sfree(fname);
1254 if (scp_sftp_dirstack_head) {
1255 act->action = SCP_SINK_RETRY;
1263 * Otherwise, the fun begins. We must fxp_opendir() the
1264 * directory, slurp the filenames into memory, return
1265 * SCP_SINK_DIR (unless this is a wildcard match), and
1266 * set targetisdir. The next time we're called, we will
1267 * run through the list of filenames one by one,
1268 * matching them against a wildcard if present.
1270 * If targetisdir is _already_ set (meaning we're
1271 * already in the middle of going through another such
1272 * list), we must push the other (target,namelist) pair
1275 sftp_register(req = fxp_opendir_send(fname));
1276 rreq = sftp_find_request(pktin = sftp_recv());
1277 assert(rreq == req);
1278 dirhandle = fxp_opendir_recv(pktin, rreq);
1281 tell_user(stderr, "scp: unable to open directory %s: %s",
1282 fname, fxp_error());
1283 if (must_free_fname) sfree(fname);
1287 nnames = namesize = 0;
1292 sftp_register(req = fxp_readdir_send(dirhandle));
1293 rreq = sftp_find_request(pktin = sftp_recv());
1294 assert(rreq == req);
1295 names = fxp_readdir_recv(pktin, rreq);
1297 if (names == NULL) {
1298 if (fxp_error_type() == SSH_FX_EOF)
1300 tell_user(stderr, "scp: reading directory %s: %s\n",
1301 fname, fxp_error());
1302 if (must_free_fname) sfree(fname);
1307 if (names->nnames == 0) {
1308 fxp_free_names(names);
1311 if (nnames + names->nnames >= namesize) {
1312 namesize += names->nnames + 128;
1313 ournames = sresize(ournames, namesize, struct fxp_name);
1315 for (i = 0; i < names->nnames; i++) {
1316 if (!strcmp(names->names[i].filename, ".") ||
1317 !strcmp(names->names[i].filename, "..")) {
1319 * . and .. are normal consequences of
1320 * reading a directory, and aren't worth
1321 * complaining about.
1323 } else if (!vet_filename(names->names[i].filename)) {
1324 tell_user(stderr, "ignoring potentially dangerous server-"
1325 "supplied filename '%s'\n",
1326 names->names[i].filename);
1328 ournames[nnames++] = names->names[i];
1330 names->nnames = 0; /* prevent free_names */
1331 fxp_free_names(names);
1333 sftp_register(req = fxp_close_send(dirhandle));
1334 rreq = sftp_find_request(pktin = sftp_recv());
1335 assert(rreq == req);
1336 fxp_close_recv(pktin, rreq);
1338 newitem = snew(struct scp_sftp_dirstack);
1339 newitem->next = scp_sftp_dirstack_head;
1340 newitem->names = ournames;
1341 newitem->namepos = 0;
1342 newitem->namelen = nnames;
1343 if (must_free_fname)
1344 newitem->dirpath = fname;
1346 newitem->dirpath = dupstr(fname);
1347 if (scp_sftp_wildcard) {
1348 newitem->wildcard = scp_sftp_wildcard;
1349 newitem->matched_something = 0;
1350 scp_sftp_wildcard = NULL;
1352 newitem->wildcard = NULL;
1354 scp_sftp_dirstack_head = newitem;
1356 if (newitem->wildcard) {
1357 act->action = SCP_SINK_RETRY;
1359 act->action = SCP_SINK_DIR;
1360 act->buf = dupstr(stripslashes(fname, 0));
1361 act->name = act->buf;
1362 act->size = 0; /* duhh, it's a directory */
1363 act->mode = 07777 & attrs.permissions;
1364 if (scp_sftp_preserve &&
1365 (attrs.flags & SSH_FILEXFER_ATTR_ACMODTIME)) {
1366 act->atime = attrs.atime;
1367 act->mtime = attrs.mtime;
1376 * It's a file. Return SCP_SINK_FILE.
1378 act->action = SCP_SINK_FILE;
1379 act->buf = dupstr(stripslashes(fname, 0));
1380 act->name = act->buf;
1381 if (attrs.flags & SSH_FILEXFER_ATTR_SIZE) {
1382 if (uint64_compare(attrs.size,
1383 uint64_make(0, ULONG_MAX)) > 0) {
1384 act->size = ULONG_MAX; /* *boggle* */
1386 act->size = attrs.size.lo;
1388 act->size = ULONG_MAX; /* no idea */
1389 act->mode = 07777 & attrs.permissions;
1390 if (scp_sftp_preserve &&
1391 (attrs.flags & SSH_FILEXFER_ATTR_ACMODTIME)) {
1392 act->atime = attrs.atime;
1393 act->mtime = attrs.mtime;
1397 if (must_free_fname)
1398 scp_sftp_currentname = fname;
1400 scp_sftp_currentname = dupstr(fname);
1415 if (ssh_scp_recv((unsigned char *) &ch, 1) <= 0)
1418 bump("Protocol error: Unexpected newline");
1422 if (ssh_scp_recv((unsigned char *) &ch, 1) <= 0)
1423 bump("Lost connection");
1426 act->buf = sresize(act->buf, bufsize, char);
1429 } while (ch != '\n');
1430 act->buf[i - 1] = '\0';
1432 case '\01': /* error */
1433 tell_user(stderr, "%s\n", act->buf);
1435 continue; /* go round again */
1436 case '\02': /* fatal error */
1437 bump("%s", act->buf);
1439 back->send(backhandle, "", 1);
1440 act->action = SCP_SINK_ENDDIR;
1443 if (sscanf(act->buf, "%ld %*d %ld %*d",
1444 &act->mtime, &act->atime) == 2) {
1446 back->send(backhandle, "", 1);
1447 continue; /* go round again */
1449 bump("Protocol error: Illegal time format");
1452 act->action = (action == 'C' ? SCP_SINK_FILE : SCP_SINK_DIR);
1455 bump("Protocol error: Expected control record");
1458 * We will go round this loop only once, unless we hit
1465 * If we get here, we must have seen SCP_SINK_FILE or
1468 if (sscanf(act->buf, "%o %lu %n", &act->mode, &act->size, &i) != 2)
1469 bump("Protocol error: Illegal file descriptor format");
1470 act->name = act->buf + i;
1475 int scp_accept_filexfer(void)
1478 struct sftp_packet *pktin;
1479 struct sftp_request *req, *rreq;
1481 sftp_register(req = fxp_open_send(scp_sftp_currentname, SSH_FXF_READ));
1482 rreq = sftp_find_request(pktin = sftp_recv());
1483 assert(rreq == req);
1484 scp_sftp_filehandle = fxp_open_recv(pktin, rreq);
1486 if (!scp_sftp_filehandle) {
1487 tell_user(stderr, "pscp: unable to open %s: %s",
1488 scp_sftp_currentname, fxp_error());
1492 scp_sftp_fileoffset = uint64_make(0, 0);
1493 scp_sftp_xfer = xfer_download_init(scp_sftp_filehandle,
1494 scp_sftp_fileoffset);
1495 sfree(scp_sftp_currentname);
1498 back->send(backhandle, "", 1);
1499 return 0; /* can't fail */
1503 int scp_recv_filedata(char *data, int len)
1506 struct sftp_packet *pktin;
1510 xfer_download_queue(scp_sftp_xfer);
1511 pktin = sftp_recv();
1512 ret = xfer_download_gotpkt(scp_sftp_xfer, pktin);
1515 tell_user(stderr, "pscp: error while reading: %s", fxp_error());
1520 if (xfer_download_data(scp_sftp_xfer, &vbuf, &actuallen)) {
1522 * This assertion relies on the fact that the natural
1523 * block size used in the xfer manager is at most that
1524 * used in this module. I don't like crossing layers in
1525 * this way, but it'll do for now.
1527 assert(actuallen <= len);
1528 memcpy(data, vbuf, actuallen);
1533 scp_sftp_fileoffset = uint64_add32(scp_sftp_fileoffset, actuallen);
1537 return ssh_scp_recv((unsigned char *) data, len);
1541 int scp_finish_filerecv(void)
1544 struct sftp_packet *pktin;
1545 struct sftp_request *req, *rreq;
1548 * Ensure that xfer_done() will work correctly, so we can
1549 * clean up any outstanding requests from the file
1552 xfer_set_error(scp_sftp_xfer);
1553 while (!xfer_done(scp_sftp_xfer)) {
1557 pktin = sftp_recv();
1558 xfer_download_gotpkt(scp_sftp_xfer, pktin);
1559 if (xfer_download_data(scp_sftp_xfer, &vbuf, &len))
1562 xfer_cleanup(scp_sftp_xfer);
1564 sftp_register(req = fxp_close_send(scp_sftp_filehandle));
1565 rreq = sftp_find_request(pktin = sftp_recv());
1566 assert(rreq == req);
1567 fxp_close_recv(pktin, rreq);
1570 back->send(backhandle, "", 1);
1575 /* ----------------------------------------------------------------------
1576 * Send an error message to the other side and to the screen.
1577 * Increment error counter.
1579 static void run_err(const char *fmt, ...)
1585 str = dupvprintf(fmt, ap);
1586 str2 = dupcat("scp: ", str, "\n", NULL);
1588 scp_send_errmsg(str2);
1589 tell_user(stderr, "%s", str2);
1595 * Execute the source part of the SCP protocol.
1597 static void source(char *src)
1600 unsigned long mtime, atime;
1605 unsigned long stat_bytes;
1606 time_t stat_starttime, stat_lasttime;
1608 attr = file_type(src);
1609 if (attr == FILE_TYPE_NONEXISTENT ||
1610 attr == FILE_TYPE_WEIRD) {
1611 run_err("%s: %s file or directory", src,
1612 (attr == FILE_TYPE_WEIRD ? "Not a" : "No such"));
1616 if (attr == FILE_TYPE_DIRECTORY) {
1619 * Avoid . and .. directories.
1622 p = strrchr(src, '/');
1624 p = strrchr(src, '\\');
1629 if (!strcmp(p, ".") || !strcmp(p, ".."))
1630 /* skip . and .. */ ;
1634 run_err("%s: not a regular file", src);
1639 if ((last = strrchr(src, '/')) == NULL)
1643 if (strrchr(last, '\\') != NULL)
1644 last = strrchr(last, '\\') + 1;
1645 if (last == src && strchr(src, ':') != NULL)
1646 last = strchr(src, ':') + 1;
1648 f = open_existing_file(src, &size, &mtime, &atime);
1650 run_err("%s: Cannot open file", src);
1654 if (scp_send_filetimes(mtime, atime))
1659 tell_user(stderr, "Sending file %s, size=%lu", last, size);
1660 if (scp_send_filename(last, size, 0644))
1664 stat_starttime = time(NULL);
1667 for (i = 0; i < size; i += 4096) {
1668 char transbuf[4096];
1673 if ((j = read_from_file(f, transbuf, k)) != k) {
1676 bump("%s: Read error", src);
1678 if (scp_send_filedata(transbuf, k))
1679 bump("%s: Network error occurred", src);
1683 if (time(NULL) != stat_lasttime || i + k == size) {
1684 stat_lasttime = time(NULL);
1685 print_stats(last, size, stat_bytes,
1686 stat_starttime, stat_lasttime);
1693 (void) scp_send_finish();
1697 * Recursively send the contents of a directory.
1699 static void rsource(char *src)
1705 if ((last = strrchr(src, '/')) == NULL)
1709 if (strrchr(last, '\\') != NULL)
1710 last = strrchr(last, '\\') + 1;
1711 if (last == src && strchr(src, ':') != NULL)
1712 last = strchr(src, ':') + 1;
1714 /* maybe send filetime */
1716 save_target = scp_save_remotepath();
1719 tell_user(stderr, "Entering directory: %s", last);
1720 if (scp_send_dirname(last, 0755))
1723 dir = open_directory(src);
1726 while ((filename = read_filename(dir)) != NULL) {
1727 char *foundfile = dupcat(src, "/", filename, NULL);
1733 close_directory(dir);
1735 (void) scp_send_enddir();
1737 scp_restore_remotepath(save_target);
1741 * Execute the sink part of the SCP protocol.
1743 static void sink(char *targ, char *src)
1750 unsigned long received;
1752 unsigned long stat_bytes;
1753 time_t stat_starttime, stat_lasttime;
1756 attr = file_type(targ);
1757 if (attr == FILE_TYPE_DIRECTORY)
1760 if (targetshouldbedirectory && !targisdir)
1761 bump("%s: Not a directory", targ);
1765 struct scp_sink_action act;
1766 if (scp_get_sink_action(&act))
1769 if (act.action == SCP_SINK_ENDDIR)
1772 if (act.action == SCP_SINK_RETRY)
1777 * Prevent the remote side from maliciously writing to
1778 * files outside the target area by sending a filename
1779 * containing `../'. In fact, it shouldn't be sending
1780 * filenames with any slashes or colons in at all; so
1781 * we'll find the last slash, backslash or colon in the
1782 * filename and use only the part after that. (And
1785 * In addition, we also ensure here that if we're
1786 * copying a single file and the target is a directory
1787 * (common usage: `pscp host:filename .') the remote
1788 * can't send us a _different_ file name. We can
1789 * distinguish this case because `src' will be non-NULL
1790 * and the last component of that will fail to match
1791 * (the last component of) the name sent.
1793 * Well, not always; if `src' is a wildcard, we do
1794 * expect to get back filenames that don't correspond
1795 * exactly to it. Ideally in this case, we would like
1796 * to ensure that the returned filename actually
1797 * matches the wildcard pattern - but one of SCP's
1798 * protocol infelicities is that wildcard matching is
1799 * done at the server end _by the server's rules_ and
1800 * so in general this is infeasible. Hence, we only
1801 * accept filenames that don't correspond to `src' if
1802 * unsafe mode is enabled or we are using SFTP (which
1803 * resolves remote wildcards on the client side and can
1806 char *striptarget, *stripsrc;
1808 striptarget = stripslashes(act.name, 1);
1809 if (striptarget != act.name) {
1810 tell_user(stderr, "warning: remote host sent a compound"
1811 " pathname '%s'", act.name);
1812 tell_user(stderr, " renaming local file to '%s'",
1817 * Also check to see if the target filename is '.' or
1818 * '..', or indeed '...' and so on because Windows
1819 * appears to interpret those like '..'.
1821 if (is_dots(striptarget)) {
1822 bump("security violation: remote host attempted to write to"
1823 " a '.' or '..' path!");
1827 stripsrc = stripslashes(src, 1);
1828 if (strcmp(striptarget, stripsrc) &&
1829 !using_sftp && !scp_unsafe_mode) {
1830 tell_user(stderr, "warning: remote host tried to write "
1831 "to a file called '%s'", striptarget);
1832 tell_user(stderr, " when we requested a file "
1833 "called '%s'.", stripsrc);
1834 tell_user(stderr, " If this is a wildcard, "
1835 "consider upgrading to SSH-2 or using");
1836 tell_user(stderr, " the '-unsafe' option. Renaming"
1837 " of this file has been disallowed.");
1838 /* Override the name the server provided with our own. */
1839 striptarget = stripsrc;
1843 if (targ[0] != '\0')
1844 destfname = dir_file_cat(targ, striptarget);
1846 destfname = dupstr(striptarget);
1849 * In this branch of the if, the target area is a
1850 * single file with an explicitly specified name in any
1851 * case, so there's no danger.
1853 destfname = dupstr(targ);
1855 attr = file_type(destfname);
1856 exists = (attr != FILE_TYPE_NONEXISTENT);
1858 if (act.action == SCP_SINK_DIR) {
1859 if (exists && attr != FILE_TYPE_DIRECTORY) {
1860 run_err("%s: Not a directory", destfname);
1864 if (!create_directory(destfname)) {
1865 run_err("%s: Cannot create directory", destfname);
1869 sink(destfname, NULL);
1870 /* can we set the timestamp for directories ? */
1874 f = open_new_file(destfname);
1876 run_err("%s: Cannot create file", destfname);
1880 if (scp_accept_filexfer())
1884 stat_starttime = time(NULL);
1886 stat_name = stripslashes(destfname, 1);
1889 while (received < act.size) {
1890 char transbuf[4096];
1891 unsigned long blksize;
1894 if (blksize > (act.size - received))
1895 blksize = act.size - received;
1896 read = scp_recv_filedata(transbuf, (int)blksize);
1898 bump("Lost connection");
1901 if (write_to_file(f, transbuf, read) != (int)read) {
1903 /* FIXME: in sftp we can actually abort the transfer */
1905 printf("\r%-25.25s | %50s\n",
1907 "Write error.. waiting for end of file");
1912 if (time(NULL) > stat_lasttime ||
1913 received + read == act.size) {
1914 stat_lasttime = time(NULL);
1915 print_stats(stat_name, act.size, stat_bytes,
1916 stat_starttime, stat_lasttime);
1922 set_file_times(f, act.mtime, act.atime);
1927 run_err("%s: Write error", destfname);
1930 (void) scp_finish_filerecv();
1937 * We will copy local files to a remote server.
1939 static void toremote(int argc, char *argv[])
1941 char *src, *targ, *host, *user;
1945 targ = argv[argc - 1];
1947 /* Separate host from filename */
1951 bump("targ == NULL in toremote()");
1955 /* Substitute "." for empty target */
1957 /* Separate host and username */
1959 host = strrchr(host, '@');
1970 if (colon(argv[0]) != NULL)
1971 bump("%s: Remote to remote not supported", argv[0]);
1973 wc_type = test_wildcard(argv[0], 1);
1974 if (wc_type == WCTYPE_NONEXISTENT)
1975 bump("%s: No such file or directory\n", argv[0]);
1976 else if (wc_type == WCTYPE_WILDCARD)
1977 targetshouldbedirectory = 1;
1980 cmd = dupprintf("scp%s%s%s%s -t %s",
1981 verbose ? " -v" : "",
1982 recursive ? " -r" : "",
1983 preserve ? " -p" : "",
1984 targetshouldbedirectory ? " -d" : "", targ);
1985 do_cmd(host, user, cmd);
1988 if (scp_source_setup(targ, targetshouldbedirectory))
1991 for (i = 0; i < argc - 1; i++) {
1993 if (colon(src) != NULL) {
1994 tell_user(stderr, "%s: Remote to remote not supported\n", src);
1999 wc_type = test_wildcard(src, 1);
2000 if (wc_type == WCTYPE_NONEXISTENT) {
2001 run_err("%s: No such file or directory", src);
2003 } else if (wc_type == WCTYPE_FILENAME) {
2007 WildcardMatcher *wc;
2010 wc = begin_wildcard_matching(src);
2012 run_err("%s: No such file or directory", src);
2016 while ((filename = wildcard_get_filename(wc)) != NULL) {
2021 finish_wildcard_matching(wc);
2027 * We will copy files from a remote server to the local machine.
2029 static void tolocal(int argc, char *argv[])
2031 char *src, *targ, *host, *user;
2035 bump("More than one remote source not supported");
2040 /* Separate host from filename */
2044 bump("Local to local copy not supported");
2048 /* Substitute "." for empty filename */
2050 /* Separate username and hostname */
2052 host = strrchr(host, '@');
2062 cmd = dupprintf("scp%s%s%s%s -f %s",
2063 verbose ? " -v" : "",
2064 recursive ? " -r" : "",
2065 preserve ? " -p" : "",
2066 targetshouldbedirectory ? " -d" : "", src);
2067 do_cmd(host, user, cmd);
2070 if (scp_sink_setup(src, preserve, recursive))
2077 * We will issue a list command to get a remote directory.
2079 static void get_dir_list(int argc, char *argv[])
2081 char *src, *host, *user;
2087 /* Separate host from filename */
2091 bump("Local to local copy not supported");
2095 /* Substitute "." for empty filename */
2097 /* Separate username and hostname */
2099 host = strrchr(host, '@');
2109 cmd = snewn(4 * strlen(src) + 100, char);
2110 strcpy(cmd, "ls -la '");
2111 p = cmd + strlen(cmd);
2112 for (q = src; *q; q++) {
2125 do_cmd(host, user, cmd);
2129 scp_sftp_listdir(src);
2131 while (ssh_scp_recv((unsigned char *) &c, 1) > 0)
2132 tell_char(stdout, c);
2137 * Short description of parameters.
2139 static void usage(void)
2141 printf("PuTTY Secure Copy client\n");
2142 printf("%s\n", ver);
2143 printf("Usage: pscp [options] [user@]host:source target\n");
2145 (" pscp [options] source [source...] [user@]host:target\n");
2146 printf(" pscp [options] -ls [user@]host:filespec\n");
2147 printf("Options:\n");
2148 printf(" -V print version information and exit\n");
2149 printf(" -pgpfp print PGP key fingerprints and exit\n");
2150 printf(" -p preserve file attributes\n");
2151 printf(" -q quiet, don't show statistics\n");
2152 printf(" -r copy directories recursively\n");
2153 printf(" -v show verbose messages\n");
2154 printf(" -load sessname Load settings from saved session\n");
2155 printf(" -P port connect to specified port\n");
2156 printf(" -l user connect with specified username\n");
2157 printf(" -pw passw login with specified password\n");
2158 printf(" -1 -2 force use of particular SSH protocol version\n");
2159 printf(" -4 -6 force use of IPv4 or IPv6\n");
2160 printf(" -C enable compression\n");
2161 printf(" -i key private key file for authentication\n");
2162 printf(" -noagent disable use of Pageant\n");
2163 printf(" -agent enable use of Pageant\n");
2164 printf(" -batch disable all interactive prompts\n");
2165 printf(" -unsafe allow server-side wildcards (DANGEROUS)\n");
2166 printf(" -sftp force use of SFTP protocol\n");
2167 printf(" -scp force use of SCP protocol\n");
2170 * -gui is an internal option, used by GUI front ends to get
2171 * pscp to pass progress reports back to them. It's not an
2172 * ordinary user-accessible option, so it shouldn't be part of
2173 * the command-line help. The only people who need to know
2174 * about it are programmers, and they can read the source.
2177 (" -gui hWnd GUI mode with the windows handle for receiving messages\n");
2184 printf("pscp: %s\n", ver);
2188 void cmdline_error(char *p, ...)
2191 fprintf(stderr, "pscp: ");
2193 vfprintf(stderr, p, ap);
2195 fprintf(stderr, "\n try typing just \"pscp\" for help\n");
2200 * Main program. (Called `psftp_main' because it gets called from
2201 * *sftp.c; bit silly, I know, but it had to be called _something_.)
2203 int psftp_main(int argc, char *argv[])
2207 default_protocol = PROT_TELNET;
2210 #ifdef FLAG_SYNCAGENT
2214 cmdline_tooltype = TOOLTYPE_FILETRANSFER;
2217 /* Load Default Settings before doing anything else. */
2218 do_defaults(NULL, &cfg);
2219 loaded_session = FALSE;
2221 for (i = 1; i < argc; i++) {
2223 if (argv[i][0] != '-')
2225 ret = cmdline_process_param(argv[i], i+1<argc?argv[i+1]:NULL, 1, &cfg);
2227 cmdline_error("option \"%s\" requires an argument", argv[i]);
2228 } else if (ret == 2) {
2229 i++; /* skip next argument */
2230 } else if (ret == 1) {
2231 /* We have our own verbosity in addition to `flags'. */
2232 if (flags & FLAG_VERBOSE)
2234 } else if (strcmp(argv[i], "-pgpfp") == 0) {
2237 } else if (strcmp(argv[i], "-r") == 0) {
2239 } else if (strcmp(argv[i], "-p") == 0) {
2241 } else if (strcmp(argv[i], "-q") == 0) {
2243 } else if (strcmp(argv[i], "-h") == 0 || strcmp(argv[i], "-?") == 0) {
2245 } else if (strcmp(argv[i], "-V") == 0) {
2247 } else if (strcmp(argv[i], "-gui") == 0 && i + 1 < argc) {
2248 gui_enable(argv[++i]);
2250 console_batch_mode = TRUE;
2251 } else if (strcmp(argv[i], "-ls") == 0) {
2253 } else if (strcmp(argv[i], "-batch") == 0) {
2254 console_batch_mode = 1;
2255 } else if (strcmp(argv[i], "-unsafe") == 0) {
2256 scp_unsafe_mode = 1;
2257 } else if (strcmp(argv[i], "-sftp") == 0) {
2258 try_scp = 0; try_sftp = 1;
2259 } else if (strcmp(argv[i], "-scp") == 0) {
2260 try_scp = 1; try_sftp = 0;
2261 } else if (strcmp(argv[i], "--") == 0) {
2265 cmdline_error("unknown option \"%s\"", argv[i]);
2275 get_dir_list(argc, argv);
2282 targetshouldbedirectory = 1;
2284 if (colon(argv[argc - 1]) != NULL)
2285 toremote(argc, argv);
2287 tolocal(argc, argv);
2290 if (back != NULL && back->socket(backhandle) != NULL) {
2292 back->special(backhandle, TS_EOF);
2293 ssh_scp_recv((unsigned char *) &ch, 1);
2298 gui_send_errcount(list, errs);
2301 console_provide_logctx(NULL);
2302 back->free(backhandle);
2306 return (errs == 0 ? 0 : 1);