1 /* vi: set sw=4 ts=4: */
5 * Mini implementation of FTP to retrieve a remote file.
7 * Copyright (C) 2002 Jeff Angielski, The PTR Group <jeff@theptrgroup.com>
8 * Copyright (C) 2002 Glenn McGrath
10 * Based on wget.c by Chip Rosenthal Covad Communications
11 * <chip@laserlink.net>
13 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
15 //config:config FTPGET
16 //config: bool "ftpget (8 kb)"
19 //config: Retrieve a remote file via FTP.
21 //config:config FTPPUT
22 //config: bool "ftpput (7.7 kb)"
25 //config: Store a remote file via FTP.
27 //config:config FEATURE_FTPGETPUT_LONG_OPTIONS
28 //config: bool "Enable long options in ftpget/ftpput"
30 //config: depends on LONG_OPTS && (FTPGET || FTPPUT)
32 //applet:IF_FTPGET(APPLET_ODDNAME(ftpget, ftpgetput, BB_DIR_USR_BIN, BB_SUID_DROP, ftpget))
33 //applet:IF_FTPPUT(APPLET_ODDNAME(ftpput, ftpgetput, BB_DIR_USR_BIN, BB_SUID_DROP, ftpput))
35 //kbuild:lib-$(CONFIG_FTPGET) += ftpgetput.o
36 //kbuild:lib-$(CONFIG_FTPPUT) += ftpgetput.o
38 //usage:#define ftpget_trivial_usage
39 //usage: "[OPTIONS] HOST [LOCAL_FILE] REMOTE_FILE"
40 //usage:#define ftpget_full_usage "\n\n"
41 //usage: "Download a file via FTP\n"
42 //usage: "\n -c Continue previous transfer"
43 //usage: "\n -v Verbose"
44 //usage: "\n -u USER Username"
45 //usage: "\n -p PASS Password"
46 //usage: "\n -P NUM Port"
48 //usage:#define ftpput_trivial_usage
49 //usage: "[OPTIONS] HOST [REMOTE_FILE] LOCAL_FILE"
50 //usage:#define ftpput_full_usage "\n\n"
51 //usage: "Upload a file to a FTP server\n"
52 //usage: "\n -v Verbose"
53 //usage: "\n -u USER Username"
54 //usage: "\n -p PASS Password"
55 //usage: "\n -P NUM Port number"
58 #include "common_bufsiz.h"
63 struct len_and_sockaddr *lsa;
67 char buf[4]; /* actually [BUFSZ] */
69 #define G (*(struct globals*)bb_common_bufsiz1)
70 enum { BUFSZ = COMMON_BUFSIZE - offsetof(struct globals, buf) };
71 #define user (G.user )
72 #define password (G.password )
74 #define control_stream (G.control_stream)
75 #define verbose_flag (G.verbose_flag )
76 #define do_continue (G.do_continue )
78 #define INIT_G() do { \
79 setup_common_bufsiz(); \
80 BUILD_BUG_ON(sizeof(G) > COMMON_BUFSIZE); \
84 static void ftp_die(const char *msg) NORETURN;
85 static void ftp_die(const char *msg)
87 char *cp = buf; /* buf holds peer's response */
89 /* Guard against garbage from remote server */
90 while (*cp >= ' ' && *cp < '\x7f')
93 bb_error_msg_and_die("unexpected server response%s%s: %s",
94 (msg ? " to " : ""), (msg ? msg : ""), buf);
97 static int ftpcmd(const char *s1, const char *s2)
102 bb_error_msg("cmd %s %s", s1, s2);
106 fprintf(control_stream, (s2 ? "%s %s\r\n" : "%s %s\r\n"+3),
108 fflush(control_stream);
112 strcpy(buf, "EOF"); /* for ftp_die */
113 if (fgets(buf, BUFSZ - 2, control_stream) == NULL) {
116 } while (!isdigit(buf[0]) || buf[3] != ' ');
124 static void ftp_login(void)
126 /* Connect to the command socket */
127 control_stream = fdopen(xconnect_stream(lsa), "r+");
128 if (control_stream == NULL) {
129 /* fdopen failed - extremely unlikely */
130 bb_perror_nomsg_and_die();
133 if (ftpcmd(NULL, NULL) != 220) {
137 /* Login to the server */
138 switch (ftpcmd("USER", user)) {
142 if (ftpcmd("PASS", password) != 230) {
150 ftpcmd("TYPE I", NULL);
153 static int xconnect_ftpdata(void)
159 TODO: PASV command will not work for IPv6. RFC2428 describes
160 IPv6-capable "extended PASV" - EPSV.
162 "EPSV [protocol]" asks server to bind to and listen on a data port
163 in specified protocol. Protocol is 1 for IPv4, 2 for IPv6.
164 If not specified, defaults to "same as used for control connection".
165 If server understood you, it should answer "229 <some text>(|||port|)"
166 where "|" are literal pipe chars and "port" is ASCII decimal port#.
168 There is also an IPv6-capable replacement for PORT (EPRT),
169 but we don't need that.
171 NB: PASV may still work for some servers even over IPv6.
172 For example, vsftp happily answers
173 "227 Entering Passive Mode (0,0,0,0,n,n)" and proceeds as usual.
175 TODO2: need to stop ignoring IP address in PASV response.
178 if (ftpcmd("PASV", NULL) != 227) {
182 /* Response is "NNN garbageN1,N2,N3,N4,P1,P2[)garbage]
183 * Server's IP is N1.N2.N3.N4 (we ignore it)
184 * Server's port for data connection is P1*256+P2 */
185 buf_ptr = strrchr(buf, ')');
186 if (buf_ptr) *buf_ptr = '\0';
188 buf_ptr = strrchr(buf, ',');
190 port_num = xatoul_range(buf_ptr + 1, 0, 255);
192 buf_ptr = strrchr(buf, ',');
194 port_num += xatoul_range(buf_ptr + 1, 0, 255) * 256;
196 set_nport(&lsa->u.sa, htons(port_num));
197 return xconnect_stream(lsa);
200 static int pump_data_and_QUIT(int from, int to)
203 if (bb_copyfd_eof(from, to) == -1) {
204 /* error msg is already printed by bb_copyfd_eof */
208 /* close data connection */
209 close(from); /* don't know which one is that, so we close both */
212 /* does server confirm that transfer is finished? */
213 if (ftpcmd(NULL, NULL) != 226) {
216 ftpcmd("QUIT", NULL);
222 int ftp_receive(const char *local_path, char *server_path);
225 int ftp_receive(const char *local_path, char *server_path)
231 /* connect to the data socket */
232 fd_data = xconnect_ftpdata();
234 if (ftpcmd("SIZE", server_path) != 213) {
238 if (LONE_DASH(local_path)) {
239 fd_local = STDOUT_FILENO;
245 /* lstat would be wrong here! */
246 if (stat(local_path, &sbuf) < 0) {
247 bb_perror_msg_and_die("stat");
249 if (sbuf.st_size > 0) {
250 beg_range = sbuf.st_size;
257 sprintf(buf, "REST %"OFF_FMT"u", beg_range);
258 if (ftpcmd(buf, NULL) != 350) {
263 if (ftpcmd("RETR", server_path) > 150) {
267 /* create local file _after_ we know that remote file exists */
268 if (fd_local == -1) {
269 fd_local = xopen(local_path,
270 do_continue ? (O_APPEND | O_WRONLY)
271 : (O_CREAT | O_TRUNC | O_WRONLY)
275 return pump_data_and_QUIT(fd_data, fd_local);
280 int ftp_send(const char *server_path, char *local_path);
283 int ftp_send(const char *server_path, char *local_path)
289 /* connect to the data socket */
290 fd_data = xconnect_ftpdata();
292 /* get the local file */
293 fd_local = STDIN_FILENO;
294 if (NOT_LONE_DASH(local_path))
295 fd_local = xopen(local_path, O_RDONLY);
297 response = ftpcmd("STOR", server_path);
306 return pump_data_and_QUIT(fd_local, fd_data);
310 #if ENABLE_FEATURE_FTPGETPUT_LONG_OPTIONS
311 static const char ftpgetput_longopts[] ALIGN1 =
312 "continue\0" Required_argument "c"
313 "verbose\0" No_argument "v"
314 "username\0" Required_argument "u"
315 "password\0" Required_argument "p"
316 "port\0" Required_argument "P"
320 int ftpgetput_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
321 int ftpgetput_main(int argc UNUSED_PARAM, char **argv)
323 const char *port = "ftp";
324 /* socket to ftp server */
326 #if ENABLE_FTPPUT && !ENABLE_FTPGET
327 # define ftp_action ftp_send
328 #elif ENABLE_FTPGET && !ENABLE_FTPPUT
329 # define ftp_action ftp_receive
331 int (*ftp_action)(const char *, char *) = ftp_send;
333 /* Check to see if the command is ftpget or ftput */
334 if (applet_name[3] == 'g') {
335 ftp_action = ftp_receive;
340 /* Set default values */
342 password = "busybox@";
345 * Decipher the command line
347 /* must have 2 to 3 params; -v and -c count */
348 #define OPTSTRING "^cvu:p:P:" "\0" "-2:?3:vv:cc"
349 #if ENABLE_FEATURE_FTPGETPUT_LONG_OPTIONS
350 getopt32long(argv, OPTSTRING, ftpgetput_longopts,
352 getopt32(argv, OPTSTRING,
354 &user, &password, &port, &verbose_flag, &do_continue
358 /* We want to do exactly _one_ DNS lookup, since some
359 * sites (i.e. ftp.us.debian.org) use round-robin DNS
360 * and we want to connect to only one IP... */
361 lsa = xhost2sockaddr(argv[0], bb_lookup_port(port, "tcp", 21));
363 printf("Connecting to %s (%s)\n", argv[0],
364 xmalloc_sockaddr2dotted(&lsa->u.sa));
368 return ftp_action(argv[1], argv[2] ? argv[2] : argv[1]);