1 /***************************************************************************
3 * Project ___| | | | _ \| |
5 * | (__| |_| | _ <| |___
6 * \___|\___/|_| \_\_____|
8 * Copyright (C) 1998 - 2011, Daniel Stenberg, <daniel@haxx.se>, et al.
10 * This software is licensed as described in the file COPYING, which
11 * you should have received as part of this distribution. The terms
12 * are also available at http://curl.haxx.se/docs/copyright.html.
14 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 * copies of the Software, and permit persons to whom the Software is
16 * furnished to do so, under the terms of the COPYING file.
18 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 * KIND, either express or implied.
21 ***************************************************************************/
25 #ifndef CURL_DISABLE_FTP
36 #ifdef HAVE_SYS_SOCKET_H
37 #include <sys/socket.h>
39 #ifdef HAVE_NETINET_IN_H
40 #include <netinet/in.h>
42 #ifdef HAVE_ARPA_INET_H
43 #include <arpa/inet.h>
46 #include <sys/utsname.h>
56 #if (defined(NETWARE) && defined(__NOVELL_LIBC__))
58 #define in_addr_t unsigned long
61 #include <curl/curl.h>
69 #include "http.h" /* for HTTP proxy tunnel stuff */
73 #include "ftplistparser.h"
75 #if defined(HAVE_KRB4) || defined(HAVE_GSSAPI)
79 #include "strtoofft.h"
84 #include "inet_ntop.h"
85 #include "inet_pton.h"
87 #include "parsedate.h" /* for the week day and month names */
88 #include "sockaddr.h" /* required for Curl_sockaddr_storage */
92 #include "speedcheck.h"
94 #include "http_proxy.h"
95 #include "non-ascii.h"
97 #define _MPRINTF_REPLACE /* use our functions only */
98 #include <curl/mprintf.h>
100 #include "curl_memory.h"
101 /* The last #include file should be: */
102 #include "memdebug.h"
105 #define NI_MAXHOST 1025
107 #ifndef INET_ADDRSTRLEN
108 #define INET_ADDRSTRLEN 16
111 #ifdef CURL_DISABLE_VERBOSE_STRINGS
112 #define ftp_pasv_verbose(a,b,c,d) do { } while(0)
115 /* Local API functions */
116 static CURLcode ftp_sendquote(struct connectdata *conn,
117 struct curl_slist *quote);
118 static CURLcode ftp_quit(struct connectdata *conn);
119 static CURLcode ftp_parse_url_path(struct connectdata *conn);
120 static CURLcode ftp_regular_transfer(struct connectdata *conn, bool *done);
121 #ifndef CURL_DISABLE_VERBOSE_STRINGS
122 static void ftp_pasv_verbose(struct connectdata *conn,
124 char *newhost, /* ascii version */
127 static CURLcode ftp_state_post_rest(struct connectdata *conn);
128 static CURLcode ftp_state_post_cwd(struct connectdata *conn);
129 static CURLcode ftp_state_quote(struct connectdata *conn,
130 bool init, ftpstate instate);
131 static CURLcode ftp_nb_type(struct connectdata *conn,
132 bool ascii, ftpstate newstate);
133 static int ftp_need_type(struct connectdata *conn,
135 static CURLcode ftp_do(struct connectdata *conn, bool *done);
136 static CURLcode ftp_done(struct connectdata *conn,
137 CURLcode, bool premature);
138 static CURLcode ftp_connect(struct connectdata *conn, bool *done);
139 static CURLcode ftp_disconnect(struct connectdata *conn, bool dead_connection);
140 static CURLcode ftp_nextconnect(struct connectdata *conn);
141 static CURLcode ftp_multi_statemach(struct connectdata *conn, bool *done);
142 static int ftp_getsock(struct connectdata *conn,
143 curl_socket_t *socks,
145 static CURLcode ftp_doing(struct connectdata *conn,
147 static CURLcode ftp_setup_connection(struct connectdata * conn);
149 static CURLcode init_wc_data(struct connectdata *conn);
150 static CURLcode wc_statemach(struct connectdata *conn);
152 static void wc_data_dtor(void *ptr);
154 static CURLcode ftp_state_post_retr_size(struct connectdata *conn,
155 curl_off_t filesize);
157 /* easy-to-use macro: */
158 #define FTPSENDF(x,y,z) if((result = Curl_ftpsendf(x,y,z)) != CURLE_OK) \
160 #define PPSENDF(x,y,z) if((result = Curl_pp_sendf(x,y,z)) != CURLE_OK) \
165 * FTP protocol handler.
168 const struct Curl_handler Curl_handler_ftp = {
170 ftp_setup_connection, /* setup_connection */
173 ftp_nextconnect, /* do_more */
174 ftp_connect, /* connect_it */
175 ftp_multi_statemach, /* connecting */
176 ftp_doing, /* doing */
177 ftp_getsock, /* proto_getsock */
178 ftp_getsock, /* doing_getsock */
179 ZERO_NULL, /* perform_getsock */
180 ftp_disconnect, /* disconnect */
181 ZERO_NULL, /* readwrite */
182 PORT_FTP, /* defport */
183 CURLPROTO_FTP, /* protocol */
184 PROTOPT_DUAL | PROTOPT_CLOSEACTION | PROTOPT_NEEDSPWD /* flags */
190 * FTPS protocol handler.
193 const struct Curl_handler Curl_handler_ftps = {
195 ftp_setup_connection, /* setup_connection */
198 ftp_nextconnect, /* do_more */
199 ftp_connect, /* connect_it */
200 ftp_multi_statemach, /* connecting */
201 ftp_doing, /* doing */
202 ftp_getsock, /* proto_getsock */
203 ftp_getsock, /* doing_getsock */
204 ZERO_NULL, /* perform_getsock */
205 ftp_disconnect, /* disconnect */
206 ZERO_NULL, /* readwrite */
207 PORT_FTPS, /* defport */
208 CURLPROTO_FTP | CURLPROTO_FTPS, /* protocol */
209 PROTOPT_SSL | PROTOPT_DUAL | PROTOPT_CLOSEACTION |
210 PROTOPT_NEEDSPWD /* flags */
214 #ifndef CURL_DISABLE_HTTP
216 * HTTP-proxyed FTP protocol handler.
219 static const struct Curl_handler Curl_handler_ftp_proxy = {
221 ZERO_NULL, /* setup_connection */
222 Curl_http, /* do_it */
223 Curl_http_done, /* done */
224 ZERO_NULL, /* do_more */
225 ZERO_NULL, /* connect_it */
226 ZERO_NULL, /* connecting */
227 ZERO_NULL, /* doing */
228 ZERO_NULL, /* proto_getsock */
229 ZERO_NULL, /* doing_getsock */
230 ZERO_NULL, /* perform_getsock */
231 ZERO_NULL, /* disconnect */
232 ZERO_NULL, /* readwrite */
233 PORT_FTP, /* defport */
234 CURLPROTO_HTTP, /* protocol */
235 PROTOPT_NONE /* flags */
241 * HTTP-proxyed FTPS protocol handler.
244 static const struct Curl_handler Curl_handler_ftps_proxy = {
246 ZERO_NULL, /* setup_connection */
247 Curl_http, /* do_it */
248 Curl_http_done, /* done */
249 ZERO_NULL, /* do_more */
250 ZERO_NULL, /* connect_it */
251 ZERO_NULL, /* connecting */
252 ZERO_NULL, /* doing */
253 ZERO_NULL, /* proto_getsock */
254 ZERO_NULL, /* doing_getsock */
255 ZERO_NULL, /* perform_getsock */
256 ZERO_NULL, /* disconnect */
257 ZERO_NULL, /* readwrite */
258 PORT_FTPS, /* defport */
259 CURLPROTO_HTTP, /* protocol */
260 PROTOPT_NONE /* flags */
267 * NOTE: back in the old days, we added code in the FTP code that made NOBODY
268 * requests on files respond with headers passed to the client/stdout that
269 * looked like HTTP ones.
271 * This approach is not very elegant, it causes confusion and is error-prone.
272 * It is subject for removal at the next (or at least a future) soname bump.
273 * Until then you can test the effects of the removal by undefining the
274 * following define named CURL_FTP_HTTPSTYLE_HEAD.
276 #define CURL_FTP_HTTPSTYLE_HEAD 1
278 static void freedirs(struct ftp_conn *ftpc)
282 for(i=0; i < ftpc->dirdepth; i++){
298 /* Returns non-zero if the given string contains CR (\r) or LF (\n),
299 which are not allowed within RFC 959 <string>.
300 Note: The input string is in the client's encoding which might
301 not be ASCII, so escape sequences \r & \n must be used instead
302 of hex values 0x0d & 0x0a.
304 static bool isBadFtpString(const char *string)
306 return (bool)((NULL != strchr(string, '\r')) ||
307 (NULL != strchr(string, '\n')));
310 /***********************************************************************
312 * AllowServerConnect()
314 * When we've issue the PORT command, we have told the server to connect
315 * to us. This function will sit and wait here until the server has
319 static CURLcode AllowServerConnect(struct connectdata *conn)
321 struct SessionHandle *data = conn->data;
322 curl_socket_t sock = conn->sock[SECONDARYSOCKET];
325 curl_socket_t s = CURL_SOCKET_BAD;
327 struct Curl_sockaddr_storage add;
329 struct sockaddr_in add;
331 curl_socklen_t size = (curl_socklen_t) sizeof(add);
334 timeout_ms = Curl_timeleft(data, NULL, TRUE);
337 /* if a timeout was already reached, bail out */
338 failf(data, "Timeout while waiting for server connect");
339 return CURLE_OPERATION_TIMEDOUT;
342 interval_ms = 1000; /* use 1 second timeout intervals */
343 if(timeout_ms < interval_ms)
344 interval_ms = timeout_ms;
346 switch (Curl_socket_ready(sock, CURL_SOCKET_BAD, (int)interval_ms)) {
349 failf(data, "Error while waiting for server connect");
350 return CURLE_FTP_PORT_FAILED;
351 case 0: /* timeout */
354 /* we have received data here */
355 if(0 == getsockname(sock, (struct sockaddr *) &add, &size)) {
358 s=accept(sock, (struct sockaddr *) &add, &size);
360 sclose(sock); /* close the first socket */
362 if(CURL_SOCKET_BAD == s) {
363 failf(data, "Error accept()ing server connect");
364 return CURLE_FTP_PORT_FAILED;
366 infof(data, "Connection accepted from server\n");
368 conn->sock[SECONDARYSOCKET] = s;
369 curlx_nonblock(s, TRUE); /* enable non-blocking */
373 /* never reaches this point */
376 /* macro to check for a three-digit ftp status code at the start of the
378 #define STATUSCODE(line) (ISDIGIT(line[0]) && ISDIGIT(line[1]) && \
381 /* macro to check for the last line in an FTP server response */
382 #define LASTLINE(line) (STATUSCODE(line) && (' ' == line[3]))
384 static int ftp_endofresp(struct pingpong *pp,
387 char *line = pp->linestart_resp;
388 size_t len = pp->nread_resp;
390 if((len > 3) && LASTLINE(line)) {
391 *code = curlx_sltosi(strtol(line, NULL, 10));
397 static CURLcode ftp_readresp(curl_socket_t sockfd,
399 int *ftpcode, /* return the ftp-code if done */
400 size_t *size) /* size of the response */
402 struct connectdata *conn = pp->conn;
403 #if defined(HAVE_KRB4) || defined(HAVE_GSSAPI)
404 struct SessionHandle *data = conn->data;
405 char * const buf = data->state.buffer;
407 CURLcode result = CURLE_OK;
410 result = Curl_pp_readresp(sockfd, pp, &code, size);
412 #if defined(HAVE_KRB4) || defined(HAVE_GSSAPI)
413 /* handle the security-oriented responses 6xx ***/
414 /* FIXME: some errorchecking perhaps... ***/
417 code = Curl_sec_read_msg(conn, buf, PROT_SAFE);
420 code = Curl_sec_read_msg(conn, buf, PROT_PRIVATE);
423 code = Curl_sec_read_msg(conn, buf, PROT_CONFIDENTIAL);
426 /* normal ftp stuff we pass through! */
431 /* store the latest code for later retrieval */
432 conn->data->info.httpcode=code;
438 /* 421 means "Service not available, closing control connection." and FTP
439 * servers use it to signal that idle session timeout has been exceeded.
440 * If we ignored the response, it could end up hanging in some cases. */
441 return CURLE_OPERATION_TIMEDOUT;
446 /* --- parse FTP server responses --- */
449 * Curl_GetFTPResponse() is a BLOCKING function to read the full response
450 * from a server after a command.
454 CURLcode Curl_GetFTPResponse(ssize_t *nreadp, /* return number of bytes read */
455 struct connectdata *conn,
456 int *ftpcode) /* return the ftp-code */
459 * We cannot read just one byte per read() and then go back to select() as
460 * the OpenSSL read() doesn't grok that properly.
462 * Alas, read as much as possible, split up into lines, use the ending
463 * line in a response or continue reading. */
465 curl_socket_t sockfd = conn->sock[FIRSTSOCKET];
466 long timeout; /* timeout in milliseconds */
468 struct SessionHandle *data = conn->data;
469 CURLcode result = CURLE_OK;
470 struct ftp_conn *ftpc = &conn->proto.ftpc;
471 struct pingpong *pp = &ftpc->pp;
474 int value_to_be_ignored=0;
477 *ftpcode = 0; /* 0 for errors */
479 /* make the pointer point to something for the rest of this function */
480 ftpcode = &value_to_be_ignored;
484 while(!*ftpcode && !result) {
485 /* check and reset timeout value every lap */
486 timeout = Curl_pp_state_timeout(pp);
489 failf(data, "FTP response timeout");
490 return CURLE_OPERATION_TIMEDOUT; /* already too little time */
493 interval_ms = 1000; /* use 1 second timeout intervals */
494 if(timeout < interval_ms)
495 interval_ms = timeout;
498 * Since this function is blocking, we need to wait here for input on the
499 * connection and only then we call the response reading function. We do
500 * timeout at least every second to make the timeout check run.
502 * A caution here is that the ftp_readresp() function has a cache that may
503 * contain pieces of a response from the previous invoke and we need to
504 * make sure we don't just wait for input while there is unhandled data in
505 * that cache. But also, if the cache is there, we call ftp_readresp() and
506 * the cache wasn't good enough to continue we must not just busy-loop
507 * around this function.
511 if(pp->cache && (cache_skip < 2)) {
513 * There's a cache left since before. We then skipping the wait for
514 * socket action, unless this is the same cache like the previous round
515 * as then the cache was deemed not enough to act on and we then need to
516 * wait for more data anyway.
520 switch (Curl_socket_ready(sockfd, CURL_SOCKET_BAD, (int)interval_ms)) {
521 case -1: /* select() error, stop reading */
522 failf(data, "FTP response aborted due to select/poll error: %d",
524 return CURLE_RECV_ERROR;
526 case 0: /* timeout */
527 if(Curl_pgrsUpdate(conn))
528 return CURLE_ABORTED_BY_CALLBACK;
529 continue; /* just continue in our loop for the timeout duration */
531 default: /* for clarity */
535 result = ftp_readresp(sockfd, pp, ftpcode, &nread);
539 if(!nread && pp->cache)
540 /* bump cache skip counter as on repeated skips we must wait for more
544 /* when we got data or there is no cache left, we reset the cache skip
550 } /* while there's buffer left and loop is requested */
552 pp->pending_resp = FALSE;
557 /* This is the ONLY way to change FTP state! */
558 static void state(struct connectdata *conn,
561 #if defined(DEBUGBUILD) && !defined(CURL_DISABLE_VERBOSE_STRINGS)
562 /* for debug purposes */
563 static const char * const names[]={
601 struct ftp_conn *ftpc = &conn->proto.ftpc;
602 #if defined(DEBUGBUILD) && !defined(CURL_DISABLE_VERBOSE_STRINGS)
603 if(ftpc->state != newstate)
604 infof(conn->data, "FTP %p state change from %s to %s\n",
605 ftpc, names[ftpc->state], names[newstate]);
607 ftpc->state = newstate;
610 static CURLcode ftp_state_user(struct connectdata *conn)
613 struct FTP *ftp = conn->data->state.proto.ftp;
615 PPSENDF(&conn->proto.ftpc.pp, "USER %s", ftp->user?ftp->user:"");
617 state(conn, FTP_USER);
618 conn->data->state.ftp_trying_alternative = FALSE;
623 static CURLcode ftp_state_pwd(struct connectdata *conn)
627 /* send PWD to discover our entry point */
628 PPSENDF(&conn->proto.ftpc.pp, "PWD", NULL);
629 state(conn, FTP_PWD);
634 /* For the FTP "protocol connect" and "doing" phases only */
635 static int ftp_getsock(struct connectdata *conn,
636 curl_socket_t *socks,
639 return Curl_pp_getsock(&conn->proto.ftpc.pp, socks, numsocks);
642 /* This is called after the FTP_QUOTE state is passed.
644 ftp_state_cwd() sends the range of CWD commands to the server to change to
645 the correct directory. It may also need to send MKD commands to create
646 missing ones, if that option is enabled.
648 static CURLcode ftp_state_cwd(struct connectdata *conn)
650 CURLcode result = CURLE_OK;
651 struct ftp_conn *ftpc = &conn->proto.ftpc;
654 /* already done and fine */
655 result = ftp_state_post_cwd(conn);
657 ftpc->count2 = 0; /* count2 counts failed CWDs */
659 /* count3 is set to allow a MKD to fail once. In the case when first CWD
660 fails and then MKD fails (due to another session raced it to create the
661 dir) this then allows for a second try to CWD to it */
662 ftpc->count3 = (conn->data->set.ftp_create_missing_dirs==2)?1:0;
664 if(conn->bits.reuse && ftpc->entrypath) {
665 /* This is a re-used connection. Since we change directory to where the
666 transfer is taking place, we must first get back to the original dir
667 where we ended up after login: */
668 ftpc->count1 = 0; /* we count this as the first path, then we add one
669 for all upcoming ones in the ftp->dirs[] array */
670 PPSENDF(&conn->proto.ftpc.pp, "CWD %s", ftpc->entrypath);
671 state(conn, FTP_CWD);
676 /* issue the first CWD, the rest is sent when the CWD responses are
678 PPSENDF(&conn->proto.ftpc.pp, "CWD %s", ftpc->dirs[ftpc->count1 -1]);
679 state(conn, FTP_CWD);
682 /* No CWD necessary */
683 result = ftp_state_post_cwd(conn);
696 static CURLcode ftp_state_use_port(struct connectdata *conn,
697 ftpport fcmd) /* start with this */
700 CURLcode result = CURLE_OK;
701 struct ftp_conn *ftpc = &conn->proto.ftpc;
702 struct SessionHandle *data=conn->data;
703 curl_socket_t portsock= CURL_SOCKET_BAD;
704 char myhost[256] = "";
706 struct Curl_sockaddr_storage ss;
707 Curl_addrinfo *res, *ai;
708 curl_socklen_t sslen;
709 char hbuf[NI_MAXHOST];
710 struct sockaddr *sa=(struct sockaddr *)&ss;
711 struct sockaddr_in * const sa4 = (void *)sa;
713 struct sockaddr_in6 * const sa6 = (void *)sa;
716 static const char mode[][5] = { "EPRT", "PORT" };
720 char *string_ftpport = data->set.str[STRING_FTPPORT];
721 struct Curl_dns_entry *h=NULL;
722 unsigned short port_min = 0;
723 unsigned short port_max = 0;
728 /* Step 1, figure out what is requested,
730 * (ipv4|ipv6|domain|interface)?(:port(-range)?)?
733 if(data->set.str[STRING_FTPPORT] &&
734 (strlen(data->set.str[STRING_FTPPORT]) > 1)) {
737 size_t addrlen = INET6_ADDRSTRLEN > strlen(string_ftpport) ?
738 INET6_ADDRSTRLEN : strlen(string_ftpport);
740 size_t addrlen = INET_ADDRSTRLEN > strlen(string_ftpport) ?
741 INET_ADDRSTRLEN : strlen(string_ftpport);
743 char *ip_start = string_ftpport;
745 char *port_start = NULL;
746 char *port_sep = NULL;
748 addr = calloc(addrlen+1, 1);
750 return CURLE_OUT_OF_MEMORY;
753 if(*string_ftpport == '[') {
754 /* [ipv6]:port(-range) */
755 ip_start = string_ftpport + 1;
756 if((ip_end = strchr(string_ftpport, ']')) != NULL )
757 strncpy(addr, ip_start, ip_end - ip_start);
761 if(*string_ftpport == ':') {
763 ip_end = string_ftpport;
765 else if((ip_end = strchr(string_ftpport, ':')) != NULL) {
766 /* either ipv6 or (ipv4|domain|interface):port(-range) */
768 if(Curl_inet_pton(AF_INET6, string_ftpport, sa6) == 1) {
770 port_min = port_max = 0;
771 strcpy(addr, string_ftpport);
772 ip_end = NULL; /* this got no port ! */
776 /* (ipv4|domain|interface):port(-range) */
777 strncpy(addr, string_ftpport, ip_end - ip_start );
781 strcpy(addr, string_ftpport);
785 if((port_start = strchr(ip_end, ':')) != NULL) {
786 port_min = curlx_ultous(strtoul(port_start+1, NULL, 10));
787 if((port_sep = strchr(port_start, '-')) != NULL) {
788 port_max = curlx_ultous(strtoul(port_sep + 1, NULL, 10));
795 /* correct errors like:
797 * :-4711 , in this case port_min is (unsigned)-1,
798 * therefore port_min > port_max for all cases
799 * but port_max = (unsigned)-1
801 if(port_min > port_max )
802 port_min = port_max = 0;
806 /* attempt to get the address of the given interface name */
807 if(!Curl_if2ip(conn->ip_addr->ai_family, addr,
809 /* not an interface, use the given string as host name instead */
812 host = hbuf; /* use the hbuf for host name */
814 /* there was only a port(-range) given, default the host */
816 } /* data->set.ftpport */
819 /* not an interface and not a host name, get default by extracting
820 the IP from the control connection */
823 if(getsockname(conn->sock[FIRSTSOCKET], sa, &sslen)) {
824 failf(data, "getsockname() failed: %s",
825 Curl_strerror(conn, SOCKERRNO) );
828 return CURLE_FTP_PORT_FAILED;
830 switch(sa->sa_family) {
833 Curl_inet_ntop(sa->sa_family, &sa6->sin6_addr, hbuf, sizeof(hbuf));
837 Curl_inet_ntop(sa->sa_family, &sa4->sin_addr, hbuf, sizeof(hbuf));
840 host = hbuf; /* use this host name */
843 /* resolv ip/host to ip */
844 rc = Curl_resolv(conn, host, 0, &h);
845 if(rc == CURLRESOLV_PENDING)
846 (void)Curl_resolver_wait_resolv(conn, &h);
849 /* when we return from this function, we can forget about this entry
850 to we can unlock it now already */
851 Curl_resolv_unlock(data, h);
854 res = NULL; /* failure! */
860 failf(data, "Curl_resolv failed, we can not recover!");
861 return CURLE_FTP_PORT_FAILED;
864 /* step 2, create a socket for the requested address */
866 portsock = CURL_SOCKET_BAD;
868 for(ai = res; ai; ai = ai->ai_next) {
870 * Workaround for AIX5 getaddrinfo() problem (it doesn't set ai_socktype):
872 if(ai->ai_socktype == 0)
873 ai->ai_socktype = conn->socktype;
875 portsock = socket(ai->ai_family, ai->ai_socktype, ai->ai_protocol);
876 if(portsock == CURL_SOCKET_BAD) {
883 failf(data, "socket failure: %s", Curl_strerror(conn, error));
884 return CURLE_FTP_PORT_FAILED;
887 /* step 3, bind to a suitable local address */
889 memcpy(sa, ai->ai_addr, ai->ai_addrlen);
890 sslen = ai->ai_addrlen;
892 for(port = port_min; port <= port_max;) {
893 if(sa->sa_family == AF_INET)
894 sa4->sin_port = htons(port);
897 sa6->sin6_port = htons(port);
899 /* Try binding the given address. */
900 if(bind(portsock, sa, sslen) ) {
903 if(error == EADDRNOTAVAIL) {
905 /* The requested bind address is not local. Use the address used for
906 * the control connection instead and restart the port loop
908 failf(data, "bind(port=%hu) failed: %s", port,
909 Curl_strerror(conn, error) );
912 if(getsockname(conn->sock[FIRSTSOCKET], sa, &sslen)) {
913 failf(data, "getsockname() failed: %s",
914 Curl_strerror(conn, SOCKERRNO) );
916 return CURLE_FTP_PORT_FAILED;
921 else if(error != EADDRINUSE && error != EACCES) {
922 failf(data, "bind(port=%hu) failed: %s", port,
923 Curl_strerror(conn, error) );
925 return CURLE_FTP_PORT_FAILED;
934 /* maybe all ports were in use already*/
935 if(port > port_max) {
936 failf(data, "bind() failed, we ran out of ports!");
938 return CURLE_FTP_PORT_FAILED;
941 /* get the name again after the bind() so that we can extract the
942 port number it uses now */
944 if(getsockname(portsock, (struct sockaddr *)sa, &sslen)) {
945 failf(data, "getsockname() failed: %s",
946 Curl_strerror(conn, SOCKERRNO) );
948 return CURLE_FTP_PORT_FAILED;
951 /* step 4, listen on the socket */
953 if(listen(portsock, 1)) {
954 failf(data, "socket failure: %s", Curl_strerror(conn, SOCKERRNO));
956 return CURLE_FTP_PORT_FAILED;
959 /* step 5, send the proper FTP command */
961 /* get a plain printable version of the numerical address to work with
963 Curl_printable_address(ai, myhost, sizeof(myhost));
966 if(!conn->bits.ftp_use_eprt && conn->bits.ipv6)
967 /* EPRT is disabled but we are connected to a IPv6 host, so we ignore the
968 request and enable EPRT again! */
969 conn->bits.ftp_use_eprt = TRUE;
972 for(; fcmd != DONE; fcmd++) {
974 if(!conn->bits.ftp_use_eprt && (EPRT == fcmd))
975 /* if disabled, goto next */
978 if((PORT == fcmd) && sa->sa_family != AF_INET)
979 /* PORT is ipv4 only */
982 switch (sa->sa_family) {
984 port = ntohs(sa4->sin_port);
988 port = ntohs(sa6->sin6_port);
992 continue; /* might as well skip this */
997 * Two fine examples from RFC2428;
999 * EPRT |1|132.235.1.2|6275|
1001 * EPRT |2|1080::8:800:200C:417A|5282|
1004 result = Curl_pp_sendf(&ftpc->pp, "%s |%d|%s|%hu|", mode[fcmd],
1005 sa->sa_family == AF_INET?1:2,
1011 else if(PORT == fcmd) {
1012 char *source = myhost;
1015 /* translate x.x.x.x to x,x,x,x */
1016 while(source && *source) {
1025 snprintf(dest, 20, ",%d,%d", (int)(port>>8), (int)(port&0xff));
1027 result = Curl_pp_sendf(&ftpc->pp, "%s %s", mode[fcmd], tmp);
1034 /* store which command was sent */
1035 ftpc->count1 = fcmd;
1037 /* we set the secondary socket variable to this for now, it is only so that
1038 the cleanup function will close it in case we fail before the true
1039 secondary stuff is made */
1040 if(CURL_SOCKET_BAD != conn->sock[SECONDARYSOCKET])
1041 sclose(conn->sock[SECONDARYSOCKET]);
1042 conn->sock[SECONDARYSOCKET] = portsock;
1044 /* this tcpconnect assignment below is a hackish work-around to make the
1045 multi interface with active FTP work - as it will not wait for a
1046 (passive) connect in Curl_is_connected().
1048 The *proper* fix is to make sure that the active connection from the
1049 server is done in a non-blocking way. Currently, it is still BLOCKING.
1051 conn->bits.tcpconnect = TRUE;
1053 state(conn, FTP_PORT);
1057 static CURLcode ftp_state_use_pasv(struct connectdata *conn)
1059 struct ftp_conn *ftpc = &conn->proto.ftpc;
1060 CURLcode result = CURLE_OK;
1062 Here's the excecutive summary on what to do:
1064 PASV is RFC959, expect:
1065 227 Entering Passive Mode (a1,a2,a3,a4,p1,p2)
1067 LPSV is RFC1639, expect:
1068 228 Entering Long Passive Mode (4,4,a1,a2,a3,a4,2,p1,p2)
1070 EPSV is RFC2428, expect:
1071 229 Entering Extended Passive Mode (|||port|)
1075 static const char mode[][5] = { "EPSV", "PASV" };
1079 if(!conn->bits.ftp_use_epsv && conn->bits.ipv6)
1080 /* EPSV is disabled but we are connected to a IPv6 host, so we ignore the
1081 request and enable EPSV again! */
1082 conn->bits.ftp_use_epsv = TRUE;
1085 modeoff = conn->bits.ftp_use_epsv?0:1;
1087 PPSENDF(&ftpc->pp, "%s", mode[modeoff]);
1089 ftpc->count1 = modeoff;
1090 state(conn, FTP_PASV);
1091 infof(conn->data, "Connect data stream passively\n");
1096 /* REST is the last command in the chain of commands when a "head"-like
1097 request is made. Thus, if an actual transfer is to be made this is where
1098 we take off for real. */
1099 static CURLcode ftp_state_post_rest(struct connectdata *conn)
1101 CURLcode result = CURLE_OK;
1102 struct FTP *ftp = conn->data->state.proto.ftp;
1103 struct SessionHandle *data = conn->data;
1105 if(ftp->transfer != FTPTRANSFER_BODY) {
1106 /* doesn't transfer any data */
1108 /* still possibly do PRE QUOTE jobs */
1109 state(conn, FTP_RETR_PREQUOTE);
1110 result = ftp_state_quote(conn, TRUE, FTP_RETR_PREQUOTE);
1112 else if(data->set.ftp_use_port) {
1113 /* We have chosen to use the PORT (or similar) command */
1114 result = ftp_state_use_port(conn, EPRT);
1117 /* We have chosen (this is default) to use the PASV (or similar) command */
1118 if(data->set.ftp_use_pret) {
1119 /* The user has requested that we send a PRET command
1120 to prepare the server for the upcoming PASV */
1121 if(!conn->proto.ftpc.file) {
1122 PPSENDF(&conn->proto.ftpc.pp, "PRET %s",
1123 data->set.str[STRING_CUSTOMREQUEST]?
1124 data->set.str[STRING_CUSTOMREQUEST]:
1125 (data->set.ftp_list_only?"NLST":"LIST"));
1127 else if(data->set.upload) {
1128 PPSENDF(&conn->proto.ftpc.pp, "PRET STOR %s", conn->proto.ftpc.file);
1131 PPSENDF(&conn->proto.ftpc.pp, "PRET RETR %s", conn->proto.ftpc.file);
1133 state(conn, FTP_PRET);
1136 result = ftp_state_use_pasv(conn);
1142 static CURLcode ftp_state_post_size(struct connectdata *conn)
1144 CURLcode result = CURLE_OK;
1145 struct FTP *ftp = conn->data->state.proto.ftp;
1146 struct ftp_conn *ftpc = &conn->proto.ftpc;
1148 if((ftp->transfer != FTPTRANSFER_BODY) && ftpc->file) {
1149 /* if a "head"-like request is being made (on a file) */
1151 /* Determine if server can respond to REST command and therefore
1152 whether it supports range */
1153 PPSENDF(&conn->proto.ftpc.pp, "REST %d", 0);
1155 state(conn, FTP_REST);
1158 result = ftp_state_post_rest(conn);
1163 static CURLcode ftp_state_post_type(struct connectdata *conn)
1165 CURLcode result = CURLE_OK;
1166 struct FTP *ftp = conn->data->state.proto.ftp;
1167 struct ftp_conn *ftpc = &conn->proto.ftpc;
1169 if((ftp->transfer == FTPTRANSFER_INFO) && ftpc->file) {
1170 /* if a "head"-like request is being made (on a file) */
1172 /* we know ftpc->file is a valid pointer to a file name */
1173 PPSENDF(&ftpc->pp, "SIZE %s", ftpc->file);
1175 state(conn, FTP_SIZE);
1178 result = ftp_state_post_size(conn);
1183 static CURLcode ftp_state_post_listtype(struct connectdata *conn)
1185 CURLcode result = CURLE_OK;
1186 struct SessionHandle *data = conn->data;
1188 /* If this output is to be machine-parsed, the NLST command might be better
1189 to use, since the LIST command output is not specified or standard in any
1190 way. It has turned out that the NLST list output is not the same on all
1191 servers either... */
1194 if FTPFILE_NOCWD was specified, we are currently in
1195 the user's home directory, so we should add the path
1196 as argument for the LIST / NLST / or custom command.
1197 Whether the server will support this, is uncertain.
1199 The other ftp_filemethods will CWD into dir/dir/ first and
1200 then just do LIST (in that case: nothing to do here)
1202 char *cmd,*lstArg,*slashPos;
1205 if((data->set.ftp_filemethod == FTPFILE_NOCWD) &&
1207 data->state.path[0] &&
1208 strchr(data->state.path,'/')) {
1210 lstArg = strdup(data->state.path);
1212 return CURLE_OUT_OF_MEMORY;
1214 /* Check if path does not end with /, as then we cut off the file part */
1215 if(lstArg[strlen(lstArg) - 1] != '/') {
1217 /* chop off the file part if format is dir/dir/file */
1218 slashPos = strrchr(lstArg,'/');
1220 *(slashPos+1) = '\0';
1224 cmd = aprintf( "%s%s%s",
1225 data->set.str[STRING_CUSTOMREQUEST]?
1226 data->set.str[STRING_CUSTOMREQUEST]:
1227 (data->set.ftp_list_only?"NLST":"LIST"),
1229 lstArg? lstArg: "" );
1234 return CURLE_OUT_OF_MEMORY;
1237 PPSENDF(&conn->proto.ftpc.pp, "%s",cmd);
1244 state(conn, FTP_LIST);
1249 static CURLcode ftp_state_post_retrtype(struct connectdata *conn)
1251 CURLcode result = CURLE_OK;
1253 /* We've sent the TYPE, now we must send the list of prequote strings */
1255 result = ftp_state_quote(conn, TRUE, FTP_RETR_PREQUOTE);
1260 static CURLcode ftp_state_post_stortype(struct connectdata *conn)
1262 CURLcode result = CURLE_OK;
1264 /* We've sent the TYPE, now we must send the list of prequote strings */
1266 result = ftp_state_quote(conn, TRUE, FTP_STOR_PREQUOTE);
1271 static CURLcode ftp_state_post_mdtm(struct connectdata *conn)
1273 CURLcode result = CURLE_OK;
1274 struct FTP *ftp = conn->data->state.proto.ftp;
1275 struct SessionHandle *data = conn->data;
1276 struct ftp_conn *ftpc = &conn->proto.ftpc;
1278 /* If we have selected NOBODY and HEADER, it means that we only want file
1279 information. Which in FTP can't be much more than the file size and
1281 if(data->set.opt_no_body && ftpc->file &&
1282 ftp_need_type(conn, data->set.prefer_ascii)) {
1283 /* The SIZE command is _not_ RFC 959 specified, and therefor many servers
1284 may not support it! It is however the only way we have to get a file's
1287 ftp->transfer = FTPTRANSFER_INFO;
1288 /* this means no actual transfer will be made */
1290 /* Some servers return different sizes for different modes, and thus we
1291 must set the proper type before we check the size */
1292 result = ftp_nb_type(conn, data->set.prefer_ascii, FTP_TYPE);
1297 result = ftp_state_post_type(conn);
1302 /* This is called after the CWD commands have been done in the beginning of
1304 static CURLcode ftp_state_post_cwd(struct connectdata *conn)
1306 CURLcode result = CURLE_OK;
1307 struct SessionHandle *data = conn->data;
1308 struct ftp_conn *ftpc = &conn->proto.ftpc;
1310 /* Requested time of file or time-depended transfer? */
1311 if((data->set.get_filetime || data->set.timecondition) && ftpc->file) {
1313 /* we have requested to get the modified-time of the file, this is a white
1314 spot as the MDTM is not mentioned in RFC959 */
1315 PPSENDF(&ftpc->pp, "MDTM %s", ftpc->file);
1317 state(conn, FTP_MDTM);
1320 result = ftp_state_post_mdtm(conn);
1326 /* This is called after the TYPE and possible quote commands have been sent */
1327 static CURLcode ftp_state_ul_setup(struct connectdata *conn,
1330 CURLcode result = CURLE_OK;
1331 struct FTP *ftp = conn->data->state.proto.ftp;
1332 struct SessionHandle *data = conn->data;
1333 struct ftp_conn *ftpc = &conn->proto.ftpc;
1334 int seekerr = CURL_SEEKFUNC_OK;
1336 if((data->state.resume_from && !sizechecked) ||
1337 ((data->state.resume_from > 0) && sizechecked)) {
1338 /* we're about to continue the uploading of a file */
1339 /* 1. get already existing file's size. We use the SIZE command for this
1340 which may not exist in the server! The SIZE command is not in
1343 /* 2. This used to set REST. But since we can do append, we
1344 don't another ftp command. We just skip the source file
1345 offset and then we APPEND the rest on the file instead */
1347 /* 3. pass file-size number of bytes in the source file */
1348 /* 4. lower the infilesize counter */
1349 /* => transfer as usual */
1351 if(data->state.resume_from < 0 ) {
1352 /* Got no given size to start from, figure it out */
1353 PPSENDF(&ftpc->pp, "SIZE %s", ftpc->file);
1354 state(conn, FTP_STOR_SIZE);
1359 data->set.ftp_append = TRUE;
1361 /* Let's read off the proper amount of bytes from the input. */
1362 if(conn->seek_func) {
1363 seekerr = conn->seek_func(conn->seek_client, data->state.resume_from,
1367 if(seekerr != CURL_SEEKFUNC_OK) {
1368 if(seekerr != CURL_SEEKFUNC_CANTSEEK) {
1369 failf(data, "Could not seek stream");
1370 return CURLE_FTP_COULDNT_USE_REST;
1372 /* seekerr == CURL_SEEKFUNC_CANTSEEK (can't seek to offset) */
1374 curl_off_t passed=0;
1376 size_t readthisamountnow =
1377 (data->state.resume_from - passed > CURL_OFF_T_C(BUFSIZE)) ?
1378 BUFSIZE : curlx_sotouz(data->state.resume_from - passed);
1380 size_t actuallyread =
1381 conn->fread_func(data->state.buffer, 1, readthisamountnow,
1384 passed += actuallyread;
1385 if((actuallyread == 0) || (actuallyread > readthisamountnow)) {
1386 /* this checks for greater-than only to make sure that the
1387 CURL_READFUNC_ABORT return code still aborts */
1388 failf(data, "Failed to read data");
1389 return CURLE_FTP_COULDNT_USE_REST;
1391 } while(passed < data->state.resume_from);
1394 /* now, decrease the size of the read */
1395 if(data->set.infilesize>0) {
1396 data->set.infilesize -= data->state.resume_from;
1398 if(data->set.infilesize <= 0) {
1399 infof(data, "File already completely uploaded\n");
1401 /* no data to transfer */
1402 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
1404 /* Set ->transfer so that we won't get any error in
1405 * ftp_done() because we didn't transfer anything! */
1406 ftp->transfer = FTPTRANSFER_NONE;
1408 state(conn, FTP_STOP);
1412 /* we've passed, proceed as normal */
1415 PPSENDF(&ftpc->pp, data->set.ftp_append?"APPE %s":"STOR %s",
1418 state(conn, FTP_STOR);
1423 static CURLcode ftp_state_quote(struct connectdata *conn,
1427 CURLcode result = CURLE_OK;
1428 struct SessionHandle *data = conn->data;
1429 struct FTP *ftp = data->state.proto.ftp;
1430 struct ftp_conn *ftpc = &conn->proto.ftpc;
1432 struct curl_slist *item;
1437 item = data->set.quote;
1439 case FTP_RETR_PREQUOTE:
1440 case FTP_STOR_PREQUOTE:
1441 item = data->set.prequote;
1444 item = data->set.postquote;
1450 * 'count1' to iterate over the commands to send
1451 * 'count2' to store wether to allow commands to fail
1462 /* Skip count1 items in the linked list */
1463 while((i< ftpc->count1) && item) {
1468 char *cmd = item->data;
1471 ftpc->count2 = 1; /* the sent command is allowed to fail */
1474 ftpc->count2 = 0; /* failure means cancel operation */
1476 PPSENDF(&ftpc->pp, "%s", cmd);
1477 state(conn, instate);
1483 /* No more quote to send, continue to ... */
1487 result = ftp_state_cwd(conn);
1489 case FTP_RETR_PREQUOTE:
1490 if(ftp->transfer != FTPTRANSFER_BODY)
1491 state(conn, FTP_STOP);
1493 if(ftpc->known_filesize != -1) {
1494 Curl_pgrsSetDownloadSize(data, ftpc->known_filesize);
1495 result = ftp_state_post_retr_size(conn, ftpc->known_filesize);
1498 PPSENDF(&ftpc->pp, "SIZE %s", ftpc->file);
1499 state(conn, FTP_RETR_SIZE);
1503 case FTP_STOR_PREQUOTE:
1504 result = ftp_state_ul_setup(conn, FALSE);
1514 static CURLcode ftp_state_pasv_resp(struct connectdata *conn,
1517 struct ftp_conn *ftpc = &conn->proto.ftpc;
1519 struct SessionHandle *data=conn->data;
1520 Curl_addrinfo *conninfo;
1521 struct Curl_dns_entry *addr=NULL;
1523 unsigned short connectport; /* the local port connect() should use! */
1524 unsigned short newport=0; /* remote port */
1527 /* newhost must be able to hold a full IP-style address in ASCII, which
1528 in the IPv6 case means 5*8-1 = 39 letters */
1529 #define NEWHOST_BUFSIZE 48
1530 char newhost[NEWHOST_BUFSIZE];
1531 char *str=&data->state.buffer[4]; /* start on the first letter */
1533 if((ftpc->count1 == 0) &&
1535 /* positive EPSV response */
1536 char *ptr = strchr(str, '(');
1541 if(5 == sscanf(ptr, "%c%c%c%u%c",
1547 const char sep1 = separator[0];
1550 /* The four separators should be identical, or else this is an oddly
1551 formatted reply and we bail out immediately. */
1552 for(i=1; i<4; i++) {
1553 if(separator[i] != sep1) {
1554 ptr=NULL; /* set to NULL to signal error */
1559 newport = (unsigned short)(num & 0xffff);
1561 if(conn->bits.tunnel_proxy ||
1562 conn->proxytype == CURLPROXY_SOCKS5 ||
1563 conn->proxytype == CURLPROXY_SOCKS5_HOSTNAME ||
1564 conn->proxytype == CURLPROXY_SOCKS4 ||
1565 conn->proxytype == CURLPROXY_SOCKS4A)
1566 /* proxy tunnel -> use other host info because ip_addr_str is the
1567 proxy address not the ftp host */
1568 snprintf(newhost, sizeof(newhost), "%s", conn->host.name);
1570 /* use the same IP we are already connected to */
1571 snprintf(newhost, NEWHOST_BUFSIZE, "%s", conn->ip_addr_str);
1578 failf(data, "Weirdly formatted EPSV reply");
1579 return CURLE_FTP_WEIRD_PASV_REPLY;
1582 else if((ftpc->count1 == 1) &&
1584 /* positive PASV response */
1589 * Scan for a sequence of six comma-separated numbers and use them as
1590 * IP+port indicators.
1592 * Found reply-strings include:
1593 * "227 Entering Passive Mode (127,0,0,1,4,51)"
1594 * "227 Data transfer will passively listen to 127,0,0,1,4,51"
1595 * "227 Entering passive mode. 127,0,0,1,4,51"
1598 if(6 == sscanf(str, "%d,%d,%d,%d,%d,%d",
1599 &ip[0], &ip[1], &ip[2], &ip[3],
1600 &port[0], &port[1]))
1606 failf(data, "Couldn't interpret the 227-response");
1607 return CURLE_FTP_WEIRD_227_FORMAT;
1610 /* we got OK from server */
1611 if(data->set.ftp_skip_ip) {
1612 /* told to ignore the remotely given IP but instead use the one we used
1613 for the control connection */
1614 infof(data, "Skips %d.%d.%d.%d for data connection, uses %s instead\n",
1615 ip[0], ip[1], ip[2], ip[3],
1617 if(conn->bits.tunnel_proxy ||
1618 conn->proxytype == CURLPROXY_SOCKS5 ||
1619 conn->proxytype == CURLPROXY_SOCKS5_HOSTNAME ||
1620 conn->proxytype == CURLPROXY_SOCKS4 ||
1621 conn->proxytype == CURLPROXY_SOCKS4A)
1622 /* proxy tunnel -> use other host info because ip_addr_str is the
1623 proxy address not the ftp host */
1624 snprintf(newhost, sizeof(newhost), "%s", conn->host.name);
1626 snprintf(newhost, sizeof(newhost), "%s", conn->ip_addr_str);
1629 snprintf(newhost, sizeof(newhost),
1630 "%d.%d.%d.%d", ip[0], ip[1], ip[2], ip[3]);
1631 newport = (unsigned short)(((port[0]<<8) + port[1]) & 0xffff);
1633 else if(ftpc->count1 == 0) {
1634 /* EPSV failed, move on to PASV */
1636 /* disable it for next transfer */
1637 conn->bits.ftp_use_epsv = FALSE;
1638 infof(data, "disabling EPSV usage\n");
1640 PPSENDF(&ftpc->pp, "PASV", NULL);
1642 /* remain in the FTP_PASV state */
1646 failf(data, "Bad PASV/EPSV response: %03d", ftpcode);
1647 return CURLE_FTP_WEIRD_PASV_REPLY;
1650 if(data->set.str[STRING_PROXY] && *data->set.str[STRING_PROXY]) {
1652 * This is a tunnel through a http proxy and we need to connect to the
1655 * We don't want to rely on a former host lookup that might've expired
1656 * now, instead we remake the lookup here and now!
1658 rc = Curl_resolv(conn, conn->proxy.name, (int)conn->port, &addr);
1659 if(rc == CURLRESOLV_PENDING)
1660 /* BLOCKING, ignores the return code but 'addr' will be NULL in
1662 (void)Curl_resolver_wait_resolv(conn, &addr);
1665 (unsigned short)conn->port; /* we connect to the proxy's port */
1668 failf(data, "Can't resolve proxy host %s:%hu",
1669 conn->proxy.name, connectport);
1670 return CURLE_FTP_CANT_GET_HOST;
1674 /* normal, direct, ftp connection */
1675 rc = Curl_resolv(conn, newhost, newport, &addr);
1676 if(rc == CURLRESOLV_PENDING)
1678 (void)Curl_resolver_wait_resolv(conn, &addr);
1680 connectport = newport; /* we connect to the remote port */
1683 failf(data, "Can't resolve new host %s:%hu", newhost, connectport);
1684 return CURLE_FTP_CANT_GET_HOST;
1688 result = Curl_connecthost(conn,
1690 &conn->sock[SECONDARYSOCKET],
1694 Curl_resolv_unlock(data, addr); /* we're done using this address */
1696 if(result && ftpc->count1 == 0 && ftpcode == 229) {
1697 infof(data, "got positive EPSV response, but can't connect. "
1698 "Disabling EPSV\n");
1699 /* disable it for next transfer */
1700 conn->bits.ftp_use_epsv = FALSE;
1701 data->state.errorbuf = FALSE; /* allow error message to get rewritten */
1702 PPSENDF(&ftpc->pp, "PASV", NULL);
1704 /* remain in the FTP_PASV state */
1711 conn->bits.tcpconnect = connected; /* simply TRUE or FALSE */
1714 * When this is used from the multi interface, this might've returned with
1715 * the 'connected' set to FALSE and thus we are now awaiting a non-blocking
1716 * connect to connect and we should not be "hanging" here waiting.
1719 if(data->set.verbose)
1720 /* this just dumps information about this second connection */
1721 ftp_pasv_verbose(conn, conninfo, newhost, connectport);
1723 switch(conn->proxytype) {
1724 /* FIX: this MUST wait for a proper connect first if 'connected' is
1726 case CURLPROXY_SOCKS5:
1727 case CURLPROXY_SOCKS5_HOSTNAME:
1728 result = Curl_SOCKS5(conn->proxyuser, conn->proxypasswd, newhost, newport,
1729 SECONDARYSOCKET, conn);
1731 case CURLPROXY_SOCKS4:
1732 result = Curl_SOCKS4(conn->proxyuser, newhost, newport,
1733 SECONDARYSOCKET, conn, FALSE);
1735 case CURLPROXY_SOCKS4A:
1736 result = Curl_SOCKS4(conn->proxyuser, newhost, newport,
1737 SECONDARYSOCKET, conn, TRUE);
1739 case CURLPROXY_HTTP:
1740 case CURLPROXY_HTTP_1_0:
1741 /* do nothing here. handled later. */
1744 failf(data, "unknown proxytype option given");
1745 result = CURLE_COULDNT_CONNECT;
1749 if(conn->bits.tunnel_proxy && conn->bits.httpproxy) {
1750 /* FIX: this MUST wait for a proper connect first if 'connected' is
1754 /* We want "seamless" FTP operations through HTTP proxy tunnel */
1756 /* Curl_proxyCONNECT is based on a pointer to a struct HTTP at the member
1757 * conn->proto.http; we want FTP through HTTP and we have to change the
1758 * member temporarily for connecting to the HTTP proxy. After
1759 * Curl_proxyCONNECT we have to set back the member to the original struct
1762 struct HTTP http_proxy;
1763 struct FTP *ftp_save = data->state.proto.ftp;
1764 memset(&http_proxy, 0, sizeof(http_proxy));
1765 data->state.proto.http = &http_proxy;
1767 result = Curl_proxyCONNECT(conn, SECONDARYSOCKET, newhost, newport);
1769 data->state.proto.ftp = ftp_save;
1771 if(CURLE_OK != result)
1776 state(conn, FTP_STOP); /* this phase is completed */
1781 static CURLcode ftp_state_port_resp(struct connectdata *conn,
1784 struct SessionHandle *data = conn->data;
1785 struct ftp_conn *ftpc = &conn->proto.ftpc;
1786 ftpport fcmd = (ftpport)ftpc->count1;
1787 CURLcode result = CURLE_OK;
1789 if(ftpcode != 200) {
1790 /* the command failed */
1793 infof(data, "disabling EPRT usage\n");
1794 conn->bits.ftp_use_eprt = FALSE;
1799 failf(data, "Failed to do PORT");
1800 result = CURLE_FTP_PORT_FAILED;
1804 result = ftp_state_use_port(conn, fcmd);
1807 infof(data, "Connect data stream actively\n");
1808 state(conn, FTP_STOP); /* end of DO phase */
1814 static CURLcode ftp_state_mdtm_resp(struct connectdata *conn,
1817 CURLcode result = CURLE_OK;
1818 struct SessionHandle *data=conn->data;
1819 struct FTP *ftp = data->state.proto.ftp;
1820 struct ftp_conn *ftpc = &conn->proto.ftpc;
1825 /* we got a time. Format should be: "YYYYMMDDHHMMSS[.sss]" where the
1826 last .sss part is optional and means fractions of a second */
1827 int year, month, day, hour, minute, second;
1828 char *buf = data->state.buffer;
1829 if(6 == sscanf(buf+4, "%04d%02d%02d%02d%02d%02d",
1830 &year, &month, &day, &hour, &minute, &second)) {
1831 /* we have a time, reformat it */
1832 time_t secs=time(NULL);
1833 /* using the good old yacc/bison yuck */
1834 snprintf(buf, sizeof(conn->data->state.buffer),
1835 "%04d%02d%02d %02d:%02d:%02d GMT",
1836 year, month, day, hour, minute, second);
1837 /* now, convert this into a time() value: */
1838 data->info.filetime = (long)curl_getdate(buf, &secs);
1841 #ifdef CURL_FTP_HTTPSTYLE_HEAD
1842 /* If we asked for a time of the file and we actually got one as well,
1843 we "emulate" a HTTP-style header in our output. */
1845 if(data->set.opt_no_body &&
1847 data->set.get_filetime &&
1848 (data->info.filetime>=0) ) {
1849 time_t filetime = (time_t)data->info.filetime;
1851 const struct tm *tm = &buffer;
1853 result = Curl_gmtime(filetime, &buffer);
1857 /* format: "Tue, 15 Nov 1994 12:45:26" */
1858 snprintf(buf, BUFSIZE-1,
1859 "Last-Modified: %s, %02d %s %4d %02d:%02d:%02d GMT\r\n",
1860 Curl_wkday[tm->tm_wday?tm->tm_wday-1:6],
1862 Curl_month[tm->tm_mon],
1867 result = Curl_client_write(conn, CLIENTWRITE_BOTH, buf, 0);
1870 } /* end of a ridiculous amount of conditionals */
1875 infof(data, "unsupported MDTM reply format\n");
1877 case 550: /* "No such file or directory" */
1878 failf(data, "Given file does not exist");
1879 result = CURLE_FTP_COULDNT_RETR_FILE;
1883 if(data->set.timecondition) {
1884 if((data->info.filetime > 0) && (data->set.timevalue > 0)) {
1885 switch(data->set.timecondition) {
1886 case CURL_TIMECOND_IFMODSINCE:
1888 if(data->info.filetime <= data->set.timevalue) {
1889 infof(data, "The requested document is not new enough\n");
1890 ftp->transfer = FTPTRANSFER_NONE; /* mark to not transfer data */
1891 data->info.timecond = TRUE;
1892 state(conn, FTP_STOP);
1896 case CURL_TIMECOND_IFUNMODSINCE:
1897 if(data->info.filetime > data->set.timevalue) {
1898 infof(data, "The requested document is not old enough\n");
1899 ftp->transfer = FTPTRANSFER_NONE; /* mark to not transfer data */
1900 data->info.timecond = TRUE;
1901 state(conn, FTP_STOP);
1908 infof(data, "Skipping time comparison\n");
1913 result = ftp_state_post_mdtm(conn);
1918 static CURLcode ftp_state_type_resp(struct connectdata *conn,
1922 CURLcode result = CURLE_OK;
1923 struct SessionHandle *data=conn->data;
1925 if(ftpcode/100 != 2) {
1926 /* "sasserftpd" and "(u)r(x)bot ftpd" both responds with 226 after a
1927 successful 'TYPE I'. While that is not as RFC959 says, it is still a
1928 positive response code and we allow that. */
1929 failf(data, "Couldn't set desired mode");
1930 return CURLE_FTP_COULDNT_SET_TYPE;
1933 infof(data, "Got a %03d response code instead of the assumed 200\n",
1936 if(instate == FTP_TYPE)
1937 result = ftp_state_post_type(conn);
1938 else if(instate == FTP_LIST_TYPE)
1939 result = ftp_state_post_listtype(conn);
1940 else if(instate == FTP_RETR_TYPE)
1941 result = ftp_state_post_retrtype(conn);
1942 else if(instate == FTP_STOR_TYPE)
1943 result = ftp_state_post_stortype(conn);
1948 static CURLcode ftp_state_post_retr_size(struct connectdata *conn,
1949 curl_off_t filesize)
1951 CURLcode result = CURLE_OK;
1952 struct SessionHandle *data=conn->data;
1953 struct FTP *ftp = data->state.proto.ftp;
1954 struct ftp_conn *ftpc = &conn->proto.ftpc;
1956 if(data->set.max_filesize && (filesize > data->set.max_filesize)) {
1957 failf(data, "Maximum file size exceeded");
1958 return CURLE_FILESIZE_EXCEEDED;
1960 ftp->downloadsize = filesize;
1962 if(data->state.resume_from) {
1963 /* We always (attempt to) get the size of downloads, so it is done before
1964 this even when not doing resumes. */
1965 if(filesize == -1) {
1966 infof(data, "ftp server doesn't support SIZE\n");
1967 /* We couldn't get the size and therefore we can't know if there really
1968 is a part of the file left to get, although the server will just
1969 close the connection when we start the connection so it won't cause
1970 us any harm, just not make us exit as nicely. */
1973 /* We got a file size report, so we check that there actually is a
1974 part of the file left to get, or else we go home. */
1975 if(data->state.resume_from< 0) {
1976 /* We're supposed to download the last abs(from) bytes */
1977 if(filesize < -data->state.resume_from) {
1978 failf(data, "Offset (%" FORMAT_OFF_T
1979 ") was beyond file size (%" FORMAT_OFF_T ")",
1980 data->state.resume_from, filesize);
1981 return CURLE_BAD_DOWNLOAD_RESUME;
1983 /* convert to size to download */
1984 ftp->downloadsize = -data->state.resume_from;
1985 /* download from where? */
1986 data->state.resume_from = filesize - ftp->downloadsize;
1989 if(filesize < data->state.resume_from) {
1990 failf(data, "Offset (%" FORMAT_OFF_T
1991 ") was beyond file size (%" FORMAT_OFF_T ")",
1992 data->state.resume_from, filesize);
1993 return CURLE_BAD_DOWNLOAD_RESUME;
1995 /* Now store the number of bytes we are expected to download */
1996 ftp->downloadsize = filesize-data->state.resume_from;
2000 if(ftp->downloadsize == 0) {
2001 /* no data to transfer */
2002 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
2003 infof(data, "File already completely downloaded\n");
2005 /* Set ->transfer so that we won't get any error in ftp_done()
2006 * because we didn't transfer the any file */
2007 ftp->transfer = FTPTRANSFER_NONE;
2008 state(conn, FTP_STOP);
2012 /* Set resume file transfer offset */
2013 infof(data, "Instructs server to resume from offset %" FORMAT_OFF_T
2014 "\n", data->state.resume_from);
2016 PPSENDF(&ftpc->pp, "REST %" FORMAT_OFF_T, data->state.resume_from);
2018 state(conn, FTP_RETR_REST);
2023 PPSENDF(&ftpc->pp, "RETR %s", ftpc->file);
2024 state(conn, FTP_RETR);
2030 static CURLcode ftp_state_size_resp(struct connectdata *conn,
2034 CURLcode result = CURLE_OK;
2035 struct SessionHandle *data=conn->data;
2036 curl_off_t filesize;
2037 char *buf = data->state.buffer;
2039 /* get the size from the ascii string: */
2040 filesize = (ftpcode == 213)?curlx_strtoofft(buf+4, NULL, 0):-1;
2042 if(instate == FTP_SIZE) {
2043 #ifdef CURL_FTP_HTTPSTYLE_HEAD
2044 if(-1 != filesize) {
2045 snprintf(buf, sizeof(data->state.buffer),
2046 "Content-Length: %" FORMAT_OFF_T "\r\n", filesize);
2047 result = Curl_client_write(conn, CLIENTWRITE_BOTH, buf, 0);
2052 Curl_pgrsSetDownloadSize(data, filesize);
2053 result = ftp_state_post_size(conn);
2055 else if(instate == FTP_RETR_SIZE) {
2056 Curl_pgrsSetDownloadSize(data, filesize);
2057 result = ftp_state_post_retr_size(conn, filesize);
2059 else if(instate == FTP_STOR_SIZE) {
2060 data->state.resume_from = filesize;
2061 result = ftp_state_ul_setup(conn, TRUE);
2067 static CURLcode ftp_state_rest_resp(struct connectdata *conn,
2071 CURLcode result = CURLE_OK;
2072 struct ftp_conn *ftpc = &conn->proto.ftpc;
2077 #ifdef CURL_FTP_HTTPSTYLE_HEAD
2078 if(ftpcode == 350) {
2079 char buffer[24]= { "Accept-ranges: bytes\r\n" };
2080 result = Curl_client_write(conn, CLIENTWRITE_BOTH, buffer, 0);
2085 result = ftp_state_post_rest(conn);
2089 if(ftpcode != 350) {
2090 failf(conn->data, "Couldn't use REST");
2091 result = CURLE_FTP_COULDNT_USE_REST;
2094 PPSENDF(&ftpc->pp, "RETR %s", ftpc->file);
2095 state(conn, FTP_RETR);
2103 static CURLcode ftp_state_stor_resp(struct connectdata *conn,
2106 CURLcode result = CURLE_OK;
2107 struct SessionHandle *data = conn->data;
2108 struct FTP *ftp = data->state.proto.ftp;
2111 failf(data, "Failed FTP upload: %0d", ftpcode);
2112 /* oops, we never close the sockets! */
2113 return CURLE_UPLOAD_FAILED;
2116 if(data->set.ftp_use_port) {
2118 /* PORT means we are now awaiting the server to connect to us. */
2119 result = AllowServerConnect(conn);
2124 if(conn->ssl[SECONDARYSOCKET].use) {
2125 /* since we only have a plaintext TCP connection here, we must now
2127 infof(data, "Doing the SSL/TLS handshake on the data stream\n");
2129 result = Curl_ssl_connect(conn, SECONDARYSOCKET);
2134 *(ftp->bytecountp)=0;
2136 /* When we know we're uploading a specified file, we can get the file
2137 size prior to the actual upload. */
2139 Curl_pgrsSetUploadSize(data, data->set.infilesize);
2141 /* set the SO_SNDBUF for the secondary socket for those who need it */
2142 Curl_sndbufset(conn->sock[SECONDARYSOCKET]);
2144 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, /* no download */
2145 SECONDARYSOCKET, ftp->bytecountp);
2146 state(conn, FTP_STOP);
2148 conn->proto.ftpc.pp.pending_resp = TRUE; /* expect a server response */
2153 /* for LIST and RETR responses */
2154 static CURLcode ftp_state_get_resp(struct connectdata *conn,
2158 CURLcode result = CURLE_OK;
2159 struct SessionHandle *data = conn->data;
2160 struct FTP *ftp = data->state.proto.ftp;
2161 char *buf = data->state.buffer;
2163 if((ftpcode == 150) || (ftpcode == 125)) {
2167 150 Opening BINARY mode data connection for /etc/passwd (2241
2168 bytes). (ok, the file is being transferred)
2171 150 Opening ASCII mode data connection for /bin/ls
2174 150 ASCII data connection for /bin/ls (137.167.104.91,37445) (0 bytes).
2177 150 Opening ASCII mode data connection for [file] (0.0.0.0,0) (545 bytes)
2180 125 Data connection already open; Transfer starting. */
2182 curl_off_t size=-1; /* default unknown size */
2186 * It appears that there are FTP-servers that return size 0 for files when
2187 * SIZE is used on the file while being in BINARY mode. To work around
2188 * that (stupid) behavior, we attempt to parse the RETR response even if
2189 * the SIZE returned size zero.
2191 * Debugging help from Salvatore Sorrentino on February 26, 2003.
2194 if((instate != FTP_LIST) &&
2195 !data->set.prefer_ascii &&
2196 (ftp->downloadsize < 1)) {
2198 * It seems directory listings either don't show the size or very
2199 * often uses size 0 anyway. ASCII transfers may very well turn out
2200 * that the transferred amount of data is not the same as this line
2201 * tells, why using this number in those cases only confuses us.
2203 * Example D above makes this parsing a little tricky */
2205 bytes=strstr(buf, " bytes");
2207 long in=(long)(bytes-buf);
2208 /* this is a hint there is size information in there! ;-) */
2210 /* scan for the left parenthesis and break there */
2213 /* skip only digits */
2214 if(!ISDIGIT(*bytes)) {
2218 /* one more estep backwards */
2221 /* if we have nothing but digits: */
2223 /* get the number! */
2224 size = curlx_strtoofft(bytes, NULL, 0);
2228 else if(ftp->downloadsize > -1)
2229 size = ftp->downloadsize;
2231 if(data->set.ftp_use_port) {
2233 result = AllowServerConnect(conn);
2238 if(conn->ssl[SECONDARYSOCKET].use) {
2239 /* since we only have a plaintext TCP connection here, we must now
2241 infof(data, "Doing the SSL/TLS handshake on the data stream\n");
2242 result = Curl_ssl_connect(conn, SECONDARYSOCKET);
2247 if(size > data->req.maxdownload && data->req.maxdownload > 0)
2248 size = data->req.size = data->req.maxdownload;
2249 else if((instate != FTP_LIST) && (data->set.prefer_ascii))
2250 size = -1; /* kludge for servers that understate ASCII mode file size */
2252 infof(data, "Maxdownload = %" FORMAT_OFF_T "\n", data->req.maxdownload);
2254 if(instate != FTP_LIST)
2255 infof(data, "Getting file with size: %" FORMAT_OFF_T "\n", size);
2258 Curl_setup_transfer(conn, SECONDARYSOCKET, size, FALSE,
2259 ftp->bytecountp, -1, NULL); /* no upload here */
2261 conn->proto.ftpc.pp.pending_resp = TRUE; /* expect server response */
2262 state(conn, FTP_STOP);
2265 if((instate == FTP_LIST) && (ftpcode == 450)) {
2266 /* simply no matching files in the dir listing */
2267 ftp->transfer = FTPTRANSFER_NONE; /* don't download anything */
2268 state(conn, FTP_STOP); /* this phase is over */
2271 failf(data, "RETR response: %03d", ftpcode);
2272 return instate == FTP_RETR && ftpcode == 550?
2273 CURLE_REMOTE_FILE_NOT_FOUND:
2274 CURLE_FTP_COULDNT_RETR_FILE;
2281 /* after USER, PASS and ACCT */
2282 static CURLcode ftp_state_loggedin(struct connectdata *conn)
2284 CURLcode result = CURLE_OK;
2287 if(conn->data->set.krb) {
2288 /* We may need to issue a KAUTH here to have access to the files
2289 * do it if user supplied a password
2291 if(conn->passwd && *conn->passwd) {
2293 result = Curl_krb_kauth(conn);
2299 if(conn->ssl[FIRSTSOCKET].use) {
2300 /* PBSZ = PROTECTION BUFFER SIZE.
2302 The 'draft-murray-auth-ftp-ssl' (draft 12, page 7) says:
2304 Specifically, the PROT command MUST be preceded by a PBSZ
2305 command and a PBSZ command MUST be preceded by a successful
2306 security data exchange (the TLS negotiation in this case)
2308 ... (and on page 8):
2310 Thus the PBSZ command must still be issued, but must have a
2311 parameter of '0' to indicate that no buffering is taking place
2312 and the data connection should not be encapsulated.
2314 PPSENDF(&conn->proto.ftpc.pp, "PBSZ %d", 0);
2315 state(conn, FTP_PBSZ);
2318 result = ftp_state_pwd(conn);
2323 /* for USER and PASS responses */
2324 static CURLcode ftp_state_user_resp(struct connectdata *conn,
2328 CURLcode result = CURLE_OK;
2329 struct SessionHandle *data = conn->data;
2330 struct FTP *ftp = data->state.proto.ftp;
2331 struct ftp_conn *ftpc = &conn->proto.ftpc;
2332 (void)instate; /* no use for this yet */
2334 /* some need password anyway, and others just return 2xx ignored */
2335 if((ftpcode == 331) && (ftpc->state == FTP_USER)) {
2336 /* 331 Password required for ...
2337 (the server requires to send the user's password too) */
2338 PPSENDF(&ftpc->pp, "PASS %s", ftp->passwd?ftp->passwd:"");
2339 state(conn, FTP_PASS);
2341 else if(ftpcode/100 == 2) {
2342 /* 230 User ... logged in.
2343 (the user logged in with or without password) */
2344 result = ftp_state_loggedin(conn);
2346 else if(ftpcode == 332) {
2347 if(data->set.str[STRING_FTP_ACCOUNT]) {
2348 PPSENDF(&ftpc->pp, "ACCT %s", data->set.str[STRING_FTP_ACCOUNT]);
2349 state(conn, FTP_ACCT);
2352 failf(data, "ACCT requested but none available");
2353 result = CURLE_LOGIN_DENIED;
2357 /* All other response codes, like:
2359 530 User ... access denied
2360 (the server denies to log the specified user) */
2362 if(conn->data->set.str[STRING_FTP_ALTERNATIVE_TO_USER] &&
2363 !conn->data->state.ftp_trying_alternative) {
2364 /* Ok, USER failed. Let's try the supplied command. */
2365 PPSENDF(&conn->proto.ftpc.pp, "%s",
2366 conn->data->set.str[STRING_FTP_ALTERNATIVE_TO_USER]);
2367 conn->data->state.ftp_trying_alternative = TRUE;
2368 state(conn, FTP_USER);
2372 failf(data, "Access denied: %03d", ftpcode);
2373 result = CURLE_LOGIN_DENIED;
2379 /* for ACCT response */
2380 static CURLcode ftp_state_acct_resp(struct connectdata *conn,
2383 CURLcode result = CURLE_OK;
2384 struct SessionHandle *data = conn->data;
2385 if(ftpcode != 230) {
2386 failf(data, "ACCT rejected by server: %03d", ftpcode);
2387 result = CURLE_FTP_WEIRD_PASS_REPLY; /* FIX */
2390 result = ftp_state_loggedin(conn);
2396 static CURLcode ftp_statemach_act(struct connectdata *conn)
2399 curl_socket_t sock = conn->sock[FIRSTSOCKET];
2400 struct SessionHandle *data=conn->data;
2402 struct ftp_conn *ftpc = &conn->proto.ftpc;
2403 struct pingpong *pp = &ftpc->pp;
2404 static const char ftpauth[][4] = { "SSL", "TLS" };
2408 return Curl_pp_flushsend(pp);
2410 /* we read a piece of response */
2411 result = ftp_readresp(sock, pp, &ftpcode, &nread);
2416 /* we have now received a full FTP server response */
2417 switch(ftpc->state) {
2419 if(ftpcode != 220) {
2420 failf(data, "Got a %03d ftp-server response when 220 was expected",
2422 return CURLE_FTP_WEIRD_SERVER_REPLY;
2425 /* We have received a 220 response fine, now we proceed. */
2426 #if defined(HAVE_KRB4) || defined(HAVE_GSSAPI)
2428 /* If not anonymous login, try a secure login. Note that this
2429 procedure is still BLOCKING. */
2431 Curl_sec_request_prot(conn, "private");
2432 /* We set private first as default, in case the line below fails to
2433 set a valid level */
2434 Curl_sec_request_prot(conn, data->set.str[STRING_KRB_LEVEL]);
2436 if(Curl_sec_login(conn) != CURLE_OK)
2437 infof(data, "Logging in with password in cleartext!\n");
2439 infof(data, "Authentication successful\n");
2443 if(data->set.ftp_ssl && !conn->ssl[FIRSTSOCKET].use) {
2444 /* We don't have a SSL/TLS connection yet, but FTPS is
2445 requested. Try a FTPS connection now */
2448 switch(data->set.ftpsslauth) {
2449 case CURLFTPAUTH_DEFAULT:
2450 case CURLFTPAUTH_SSL:
2451 ftpc->count2 = 1; /* add one to get next */
2454 case CURLFTPAUTH_TLS:
2455 ftpc->count2 = -1; /* subtract one to get next */
2459 failf(data, "unsupported parameter to CURLOPT_FTPSSLAUTH: %d",
2460 (int)data->set.ftpsslauth);
2461 return CURLE_UNKNOWN_OPTION; /* we don't know what to do */
2463 PPSENDF(&ftpc->pp, "AUTH %s", ftpauth[ftpc->count1]);
2464 state(conn, FTP_AUTH);
2467 result = ftp_state_user(conn);
2475 /* we have gotten the response to a previous AUTH command */
2477 /* RFC2228 (page 5) says:
2479 * If the server is willing to accept the named security mechanism,
2480 * and does not require any security data, it must respond with
2481 * reply code 234/334.
2484 if((ftpcode == 234) || (ftpcode == 334)) {
2485 /* Curl_ssl_connect is BLOCKING */
2486 result = Curl_ssl_connect(conn, FIRSTSOCKET);
2487 if(CURLE_OK == result) {
2488 conn->ssl[SECONDARYSOCKET].use = FALSE; /* clear-text data */
2489 result = ftp_state_user(conn);
2492 else if(ftpc->count3 < 1) {
2494 ftpc->count1 += ftpc->count2; /* get next attempt */
2495 result = Curl_pp_sendf(&ftpc->pp, "AUTH %s", ftpauth[ftpc->count1]);
2496 /* remain in this same state */
2499 if(data->set.ftp_ssl > CURLUSESSL_TRY)
2500 /* we failed and CURLUSESSL_CONTROL or CURLUSESSL_ALL is set */
2501 result = CURLE_USE_SSL_FAILED;
2503 /* ignore the failure and continue */
2504 result = ftp_state_user(conn);
2513 result = ftp_state_user_resp(conn, ftpcode, ftpc->state);
2517 result = ftp_state_acct_resp(conn, ftpcode);
2521 PPSENDF(&ftpc->pp, "PROT %c",
2522 data->set.ftp_ssl == CURLUSESSL_CONTROL ? 'C' : 'P');
2523 state(conn, FTP_PROT);
2528 if(ftpcode/100 == 2)
2529 /* We have enabled SSL for the data connection! */
2530 conn->ssl[SECONDARYSOCKET].use =
2531 (bool)(data->set.ftp_ssl != CURLUSESSL_CONTROL);
2532 /* FTP servers typically responds with 500 if they decide to reject
2534 else if(data->set.ftp_ssl > CURLUSESSL_CONTROL)
2535 /* we failed and bails out */
2536 return CURLE_USE_SSL_FAILED;
2538 if(data->set.ftp_ccc) {
2539 /* CCC - Clear Command Channel
2541 PPSENDF(&ftpc->pp, "CCC", NULL);
2542 state(conn, FTP_CCC);
2545 result = ftp_state_pwd(conn);
2553 /* First shut down the SSL layer (note: this call will block) */
2554 result = Curl_ssl_shutdown(conn, FIRSTSOCKET);
2557 failf(conn->data, "Failed to clear the command channel (CCC)");
2562 /* Then continue as normal */
2563 result = ftp_state_pwd(conn);
2569 if(ftpcode == 257) {
2570 char *ptr=&data->state.buffer[4]; /* start on the first letter */
2574 dir = malloc(nread + 1);
2576 return CURLE_OUT_OF_MEMORY;
2578 /* Reply format is like
2579 257<space>"<directory-name>"<space><commentary> and the RFC959
2582 The directory name can contain any character; embedded
2583 double-quotes should be escaped by double-quotes (the
2584 "quote-doubling" convention).
2587 /* it started good */
2589 for(store = dir; *ptr;) {
2591 if('\"' == ptr[1]) {
2592 /* "quote-doubling" */
2598 *store = '\0'; /* zero terminate */
2599 break; /* get out of this loop */
2608 free(ftpc->entrypath);
2609 ftpc->entrypath =dir; /* remember this */
2610 infof(data, "Entry path is '%s'\n", ftpc->entrypath);
2611 /* also save it where getinfo can access it: */
2612 data->state.most_recent_ftp_entrypath = ftpc->entrypath;
2614 /* If the path name does not look like an absolute path (i.e.: it
2615 does not start with a '/'), we probably need some server-dependent
2616 adjustments. For example, this is the case when connecting to
2617 an OS400 FTP server: this server supports two name syntaxes,
2618 the default one being incompatible with standard pathes. In
2619 addition, this server switches automatically to the regular path
2620 syntax when one is encountered in a command: this results in
2621 having an entrypath in the wrong syntax when later used in CWD.
2622 The method used here is to check the server OS: we do it only
2623 if the path name looks strange to minimize overhead on other
2626 if(!ftpc->server_os && ftpc->entrypath[0] != '/') {
2627 PPSENDF(&ftpc->pp, "SYST", NULL);
2628 state(conn, FTP_SYST);
2633 /* couldn't get the path */
2635 infof(data, "Failed to figure out path\n");
2638 state(conn, FTP_STOP); /* we are done with the CONNECT phase! */
2639 DEBUGF(infof(data, "protocol connect phase DONE\n"));
2643 if(ftpcode == 215) {
2644 char *ptr=&data->state.buffer[4]; /* start on the first letter */
2648 os = malloc(nread + 1);
2650 return CURLE_OUT_OF_MEMORY;
2652 /* Reply format is like
2653 215<space><OS-name><space><commentary>
2657 for(store = os; *ptr && *ptr != ' ';)
2659 *store = '\0'; /* zero terminate */
2660 ftpc->server_os = os;
2662 /* Check for special servers here. */
2664 if(strequal(ftpc->server_os, "OS/400")) {
2665 /* Force OS400 name format 1. */
2666 PPSENDF(&ftpc->pp, "SITE NAMEFMT 1", NULL);
2667 state(conn, FTP_NAMEFMT);
2671 /* Nothing special for the target server. */
2675 /* Cannot identify server OS. Continue anyway and cross fingers. */
2678 state(conn, FTP_STOP); /* we are done with the CONNECT phase! */
2679 DEBUGF(infof(data, "protocol connect phase DONE\n"));
2683 if(ftpcode == 250) {
2684 /* Name format change successful: reload initial path. */
2685 ftp_state_pwd(conn);
2689 state(conn, FTP_STOP); /* we are done with the CONNECT phase! */
2690 DEBUGF(infof(data, "protocol connect phase DONE\n"));
2695 case FTP_RETR_PREQUOTE:
2696 case FTP_STOR_PREQUOTE:
2697 if((ftpcode >= 400) && !ftpc->count2) {
2698 /* failure response code, and not allowed to fail */
2699 failf(conn->data, "QUOT command failed with %03d", ftpcode);
2700 return CURLE_QUOTE_ERROR;
2702 result = ftp_state_quote(conn, FALSE, ftpc->state);
2709 if(ftpcode/100 != 2) {
2710 /* failure to CWD there */
2711 if(conn->data->set.ftp_create_missing_dirs &&
2712 ftpc->count1 && !ftpc->count2) {
2714 ftpc->count2++; /* counter to prevent CWD-MKD loops */
2715 PPSENDF(&ftpc->pp, "MKD %s", ftpc->dirs[ftpc->count1 - 1]);
2716 state(conn, FTP_MKD);
2719 /* return failure */
2720 failf(data, "Server denied you to change to the given directory");
2721 ftpc->cwdfail = TRUE; /* don't remember this path as we failed
2723 return CURLE_REMOTE_ACCESS_DENIED;
2729 if(++ftpc->count1 <= ftpc->dirdepth) {
2731 PPSENDF(&ftpc->pp, "CWD %s", ftpc->dirs[ftpc->count1 - 1]);
2734 result = ftp_state_post_cwd(conn);
2742 if((ftpcode/100 != 2) && !ftpc->count3--) {
2743 /* failure to MKD the dir */
2744 failf(data, "Failed to MKD dir: %03d", ftpcode);
2745 return CURLE_REMOTE_ACCESS_DENIED;
2747 state(conn, FTP_CWD);
2749 PPSENDF(&ftpc->pp, "CWD %s", ftpc->dirs[ftpc->count1 - 1]);
2753 result = ftp_state_mdtm_resp(conn, ftpcode);
2760 result = ftp_state_type_resp(conn, ftpcode, ftpc->state);
2766 result = ftp_state_size_resp(conn, ftpcode, ftpc->state);
2771 result = ftp_state_rest_resp(conn, ftpcode, ftpc->state);
2775 if(ftpcode != 200) {
2776 /* there only is this one standard OK return code. */
2777 failf(data, "PRET command not accepted: %03d", ftpcode);
2778 return CURLE_FTP_PRET_FAILED;
2780 result = ftp_state_use_pasv(conn);
2784 result = ftp_state_pasv_resp(conn, ftpcode);
2788 result = ftp_state_port_resp(conn, ftpcode);
2793 result = ftp_state_get_resp(conn, ftpcode, ftpc->state);
2797 result = ftp_state_stor_resp(conn, ftpcode);
2801 /* fallthrough, just stop! */
2803 /* internal error */
2804 state(conn, FTP_STOP);
2813 /* called repeatedly until done from multi.c */
2814 static CURLcode ftp_multi_statemach(struct connectdata *conn,
2817 struct ftp_conn *ftpc = &conn->proto.ftpc;
2818 CURLcode result = Curl_pp_multi_statemach(&ftpc->pp);
2820 /* Check for the state outside of the Curl_socket_ready() return code checks
2821 since at times we are in fact already in this state when this function
2823 *done = (bool)(ftpc->state == FTP_STOP);
2828 static CURLcode ftp_easy_statemach(struct connectdata *conn)
2830 struct ftp_conn *ftpc = &conn->proto.ftpc;
2831 struct pingpong *pp = &ftpc->pp;
2832 CURLcode result = CURLE_OK;
2834 while(ftpc->state != FTP_STOP) {
2835 result = Curl_pp_easy_statemach(pp);
2844 * Allocate and initialize the struct FTP for the current SessionHandle. If
2848 #if defined(__INTEL_COMPILER) && (__INTEL_COMPILER == 910) && \
2849 defined(__OPTIMIZE__) && defined(__unix__) && defined(__i386__)
2850 /* workaround icc 9.1 optimizer issue */
2851 #pragma optimize("", off)
2854 static CURLcode ftp_init(struct connectdata *conn)
2858 if(NULL == conn->data->state.proto.ftp) {
2859 conn->data->state.proto.ftp = malloc(sizeof(struct FTP));
2860 if(NULL == conn->data->state.proto.ftp)
2861 return CURLE_OUT_OF_MEMORY;
2864 ftp = conn->data->state.proto.ftp;
2866 /* get some initial data into the ftp struct */
2867 ftp->bytecountp = &conn->data->req.bytecount;
2868 ftp->transfer = FTPTRANSFER_BODY;
2869 ftp->downloadsize = 0;
2871 /* No need to duplicate user+password, the connectdata struct won't change
2872 during a session, but we re-init them here since on subsequent inits
2873 since the conn struct may have changed or been replaced.
2875 ftp->user = conn->user;
2876 ftp->passwd = conn->passwd;
2877 if(TRUE == isBadFtpString(ftp->user))
2878 return CURLE_URL_MALFORMAT;
2879 if(TRUE == isBadFtpString(ftp->passwd))
2880 return CURLE_URL_MALFORMAT;
2882 conn->proto.ftpc.known_filesize = -1; /* unknown size for now */
2887 #if defined(__INTEL_COMPILER) && (__INTEL_COMPILER == 910) && \
2888 defined(__OPTIMIZE__) && defined(__unix__) && defined(__i386__)
2889 /* workaround icc 9.1 optimizer issue */
2890 #pragma optimize("", on)
2894 * ftp_connect() should do everything that is to be considered a part of
2895 * the connection phase.
2897 * The variable 'done' points to will be TRUE if the protocol-layer connect
2898 * phase is done when this function returns, or FALSE is not. When called as
2899 * a part of the easy interface, it will always be TRUE.
2901 static CURLcode ftp_connect(struct connectdata *conn,
2902 bool *done) /* see description above */
2905 struct ftp_conn *ftpc = &conn->proto.ftpc;
2906 struct SessionHandle *data=conn->data;
2907 struct pingpong *pp = &ftpc->pp;
2909 *done = FALSE; /* default to not done yet */
2911 /* If there already is a protocol-specific struct allocated for this
2912 sessionhandle, deal with it */
2913 Curl_reset_reqproto(conn);
2915 result = ftp_init(conn);
2916 if(CURLE_OK != result)
2919 /* We always support persistent connections on ftp */
2920 conn->bits.close = FALSE;
2922 pp->response_time = RESP_TIMEOUT; /* set default response time-out */
2923 pp->statemach_act = ftp_statemach_act;
2924 pp->endofresp = ftp_endofresp;
2927 if(conn->bits.tunnel_proxy && conn->bits.httpproxy) {
2928 /* for FTP over HTTP proxy */
2929 struct HTTP http_proxy;
2930 struct FTP *ftp_save;
2933 /* We want "seamless" FTP operations through HTTP proxy tunnel */
2935 /* Curl_proxyCONNECT is based on a pointer to a struct HTTP at the member
2936 * conn->proto.http; we want FTP through HTTP and we have to change the
2937 * member temporarily for connecting to the HTTP proxy. After
2938 * Curl_proxyCONNECT we have to set back the member to the original struct
2941 ftp_save = data->state.proto.ftp;
2942 memset(&http_proxy, 0, sizeof(http_proxy));
2943 data->state.proto.http = &http_proxy;
2945 result = Curl_proxyCONNECT(conn, FIRSTSOCKET,
2946 conn->host.name, conn->remote_port);
2948 data->state.proto.ftp = ftp_save;
2950 if(CURLE_OK != result)
2954 if(conn->handler->flags & PROTOPT_SSL) {
2956 result = Curl_ssl_connect(conn, FIRSTSOCKET);
2961 Curl_pp_init(pp); /* init the generic pingpong data */
2963 /* When we connect, we start in the state where we await the 220
2965 state(conn, FTP_WAIT220);
2967 if(data->state.used_interface == Curl_if_multi)
2968 result = ftp_multi_statemach(conn, done);
2970 result = ftp_easy_statemach(conn);
2978 /***********************************************************************
2982 * The DONE function. This does what needs to be done after a single DO has
2985 * Input argument is already checked for validity.
2987 static CURLcode ftp_done(struct connectdata *conn, CURLcode status,
2990 struct SessionHandle *data = conn->data;
2991 struct FTP *ftp = data->state.proto.ftp;
2992 struct ftp_conn *ftpc = &conn->proto.ftpc;
2993 struct pingpong *pp = &ftpc->pp;
2996 CURLcode result=CURLE_OK;
2997 bool was_ctl_valid = ftpc->ctl_valid;
2999 const char *path_to_use = data->state.path;
3002 /* When the easy handle is removed from the multi while libcurl is still
3003 * trying to resolve the host name, it seems that the ftp struct is not
3004 * yet initialized, but the removal action calls Curl_done() which calls
3005 * this function. So we simply return success if no ftp pointer is set.
3010 case CURLE_BAD_DOWNLOAD_RESUME:
3011 case CURLE_FTP_WEIRD_PASV_REPLY:
3012 case CURLE_FTP_PORT_FAILED:
3013 case CURLE_FTP_COULDNT_SET_TYPE:
3014 case CURLE_FTP_COULDNT_RETR_FILE:
3015 case CURLE_UPLOAD_FAILED:
3016 case CURLE_REMOTE_ACCESS_DENIED:
3017 case CURLE_FILESIZE_EXCEEDED:
3018 case CURLE_REMOTE_FILE_NOT_FOUND:
3019 case CURLE_WRITE_ERROR:
3020 /* the connection stays alive fine even though this happened */
3022 case CURLE_OK: /* doesn't affect the control connection's status */
3024 ftpc->ctl_valid = was_ctl_valid;
3027 /* until we cope better with prematurely ended requests, let them
3028 * fallback as if in complete failure */
3029 default: /* by default, an error means the control connection is
3030 wedged and should not be used anymore */
3031 ftpc->ctl_valid = FALSE;
3032 ftpc->cwdfail = TRUE; /* set this TRUE to prevent us to remember the
3033 current path, as this connection is going */
3034 conn->bits.close = TRUE; /* marked for closure */
3035 result = status; /* use the already set error code */
3039 /* now store a copy of the directory we are in */
3041 free(ftpc->prevpath);
3043 if(data->set.wildcardmatch) {
3044 if(data->set.chunk_end && ftpc->file) {
3045 data->set.chunk_end(data->wildcard.customptr);
3047 ftpc->known_filesize = -1;
3050 /* get the "raw" path */
3051 path = curl_easy_unescape(data, path_to_use, 0, NULL);
3053 /* out of memory, but we can limp along anyway (and should try to
3054 * since we're in the out of memory cleanup path) */
3055 ftpc->prevpath = NULL; /* no path */
3058 size_t flen = ftpc->file?strlen(ftpc->file):0; /* file is "raw" already */
3059 size_t dlen = strlen(path)-flen;
3060 if(!ftpc->cwdfail) {
3061 if(dlen && (data->set.ftp_filemethod != FTPFILE_NOCWD)) {
3062 ftpc->prevpath = path;
3064 /* if 'path' is not the whole string */
3065 ftpc->prevpath[dlen]=0; /* terminate */
3068 /* we never changed dir */
3069 ftpc->prevpath=strdup("");
3073 infof(data, "Remembering we are in dir \"%s\"\n", ftpc->prevpath);
3076 ftpc->prevpath = NULL; /* no path */
3080 /* free the dir tree and file parts */
3083 /* shut down the socket to inform the server we're done */
3086 shutdown(conn->sock[SECONDARYSOCKET],2); /* SD_BOTH */
3089 if(conn->sock[SECONDARYSOCKET] != CURL_SOCKET_BAD) {
3090 if(!result && ftpc->dont_check && data->req.maxdownload > 0)
3091 /* partial download completed */
3092 result = Curl_pp_sendf(pp, "ABOR");
3094 if(conn->ssl[SECONDARYSOCKET].use) {
3095 /* The secondary socket is using SSL so we must close down that part
3096 first before we close the socket for real */
3097 Curl_ssl_close(conn, SECONDARYSOCKET);
3099 /* Note that we keep "use" set to TRUE since that (next) connection is
3100 still requested to use SSL */
3102 if(CURL_SOCKET_BAD != conn->sock[SECONDARYSOCKET]) {
3103 sclose(conn->sock[SECONDARYSOCKET]);
3104 conn->sock[SECONDARYSOCKET] = CURL_SOCKET_BAD;
3108 if(!result && (ftp->transfer == FTPTRANSFER_BODY) && ftpc->ctl_valid &&
3109 pp->pending_resp && !premature) {
3111 * Let's see what the server says about the transfer we just performed,
3112 * but lower the timeout as sometimes this connection has died while the
3113 * data has been transferred. This happens when doing through NATs etc that
3114 * abandon old silent connections.
3116 long old_time = pp->response_time;
3118 pp->response_time = 60*1000; /* give it only a minute for now */
3119 pp->response = Curl_tvnow(); /* timeout relative now */
3121 result = Curl_GetFTPResponse(&nread, conn, &ftpcode);
3123 pp->response_time = old_time; /* set this back to previous value */
3125 if(!nread && (CURLE_OPERATION_TIMEDOUT == result)) {
3126 failf(data, "control connection looks dead");
3127 ftpc->ctl_valid = FALSE; /* mark control connection as bad */
3128 conn->bits.close = TRUE; /* mark for closure */
3134 if(ftpc->dont_check && data->req.maxdownload > 0) {
3135 /* we have just sent ABOR and there is no reliable way to check if it was
3136 * successful or not; we have to close the connection now */
3137 infof(data, "partial download completed, closing connection\n");
3138 conn->bits.close = TRUE; /* mark for closure */
3142 if(!ftpc->dont_check) {
3143 /* 226 Transfer complete, 250 Requested file action okay, completed. */
3144 if((ftpcode != 226) && (ftpcode != 250)) {
3145 failf(data, "server did not report OK, got %d", ftpcode);
3146 result = CURLE_PARTIAL_FILE;
3151 if(result || premature)
3152 /* the response code from the transfer showed an error already so no
3153 use checking further */
3155 else if(data->set.upload) {
3156 if((-1 != data->set.infilesize) &&
3157 (data->set.infilesize != *ftp->bytecountp) &&
3159 (ftp->transfer == FTPTRANSFER_BODY)) {
3160 failf(data, "Uploaded unaligned file size (%" FORMAT_OFF_T
3161 " out of %" FORMAT_OFF_T " bytes)",
3162 *ftp->bytecountp, data->set.infilesize);
3163 result = CURLE_PARTIAL_FILE;
3167 if((-1 != data->req.size) &&
3168 (data->req.size != *ftp->bytecountp) &&
3169 #ifdef CURL_DO_LINEEND_CONV
3170 /* Most FTP servers don't adjust their file SIZE response for CRLFs, so
3171 * we'll check to see if the discrepancy can be explained by the number
3172 * of CRLFs we've changed to LFs.
3174 ((data->req.size + data->state.crlf_conversions) !=
3175 *ftp->bytecountp) &&
3176 #endif /* CURL_DO_LINEEND_CONV */
3177 (data->req.maxdownload != *ftp->bytecountp)) {
3178 failf(data, "Received only partial file: %" FORMAT_OFF_T " bytes",
3180 result = CURLE_PARTIAL_FILE;
3182 else if(!ftpc->dont_check &&
3183 !*ftp->bytecountp &&
3184 (data->req.size>0)) {
3185 failf(data, "No data was received!");
3186 result = CURLE_FTP_COULDNT_RETR_FILE;
3190 /* clear these for next connection */
3191 ftp->transfer = FTPTRANSFER_BODY;
3192 ftpc->dont_check = FALSE;
3194 /* Send any post-transfer QUOTE strings? */
3195 if(!status && !result && !premature && data->set.postquote)
3196 result = ftp_sendquote(conn, data->set.postquote);
3201 /***********************************************************************
3205 * Where a 'quote' means a list of custom commands to send to the server.
3206 * The quote list is passed as an argument.
3212 CURLcode ftp_sendquote(struct connectdata *conn, struct curl_slist *quote)
3214 struct curl_slist *item;
3218 struct ftp_conn *ftpc = &conn->proto.ftpc;
3219 struct pingpong *pp = &ftpc->pp;
3224 char *cmd = item->data;
3225 bool acceptfail = FALSE;
3227 /* if a command starts with an asterisk, which a legal FTP command never
3228 can, the command will be allowed to fail without it causing any
3229 aborts or cancels etc. It will cause libcurl to act as if the command
3230 is successful, whatever the server reponds. */
3237 FTPSENDF(conn, "%s", cmd);
3239 pp->response = Curl_tvnow(); /* timeout relative now */
3241 result = Curl_GetFTPResponse(&nread, conn, &ftpcode);
3245 if(!acceptfail && (ftpcode >= 400)) {
3246 failf(conn->data, "QUOT string not accepted: %s", cmd);
3247 return CURLE_QUOTE_ERROR;
3257 /***********************************************************************
3261 * Returns TRUE if we in the current situation should send TYPE
3263 static int ftp_need_type(struct connectdata *conn,
3266 return conn->proto.ftpc.transfertype != (ascii_wanted?'A':'I');
3269 /***********************************************************************
3273 * Set TYPE. We only deal with ASCII or BINARY so this function
3275 * If the transfer type is not sent, simulate on OK response in newstate
3277 static CURLcode ftp_nb_type(struct connectdata *conn,
3278 bool ascii, ftpstate newstate)
3280 struct ftp_conn *ftpc = &conn->proto.ftpc;
3282 char want = (char)(ascii?'A':'I');
3284 if(ftpc->transfertype == want) {
3285 state(conn, newstate);
3286 return ftp_state_type_resp(conn, 200, newstate);
3289 PPSENDF(&ftpc->pp, "TYPE %c", want);
3290 state(conn, newstate);
3292 /* keep track of our current transfer type */
3293 ftpc->transfertype = want;
3297 /***************************************************************************
3299 * ftp_pasv_verbose()
3301 * This function only outputs some informationals about this second connection
3302 * when we've issued a PASV command before and thus we have connected to a
3303 * possibly new IP address.
3306 #ifndef CURL_DISABLE_VERBOSE_STRINGS
3308 ftp_pasv_verbose(struct connectdata *conn,
3310 char *newhost, /* ascii version */
3314 Curl_printable_address(ai, buf, sizeof(buf));
3315 infof(conn->data, "Connecting to %s (%s) port %d\n", newhost, buf, port);
3320 Check if this is a range download, and if so, set the internal variables
3324 static CURLcode ftp_range(struct connectdata *conn)
3326 curl_off_t from, to;
3329 struct SessionHandle *data = conn->data;
3330 struct ftp_conn *ftpc = &conn->proto.ftpc;
3332 if(data->state.use_range && data->state.range) {
3333 from=curlx_strtoofft(data->state.range, &ptr, 0);
3334 while(*ptr && (ISSPACE(*ptr) || (*ptr=='-')))
3336 to=curlx_strtoofft(ptr, &ptr2, 0);
3338 /* we didn't get any digit */
3341 if((-1 == to) && (from>=0)) {
3343 data->state.resume_from = from;
3344 DEBUGF(infof(conn->data, "FTP RANGE %" FORMAT_OFF_T " to end of file\n",
3349 data->req.maxdownload = -from;
3350 data->state.resume_from = from;
3351 DEBUGF(infof(conn->data, "FTP RANGE the last %" FORMAT_OFF_T " bytes\n",
3356 data->req.maxdownload = (to-from)+1; /* include last byte */
3357 data->state.resume_from = from;
3358 DEBUGF(infof(conn->data, "FTP RANGE from %" FORMAT_OFF_T
3359 " getting %" FORMAT_OFF_T " bytes\n",
3360 from, data->req.maxdownload));
3362 DEBUGF(infof(conn->data, "range-download from %" FORMAT_OFF_T
3363 " to %" FORMAT_OFF_T ", totally %" FORMAT_OFF_T " bytes\n",
3364 from, to, data->req.maxdownload));
3365 ftpc->dont_check = TRUE; /* dont check for successful transfer */
3368 data->req.maxdownload = -1;
3376 * This function shall be called when the second FTP (data) connection is
3380 static CURLcode ftp_nextconnect(struct connectdata *conn)
3382 struct SessionHandle *data=conn->data;
3383 struct ftp_conn *ftpc = &conn->proto.ftpc;
3384 CURLcode result = CURLE_OK;
3386 /* the ftp struct is inited in ftp_connect() */
3387 struct FTP *ftp = data->state.proto.ftp;
3389 DEBUGF(infof(data, "DO-MORE phase starts\n"));
3391 if(ftp->transfer <= FTPTRANSFER_INFO) {
3392 /* a transfer is about to take place, or if not a file name was given
3393 so we'll do a SIZE on it later and then we need the right TYPE first */
3395 if(data->set.upload) {
3396 result = ftp_nb_type(conn, data->set.prefer_ascii, FTP_STOR_TYPE);
3402 ftp->downloadsize = -1; /* unknown as of yet */
3404 result = ftp_range(conn);
3407 else if(data->set.ftp_list_only || !ftpc->file) {
3408 /* The specified path ends with a slash, and therefore we think this
3409 is a directory that is requested, use LIST. But before that we
3410 need to set ASCII transfer mode. */
3412 /* But only if a body transfer was requested. */
3413 if(ftp->transfer == FTPTRANSFER_BODY) {
3414 result = ftp_nb_type(conn, TRUE, FTP_LIST_TYPE);
3418 /* otherwise just fall through */
3421 result = ftp_nb_type(conn, data->set.prefer_ascii, FTP_RETR_TYPE);
3426 result = ftp_easy_statemach(conn);
3429 if((result == CURLE_OK) && (ftp->transfer != FTPTRANSFER_BODY))
3430 /* no data to transfer. FIX: it feels like a kludge to have this here
3432 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
3434 /* end of transfer */
3435 DEBUGF(infof(data, "DO-MORE phase ends with %d\n", (int)result));
3442 /***********************************************************************
3446 * This is the actual DO function for FTP. Get a file/directory according to
3447 * the options previously setup.
3451 CURLcode ftp_perform(struct connectdata *conn,
3452 bool *connected, /* connect status after PASV / PORT */
3455 /* this is FTP and no proxy */
3456 CURLcode result=CURLE_OK;
3458 DEBUGF(infof(conn->data, "DO phase starts\n"));
3460 if(conn->data->set.opt_no_body) {
3461 /* requested no body means no transfer... */
3462 struct FTP *ftp = conn->data->state.proto.ftp;
3463 ftp->transfer = FTPTRANSFER_INFO;
3467 *dophase_done = FALSE; /* not done yet */
3469 /* start the first command in the DO phase */
3470 result = ftp_state_quote(conn, TRUE, FTP_QUOTE);
3474 /* run the state-machine */
3475 if(conn->data->state.used_interface == Curl_if_multi)
3476 result = ftp_multi_statemach(conn, dophase_done);
3478 result = ftp_easy_statemach(conn);
3479 *dophase_done = TRUE; /* with the easy interface we are done here */
3481 *connected = conn->bits.tcpconnect;
3484 DEBUGF(infof(conn->data, "DO phase is complete\n"));
3489 static void wc_data_dtor(void *ptr)
3491 struct ftp_wc_tmpdata *tmp = ptr;
3493 Curl_ftp_parselist_data_free(&tmp->parser);
3497 static CURLcode init_wc_data(struct connectdata *conn)
3500 char *path = conn->data->state.path;
3501 struct WildcardData *wildcard = &(conn->data->wildcard);
3502 CURLcode ret = CURLE_OK;
3503 struct ftp_wc_tmpdata *ftp_tmp;
3505 last_slash = strrchr(conn->data->state.path, '/');
3508 if(last_slash[0] == '\0') {
3509 wildcard->state = CURLWC_CLEAN;
3510 ret = ftp_parse_url_path(conn);
3514 wildcard->pattern = strdup(last_slash);
3515 if(!wildcard->pattern)
3516 return CURLE_OUT_OF_MEMORY;
3517 last_slash[0] = '\0'; /* cut file from path */
3520 else { /* there is only 'wildcard pattern' or nothing */
3522 wildcard->pattern = strdup(path);
3523 if(!wildcard->pattern)
3524 return CURLE_OUT_OF_MEMORY;
3527 else { /* only list */
3528 wildcard->state = CURLWC_CLEAN;
3529 ret = ftp_parse_url_path(conn);
3534 /* program continues only if URL is not ending with slash, allocate needed
3535 resources for wildcard transfer */
3537 /* allocate ftp protocol specific temporary wildcard data */
3538 ftp_tmp = malloc(sizeof(struct ftp_wc_tmpdata));
3540 return CURLE_OUT_OF_MEMORY;
3543 /* INITIALIZE parselist structure */
3544 ftp_tmp->parser = Curl_ftp_parselist_data_alloc();
3545 if(!ftp_tmp->parser) {
3547 return CURLE_OUT_OF_MEMORY;
3550 wildcard->tmp = ftp_tmp; /* put it to the WildcardData tmp pointer */
3551 wildcard->tmp_dtor = wc_data_dtor;
3553 /* wildcard does not support NOCWD option (assert it?) */
3554 if(conn->data->set.ftp_filemethod == FTPFILE_NOCWD)
3555 conn->data->set.ftp_filemethod = FTPFILE_MULTICWD;
3557 /* try to parse ftp url */
3558 ret = ftp_parse_url_path(conn);
3563 /* backup old write_function */
3564 ftp_tmp->backup.write_function = conn->data->set.fwrite_func;
3565 /* parsing write function */
3566 conn->data->set.fwrite_func = Curl_ftp_parselist;
3567 /* backup old file descriptor */
3568 ftp_tmp->backup.file_descriptor = conn->data->set.out;
3569 /* let the writefunc callback know what curl pointer is working with */
3570 conn->data->set.out = conn;
3572 wildcard->path = strdup(conn->data->state.path);
3573 if(!wildcard->path) {
3574 return CURLE_OUT_OF_MEMORY;
3577 infof(conn->data, "Wildcard - Parsing started\n");
3581 /* This is called recursively */
3582 static CURLcode wc_statemach(struct connectdata *conn)
3584 struct WildcardData * const wildcard = &(conn->data->wildcard);
3585 CURLcode ret = CURLE_OK;
3587 switch (wildcard->state) {
3589 ret = init_wc_data(conn);
3590 if(wildcard->state == CURLWC_CLEAN)
3594 wildcard->state = ret ? CURLWC_ERROR : CURLWC_MATCHING;
3597 case CURLWC_MATCHING: {
3598 /* In this state is LIST response successfully parsed, so lets restore
3599 previous WRITEFUNCTION callback and WRITEDATA pointer */
3600 struct ftp_wc_tmpdata *ftp_tmp = wildcard->tmp;
3601 conn->data->set.fwrite_func = ftp_tmp->backup.write_function;
3602 conn->data->set.out = ftp_tmp->backup.file_descriptor;
3603 wildcard->state = CURLWC_DOWNLOADING;
3605 if(Curl_ftp_parselist_geterror(ftp_tmp->parser)) {
3606 /* error found in LIST parsing */
3607 wildcard->state = CURLWC_CLEAN;
3608 return wc_statemach(conn);
3610 else if(wildcard->filelist->size == 0) {
3611 /* no corresponding file */
3612 wildcard->state = CURLWC_CLEAN;
3613 return CURLE_REMOTE_FILE_NOT_FOUND;
3615 return wc_statemach(conn);
3618 case CURLWC_DOWNLOADING: {
3619 /* filelist has at least one file, lets get first one */
3620 struct ftp_conn *ftpc = &conn->proto.ftpc;
3621 struct curl_fileinfo *finfo = wildcard->filelist->head->ptr;
3622 char *tmp_path = malloc(strlen(conn->data->state.path) +
3623 strlen(finfo->filename) + 1);
3625 return CURLE_OUT_OF_MEMORY;
3629 /* make full path to matched file */
3630 strcat(tmp_path, wildcard->path);
3631 strcat(tmp_path, finfo->filename);
3632 /* switch default "state.pathbuffer" and tmp_path, good to see
3633 ftp_parse_url_path function to understand this trick */
3634 if(conn->data->state.pathbuffer)
3635 free(conn->data->state.pathbuffer);
3636 conn->data->state.pathbuffer = tmp_path;
3637 conn->data->state.path = tmp_path;
3639 infof(conn->data, "Wildcard - START of \"%s\"\n", finfo->filename);
3640 if(conn->data->set.chunk_bgn) {
3641 long userresponse = conn->data->set.chunk_bgn(
3642 finfo, wildcard->customptr, (int)wildcard->filelist->size);
3643 switch(userresponse) {
3644 case CURL_CHUNK_BGN_FUNC_SKIP:
3645 infof(conn->data, "Wildcard - \"%s\" skipped by user\n",
3647 wildcard->state = CURLWC_SKIP;
3648 return wc_statemach(conn);
3649 case CURL_CHUNK_BGN_FUNC_FAIL:
3650 return CURLE_CHUNK_FAILED;
3654 if(finfo->filetype != CURLFILETYPE_FILE) {
3655 wildcard->state = CURLWC_SKIP;
3656 return wc_statemach(conn);
3659 if(finfo->flags & CURLFINFOFLAG_KNOWN_SIZE)
3660 ftpc->known_filesize = finfo->size;
3662 ret = ftp_parse_url_path(conn);
3667 /* we don't need the Curl_fileinfo of first file anymore */
3668 Curl_llist_remove(wildcard->filelist, wildcard->filelist->head, NULL);
3670 if(wildcard->filelist->size == 0) { /* remains only one file to down. */
3671 wildcard->state = CURLWC_CLEAN;
3672 /* after that will be ftp_do called once again and no transfer
3673 will be done because of CURLWC_CLEAN state */
3679 if(conn->data->set.chunk_end)
3680 conn->data->set.chunk_end(conn->data->wildcard.customptr);
3681 Curl_llist_remove(wildcard->filelist, wildcard->filelist->head, NULL);
3682 wildcard->state = (wildcard->filelist->size == 0) ?
3683 CURLWC_CLEAN : CURLWC_DOWNLOADING;
3684 return wc_statemach(conn);
3687 case CURLWC_CLEAN: {
3688 struct ftp_wc_tmpdata *ftp_tmp = wildcard->tmp;
3691 ret = Curl_ftp_parselist_geterror(ftp_tmp->parser);
3693 wildcard->state = ret ? CURLWC_ERROR : CURLWC_DONE;
3704 /***********************************************************************
3708 * This function is registered as 'curl_do' function. It decodes the path
3709 * parts etc as a wrapper to the actual DO function (ftp_perform).
3711 * The input argument is already checked for validity.
3713 static CURLcode ftp_do(struct connectdata *conn, bool *done)
3715 CURLcode retcode = CURLE_OK;
3717 *done = FALSE; /* default to false */
3720 Since connections can be re-used between SessionHandles, this might be a
3721 connection already existing but on a fresh SessionHandle struct so we must
3722 make sure we have a good 'struct FTP' to play with. For new connections,
3723 the struct FTP is allocated and setup in the ftp_connect() function.
3725 Curl_reset_reqproto(conn);
3726 retcode = ftp_init(conn);
3730 if(conn->data->set.wildcardmatch) {
3731 retcode = wc_statemach(conn);
3732 if(conn->data->wildcard.state == CURLWC_SKIP ||
3733 conn->data->wildcard.state == CURLWC_DONE) {
3734 /* do not call ftp_regular_transfer */
3737 if(retcode) /* error, loop or skipping the file */
3740 else { /* no wildcard FSM needed */
3741 retcode = ftp_parse_url_path(conn);
3746 retcode = ftp_regular_transfer(conn, done);
3752 CURLcode Curl_ftpsendf(struct connectdata *conn,
3753 const char *fmt, ...)
3755 ssize_t bytes_written;
3756 #define SBUF_SIZE 1024
3760 CURLcode res = CURLE_OK;
3761 #if defined(HAVE_KRB4) || defined(HAVE_GSSAPI)
3762 enum protection_level data_sec = conn->data_prot;
3767 vsnprintf(s, SBUF_SIZE-3, fmt, ap);
3770 strcat(s, "\r\n"); /* append a trailing CRLF */
3773 write_len = strlen(s);
3775 res = Curl_convert_to_network(conn->data, s, write_len);
3776 /* Curl_convert_to_network calls failf if unsuccessful */
3781 #if defined(HAVE_KRB4) || defined(HAVE_GSSAPI)
3782 conn->data_prot = PROT_CMD;
3784 res = Curl_write(conn, conn->sock[FIRSTSOCKET], sptr, write_len,
3786 #if defined(HAVE_KRB4) || defined(HAVE_GSSAPI)
3787 DEBUGASSERT(data_sec > PROT_NONE && data_sec < PROT_LAST);
3788 conn->data_prot = data_sec;
3794 if(conn->data->set.verbose)
3795 Curl_debug(conn->data, CURLINFO_HEADER_OUT,
3796 sptr, (size_t)bytes_written, conn);
3798 if(bytes_written != (ssize_t)write_len) {
3799 write_len -= bytes_written;
3800 sptr += bytes_written;
3809 /***********************************************************************
3813 * This should be called before calling sclose() on an ftp control connection
3814 * (not data connections). We should then wait for the response from the
3815 * server before returning. The calling code should then try to close the
3819 static CURLcode ftp_quit(struct connectdata *conn)
3821 CURLcode result = CURLE_OK;
3823 if(conn->proto.ftpc.ctl_valid) {
3824 PPSENDF(&conn->proto.ftpc.pp, "QUIT", NULL);
3825 state(conn, FTP_QUIT);
3827 result = ftp_easy_statemach(conn);
3833 /***********************************************************************
3837 * Disconnect from an FTP server. Cleanup protocol-specific per-connection
3838 * resources. BLOCKING.
3840 static CURLcode ftp_disconnect(struct connectdata *conn, bool dead_connection)
3842 struct ftp_conn *ftpc= &conn->proto.ftpc;
3843 struct pingpong *pp = &ftpc->pp;
3845 /* We cannot send quit unconditionally. If this connection is stale or
3846 bad in any way, sending quit and waiting around here will make the
3847 disconnect wait in vain and cause more problems than we need to.
3849 ftp_quit() will check the state of ftp->ctl_valid. If it's ok it
3850 will try to send the QUIT command, otherwise it will just return.
3853 ftpc->ctl_valid = FALSE;
3855 /* The FTP session may or may not have been allocated/setup at this point! */
3856 (void)ftp_quit(conn); /* ignore errors on the QUIT */
3858 if(ftpc->entrypath) {
3859 struct SessionHandle *data = conn->data;
3860 if(data->state.most_recent_ftp_entrypath == ftpc->entrypath) {
3861 data->state.most_recent_ftp_entrypath = NULL;
3863 free(ftpc->entrypath);
3864 ftpc->entrypath = NULL;
3868 if(ftpc->prevpath) {
3869 free(ftpc->prevpath);
3870 ftpc->prevpath = NULL;
3872 if(ftpc->server_os) {
3873 free(ftpc->server_os);
3874 ftpc->server_os = NULL;
3877 Curl_pp_disconnect(pp);
3879 #if defined(HAVE_KRB4) || defined(HAVE_GSSAPI)
3886 /***********************************************************************
3888 * ftp_parse_url_path()
3890 * Parse the URL path into separate path components.
3894 CURLcode ftp_parse_url_path(struct connectdata *conn)
3896 struct SessionHandle *data = conn->data;
3897 /* the ftp struct is already inited in ftp_connect() */
3898 struct FTP *ftp = data->state.proto.ftp;
3899 struct ftp_conn *ftpc = &conn->proto.ftpc;
3900 const char *slash_pos; /* position of the first '/' char in curpos */
3901 const char *path_to_use = data->state.path;
3902 const char *cur_pos;
3903 const char *filename = NULL;
3905 cur_pos = path_to_use; /* current position in path. point at the begin
3906 of next path component */
3908 ftpc->ctl_valid = FALSE;
3909 ftpc->cwdfail = FALSE;
3911 switch(data->set.ftp_filemethod) {
3913 /* fastest, but less standard-compliant */
3916 The best time to check whether the path is a file or directory is right
3919 the first condition in the if() right here, is there just in case
3920 someone decides to set path to NULL one day
3922 if(data->state.path &&
3923 data->state.path[0] &&
3924 (data->state.path[strlen(data->state.path) - 1] != '/') )
3925 filename = data->state.path; /* this is a full file path */
3927 ftpc->file is not used anywhere other than for operations on a file.
3928 In other words, never for directory operations.
3929 So we can safely leave filename as NULL here and use it as a
3930 argument in dir/file decisions.
3934 case FTPFILE_SINGLECWD:
3935 /* get the last slash */
3936 if(!path_to_use[0]) {
3937 /* no dir, no file */
3941 slash_pos=strrchr(cur_pos, '/');
3942 if(slash_pos || !*cur_pos) {
3943 ftpc->dirs = calloc(1, sizeof(ftpc->dirs[0]));
3945 return CURLE_OUT_OF_MEMORY;
3947 ftpc->dirs[0] = curl_easy_unescape(conn->data, slash_pos ? cur_pos : "/",
3948 slash_pos?(int)(slash_pos-cur_pos):1,
3950 if(!ftpc->dirs[0]) {
3952 return CURLE_OUT_OF_MEMORY;
3954 ftpc->dirdepth = 1; /* we consider it to be a single dir */
3955 filename = slash_pos ? slash_pos+1 : cur_pos; /* rest is file name */
3958 filename = cur_pos; /* this is a file name only */
3961 default: /* allow pretty much anything */
3962 case FTPFILE_MULTICWD:
3964 ftpc->diralloc = 5; /* default dir depth to allocate */
3965 ftpc->dirs = calloc(ftpc->diralloc, sizeof(ftpc->dirs[0]));
3967 return CURLE_OUT_OF_MEMORY;
3969 /* we have a special case for listing the root dir only */
3970 if(strequal(path_to_use, "/")) {
3971 cur_pos++; /* make it point to the zero byte */
3972 ftpc->dirs[0] = strdup("/");
3976 /* parse the URL path into separate path components */
3977 while((slash_pos = strchr(cur_pos, '/')) != NULL) {
3978 /* 1 or 0 pointer offset to indicate absolute directory */
3979 ssize_t absolute_dir = ((cur_pos - data->state.path > 0) &&
3980 (ftpc->dirdepth == 0))?1:0;
3982 /* seek out the next path component */
3983 if(slash_pos-cur_pos) {
3984 /* we skip empty path components, like "x//y" since the FTP command
3985 CWD requires a parameter and a non-existent parameter a) doesn't
3986 work on many servers and b) has no effect on the others. */
3987 int len = (int)(slash_pos - cur_pos + absolute_dir);
3988 ftpc->dirs[ftpc->dirdepth] =
3989 curl_easy_unescape(conn->data, cur_pos - absolute_dir, len, NULL);
3990 if(!ftpc->dirs[ftpc->dirdepth]) { /* run out of memory ... */
3991 failf(data, "no memory");
3993 return CURLE_OUT_OF_MEMORY;
3995 if(isBadFtpString(ftpc->dirs[ftpc->dirdepth])) {
3996 free(ftpc->dirs[ftpc->dirdepth]);
3998 return CURLE_URL_MALFORMAT;
4002 cur_pos = slash_pos + 1; /* jump to the rest of the string */
4006 cur_pos = slash_pos + 1; /* jump to the rest of the string */
4007 if(++ftpc->dirdepth >= ftpc->diralloc) {
4010 ftpc->diralloc *= 2; /* double the size each time */
4011 bigger = realloc(ftpc->dirs, ftpc->diralloc * sizeof(ftpc->dirs[0]));
4014 return CURLE_OUT_OF_MEMORY;
4016 ftpc->dirs = (char **)bigger;
4020 filename = cur_pos; /* the rest is the file name */
4024 if(filename && *filename) {
4025 ftpc->file = curl_easy_unescape(conn->data, filename, 0, NULL);
4026 if(NULL == ftpc->file) {
4028 failf(data, "no memory");
4029 return CURLE_OUT_OF_MEMORY;
4031 if(isBadFtpString(ftpc->file)) {
4033 return CURLE_URL_MALFORMAT;
4037 ftpc->file=NULL; /* instead of point to a zero byte, we make it a NULL
4040 if(data->set.upload && !ftpc->file && (ftp->transfer == FTPTRANSFER_BODY)) {
4041 /* We need a file name when uploading. Return error! */
4042 failf(data, "Uploading to a URL without a file name!");
4043 return CURLE_URL_MALFORMAT;
4046 ftpc->cwddone = FALSE; /* default to not done */
4048 if(ftpc->prevpath) {
4049 /* prevpath is "raw" so we convert the input path before we compare the
4052 char *path = curl_easy_unescape(conn->data, data->state.path, 0, &dlen);
4055 return CURLE_OUT_OF_MEMORY;
4058 dlen -= ftpc->file?(int)strlen(ftpc->file):0;
4059 if((dlen == (int)strlen(ftpc->prevpath)) &&
4060 strnequal(path, ftpc->prevpath, dlen)) {
4061 infof(data, "Request has same path as previous transfer\n");
4062 ftpc->cwddone = TRUE;
4070 /* call this when the DO phase has completed */
4071 static CURLcode ftp_dophase_done(struct connectdata *conn,
4074 CURLcode result = CURLE_OK;
4075 struct FTP *ftp = conn->data->state.proto.ftp;
4076 struct ftp_conn *ftpc = &conn->proto.ftpc;
4079 result = ftp_nextconnect(conn);
4081 if(result && (conn->sock[SECONDARYSOCKET] != CURL_SOCKET_BAD)) {
4082 /* Failure detected, close the second socket if it was created already */
4083 sclose(conn->sock[SECONDARYSOCKET]);
4084 conn->sock[SECONDARYSOCKET] = CURL_SOCKET_BAD;
4088 if(ftp->transfer != FTPTRANSFER_BODY)
4089 /* no data to transfer */
4090 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
4092 /* since we didn't connect now, we want do_more to get called */
4093 conn->bits.do_more = TRUE;
4095 ftpc->ctl_valid = TRUE; /* seems good */
4100 /* called from multi.c while DOing */
4101 static CURLcode ftp_doing(struct connectdata *conn,
4105 result = ftp_multi_statemach(conn, dophase_done);
4108 result = ftp_dophase_done(conn, FALSE /* not connected */);
4110 DEBUGF(infof(conn->data, "DO phase is complete\n"));
4115 /***********************************************************************
4117 * ftp_regular_transfer()
4119 * The input argument is already checked for validity.
4121 * Performs all commands done before a regular transfer between a local and a
4124 * ftp->ctl_valid starts out as FALSE, and gets set to TRUE if we reach the
4125 * ftp_done() function without finding any major problem.
4128 CURLcode ftp_regular_transfer(struct connectdata *conn,
4131 CURLcode result=CURLE_OK;
4132 bool connected=FALSE;
4133 struct SessionHandle *data = conn->data;
4134 struct ftp_conn *ftpc = &conn->proto.ftpc;
4135 data->req.size = -1; /* make sure this is unknown at this point */
4137 Curl_pgrsSetUploadCounter(data, 0);
4138 Curl_pgrsSetDownloadCounter(data, 0);
4139 Curl_pgrsSetUploadSize(data, 0);
4140 Curl_pgrsSetDownloadSize(data, 0);
4142 ftpc->ctl_valid = TRUE; /* starts good */
4144 result = ftp_perform(conn,
4145 &connected, /* have we connected after PASV/PORT */
4146 dophase_done); /* all commands in the DO-phase done? */
4148 if(CURLE_OK == result) {
4151 /* the DO phase has not completed yet */
4154 result = ftp_dophase_done(conn, connected);
4164 static CURLcode ftp_setup_connection(struct connectdata * conn)
4166 struct SessionHandle *data = conn->data;
4170 if(conn->bits.httpproxy && !data->set.tunnel_thru_httpproxy) {
4171 /* Unless we have asked to tunnel ftp operations through the proxy, we
4172 switch and use HTTP operations only */
4173 #ifndef CURL_DISABLE_HTTP
4174 if(conn->handler == &Curl_handler_ftp)
4175 conn->handler = &Curl_handler_ftp_proxy;
4178 conn->handler = &Curl_handler_ftps_proxy;
4180 failf(data, "FTPS not supported!");
4181 return CURLE_UNSUPPORTED_PROTOCOL;
4185 * We explicitly mark this connection as persistent here as we're doing
4186 * FTP over HTTP and thus we accidentally avoid setting this value
4189 conn->bits.close = FALSE;
4191 failf(data, "FTP over http proxy requires HTTP support built-in!");
4192 return CURLE_UNSUPPORTED_PROTOCOL;
4196 data->state.path++; /* don't include the initial slash */
4197 data->state.slash_removed = TRUE; /* we've skipped the slash */
4199 /* FTP URLs support an extension like ";type=<typecode>" that
4200 * we'll try to get now! */
4201 type = strstr(data->state.path, ";type=");
4204 type = strstr(conn->host.rawalloc, ";type=");
4207 *type = 0; /* it was in the middle of the hostname */
4208 command = Curl_raw_toupper(type[6]);
4209 conn->bits.type_set = TRUE;
4212 case 'A': /* ASCII mode */
4213 data->set.prefer_ascii = TRUE;
4216 case 'D': /* directory mode */
4217 data->set.ftp_list_only = TRUE;
4220 case 'I': /* binary mode */
4222 /* switch off ASCII */
4223 data->set.prefer_ascii = FALSE;
4231 #endif /* CURL_DISABLE_FTP */