1 /***************************************************************************
3 * Project ___| | | | _ \| |
5 * | (__| |_| | _ <| |___
6 * \___|\___/|_| \_\_____|
8 * Copyright (C) 1998 - 2016, 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 https://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 ***************************************************************************/
23 #include "curl_setup.h"
25 #ifndef CURL_DISABLE_FTP
27 #ifdef HAVE_NETINET_IN_H
28 #include <netinet/in.h>
30 #ifdef HAVE_ARPA_INET_H
31 #include <arpa/inet.h>
34 #include <sys/utsname.h>
44 #if (defined(NETWARE) && defined(__NOVELL_LIBC__))
46 #define in_addr_t unsigned long
49 #include <curl/curl.h>
57 #include "http.h" /* for HTTP proxy tunnel stuff */
61 #include "ftplistparser.h"
63 #include "strtoofft.h"
65 #include "vtls/vtls.h"
68 #include "inet_ntop.h"
69 #include "inet_pton.h"
71 #include "parsedate.h" /* for the week day and month names */
72 #include "sockaddr.h" /* required for Curl_sockaddr_storage */
76 #include "speedcheck.h"
78 #include "http_proxy.h"
79 #include "non-ascii.h"
80 /* The last 3 #include files should be in this order */
81 #include "curl_printf.h"
82 #include "curl_memory.h"
86 #define NI_MAXHOST 1025
88 #ifndef INET_ADDRSTRLEN
89 #define INET_ADDRSTRLEN 16
92 #ifdef CURL_DISABLE_VERBOSE_STRINGS
93 #define ftp_pasv_verbose(a,b,c,d) Curl_nop_stmt
96 /* Local API functions */
98 static void _state(struct connectdata *conn,
100 #define state(x,y) _state(x,y)
102 static void _state(struct connectdata *conn,
105 #define state(x,y) _state(x,y,__LINE__)
108 static CURLcode ftp_sendquote(struct connectdata *conn,
109 struct curl_slist *quote);
110 static CURLcode ftp_quit(struct connectdata *conn);
111 static CURLcode ftp_parse_url_path(struct connectdata *conn);
112 static CURLcode ftp_regular_transfer(struct connectdata *conn, bool *done);
113 #ifndef CURL_DISABLE_VERBOSE_STRINGS
114 static void ftp_pasv_verbose(struct connectdata *conn,
116 char *newhost, /* ascii version */
119 static CURLcode ftp_state_prepare_transfer(struct connectdata *conn);
120 static CURLcode ftp_state_mdtm(struct connectdata *conn);
121 static CURLcode ftp_state_quote(struct connectdata *conn,
122 bool init, ftpstate instate);
123 static CURLcode ftp_nb_type(struct connectdata *conn,
124 bool ascii, ftpstate newstate);
125 static int ftp_need_type(struct connectdata *conn,
127 static CURLcode ftp_do(struct connectdata *conn, bool *done);
128 static CURLcode ftp_done(struct connectdata *conn,
129 CURLcode, bool premature);
130 static CURLcode ftp_connect(struct connectdata *conn, bool *done);
131 static CURLcode ftp_disconnect(struct connectdata *conn, bool dead_connection);
132 static CURLcode ftp_do_more(struct connectdata *conn, int *completed);
133 static CURLcode ftp_multi_statemach(struct connectdata *conn, bool *done);
134 static int ftp_getsock(struct connectdata *conn, curl_socket_t *socks,
136 static int ftp_domore_getsock(struct connectdata *conn, curl_socket_t *socks,
138 static CURLcode ftp_doing(struct connectdata *conn,
140 static CURLcode ftp_setup_connection(struct connectdata * conn);
142 static CURLcode init_wc_data(struct connectdata *conn);
143 static CURLcode wc_statemach(struct connectdata *conn);
145 static void wc_data_dtor(void *ptr);
147 static CURLcode ftp_state_retr(struct connectdata *conn, curl_off_t filesize);
149 static CURLcode ftp_readresp(curl_socket_t sockfd,
153 static CURLcode ftp_dophase_done(struct connectdata *conn,
156 /* easy-to-use macro: */
157 #define PPSENDF(x,y,z) result = Curl_pp_sendf(x,y,z); \
163 * FTP protocol handler.
166 const struct Curl_handler Curl_handler_ftp = {
168 ftp_setup_connection, /* setup_connection */
171 ftp_do_more, /* do_more */
172 ftp_connect, /* connect_it */
173 ftp_multi_statemach, /* connecting */
174 ftp_doing, /* doing */
175 ftp_getsock, /* proto_getsock */
176 ftp_getsock, /* doing_getsock */
177 ftp_domore_getsock, /* domore_getsock */
178 ZERO_NULL, /* perform_getsock */
179 ftp_disconnect, /* disconnect */
180 ZERO_NULL, /* readwrite */
181 PORT_FTP, /* defport */
182 CURLPROTO_FTP, /* protocol */
183 PROTOPT_DUAL | PROTOPT_CLOSEACTION | PROTOPT_NEEDSPWD
184 | PROTOPT_NOURLQUERY /* flags */
190 * FTPS protocol handler.
193 const struct Curl_handler Curl_handler_ftps = {
195 ftp_setup_connection, /* setup_connection */
198 ftp_do_more, /* 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 ftp_domore_getsock, /* domore_getsock */
205 ZERO_NULL, /* perform_getsock */
206 ftp_disconnect, /* disconnect */
207 ZERO_NULL, /* readwrite */
208 PORT_FTPS, /* defport */
209 CURLPROTO_FTPS, /* protocol */
210 PROTOPT_SSL | PROTOPT_DUAL | PROTOPT_CLOSEACTION |
211 PROTOPT_NEEDSPWD | PROTOPT_NOURLQUERY /* flags */
215 #ifndef CURL_DISABLE_HTTP
217 * HTTP-proxyed FTP protocol handler.
220 static const struct Curl_handler Curl_handler_ftp_proxy = {
222 Curl_http_setup_conn, /* setup_connection */
223 Curl_http, /* do_it */
224 Curl_http_done, /* done */
225 ZERO_NULL, /* do_more */
226 ZERO_NULL, /* connect_it */
227 ZERO_NULL, /* connecting */
228 ZERO_NULL, /* doing */
229 ZERO_NULL, /* proto_getsock */
230 ZERO_NULL, /* doing_getsock */
231 ZERO_NULL, /* domore_getsock */
232 ZERO_NULL, /* perform_getsock */
233 ZERO_NULL, /* disconnect */
234 ZERO_NULL, /* readwrite */
235 PORT_FTP, /* defport */
236 CURLPROTO_HTTP, /* protocol */
237 PROTOPT_NONE /* flags */
243 * HTTP-proxyed FTPS protocol handler.
246 static const struct Curl_handler Curl_handler_ftps_proxy = {
248 Curl_http_setup_conn, /* setup_connection */
249 Curl_http, /* do_it */
250 Curl_http_done, /* done */
251 ZERO_NULL, /* do_more */
252 ZERO_NULL, /* connect_it */
253 ZERO_NULL, /* connecting */
254 ZERO_NULL, /* doing */
255 ZERO_NULL, /* proto_getsock */
256 ZERO_NULL, /* doing_getsock */
257 ZERO_NULL, /* domore_getsock */
258 ZERO_NULL, /* perform_getsock */
259 ZERO_NULL, /* disconnect */
260 ZERO_NULL, /* readwrite */
261 PORT_FTPS, /* defport */
262 CURLPROTO_HTTP, /* protocol */
263 PROTOPT_NONE /* flags */
268 static void close_secondarysocket(struct connectdata *conn)
270 if(CURL_SOCKET_BAD != conn->sock[SECONDARYSOCKET]) {
271 Curl_closesocket(conn, conn->sock[SECONDARYSOCKET]);
272 conn->sock[SECONDARYSOCKET] = CURL_SOCKET_BAD;
274 conn->bits.tcpconnect[SECONDARYSOCKET] = FALSE;
275 conn->tunnel_state[SECONDARYSOCKET] = TUNNEL_INIT;
279 * NOTE: back in the old days, we added code in the FTP code that made NOBODY
280 * requests on files respond with headers passed to the client/stdout that
281 * looked like HTTP ones.
283 * This approach is not very elegant, it causes confusion and is error-prone.
284 * It is subject for removal at the next (or at least a future) soname bump.
285 * Until then you can test the effects of the removal by undefining the
286 * following define named CURL_FTP_HTTPSTYLE_HEAD.
288 #define CURL_FTP_HTTPSTYLE_HEAD 1
290 static void freedirs(struct ftp_conn *ftpc)
294 for(i=0; i < ftpc->dirdepth; i++) {
302 Curl_safefree(ftpc->file);
304 /* no longer of any use */
305 Curl_safefree(ftpc->newhost);
308 /* Returns non-zero if the given string contains CR (\r) or LF (\n),
309 which are not allowed within RFC 959 <string>.
310 Note: The input string is in the client's encoding which might
311 not be ASCII, so escape sequences \r & \n must be used instead
312 of hex values 0x0d & 0x0a.
314 static bool isBadFtpString(const char *string)
316 return ((NULL != strchr(string, '\r')) ||
317 (NULL != strchr(string, '\n'))) ? TRUE : FALSE;
320 /***********************************************************************
322 * AcceptServerConnect()
324 * After connection request is received from the server this function is
325 * called to accept the connection and close the listening socket
328 static CURLcode AcceptServerConnect(struct connectdata *conn)
330 struct Curl_easy *data = conn->data;
331 curl_socket_t sock = conn->sock[SECONDARYSOCKET];
332 curl_socket_t s = CURL_SOCKET_BAD;
334 struct Curl_sockaddr_storage add;
336 struct sockaddr_in add;
338 curl_socklen_t size = (curl_socklen_t) sizeof(add);
340 if(0 == getsockname(sock, (struct sockaddr *) &add, &size)) {
343 s=accept(sock, (struct sockaddr *) &add, &size);
345 Curl_closesocket(conn, sock); /* close the first socket */
347 if(CURL_SOCKET_BAD == s) {
348 failf(data, "Error accept()ing server connect");
349 return CURLE_FTP_PORT_FAILED;
351 infof(data, "Connection accepted from server\n");
352 /* when this happens within the DO state it is important that we mark us as
353 not needing DO_MORE anymore */
354 conn->bits.do_more = FALSE;
356 conn->sock[SECONDARYSOCKET] = s;
357 (void)curlx_nonblock(s, TRUE); /* enable non-blocking */
358 conn->sock_accepted[SECONDARYSOCKET] = TRUE;
360 if(data->set.fsockopt) {
363 /* activate callback for setting socket options */
364 error = data->set.fsockopt(data->set.sockopt_client,
366 CURLSOCKTYPE_ACCEPT);
369 close_secondarysocket(conn);
370 return CURLE_ABORTED_BY_CALLBACK;
379 * ftp_timeleft_accept() returns the amount of milliseconds left allowed for
380 * waiting server to connect. If the value is negative, the timeout time has
383 * The start time is stored in progress.t_acceptdata - as set with
384 * Curl_pgrsTime(..., TIMER_STARTACCEPT);
387 static long ftp_timeleft_accept(struct Curl_easy *data)
389 long timeout_ms = DEFAULT_ACCEPT_TIMEOUT;
393 if(data->set.accepttimeout > 0)
394 timeout_ms = data->set.accepttimeout;
398 /* check if the generic timeout possibly is set shorter */
399 other = Curl_timeleft(data, &now, FALSE);
400 if(other && (other < timeout_ms))
401 /* note that this also works fine for when other happens to be negative
402 due to it already having elapsed */
405 /* subtract elapsed time */
406 timeout_ms -= Curl_tvdiff(now, data->progress.t_acceptdata);
408 /* avoid returning 0 as that means no timeout! */
416 /***********************************************************************
418 * ReceivedServerConnect()
420 * After allowing server to connect to us from data port, this function
421 * checks both data connection for connection establishment and ctrl
422 * connection for a negative response regarding a failure in connecting
425 static CURLcode ReceivedServerConnect(struct connectdata *conn, bool *received)
427 struct Curl_easy *data = conn->data;
428 curl_socket_t ctrl_sock = conn->sock[FIRSTSOCKET];
429 curl_socket_t data_sock = conn->sock[SECONDARYSOCKET];
430 struct ftp_conn *ftpc = &conn->proto.ftpc;
431 struct pingpong *pp = &ftpc->pp;
439 timeout_ms = ftp_timeleft_accept(data);
440 infof(data, "Checking for server connect\n");
442 /* if a timeout was already reached, bail out */
443 failf(data, "Accept timeout occurred while waiting server connect");
444 return CURLE_FTP_ACCEPT_TIMEOUT;
447 /* First check whether there is a cached response from server */
448 if(pp->cache_size && pp->cache && pp->cache[0] > '3') {
449 /* Data connection could not be established, let's return */
450 infof(data, "There is negative response in cache while serv connect\n");
451 Curl_GetFTPResponse(&nread, conn, &ftpcode);
452 return CURLE_FTP_ACCEPT_FAILED;
455 result = Curl_socket_check(ctrl_sock, data_sock, CURL_SOCKET_BAD, 0);
457 /* see if the connection request is already here */
461 failf(data, "Error while waiting for server connect");
462 return CURLE_FTP_ACCEPT_FAILED;
463 case 0: /* Server connect is not received yet */
467 if(result & CURL_CSELECT_IN2) {
468 infof(data, "Ready to accept data connection from server\n");
471 else if(result & CURL_CSELECT_IN) {
472 infof(data, "Ctrl conn has data while waiting for data conn\n");
473 Curl_GetFTPResponse(&nread, conn, &ftpcode);
476 return CURLE_FTP_ACCEPT_FAILED;
478 return CURLE_FTP_WEIRD_SERVER_REPLY;
488 /***********************************************************************
492 * After connection from server is accepted this function is called to
493 * setup transfer parameters and initiate the data transfer.
496 static CURLcode InitiateTransfer(struct connectdata *conn)
498 struct Curl_easy *data = conn->data;
499 struct FTP *ftp = data->req.protop;
500 CURLcode result = CURLE_OK;
502 if(conn->ssl[SECONDARYSOCKET].use) {
503 /* since we only have a plaintext TCP connection here, we must now
504 * do the TLS stuff */
505 infof(data, "Doing the SSL/TLS handshake on the data stream\n");
506 result = Curl_ssl_connect(conn, SECONDARYSOCKET);
511 if(conn->proto.ftpc.state_saved == FTP_STOR) {
512 *(ftp->bytecountp)=0;
514 /* When we know we're uploading a specified file, we can get the file
515 size prior to the actual upload. */
517 Curl_pgrsSetUploadSize(data, data->state.infilesize);
519 /* set the SO_SNDBUF for the secondary socket for those who need it */
520 Curl_sndbufset(conn->sock[SECONDARYSOCKET]);
522 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, /* no download */
523 SECONDARYSOCKET, ftp->bytecountp);
527 Curl_setup_transfer(conn, SECONDARYSOCKET,
528 conn->proto.ftpc.retr_size_saved, FALSE,
529 ftp->bytecountp, -1, NULL); /* no upload here */
532 conn->proto.ftpc.pp.pending_resp = TRUE; /* expect server response */
533 state(conn, FTP_STOP);
538 /***********************************************************************
540 * AllowServerConnect()
542 * When we've issue the PORT command, we have told the server to connect to
543 * us. This function checks whether data connection is established if so it is
547 static CURLcode AllowServerConnect(struct connectdata *conn, bool *connected)
549 struct Curl_easy *data = conn->data;
551 CURLcode result = CURLE_OK;
554 infof(data, "Preparing for accepting server on data port\n");
556 /* Save the time we start accepting server connect */
557 Curl_pgrsTime(data, TIMER_STARTACCEPT);
559 timeout_ms = ftp_timeleft_accept(data);
561 /* if a timeout was already reached, bail out */
562 failf(data, "Accept timeout occurred while waiting server connect");
563 return CURLE_FTP_ACCEPT_TIMEOUT;
566 /* see if the connection request is already here */
567 result = ReceivedServerConnect(conn, connected);
572 result = AcceptServerConnect(conn);
576 result = InitiateTransfer(conn);
581 /* Add timeout to multi handle and break out of the loop */
582 if(!result && *connected == FALSE) {
583 if(data->set.accepttimeout > 0)
584 Curl_expire(data, data->set.accepttimeout);
586 Curl_expire(data, DEFAULT_ACCEPT_TIMEOUT);
593 /* macro to check for a three-digit ftp status code at the start of the
595 #define STATUSCODE(line) (ISDIGIT(line[0]) && ISDIGIT(line[1]) && \
598 /* macro to check for the last line in an FTP server response */
599 #define LASTLINE(line) (STATUSCODE(line) && (' ' == line[3]))
601 static bool ftp_endofresp(struct connectdata *conn, char *line, size_t len,
606 if((len > 3) && LASTLINE(line)) {
607 *code = curlx_sltosi(strtol(line, NULL, 10));
614 static CURLcode ftp_readresp(curl_socket_t sockfd,
616 int *ftpcode, /* return the ftp-code if done */
617 size_t *size) /* size of the response */
619 struct connectdata *conn = pp->conn;
620 struct Curl_easy *data = conn->data;
622 char * const buf = data->state.buffer;
624 CURLcode result = CURLE_OK;
627 result = Curl_pp_readresp(sockfd, pp, &code, size);
629 #if defined(HAVE_GSSAPI)
630 /* handle the security-oriented responses 6xx ***/
631 /* FIXME: some errorchecking perhaps... ***/
634 code = Curl_sec_read_msg(conn, buf, PROT_SAFE);
637 code = Curl_sec_read_msg(conn, buf, PROT_PRIVATE);
640 code = Curl_sec_read_msg(conn, buf, PROT_CONFIDENTIAL);
643 /* normal ftp stuff we pass through! */
648 /* store the latest code for later retrieval */
649 data->info.httpcode=code;
655 /* 421 means "Service not available, closing control connection." and FTP
656 * servers use it to signal that idle session timeout has been exceeded.
657 * If we ignored the response, it could end up hanging in some cases.
659 * This response code can come at any point so having it treated
660 * generically is a good idea.
662 infof(data, "We got a 421 - timeout!\n");
663 state(conn, FTP_STOP);
664 return CURLE_OPERATION_TIMEDOUT;
670 /* --- parse FTP server responses --- */
673 * Curl_GetFTPResponse() is a BLOCKING function to read the full response
674 * from a server after a command.
678 CURLcode Curl_GetFTPResponse(ssize_t *nreadp, /* return number of bytes read */
679 struct connectdata *conn,
680 int *ftpcode) /* return the ftp-code */
683 * We cannot read just one byte per read() and then go back to select() as
684 * the OpenSSL read() doesn't grok that properly.
686 * Alas, read as much as possible, split up into lines, use the ending
687 * line in a response or continue reading. */
689 curl_socket_t sockfd = conn->sock[FIRSTSOCKET];
690 long timeout; /* timeout in milliseconds */
692 struct Curl_easy *data = conn->data;
693 CURLcode result = CURLE_OK;
694 struct ftp_conn *ftpc = &conn->proto.ftpc;
695 struct pingpong *pp = &ftpc->pp;
698 int value_to_be_ignored=0;
701 *ftpcode = 0; /* 0 for errors */
703 /* make the pointer point to something for the rest of this function */
704 ftpcode = &value_to_be_ignored;
708 while(!*ftpcode && !result) {
709 /* check and reset timeout value every lap */
710 timeout = Curl_pp_state_timeout(pp);
713 failf(data, "FTP response timeout");
714 return CURLE_OPERATION_TIMEDOUT; /* already too little time */
717 interval_ms = 1000; /* use 1 second timeout intervals */
718 if(timeout < interval_ms)
719 interval_ms = timeout;
722 * Since this function is blocking, we need to wait here for input on the
723 * connection and only then we call the response reading function. We do
724 * timeout at least every second to make the timeout check run.
726 * A caution here is that the ftp_readresp() function has a cache that may
727 * contain pieces of a response from the previous invoke and we need to
728 * make sure we don't just wait for input while there is unhandled data in
729 * that cache. But also, if the cache is there, we call ftp_readresp() and
730 * the cache wasn't good enough to continue we must not just busy-loop
731 * around this function.
735 if(pp->cache && (cache_skip < 2)) {
737 * There's a cache left since before. We then skipping the wait for
738 * socket action, unless this is the same cache like the previous round
739 * as then the cache was deemed not enough to act on and we then need to
740 * wait for more data anyway.
744 switch (Curl_socket_ready(sockfd, CURL_SOCKET_BAD, interval_ms)) {
745 case -1: /* select() error, stop reading */
746 failf(data, "FTP response aborted due to select/poll error: %d",
748 return CURLE_RECV_ERROR;
750 case 0: /* timeout */
751 if(Curl_pgrsUpdate(conn))
752 return CURLE_ABORTED_BY_CALLBACK;
753 continue; /* just continue in our loop for the timeout duration */
755 default: /* for clarity */
759 result = ftp_readresp(sockfd, pp, ftpcode, &nread);
763 if(!nread && pp->cache)
764 /* bump cache skip counter as on repeated skips we must wait for more
768 /* when we got data or there is no cache left, we reset the cache skip
774 } /* while there's buffer left and loop is requested */
776 pp->pending_resp = FALSE;
781 #if defined(DEBUGBUILD) && !defined(CURL_DISABLE_VERBOSE_STRINGS)
782 /* for debug purposes */
783 static const char * const ftp_state_names[]={
822 /* This is the ONLY way to change FTP state! */
823 static void _state(struct connectdata *conn,
830 struct ftp_conn *ftpc = &conn->proto.ftpc;
832 #if defined(DEBUGBUILD)
834 #if defined(CURL_DISABLE_VERBOSE_STRINGS)
837 if(ftpc->state != newstate)
838 infof(conn->data, "FTP %p (line %d) state change from %s to %s\n",
839 (void *)ftpc, lineno, ftp_state_names[ftpc->state],
840 ftp_state_names[newstate]);
844 ftpc->state = newstate;
847 static CURLcode ftp_state_user(struct connectdata *conn)
850 struct FTP *ftp = conn->data->req.protop;
852 PPSENDF(&conn->proto.ftpc.pp, "USER %s", ftp->user?ftp->user:"");
854 state(conn, FTP_USER);
855 conn->data->state.ftp_trying_alternative = FALSE;
860 static CURLcode ftp_state_pwd(struct connectdata *conn)
864 /* send PWD to discover our entry point */
865 PPSENDF(&conn->proto.ftpc.pp, "%s", "PWD");
866 state(conn, FTP_PWD);
871 /* For the FTP "protocol connect" and "doing" phases only */
872 static int ftp_getsock(struct connectdata *conn,
873 curl_socket_t *socks,
876 return Curl_pp_getsock(&conn->proto.ftpc.pp, socks, numsocks);
879 /* For the FTP "DO_MORE" phase only */
880 static int ftp_domore_getsock(struct connectdata *conn, curl_socket_t *socks,
883 struct ftp_conn *ftpc = &conn->proto.ftpc;
886 return GETSOCK_BLANK;
888 /* When in DO_MORE state, we could be either waiting for us to connect to a
889 * remote site, or we could wait for that site to connect to us. Or just
890 * handle ordinary commands.
893 if(FTP_STOP == ftpc->state) {
894 int bits = GETSOCK_READSOCK(0);
896 /* if stopped and still in this state, then we're also waiting for a
897 connect on the secondary connection */
898 socks[0] = conn->sock[FIRSTSOCKET];
900 if(!conn->data->set.ftp_use_port) {
903 /* PORT is used to tell the server to connect to us, and during that we
904 don't do happy eyeballs, but we do if we connect to the server */
905 for(s=1, i=0; i<2; i++) {
906 if(conn->tempsock[i] != CURL_SOCKET_BAD) {
907 socks[s] = conn->tempsock[i];
908 bits |= GETSOCK_WRITESOCK(s++);
913 socks[1] = conn->sock[SECONDARYSOCKET];
914 bits |= GETSOCK_WRITESOCK(1) | GETSOCK_READSOCK(1);
920 return Curl_pp_getsock(&conn->proto.ftpc.pp, socks, numsocks);
923 /* This is called after the FTP_QUOTE state is passed.
925 ftp_state_cwd() sends the range of CWD commands to the server to change to
926 the correct directory. It may also need to send MKD commands to create
927 missing ones, if that option is enabled.
929 static CURLcode ftp_state_cwd(struct connectdata *conn)
931 CURLcode result = CURLE_OK;
932 struct ftp_conn *ftpc = &conn->proto.ftpc;
935 /* already done and fine */
936 result = ftp_state_mdtm(conn);
938 ftpc->count2 = 0; /* count2 counts failed CWDs */
940 /* count3 is set to allow a MKD to fail once. In the case when first CWD
941 fails and then MKD fails (due to another session raced it to create the
942 dir) this then allows for a second try to CWD to it */
943 ftpc->count3 = (conn->data->set.ftp_create_missing_dirs==2)?1:0;
945 if(conn->bits.reuse && ftpc->entrypath) {
946 /* This is a re-used connection. Since we change directory to where the
947 transfer is taking place, we must first get back to the original dir
948 where we ended up after login: */
949 ftpc->count1 = 0; /* we count this as the first path, then we add one
950 for all upcoming ones in the ftp->dirs[] array */
951 PPSENDF(&conn->proto.ftpc.pp, "CWD %s", ftpc->entrypath);
952 state(conn, FTP_CWD);
957 /* issue the first CWD, the rest is sent when the CWD responses are
959 PPSENDF(&conn->proto.ftpc.pp, "CWD %s", ftpc->dirs[ftpc->count1 -1]);
960 state(conn, FTP_CWD);
963 /* No CWD necessary */
964 result = ftp_state_mdtm(conn);
977 static CURLcode ftp_state_use_port(struct connectdata *conn,
978 ftpport fcmd) /* start with this */
981 CURLcode result = CURLE_OK;
982 struct ftp_conn *ftpc = &conn->proto.ftpc;
983 struct Curl_easy *data=conn->data;
984 curl_socket_t portsock= CURL_SOCKET_BAD;
985 char myhost[256] = "";
987 struct Curl_sockaddr_storage ss;
988 Curl_addrinfo *res, *ai;
989 curl_socklen_t sslen;
990 char hbuf[NI_MAXHOST];
991 struct sockaddr *sa=(struct sockaddr *)&ss;
992 struct sockaddr_in * const sa4 = (void *)sa;
994 struct sockaddr_in6 * const sa6 = (void *)sa;
997 static const char mode[][5] = { "EPRT", "PORT" };
1001 char *string_ftpport = data->set.str[STRING_FTPPORT];
1002 struct Curl_dns_entry *h=NULL;
1003 unsigned short port_min = 0;
1004 unsigned short port_max = 0;
1005 unsigned short port;
1006 bool possibly_non_local = TRUE;
1010 /* Step 1, figure out what is requested,
1012 * (ipv4|ipv6|domain|interface)?(:port(-range)?)?
1015 if(data->set.str[STRING_FTPPORT] &&
1016 (strlen(data->set.str[STRING_FTPPORT]) > 1)) {
1019 size_t addrlen = INET6_ADDRSTRLEN > strlen(string_ftpport) ?
1020 INET6_ADDRSTRLEN : strlen(string_ftpport);
1022 size_t addrlen = INET_ADDRSTRLEN > strlen(string_ftpport) ?
1023 INET_ADDRSTRLEN : strlen(string_ftpport);
1025 char *ip_start = string_ftpport;
1026 char *ip_end = NULL;
1027 char *port_start = NULL;
1028 char *port_sep = NULL;
1030 addr = calloc(addrlen+1, 1);
1032 return CURLE_OUT_OF_MEMORY;
1035 if(*string_ftpport == '[') {
1036 /* [ipv6]:port(-range) */
1037 ip_start = string_ftpport + 1;
1038 if((ip_end = strchr(string_ftpport, ']')) != NULL)
1039 strncpy(addr, ip_start, ip_end - ip_start);
1043 if(*string_ftpport == ':') {
1045 ip_end = string_ftpport;
1047 else if((ip_end = strchr(string_ftpport, ':')) != NULL) {
1048 /* either ipv6 or (ipv4|domain|interface):port(-range) */
1050 if(Curl_inet_pton(AF_INET6, string_ftpport, sa6) == 1) {
1052 port_min = port_max = 0;
1053 strcpy(addr, string_ftpport);
1054 ip_end = NULL; /* this got no port ! */
1058 /* (ipv4|domain|interface):port(-range) */
1059 strncpy(addr, string_ftpport, ip_end - ip_start);
1062 /* ipv4|interface */
1063 strcpy(addr, string_ftpport);
1065 /* parse the port */
1066 if(ip_end != NULL) {
1067 if((port_start = strchr(ip_end, ':')) != NULL) {
1068 port_min = curlx_ultous(strtoul(port_start+1, NULL, 10));
1069 if((port_sep = strchr(port_start, '-')) != NULL) {
1070 port_max = curlx_ultous(strtoul(port_sep + 1, NULL, 10));
1073 port_max = port_min;
1077 /* correct errors like:
1079 * :-4711, in this case port_min is (unsigned)-1,
1080 * therefore port_min > port_max for all cases
1081 * but port_max = (unsigned)-1
1083 if(port_min > port_max)
1084 port_min = port_max = 0;
1088 /* attempt to get the address of the given interface name */
1089 switch(Curl_if2ip(conn->ip_addr->ai_family,
1090 Curl_ipv6_scope(conn->ip_addr->ai_addr),
1091 conn->scope_id, addr, hbuf, sizeof(hbuf))) {
1092 case IF2IP_NOT_FOUND:
1093 /* not an interface, use the given string as host name instead */
1096 case IF2IP_AF_NOT_SUPPORTED:
1097 return CURLE_FTP_PORT_FAILED;
1099 host = hbuf; /* use the hbuf for host name */
1103 /* there was only a port(-range) given, default the host */
1105 } /* data->set.ftpport */
1108 /* not an interface and not a host name, get default by extracting
1109 the IP from the control connection */
1112 if(getsockname(conn->sock[FIRSTSOCKET], sa, &sslen)) {
1113 failf(data, "getsockname() failed: %s",
1114 Curl_strerror(conn, SOCKERRNO) );
1116 return CURLE_FTP_PORT_FAILED;
1118 switch(sa->sa_family) {
1121 Curl_inet_ntop(sa->sa_family, &sa6->sin6_addr, hbuf, sizeof(hbuf));
1125 Curl_inet_ntop(sa->sa_family, &sa4->sin_addr, hbuf, sizeof(hbuf));
1128 host = hbuf; /* use this host name */
1129 possibly_non_local = FALSE; /* we know it is local now */
1132 /* resolv ip/host to ip */
1133 rc = Curl_resolv(conn, host, 0, &h);
1134 if(rc == CURLRESOLV_PENDING)
1135 (void)Curl_resolver_wait_resolv(conn, &h);
1138 /* when we return from this function, we can forget about this entry
1139 to we can unlock it now already */
1140 Curl_resolv_unlock(data, h);
1143 res = NULL; /* failure! */
1146 failf(data, "failed to resolve the address provided to PORT: %s", host);
1148 return CURLE_FTP_PORT_FAILED;
1154 /* step 2, create a socket for the requested address */
1156 portsock = CURL_SOCKET_BAD;
1158 for(ai = res; ai; ai = ai->ai_next) {
1159 result = Curl_socket(conn, ai, NULL, &portsock);
1167 failf(data, "socket failure: %s", Curl_strerror(conn, error));
1168 return CURLE_FTP_PORT_FAILED;
1171 /* step 3, bind to a suitable local address */
1173 memcpy(sa, ai->ai_addr, ai->ai_addrlen);
1174 sslen = ai->ai_addrlen;
1176 for(port = port_min; port <= port_max;) {
1177 if(sa->sa_family == AF_INET)
1178 sa4->sin_port = htons(port);
1181 sa6->sin6_port = htons(port);
1183 /* Try binding the given address. */
1184 if(bind(portsock, sa, sslen) ) {
1187 if(possibly_non_local && (error == EADDRNOTAVAIL)) {
1188 /* The requested bind address is not local. Use the address used for
1189 * the control connection instead and restart the port loop
1192 infof(data, "bind(port=%hu) on non-local address failed: %s\n", port,
1193 Curl_strerror(conn, error) );
1196 if(getsockname(conn->sock[FIRSTSOCKET], sa, &sslen)) {
1197 failf(data, "getsockname() failed: %s",
1198 Curl_strerror(conn, SOCKERRNO) );
1199 Curl_closesocket(conn, portsock);
1200 return CURLE_FTP_PORT_FAILED;
1203 possibly_non_local = FALSE; /* don't try this again */
1206 else if(error != EADDRINUSE && error != EACCES) {
1207 failf(data, "bind(port=%hu) failed: %s", port,
1208 Curl_strerror(conn, error) );
1209 Curl_closesocket(conn, portsock);
1210 return CURLE_FTP_PORT_FAILED;
1219 /* maybe all ports were in use already*/
1220 if(port > port_max) {
1221 failf(data, "bind() failed, we ran out of ports!");
1222 Curl_closesocket(conn, portsock);
1223 return CURLE_FTP_PORT_FAILED;
1226 /* get the name again after the bind() so that we can extract the
1227 port number it uses now */
1229 if(getsockname(portsock, (struct sockaddr *)sa, &sslen)) {
1230 failf(data, "getsockname() failed: %s",
1231 Curl_strerror(conn, SOCKERRNO) );
1232 Curl_closesocket(conn, portsock);
1233 return CURLE_FTP_PORT_FAILED;
1236 /* step 4, listen on the socket */
1238 if(listen(portsock, 1)) {
1239 failf(data, "socket failure: %s", Curl_strerror(conn, SOCKERRNO));
1240 Curl_closesocket(conn, portsock);
1241 return CURLE_FTP_PORT_FAILED;
1244 /* step 5, send the proper FTP command */
1246 /* get a plain printable version of the numerical address to work with
1248 Curl_printable_address(ai, myhost, sizeof(myhost));
1251 if(!conn->bits.ftp_use_eprt && conn->bits.ipv6)
1252 /* EPRT is disabled but we are connected to a IPv6 host, so we ignore the
1253 request and enable EPRT again! */
1254 conn->bits.ftp_use_eprt = TRUE;
1257 for(; fcmd != DONE; fcmd++) {
1259 if(!conn->bits.ftp_use_eprt && (EPRT == fcmd))
1260 /* if disabled, goto next */
1263 if((PORT == fcmd) && sa->sa_family != AF_INET)
1264 /* PORT is IPv4 only */
1267 switch(sa->sa_family) {
1269 port = ntohs(sa4->sin_port);
1273 port = ntohs(sa6->sin6_port);
1277 continue; /* might as well skip this */
1282 * Two fine examples from RFC2428;
1284 * EPRT |1|132.235.1.2|6275|
1286 * EPRT |2|1080::8:800:200C:417A|5282|
1289 result = Curl_pp_sendf(&ftpc->pp, "%s |%d|%s|%hu|", mode[fcmd],
1290 sa->sa_family == AF_INET?1:2,
1293 failf(data, "Failure sending EPRT command: %s",
1294 curl_easy_strerror(result));
1295 Curl_closesocket(conn, portsock);
1296 /* don't retry using PORT */
1297 ftpc->count1 = PORT;
1299 state(conn, FTP_STOP);
1304 else if(PORT == fcmd) {
1305 char *source = myhost;
1308 /* translate x.x.x.x to x,x,x,x */
1309 while(source && *source) {
1318 snprintf(dest, 20, ",%d,%d", (int)(port>>8), (int)(port&0xff));
1320 result = Curl_pp_sendf(&ftpc->pp, "%s %s", mode[fcmd], tmp);
1322 failf(data, "Failure sending PORT command: %s",
1323 curl_easy_strerror(result));
1324 Curl_closesocket(conn, portsock);
1326 state(conn, FTP_STOP);
1333 /* store which command was sent */
1334 ftpc->count1 = fcmd;
1336 close_secondarysocket(conn);
1338 /* we set the secondary socket variable to this for now, it is only so that
1339 the cleanup function will close it in case we fail before the true
1340 secondary stuff is made */
1341 conn->sock[SECONDARYSOCKET] = portsock;
1343 /* this tcpconnect assignment below is a hackish work-around to make the
1344 multi interface with active FTP work - as it will not wait for a
1345 (passive) connect in Curl_is_connected().
1347 The *proper* fix is to make sure that the active connection from the
1348 server is done in a non-blocking way. Currently, it is still BLOCKING.
1350 conn->bits.tcpconnect[SECONDARYSOCKET] = TRUE;
1352 state(conn, FTP_PORT);
1356 static CURLcode ftp_state_use_pasv(struct connectdata *conn)
1358 struct ftp_conn *ftpc = &conn->proto.ftpc;
1359 CURLcode result = CURLE_OK;
1361 Here's the excecutive summary on what to do:
1363 PASV is RFC959, expect:
1364 227 Entering Passive Mode (a1,a2,a3,a4,p1,p2)
1366 LPSV is RFC1639, expect:
1367 228 Entering Long Passive Mode (4,4,a1,a2,a3,a4,2,p1,p2)
1369 EPSV is RFC2428, expect:
1370 229 Entering Extended Passive Mode (|||port|)
1374 static const char mode[][5] = { "EPSV", "PASV" };
1378 if(!conn->bits.ftp_use_epsv && conn->bits.ipv6)
1379 /* EPSV is disabled but we are connected to a IPv6 host, so we ignore the
1380 request and enable EPSV again! */
1381 conn->bits.ftp_use_epsv = TRUE;
1384 modeoff = conn->bits.ftp_use_epsv?0:1;
1386 PPSENDF(&ftpc->pp, "%s", mode[modeoff]);
1388 ftpc->count1 = modeoff;
1389 state(conn, FTP_PASV);
1390 infof(conn->data, "Connect data stream passively\n");
1396 * ftp_state_prepare_transfer() starts PORT, PASV or PRET etc.
1398 * REST is the last command in the chain of commands when a "head"-like
1399 * request is made. Thus, if an actual transfer is to be made this is where we
1400 * take off for real.
1402 static CURLcode ftp_state_prepare_transfer(struct connectdata *conn)
1404 CURLcode result = CURLE_OK;
1405 struct FTP *ftp = conn->data->req.protop;
1406 struct Curl_easy *data = conn->data;
1408 if(ftp->transfer != FTPTRANSFER_BODY) {
1409 /* doesn't transfer any data */
1411 /* still possibly do PRE QUOTE jobs */
1412 state(conn, FTP_RETR_PREQUOTE);
1413 result = ftp_state_quote(conn, TRUE, FTP_RETR_PREQUOTE);
1415 else if(data->set.ftp_use_port) {
1416 /* We have chosen to use the PORT (or similar) command */
1417 result = ftp_state_use_port(conn, EPRT);
1420 /* We have chosen (this is default) to use the PASV (or similar) command */
1421 if(data->set.ftp_use_pret) {
1422 /* The user has requested that we send a PRET command
1423 to prepare the server for the upcoming PASV */
1424 if(!conn->proto.ftpc.file) {
1425 PPSENDF(&conn->proto.ftpc.pp, "PRET %s",
1426 data->set.str[STRING_CUSTOMREQUEST]?
1427 data->set.str[STRING_CUSTOMREQUEST]:
1428 (data->set.ftp_list_only?"NLST":"LIST"));
1430 else if(data->set.upload) {
1431 PPSENDF(&conn->proto.ftpc.pp, "PRET STOR %s", conn->proto.ftpc.file);
1434 PPSENDF(&conn->proto.ftpc.pp, "PRET RETR %s", conn->proto.ftpc.file);
1436 state(conn, FTP_PRET);
1439 result = ftp_state_use_pasv(conn);
1445 static CURLcode ftp_state_rest(struct connectdata *conn)
1447 CURLcode result = CURLE_OK;
1448 struct FTP *ftp = conn->data->req.protop;
1449 struct ftp_conn *ftpc = &conn->proto.ftpc;
1451 if((ftp->transfer != FTPTRANSFER_BODY) && ftpc->file) {
1452 /* if a "head"-like request is being made (on a file) */
1454 /* Determine if server can respond to REST command and therefore
1455 whether it supports range */
1456 PPSENDF(&conn->proto.ftpc.pp, "REST %d", 0);
1458 state(conn, FTP_REST);
1461 result = ftp_state_prepare_transfer(conn);
1466 static CURLcode ftp_state_size(struct connectdata *conn)
1468 CURLcode result = CURLE_OK;
1469 struct FTP *ftp = conn->data->req.protop;
1470 struct ftp_conn *ftpc = &conn->proto.ftpc;
1472 if((ftp->transfer == FTPTRANSFER_INFO) && ftpc->file) {
1473 /* if a "head"-like request is being made (on a file) */
1475 /* we know ftpc->file is a valid pointer to a file name */
1476 PPSENDF(&ftpc->pp, "SIZE %s", ftpc->file);
1478 state(conn, FTP_SIZE);
1481 result = ftp_state_rest(conn);
1486 static CURLcode ftp_state_list(struct connectdata *conn)
1488 CURLcode result = CURLE_OK;
1489 struct Curl_easy *data = conn->data;
1491 /* If this output is to be machine-parsed, the NLST command might be better
1492 to use, since the LIST command output is not specified or standard in any
1493 way. It has turned out that the NLST list output is not the same on all
1494 servers either... */
1497 if FTPFILE_NOCWD was specified, we are currently in
1498 the user's home directory, so we should add the path
1499 as argument for the LIST / NLST / or custom command.
1500 Whether the server will support this, is uncertain.
1502 The other ftp_filemethods will CWD into dir/dir/ first and
1503 then just do LIST (in that case: nothing to do here)
1505 char *cmd, *lstArg, *slashPos;
1508 if((data->set.ftp_filemethod == FTPFILE_NOCWD) &&
1510 data->state.path[0] &&
1511 strchr(data->state.path, '/')) {
1513 lstArg = strdup(data->state.path);
1515 return CURLE_OUT_OF_MEMORY;
1517 /* Check if path does not end with /, as then we cut off the file part */
1518 if(lstArg[strlen(lstArg) - 1] != '/') {
1520 /* chop off the file part if format is dir/dir/file */
1521 slashPos = strrchr(lstArg, '/');
1523 *(slashPos+1) = '\0';
1527 cmd = aprintf("%s%s%s",
1528 data->set.str[STRING_CUSTOMREQUEST]?
1529 data->set.str[STRING_CUSTOMREQUEST]:
1530 (data->set.ftp_list_only?"NLST":"LIST"),
1532 lstArg? lstArg: "");
1536 return CURLE_OUT_OF_MEMORY;
1539 result = Curl_pp_sendf(&conn->proto.ftpc.pp, "%s", cmd);
1547 state(conn, FTP_LIST);
1552 static CURLcode ftp_state_retr_prequote(struct connectdata *conn)
1554 CURLcode result = CURLE_OK;
1556 /* We've sent the TYPE, now we must send the list of prequote strings */
1558 result = ftp_state_quote(conn, TRUE, FTP_RETR_PREQUOTE);
1563 static CURLcode ftp_state_stor_prequote(struct connectdata *conn)
1565 CURLcode result = CURLE_OK;
1567 /* We've sent the TYPE, now we must send the list of prequote strings */
1569 result = ftp_state_quote(conn, TRUE, FTP_STOR_PREQUOTE);
1574 static CURLcode ftp_state_type(struct connectdata *conn)
1576 CURLcode result = CURLE_OK;
1577 struct FTP *ftp = conn->data->req.protop;
1578 struct Curl_easy *data = conn->data;
1579 struct ftp_conn *ftpc = &conn->proto.ftpc;
1581 /* If we have selected NOBODY and HEADER, it means that we only want file
1582 information. Which in FTP can't be much more than the file size and
1584 if(data->set.opt_no_body && ftpc->file &&
1585 ftp_need_type(conn, data->set.prefer_ascii)) {
1586 /* The SIZE command is _not_ RFC 959 specified, and therefor many servers
1587 may not support it! It is however the only way we have to get a file's
1590 ftp->transfer = FTPTRANSFER_INFO;
1591 /* this means no actual transfer will be made */
1593 /* Some servers return different sizes for different modes, and thus we
1594 must set the proper type before we check the size */
1595 result = ftp_nb_type(conn, data->set.prefer_ascii, FTP_TYPE);
1600 result = ftp_state_size(conn);
1605 /* This is called after the CWD commands have been done in the beginning of
1607 static CURLcode ftp_state_mdtm(struct connectdata *conn)
1609 CURLcode result = CURLE_OK;
1610 struct Curl_easy *data = conn->data;
1611 struct ftp_conn *ftpc = &conn->proto.ftpc;
1613 /* Requested time of file or time-depended transfer? */
1614 if((data->set.get_filetime || data->set.timecondition) && ftpc->file) {
1616 /* we have requested to get the modified-time of the file, this is a white
1617 spot as the MDTM is not mentioned in RFC959 */
1618 PPSENDF(&ftpc->pp, "MDTM %s", ftpc->file);
1620 state(conn, FTP_MDTM);
1623 result = ftp_state_type(conn);
1629 /* This is called after the TYPE and possible quote commands have been sent */
1630 static CURLcode ftp_state_ul_setup(struct connectdata *conn,
1633 CURLcode result = CURLE_OK;
1634 struct FTP *ftp = conn->data->req.protop;
1635 struct Curl_easy *data = conn->data;
1636 struct ftp_conn *ftpc = &conn->proto.ftpc;
1637 int seekerr = CURL_SEEKFUNC_OK;
1639 if((data->state.resume_from && !sizechecked) ||
1640 ((data->state.resume_from > 0) && sizechecked)) {
1641 /* we're about to continue the uploading of a file */
1642 /* 1. get already existing file's size. We use the SIZE command for this
1643 which may not exist in the server! The SIZE command is not in
1646 /* 2. This used to set REST. But since we can do append, we
1647 don't another ftp command. We just skip the source file
1648 offset and then we APPEND the rest on the file instead */
1650 /* 3. pass file-size number of bytes in the source file */
1651 /* 4. lower the infilesize counter */
1652 /* => transfer as usual */
1654 if(data->state.resume_from < 0) {
1655 /* Got no given size to start from, figure it out */
1656 PPSENDF(&ftpc->pp, "SIZE %s", ftpc->file);
1657 state(conn, FTP_STOR_SIZE);
1662 data->set.ftp_append = TRUE;
1664 /* Let's read off the proper amount of bytes from the input. */
1665 if(conn->seek_func) {
1666 seekerr = conn->seek_func(conn->seek_client, data->state.resume_from,
1670 if(seekerr != CURL_SEEKFUNC_OK) {
1671 if(seekerr != CURL_SEEKFUNC_CANTSEEK) {
1672 failf(data, "Could not seek stream");
1673 return CURLE_FTP_COULDNT_USE_REST;
1675 /* seekerr == CURL_SEEKFUNC_CANTSEEK (can't seek to offset) */
1677 curl_off_t passed=0;
1679 size_t readthisamountnow =
1680 (data->state.resume_from - passed > CURL_OFF_T_C(BUFSIZE)) ?
1681 BUFSIZE : curlx_sotouz(data->state.resume_from - passed);
1683 size_t actuallyread =
1684 data->state.fread_func(data->state.buffer, 1, readthisamountnow,
1687 passed += actuallyread;
1688 if((actuallyread == 0) || (actuallyread > readthisamountnow)) {
1689 /* this checks for greater-than only to make sure that the
1690 CURL_READFUNC_ABORT return code still aborts */
1691 failf(data, "Failed to read data");
1692 return CURLE_FTP_COULDNT_USE_REST;
1694 } while(passed < data->state.resume_from);
1697 /* now, decrease the size of the read */
1698 if(data->state.infilesize>0) {
1699 data->state.infilesize -= data->state.resume_from;
1701 if(data->state.infilesize <= 0) {
1702 infof(data, "File already completely uploaded\n");
1704 /* no data to transfer */
1705 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
1707 /* Set ->transfer so that we won't get any error in
1708 * ftp_done() because we didn't transfer anything! */
1709 ftp->transfer = FTPTRANSFER_NONE;
1711 state(conn, FTP_STOP);
1715 /* we've passed, proceed as normal */
1718 PPSENDF(&ftpc->pp, data->set.ftp_append?"APPE %s":"STOR %s",
1721 state(conn, FTP_STOR);
1726 static CURLcode ftp_state_quote(struct connectdata *conn,
1730 CURLcode result = CURLE_OK;
1731 struct Curl_easy *data = conn->data;
1732 struct FTP *ftp = data->req.protop;
1733 struct ftp_conn *ftpc = &conn->proto.ftpc;
1735 struct curl_slist *item;
1740 item = data->set.quote;
1742 case FTP_RETR_PREQUOTE:
1743 case FTP_STOR_PREQUOTE:
1744 item = data->set.prequote;
1747 item = data->set.postquote;
1753 * 'count1' to iterate over the commands to send
1754 * 'count2' to store wether to allow commands to fail
1765 /* Skip count1 items in the linked list */
1766 while((i< ftpc->count1) && item) {
1771 char *cmd = item->data;
1774 ftpc->count2 = 1; /* the sent command is allowed to fail */
1777 ftpc->count2 = 0; /* failure means cancel operation */
1779 PPSENDF(&ftpc->pp, "%s", cmd);
1780 state(conn, instate);
1786 /* No more quote to send, continue to ... */
1790 result = ftp_state_cwd(conn);
1792 case FTP_RETR_PREQUOTE:
1793 if(ftp->transfer != FTPTRANSFER_BODY)
1794 state(conn, FTP_STOP);
1796 if(ftpc->known_filesize != -1) {
1797 Curl_pgrsSetDownloadSize(data, ftpc->known_filesize);
1798 result = ftp_state_retr(conn, ftpc->known_filesize);
1801 if(data->set.ignorecl) {
1802 /* This code is to support download of growing files. It prevents
1803 the state machine from requesting the file size from the
1804 server. With an unknown file size the download continues until
1805 the server terminates it, otherwise the client stops if the
1806 received byte count exceeds the reported file size. Set option
1807 CURLOPT_IGNORE_CONTENT_LENGTH to 1 to enable this behavior.*/
1808 PPSENDF(&ftpc->pp, "RETR %s", ftpc->file);
1809 state(conn, FTP_RETR);
1812 PPSENDF(&ftpc->pp, "SIZE %s", ftpc->file);
1813 state(conn, FTP_RETR_SIZE);
1818 case FTP_STOR_PREQUOTE:
1819 result = ftp_state_ul_setup(conn, FALSE);
1829 /* called from ftp_state_pasv_resp to switch to PASV in case of EPSV
1831 static CURLcode ftp_epsv_disable(struct connectdata *conn)
1833 CURLcode result = CURLE_OK;
1835 if(conn->bits.ipv6) {
1836 /* We can't disable EPSV when doing IPv6, so this is instead a fail */
1837 failf(conn->data, "Failed EPSV attempt, exiting\n");
1838 return CURLE_FTP_WEIRD_SERVER_REPLY;
1841 infof(conn->data, "Failed EPSV attempt. Disabling EPSV\n");
1842 /* disable it for next transfer */
1843 conn->bits.ftp_use_epsv = FALSE;
1844 conn->data->state.errorbuf = FALSE; /* allow error message to get
1846 PPSENDF(&conn->proto.ftpc.pp, "%s", "PASV");
1847 conn->proto.ftpc.count1++;
1848 /* remain in/go to the FTP_PASV state */
1849 state(conn, FTP_PASV);
1854 * Perform the necessary magic that needs to be done once the TCP connection
1855 * to the proxy has completed.
1857 static CURLcode proxy_magic(struct connectdata *conn,
1858 char *newhost, unsigned short newport,
1861 CURLcode result = CURLE_OK;
1862 struct Curl_easy *data = conn->data;
1864 #if defined(CURL_DISABLE_PROXY)
1871 switch(conn->proxytype) {
1872 case CURLPROXY_SOCKS5:
1873 case CURLPROXY_SOCKS5_HOSTNAME:
1874 result = Curl_SOCKS5(conn->proxyuser, conn->proxypasswd, newhost,
1875 newport, SECONDARYSOCKET, conn);
1878 case CURLPROXY_SOCKS4:
1879 result = Curl_SOCKS4(conn->proxyuser, newhost, newport,
1880 SECONDARYSOCKET, conn, FALSE);
1883 case CURLPROXY_SOCKS4A:
1884 result = Curl_SOCKS4(conn->proxyuser, newhost, newport,
1885 SECONDARYSOCKET, conn, TRUE);
1888 case CURLPROXY_HTTP:
1889 case CURLPROXY_HTTP_1_0:
1890 /* do nothing here. handled later. */
1893 failf(data, "unknown proxytype option given");
1894 result = CURLE_COULDNT_CONNECT;
1898 if(conn->bits.tunnel_proxy && conn->bits.httpproxy) {
1900 /* We want "seamless" FTP operations through HTTP proxy tunnel */
1902 /* Curl_proxyCONNECT is based on a pointer to a struct HTTP at the
1903 * member conn->proto.http; we want FTP through HTTP and we have to
1904 * change the member temporarily for connecting to the HTTP proxy. After
1905 * Curl_proxyCONNECT we have to set back the member to the original
1906 * struct FTP pointer
1908 struct HTTP http_proxy;
1909 struct FTP *ftp_save = data->req.protop;
1910 memset(&http_proxy, 0, sizeof(http_proxy));
1911 data->req.protop = &http_proxy;
1913 result = Curl_proxyCONNECT(conn, SECONDARYSOCKET, newhost, newport, TRUE);
1915 data->req.protop = ftp_save;
1920 if(conn->tunnel_state[SECONDARYSOCKET] != TUNNEL_COMPLETE) {
1921 /* the CONNECT procedure is not complete, the tunnel is not yet up */
1922 state(conn, FTP_STOP); /* this phase is completed */
1932 static char *control_address(struct connectdata *conn)
1934 /* Returns the control connection IP address.
1935 If a proxy tunnel is used, returns the original host name instead, because
1936 the effective control connection address is the proxy address,
1937 not the ftp host. */
1938 if(conn->bits.tunnel_proxy ||
1939 conn->proxytype == CURLPROXY_SOCKS5 ||
1940 conn->proxytype == CURLPROXY_SOCKS5_HOSTNAME ||
1941 conn->proxytype == CURLPROXY_SOCKS4 ||
1942 conn->proxytype == CURLPROXY_SOCKS4A)
1943 return conn->host.name;
1945 return conn->ip_addr_str;
1948 static CURLcode ftp_state_pasv_resp(struct connectdata *conn,
1951 struct ftp_conn *ftpc = &conn->proto.ftpc;
1953 struct Curl_easy *data=conn->data;
1954 struct Curl_dns_entry *addr=NULL;
1956 unsigned short connectport; /* the local port connect() should use! */
1957 char *str=&data->state.buffer[4]; /* start on the first letter */
1959 /* if we come here again, make sure the former name is cleared */
1960 Curl_safefree(ftpc->newhost);
1962 if((ftpc->count1 == 0) &&
1964 /* positive EPSV response */
1965 char *ptr = strchr(str, '(');
1970 if(5 == sscanf(ptr, "%c%c%c%u%c",
1976 const char sep1 = separator[0];
1979 /* The four separators should be identical, or else this is an oddly
1980 formatted reply and we bail out immediately. */
1981 for(i=1; i<4; i++) {
1982 if(separator[i] != sep1) {
1983 ptr=NULL; /* set to NULL to signal error */
1988 failf(data, "Illegal port number in EPSV reply");
1989 return CURLE_FTP_WEIRD_PASV_REPLY;
1992 ftpc->newport = (unsigned short)(num & 0xffff);
1993 ftpc->newhost = strdup(control_address(conn));
1995 return CURLE_OUT_OF_MEMORY;
2002 failf(data, "Weirdly formatted EPSV reply");
2003 return CURLE_FTP_WEIRD_PASV_REPLY;
2006 else if((ftpc->count1 == 1) &&
2008 /* positive PASV response */
2013 * Scan for a sequence of six comma-separated numbers and use them as
2014 * IP+port indicators.
2016 * Found reply-strings include:
2017 * "227 Entering Passive Mode (127,0,0,1,4,51)"
2018 * "227 Data transfer will passively listen to 127,0,0,1,4,51"
2019 * "227 Entering passive mode. 127,0,0,1,4,51"
2022 if(6 == sscanf(str, "%d,%d,%d,%d,%d,%d",
2023 &ip[0], &ip[1], &ip[2], &ip[3],
2024 &port[0], &port[1]))
2030 failf(data, "Couldn't interpret the 227-response");
2031 return CURLE_FTP_WEIRD_227_FORMAT;
2034 /* we got OK from server */
2035 if(data->set.ftp_skip_ip) {
2036 /* told to ignore the remotely given IP but instead use the host we used
2037 for the control connection */
2038 infof(data, "Skip %d.%d.%d.%d for data connection, re-use %s instead\n",
2039 ip[0], ip[1], ip[2], ip[3],
2041 ftpc->newhost = strdup(control_address(conn));
2044 ftpc->newhost = aprintf("%d.%d.%d.%d", ip[0], ip[1], ip[2], ip[3]);
2047 return CURLE_OUT_OF_MEMORY;
2049 ftpc->newport = (unsigned short)(((port[0]<<8) + port[1]) & 0xffff);
2051 else if(ftpc->count1 == 0) {
2052 /* EPSV failed, move on to PASV */
2053 return ftp_epsv_disable(conn);
2056 failf(data, "Bad PASV/EPSV response: %03d", ftpcode);
2057 return CURLE_FTP_WEIRD_PASV_REPLY;
2060 if(conn->bits.proxy) {
2062 * This connection uses a proxy and we need to connect to the proxy again
2063 * here. We don't want to rely on a former host lookup that might've
2064 * expired now, instead we remake the lookup here and now!
2066 rc = Curl_resolv(conn, conn->proxy.name, (int)conn->port, &addr);
2067 if(rc == CURLRESOLV_PENDING)
2068 /* BLOCKING, ignores the return code but 'addr' will be NULL in
2070 (void)Curl_resolver_wait_resolv(conn, &addr);
2073 (unsigned short)conn->port; /* we connect to the proxy's port */
2076 failf(data, "Can't resolve proxy host %s:%hu",
2077 conn->proxy.name, connectport);
2078 return CURLE_FTP_CANT_GET_HOST;
2082 /* normal, direct, ftp connection */
2083 rc = Curl_resolv(conn, ftpc->newhost, ftpc->newport, &addr);
2084 if(rc == CURLRESOLV_PENDING)
2086 (void)Curl_resolver_wait_resolv(conn, &addr);
2088 connectport = ftpc->newport; /* we connect to the remote port */
2091 failf(data, "Can't resolve new host %s:%hu", ftpc->newhost, connectport);
2092 return CURLE_FTP_CANT_GET_HOST;
2096 conn->bits.tcpconnect[SECONDARYSOCKET] = FALSE;
2097 result = Curl_connecthost(conn, addr);
2100 Curl_resolv_unlock(data, addr); /* we're done using this address */
2101 if(ftpc->count1 == 0 && ftpcode == 229)
2102 return ftp_epsv_disable(conn);
2109 * When this is used from the multi interface, this might've returned with
2110 * the 'connected' set to FALSE and thus we are now awaiting a non-blocking
2111 * connect to connect.
2114 if(data->set.verbose)
2115 /* this just dumps information about this second connection */
2116 ftp_pasv_verbose(conn, addr->addr, ftpc->newhost, connectport);
2118 Curl_resolv_unlock(data, addr); /* we're done using this address */
2119 conn->bits.do_more = TRUE;
2120 state(conn, FTP_STOP); /* this phase is completed */
2125 static CURLcode ftp_state_port_resp(struct connectdata *conn,
2128 struct Curl_easy *data = conn->data;
2129 struct ftp_conn *ftpc = &conn->proto.ftpc;
2130 ftpport fcmd = (ftpport)ftpc->count1;
2131 CURLcode result = CURLE_OK;
2133 /* The FTP spec tells a positive response should have code 200.
2134 Be more permissive here to tolerate deviant servers. */
2135 if(ftpcode / 100 != 2) {
2136 /* the command failed */
2139 infof(data, "disabling EPRT usage\n");
2140 conn->bits.ftp_use_eprt = FALSE;
2145 failf(data, "Failed to do PORT");
2146 result = CURLE_FTP_PORT_FAILED;
2150 result = ftp_state_use_port(conn, fcmd);
2153 infof(data, "Connect data stream actively\n");
2154 state(conn, FTP_STOP); /* end of DO phase */
2155 result = ftp_dophase_done(conn, FALSE);
2161 static CURLcode ftp_state_mdtm_resp(struct connectdata *conn,
2164 CURLcode result = CURLE_OK;
2165 struct Curl_easy *data=conn->data;
2166 struct FTP *ftp = data->req.protop;
2167 struct ftp_conn *ftpc = &conn->proto.ftpc;
2172 /* we got a time. Format should be: "YYYYMMDDHHMMSS[.sss]" where the
2173 last .sss part is optional and means fractions of a second */
2174 int year, month, day, hour, minute, second;
2175 char *buf = data->state.buffer;
2176 if(6 == sscanf(buf+4, "%04d%02d%02d%02d%02d%02d",
2177 &year, &month, &day, &hour, &minute, &second)) {
2178 /* we have a time, reformat it */
2179 time_t secs=time(NULL);
2180 /* using the good old yacc/bison yuck */
2181 snprintf(buf, sizeof(conn->data->state.buffer),
2182 "%04d%02d%02d %02d:%02d:%02d GMT",
2183 year, month, day, hour, minute, second);
2184 /* now, convert this into a time() value: */
2185 data->info.filetime = (long)curl_getdate(buf, &secs);
2188 #ifdef CURL_FTP_HTTPSTYLE_HEAD
2189 /* If we asked for a time of the file and we actually got one as well,
2190 we "emulate" a HTTP-style header in our output. */
2192 if(data->set.opt_no_body &&
2194 data->set.get_filetime &&
2195 (data->info.filetime>=0) ) {
2196 time_t filetime = (time_t)data->info.filetime;
2198 const struct tm *tm = &buffer;
2200 result = Curl_gmtime(filetime, &buffer);
2204 /* format: "Tue, 15 Nov 1994 12:45:26" */
2205 snprintf(buf, BUFSIZE-1,
2206 "Last-Modified: %s, %02d %s %4d %02d:%02d:%02d GMT\r\n",
2207 Curl_wkday[tm->tm_wday?tm->tm_wday-1:6],
2209 Curl_month[tm->tm_mon],
2214 result = Curl_client_write(conn, CLIENTWRITE_BOTH, buf, 0);
2217 } /* end of a ridiculous amount of conditionals */
2222 infof(data, "unsupported MDTM reply format\n");
2224 case 550: /* "No such file or directory" */
2225 failf(data, "Given file does not exist");
2226 result = CURLE_FTP_COULDNT_RETR_FILE;
2230 if(data->set.timecondition) {
2231 if((data->info.filetime > 0) && (data->set.timevalue > 0)) {
2232 switch(data->set.timecondition) {
2233 case CURL_TIMECOND_IFMODSINCE:
2235 if(data->info.filetime <= data->set.timevalue) {
2236 infof(data, "The requested document is not new enough\n");
2237 ftp->transfer = FTPTRANSFER_NONE; /* mark to not transfer data */
2238 data->info.timecond = TRUE;
2239 state(conn, FTP_STOP);
2243 case CURL_TIMECOND_IFUNMODSINCE:
2244 if(data->info.filetime > data->set.timevalue) {
2245 infof(data, "The requested document is not old enough\n");
2246 ftp->transfer = FTPTRANSFER_NONE; /* mark to not transfer data */
2247 data->info.timecond = TRUE;
2248 state(conn, FTP_STOP);
2255 infof(data, "Skipping time comparison\n");
2260 result = ftp_state_type(conn);
2265 static CURLcode ftp_state_type_resp(struct connectdata *conn,
2269 CURLcode result = CURLE_OK;
2270 struct Curl_easy *data=conn->data;
2272 if(ftpcode/100 != 2) {
2273 /* "sasserftpd" and "(u)r(x)bot ftpd" both responds with 226 after a
2274 successful 'TYPE I'. While that is not as RFC959 says, it is still a
2275 positive response code and we allow that. */
2276 failf(data, "Couldn't set desired mode");
2277 return CURLE_FTP_COULDNT_SET_TYPE;
2280 infof(data, "Got a %03d response code instead of the assumed 200\n",
2283 if(instate == FTP_TYPE)
2284 result = ftp_state_size(conn);
2285 else if(instate == FTP_LIST_TYPE)
2286 result = ftp_state_list(conn);
2287 else if(instate == FTP_RETR_TYPE)
2288 result = ftp_state_retr_prequote(conn);
2289 else if(instate == FTP_STOR_TYPE)
2290 result = ftp_state_stor_prequote(conn);
2295 static CURLcode ftp_state_retr(struct connectdata *conn,
2296 curl_off_t filesize)
2298 CURLcode result = CURLE_OK;
2299 struct Curl_easy *data=conn->data;
2300 struct FTP *ftp = data->req.protop;
2301 struct ftp_conn *ftpc = &conn->proto.ftpc;
2303 if(data->set.max_filesize && (filesize > data->set.max_filesize)) {
2304 failf(data, "Maximum file size exceeded");
2305 return CURLE_FILESIZE_EXCEEDED;
2307 ftp->downloadsize = filesize;
2309 if(data->state.resume_from) {
2310 /* We always (attempt to) get the size of downloads, so it is done before
2311 this even when not doing resumes. */
2312 if(filesize == -1) {
2313 infof(data, "ftp server doesn't support SIZE\n");
2314 /* We couldn't get the size and therefore we can't know if there really
2315 is a part of the file left to get, although the server will just
2316 close the connection when we start the connection so it won't cause
2317 us any harm, just not make us exit as nicely. */
2320 /* We got a file size report, so we check that there actually is a
2321 part of the file left to get, or else we go home. */
2322 if(data->state.resume_from< 0) {
2323 /* We're supposed to download the last abs(from) bytes */
2324 if(filesize < -data->state.resume_from) {
2325 failf(data, "Offset (%" CURL_FORMAT_CURL_OFF_T
2326 ") was beyond file size (%" CURL_FORMAT_CURL_OFF_T ")",
2327 data->state.resume_from, filesize);
2328 return CURLE_BAD_DOWNLOAD_RESUME;
2330 /* convert to size to download */
2331 ftp->downloadsize = -data->state.resume_from;
2332 /* download from where? */
2333 data->state.resume_from = filesize - ftp->downloadsize;
2336 if(filesize < data->state.resume_from) {
2337 failf(data, "Offset (%" CURL_FORMAT_CURL_OFF_T
2338 ") was beyond file size (%" CURL_FORMAT_CURL_OFF_T ")",
2339 data->state.resume_from, filesize);
2340 return CURLE_BAD_DOWNLOAD_RESUME;
2342 /* Now store the number of bytes we are expected to download */
2343 ftp->downloadsize = filesize-data->state.resume_from;
2347 if(ftp->downloadsize == 0) {
2348 /* no data to transfer */
2349 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
2350 infof(data, "File already completely downloaded\n");
2352 /* Set ->transfer so that we won't get any error in ftp_done()
2353 * because we didn't transfer the any file */
2354 ftp->transfer = FTPTRANSFER_NONE;
2355 state(conn, FTP_STOP);
2359 /* Set resume file transfer offset */
2360 infof(data, "Instructs server to resume from offset %"
2361 CURL_FORMAT_CURL_OFF_T "\n", data->state.resume_from);
2363 PPSENDF(&ftpc->pp, "REST %" CURL_FORMAT_CURL_OFF_T,
2364 data->state.resume_from);
2366 state(conn, FTP_RETR_REST);
2370 PPSENDF(&ftpc->pp, "RETR %s", ftpc->file);
2371 state(conn, FTP_RETR);
2377 static CURLcode ftp_state_size_resp(struct connectdata *conn,
2381 CURLcode result = CURLE_OK;
2382 struct Curl_easy *data=conn->data;
2383 curl_off_t filesize;
2384 char *buf = data->state.buffer;
2386 /* get the size from the ascii string: */
2387 filesize = (ftpcode == 213)?curlx_strtoofft(buf+4, NULL, 0):-1;
2389 if(instate == FTP_SIZE) {
2390 #ifdef CURL_FTP_HTTPSTYLE_HEAD
2391 if(-1 != filesize) {
2392 snprintf(buf, sizeof(data->state.buffer),
2393 "Content-Length: %" CURL_FORMAT_CURL_OFF_T "\r\n", filesize);
2394 result = Curl_client_write(conn, CLIENTWRITE_BOTH, buf, 0);
2399 Curl_pgrsSetDownloadSize(data, filesize);
2400 result = ftp_state_rest(conn);
2402 else if(instate == FTP_RETR_SIZE) {
2403 Curl_pgrsSetDownloadSize(data, filesize);
2404 result = ftp_state_retr(conn, filesize);
2406 else if(instate == FTP_STOR_SIZE) {
2407 data->state.resume_from = filesize;
2408 result = ftp_state_ul_setup(conn, TRUE);
2414 static CURLcode ftp_state_rest_resp(struct connectdata *conn,
2418 CURLcode result = CURLE_OK;
2419 struct ftp_conn *ftpc = &conn->proto.ftpc;
2424 #ifdef CURL_FTP_HTTPSTYLE_HEAD
2425 if(ftpcode == 350) {
2426 char buffer[24]= { "Accept-ranges: bytes\r\n" };
2427 result = Curl_client_write(conn, CLIENTWRITE_BOTH, buffer, 0);
2432 result = ftp_state_prepare_transfer(conn);
2436 if(ftpcode != 350) {
2437 failf(conn->data, "Couldn't use REST");
2438 result = CURLE_FTP_COULDNT_USE_REST;
2441 PPSENDF(&ftpc->pp, "RETR %s", ftpc->file);
2442 state(conn, FTP_RETR);
2450 static CURLcode ftp_state_stor_resp(struct connectdata *conn,
2451 int ftpcode, ftpstate instate)
2453 CURLcode result = CURLE_OK;
2454 struct Curl_easy *data = conn->data;
2457 failf(data, "Failed FTP upload: %0d", ftpcode);
2458 state(conn, FTP_STOP);
2459 /* oops, we never close the sockets! */
2460 return CURLE_UPLOAD_FAILED;
2463 conn->proto.ftpc.state_saved = instate;
2465 /* PORT means we are now awaiting the server to connect to us. */
2466 if(data->set.ftp_use_port) {
2469 state(conn, FTP_STOP); /* no longer in STOR state */
2471 result = AllowServerConnect(conn, &connected);
2476 struct ftp_conn *ftpc = &conn->proto.ftpc;
2477 infof(data, "Data conn was not available immediately\n");
2478 ftpc->wait_data_conn = TRUE;
2484 return InitiateTransfer(conn);
2487 /* for LIST and RETR responses */
2488 static CURLcode ftp_state_get_resp(struct connectdata *conn,
2492 CURLcode result = CURLE_OK;
2493 struct Curl_easy *data = conn->data;
2494 struct FTP *ftp = data->req.protop;
2495 char *buf = data->state.buffer;
2497 if((ftpcode == 150) || (ftpcode == 125)) {
2501 150 Opening BINARY mode data connection for /etc/passwd (2241
2502 bytes). (ok, the file is being transferred)
2505 150 Opening ASCII mode data connection for /bin/ls
2508 150 ASCII data connection for /bin/ls (137.167.104.91,37445) (0 bytes).
2511 150 Opening ASCII mode data connection for [file] (0.0.0.0,0) (545 bytes)
2514 125 Data connection already open; Transfer starting. */
2516 curl_off_t size=-1; /* default unknown size */
2520 * It appears that there are FTP-servers that return size 0 for files when
2521 * SIZE is used on the file while being in BINARY mode. To work around
2522 * that (stupid) behavior, we attempt to parse the RETR response even if
2523 * the SIZE returned size zero.
2525 * Debugging help from Salvatore Sorrentino on February 26, 2003.
2528 if((instate != FTP_LIST) &&
2529 !data->set.prefer_ascii &&
2530 (ftp->downloadsize < 1)) {
2532 * It seems directory listings either don't show the size or very
2533 * often uses size 0 anyway. ASCII transfers may very well turn out
2534 * that the transferred amount of data is not the same as this line
2535 * tells, why using this number in those cases only confuses us.
2537 * Example D above makes this parsing a little tricky */
2539 bytes=strstr(buf, " bytes");
2541 long in=(long)(bytes-buf);
2542 /* this is a hint there is size information in there! ;-) */
2544 /* scan for the left parenthesis and break there */
2547 /* skip only digits */
2548 if(!ISDIGIT(*bytes)) {
2552 /* one more estep backwards */
2555 /* if we have nothing but digits: */
2557 /* get the number! */
2558 size = curlx_strtoofft(bytes, NULL, 0);
2562 else if(ftp->downloadsize > -1)
2563 size = ftp->downloadsize;
2565 if(size > data->req.maxdownload && data->req.maxdownload > 0)
2566 size = data->req.size = data->req.maxdownload;
2567 else if((instate != FTP_LIST) && (data->set.prefer_ascii))
2568 size = -1; /* kludge for servers that understate ASCII mode file size */
2570 infof(data, "Maxdownload = %" CURL_FORMAT_CURL_OFF_T "\n",
2571 data->req.maxdownload);
2573 if(instate != FTP_LIST)
2574 infof(data, "Getting file with size: %" CURL_FORMAT_CURL_OFF_T "\n",
2578 conn->proto.ftpc.state_saved = instate;
2579 conn->proto.ftpc.retr_size_saved = size;
2581 if(data->set.ftp_use_port) {
2584 result = AllowServerConnect(conn, &connected);
2589 struct ftp_conn *ftpc = &conn->proto.ftpc;
2590 infof(data, "Data conn was not available immediately\n");
2591 state(conn, FTP_STOP);
2592 ftpc->wait_data_conn = TRUE;
2596 return InitiateTransfer(conn);
2599 if((instate == FTP_LIST) && (ftpcode == 450)) {
2600 /* simply no matching files in the dir listing */
2601 ftp->transfer = FTPTRANSFER_NONE; /* don't download anything */
2602 state(conn, FTP_STOP); /* this phase is over */
2605 failf(data, "RETR response: %03d", ftpcode);
2606 return instate == FTP_RETR && ftpcode == 550?
2607 CURLE_REMOTE_FILE_NOT_FOUND:
2608 CURLE_FTP_COULDNT_RETR_FILE;
2615 /* after USER, PASS and ACCT */
2616 static CURLcode ftp_state_loggedin(struct connectdata *conn)
2618 CURLcode result = CURLE_OK;
2620 if(conn->ssl[FIRSTSOCKET].use) {
2621 /* PBSZ = PROTECTION BUFFER SIZE.
2623 The 'draft-murray-auth-ftp-ssl' (draft 12, page 7) says:
2625 Specifically, the PROT command MUST be preceded by a PBSZ
2626 command and a PBSZ command MUST be preceded by a successful
2627 security data exchange (the TLS negotiation in this case)
2629 ... (and on page 8):
2631 Thus the PBSZ command must still be issued, but must have a
2632 parameter of '0' to indicate that no buffering is taking place
2633 and the data connection should not be encapsulated.
2635 PPSENDF(&conn->proto.ftpc.pp, "PBSZ %d", 0);
2636 state(conn, FTP_PBSZ);
2639 result = ftp_state_pwd(conn);
2644 /* for USER and PASS responses */
2645 static CURLcode ftp_state_user_resp(struct connectdata *conn,
2649 CURLcode result = CURLE_OK;
2650 struct Curl_easy *data = conn->data;
2651 struct FTP *ftp = data->req.protop;
2652 struct ftp_conn *ftpc = &conn->proto.ftpc;
2653 (void)instate; /* no use for this yet */
2655 /* some need password anyway, and others just return 2xx ignored */
2656 if((ftpcode == 331) && (ftpc->state == FTP_USER)) {
2657 /* 331 Password required for ...
2658 (the server requires to send the user's password too) */
2659 PPSENDF(&ftpc->pp, "PASS %s", ftp->passwd?ftp->passwd:"");
2660 state(conn, FTP_PASS);
2662 else if(ftpcode/100 == 2) {
2663 /* 230 User ... logged in.
2664 (the user logged in with or without password) */
2665 result = ftp_state_loggedin(conn);
2667 else if(ftpcode == 332) {
2668 if(data->set.str[STRING_FTP_ACCOUNT]) {
2669 PPSENDF(&ftpc->pp, "ACCT %s", data->set.str[STRING_FTP_ACCOUNT]);
2670 state(conn, FTP_ACCT);
2673 failf(data, "ACCT requested but none available");
2674 result = CURLE_LOGIN_DENIED;
2678 /* All other response codes, like:
2680 530 User ... access denied
2681 (the server denies to log the specified user) */
2683 if(conn->data->set.str[STRING_FTP_ALTERNATIVE_TO_USER] &&
2684 !conn->data->state.ftp_trying_alternative) {
2685 /* Ok, USER failed. Let's try the supplied command. */
2686 PPSENDF(&conn->proto.ftpc.pp, "%s",
2687 conn->data->set.str[STRING_FTP_ALTERNATIVE_TO_USER]);
2688 conn->data->state.ftp_trying_alternative = TRUE;
2689 state(conn, FTP_USER);
2693 failf(data, "Access denied: %03d", ftpcode);
2694 result = CURLE_LOGIN_DENIED;
2700 /* for ACCT response */
2701 static CURLcode ftp_state_acct_resp(struct connectdata *conn,
2704 CURLcode result = CURLE_OK;
2705 struct Curl_easy *data = conn->data;
2706 if(ftpcode != 230) {
2707 failf(data, "ACCT rejected by server: %03d", ftpcode);
2708 result = CURLE_FTP_WEIRD_PASS_REPLY; /* FIX */
2711 result = ftp_state_loggedin(conn);
2717 static CURLcode ftp_statemach_act(struct connectdata *conn)
2720 curl_socket_t sock = conn->sock[FIRSTSOCKET];
2721 struct Curl_easy *data=conn->data;
2723 struct ftp_conn *ftpc = &conn->proto.ftpc;
2724 struct pingpong *pp = &ftpc->pp;
2725 static const char ftpauth[][4] = { "SSL", "TLS" };
2729 return Curl_pp_flushsend(pp);
2731 result = ftp_readresp(sock, pp, &ftpcode, &nread);
2736 /* we have now received a full FTP server response */
2737 switch(ftpc->state) {
2740 /* 230 User logged in - already! */
2741 return ftp_state_user_resp(conn, ftpcode, ftpc->state);
2742 else if(ftpcode != 220) {
2743 failf(data, "Got a %03d ftp-server response when 220 was expected",
2745 return CURLE_FTP_WEIRD_SERVER_REPLY;
2748 /* We have received a 220 response fine, now we proceed. */
2751 /* If not anonymous login, try a secure login. Note that this
2752 procedure is still BLOCKING. */
2754 Curl_sec_request_prot(conn, "private");
2755 /* We set private first as default, in case the line below fails to
2756 set a valid level */
2757 Curl_sec_request_prot(conn, data->set.str[STRING_KRB_LEVEL]);
2759 if(Curl_sec_login(conn))
2760 infof(data, "Logging in with password in cleartext!\n");
2762 infof(data, "Authentication successful\n");
2766 if(data->set.use_ssl && !conn->ssl[FIRSTSOCKET].use) {
2767 /* We don't have a SSL/TLS connection yet, but FTPS is
2768 requested. Try a FTPS connection now */
2771 switch(data->set.ftpsslauth) {
2772 case CURLFTPAUTH_DEFAULT:
2773 case CURLFTPAUTH_SSL:
2774 ftpc->count2 = 1; /* add one to get next */
2777 case CURLFTPAUTH_TLS:
2778 ftpc->count2 = -1; /* subtract one to get next */
2782 failf(data, "unsupported parameter to CURLOPT_FTPSSLAUTH: %d",
2783 (int)data->set.ftpsslauth);
2784 return CURLE_UNKNOWN_OPTION; /* we don't know what to do */
2786 PPSENDF(&ftpc->pp, "AUTH %s", ftpauth[ftpc->count1]);
2787 state(conn, FTP_AUTH);
2790 result = ftp_state_user(conn);
2798 /* we have gotten the response to a previous AUTH command */
2800 /* RFC2228 (page 5) says:
2802 * If the server is willing to accept the named security mechanism,
2803 * and does not require any security data, it must respond with
2804 * reply code 234/334.
2807 if((ftpcode == 234) || (ftpcode == 334)) {
2808 /* Curl_ssl_connect is BLOCKING */
2809 result = Curl_ssl_connect(conn, FIRSTSOCKET);
2811 conn->ssl[SECONDARYSOCKET].use = FALSE; /* clear-text data */
2812 result = ftp_state_user(conn);
2815 else if(ftpc->count3 < 1) {
2817 ftpc->count1 += ftpc->count2; /* get next attempt */
2818 result = Curl_pp_sendf(&ftpc->pp, "AUTH %s", ftpauth[ftpc->count1]);
2819 /* remain in this same state */
2822 if(data->set.use_ssl > CURLUSESSL_TRY)
2823 /* we failed and CURLUSESSL_CONTROL or CURLUSESSL_ALL is set */
2824 result = CURLE_USE_SSL_FAILED;
2826 /* ignore the failure and continue */
2827 result = ftp_state_user(conn);
2836 result = ftp_state_user_resp(conn, ftpcode, ftpc->state);
2840 result = ftp_state_acct_resp(conn, ftpcode);
2844 PPSENDF(&ftpc->pp, "PROT %c",
2845 data->set.use_ssl == CURLUSESSL_CONTROL ? 'C' : 'P');
2846 state(conn, FTP_PROT);
2851 if(ftpcode/100 == 2)
2852 /* We have enabled SSL for the data connection! */
2853 conn->ssl[SECONDARYSOCKET].use =
2854 (data->set.use_ssl != CURLUSESSL_CONTROL) ? TRUE : FALSE;
2855 /* FTP servers typically responds with 500 if they decide to reject
2857 else if(data->set.use_ssl > CURLUSESSL_CONTROL)
2858 /* we failed and bails out */
2859 return CURLE_USE_SSL_FAILED;
2861 if(data->set.ftp_ccc) {
2862 /* CCC - Clear Command Channel
2864 PPSENDF(&ftpc->pp, "%s", "CCC");
2865 state(conn, FTP_CCC);
2868 result = ftp_state_pwd(conn);
2876 /* First shut down the SSL layer (note: this call will block) */
2877 result = Curl_ssl_shutdown(conn, FIRSTSOCKET);
2880 failf(conn->data, "Failed to clear the command channel (CCC)");
2885 /* Then continue as normal */
2886 result = ftp_state_pwd(conn);
2892 if(ftpcode == 257) {
2893 char *ptr=&data->state.buffer[4]; /* start on the first letter */
2897 dir = malloc(nread + 1);
2899 return CURLE_OUT_OF_MEMORY;
2901 /* Reply format is like
2902 257<space>[rubbish]"<directory-name>"<space><commentary> and the
2905 The directory name can contain any character; embedded
2906 double-quotes should be escaped by double-quotes (the
2907 "quote-doubling" convention).
2910 /* scan for the first double-quote for non-standard responses */
2911 while(ptr < &data->state.buffer[sizeof(data->state.buffer)]
2912 && *ptr != '\n' && *ptr != '\0' && *ptr != '"')
2916 /* it started good */
2918 for(store = dir; *ptr;) {
2920 if('\"' == ptr[1]) {
2921 /* "quote-doubling" */
2927 *store = '\0'; /* zero terminate */
2928 break; /* get out of this loop */
2937 /* If the path name does not look like an absolute path (i.e.: it
2938 does not start with a '/'), we probably need some server-dependent
2939 adjustments. For example, this is the case when connecting to
2940 an OS400 FTP server: this server supports two name syntaxes,
2941 the default one being incompatible with standard pathes. In
2942 addition, this server switches automatically to the regular path
2943 syntax when one is encountered in a command: this results in
2944 having an entrypath in the wrong syntax when later used in CWD.
2945 The method used here is to check the server OS: we do it only
2946 if the path name looks strange to minimize overhead on other
2949 if(!ftpc->server_os && dir[0] != '/') {
2951 result = Curl_pp_sendf(&ftpc->pp, "%s", "SYST");
2956 Curl_safefree(ftpc->entrypath);
2957 ftpc->entrypath = dir; /* remember this */
2958 infof(data, "Entry path is '%s'\n", ftpc->entrypath);
2959 /* also save it where getinfo can access it: */
2960 data->state.most_recent_ftp_entrypath = ftpc->entrypath;
2961 state(conn, FTP_SYST);
2965 Curl_safefree(ftpc->entrypath);
2966 ftpc->entrypath = dir; /* remember this */
2967 infof(data, "Entry path is '%s'\n", ftpc->entrypath);
2968 /* also save it where getinfo can access it: */
2969 data->state.most_recent_ftp_entrypath = ftpc->entrypath;
2972 /* couldn't get the path */
2974 infof(data, "Failed to figure out path\n");
2977 state(conn, FTP_STOP); /* we are done with the CONNECT phase! */
2978 DEBUGF(infof(data, "protocol connect phase DONE\n"));
2982 if(ftpcode == 215) {
2983 char *ptr=&data->state.buffer[4]; /* start on the first letter */
2987 os = malloc(nread + 1);
2989 return CURLE_OUT_OF_MEMORY;
2991 /* Reply format is like
2992 215<space><OS-name><space><commentary>
2996 for(store = os; *ptr && *ptr != ' ';)
2998 *store = '\0'; /* zero terminate */
3000 /* Check for special servers here. */
3002 if(strequal(os, "OS/400")) {
3003 /* Force OS400 name format 1. */
3004 result = Curl_pp_sendf(&ftpc->pp, "%s", "SITE NAMEFMT 1");
3009 /* remember target server OS */
3010 Curl_safefree(ftpc->server_os);
3011 ftpc->server_os = os;
3012 state(conn, FTP_NAMEFMT);
3016 /* Nothing special for the target server. */
3017 /* remember target server OS */
3018 Curl_safefree(ftpc->server_os);
3019 ftpc->server_os = os;
3023 /* Cannot identify server OS. Continue anyway and cross fingers. */
3026 state(conn, FTP_STOP); /* we are done with the CONNECT phase! */
3027 DEBUGF(infof(data, "protocol connect phase DONE\n"));
3031 if(ftpcode == 250) {
3032 /* Name format change successful: reload initial path. */
3033 ftp_state_pwd(conn);
3037 state(conn, FTP_STOP); /* we are done with the CONNECT phase! */
3038 DEBUGF(infof(data, "protocol connect phase DONE\n"));
3043 case FTP_RETR_PREQUOTE:
3044 case FTP_STOR_PREQUOTE:
3045 if((ftpcode >= 400) && !ftpc->count2) {
3046 /* failure response code, and not allowed to fail */
3047 failf(conn->data, "QUOT command failed with %03d", ftpcode);
3048 return CURLE_QUOTE_ERROR;
3050 result = ftp_state_quote(conn, FALSE, ftpc->state);
3057 if(ftpcode/100 != 2) {
3058 /* failure to CWD there */
3059 if(conn->data->set.ftp_create_missing_dirs &&
3060 ftpc->count1 && !ftpc->count2) {
3062 ftpc->count2++; /* counter to prevent CWD-MKD loops */
3063 PPSENDF(&ftpc->pp, "MKD %s", ftpc->dirs[ftpc->count1 - 1]);
3064 state(conn, FTP_MKD);
3067 /* return failure */
3068 failf(data, "Server denied you to change to the given directory");
3069 ftpc->cwdfail = TRUE; /* don't remember this path as we failed
3071 return CURLE_REMOTE_ACCESS_DENIED;
3077 if(++ftpc->count1 <= ftpc->dirdepth) {
3079 PPSENDF(&ftpc->pp, "CWD %s", ftpc->dirs[ftpc->count1 - 1]);
3082 result = ftp_state_mdtm(conn);
3090 if((ftpcode/100 != 2) && !ftpc->count3--) {
3091 /* failure to MKD the dir */
3092 failf(data, "Failed to MKD dir: %03d", ftpcode);
3093 return CURLE_REMOTE_ACCESS_DENIED;
3095 state(conn, FTP_CWD);
3097 PPSENDF(&ftpc->pp, "CWD %s", ftpc->dirs[ftpc->count1 - 1]);
3101 result = ftp_state_mdtm_resp(conn, ftpcode);
3108 result = ftp_state_type_resp(conn, ftpcode, ftpc->state);
3114 result = ftp_state_size_resp(conn, ftpcode, ftpc->state);
3119 result = ftp_state_rest_resp(conn, ftpcode, ftpc->state);
3123 if(ftpcode != 200) {
3124 /* there only is this one standard OK return code. */
3125 failf(data, "PRET command not accepted: %03d", ftpcode);
3126 return CURLE_FTP_PRET_FAILED;
3128 result = ftp_state_use_pasv(conn);
3132 result = ftp_state_pasv_resp(conn, ftpcode);
3136 result = ftp_state_port_resp(conn, ftpcode);
3141 result = ftp_state_get_resp(conn, ftpcode, ftpc->state);
3145 result = ftp_state_stor_resp(conn, ftpcode, ftpc->state);
3149 /* fallthrough, just stop! */
3151 /* internal error */
3152 state(conn, FTP_STOP);
3161 /* called repeatedly until done from multi.c */
3162 static CURLcode ftp_multi_statemach(struct connectdata *conn,
3165 struct ftp_conn *ftpc = &conn->proto.ftpc;
3166 CURLcode result = Curl_pp_statemach(&ftpc->pp, FALSE);
3168 /* Check for the state outside of the Curl_socket_ready() return code checks
3169 since at times we are in fact already in this state when this function
3171 *done = (ftpc->state == FTP_STOP) ? TRUE : FALSE;
3176 static CURLcode ftp_block_statemach(struct connectdata *conn)
3178 struct ftp_conn *ftpc = &conn->proto.ftpc;
3179 struct pingpong *pp = &ftpc->pp;
3180 CURLcode result = CURLE_OK;
3182 while(ftpc->state != FTP_STOP) {
3183 result = Curl_pp_statemach(pp, TRUE);
3192 * ftp_connect() should do everything that is to be considered a part of
3193 * the connection phase.
3195 * The variable 'done' points to will be TRUE if the protocol-layer connect
3196 * phase is done when this function returns, or FALSE if not.
3199 static CURLcode ftp_connect(struct connectdata *conn,
3200 bool *done) /* see description above */
3203 struct ftp_conn *ftpc = &conn->proto.ftpc;
3204 struct pingpong *pp = &ftpc->pp;
3206 *done = FALSE; /* default to not done yet */
3208 /* We always support persistent connections on ftp */
3209 connkeep(conn, "FTP default");
3211 pp->response_time = RESP_TIMEOUT; /* set default response time-out */
3212 pp->statemach_act = ftp_statemach_act;
3213 pp->endofresp = ftp_endofresp;
3216 if(conn->handler->flags & PROTOPT_SSL) {
3218 result = Curl_ssl_connect(conn, FIRSTSOCKET);
3223 Curl_pp_init(pp); /* init the generic pingpong data */
3225 /* When we connect, we start in the state where we await the 220
3227 state(conn, FTP_WAIT220);
3229 result = ftp_multi_statemach(conn, done);
3234 /***********************************************************************
3238 * The DONE function. This does what needs to be done after a single DO has
3241 * Input argument is already checked for validity.
3243 static CURLcode ftp_done(struct connectdata *conn, CURLcode status,
3246 struct Curl_easy *data = conn->data;
3247 struct FTP *ftp = data->req.protop;
3248 struct ftp_conn *ftpc = &conn->proto.ftpc;
3249 struct pingpong *pp = &ftpc->pp;
3252 CURLcode result = CURLE_OK;
3254 const char *path_to_use = data->state.path;
3260 case CURLE_BAD_DOWNLOAD_RESUME:
3261 case CURLE_FTP_WEIRD_PASV_REPLY:
3262 case CURLE_FTP_PORT_FAILED:
3263 case CURLE_FTP_ACCEPT_FAILED:
3264 case CURLE_FTP_ACCEPT_TIMEOUT:
3265 case CURLE_FTP_COULDNT_SET_TYPE:
3266 case CURLE_FTP_COULDNT_RETR_FILE:
3267 case CURLE_PARTIAL_FILE:
3268 case CURLE_UPLOAD_FAILED:
3269 case CURLE_REMOTE_ACCESS_DENIED:
3270 case CURLE_FILESIZE_EXCEEDED:
3271 case CURLE_REMOTE_FILE_NOT_FOUND:
3272 case CURLE_WRITE_ERROR:
3273 /* the connection stays alive fine even though this happened */
3275 case CURLE_OK: /* doesn't affect the control connection's status */
3279 /* until we cope better with prematurely ended requests, let them
3280 * fallback as if in complete failure */
3281 default: /* by default, an error means the control connection is
3282 wedged and should not be used anymore */
3283 ftpc->ctl_valid = FALSE;
3284 ftpc->cwdfail = TRUE; /* set this TRUE to prevent us to remember the
3285 current path, as this connection is going */
3286 connclose(conn, "FTP ended with bad error code");
3287 result = status; /* use the already set error code */
3291 /* now store a copy of the directory we are in */
3292 free(ftpc->prevpath);
3294 if(data->set.wildcardmatch) {
3295 if(data->set.chunk_end && ftpc->file) {
3296 data->set.chunk_end(data->wildcard.customptr);
3298 ftpc->known_filesize = -1;
3301 /* get the "raw" path */
3302 path = curl_easy_unescape(data, path_to_use, 0, NULL);
3304 /* out of memory, but we can limp along anyway (and should try to
3305 * since we may already be in the out of memory cleanup path) */
3307 result = CURLE_OUT_OF_MEMORY;
3308 ftpc->ctl_valid = FALSE; /* mark control connection as bad */
3309 connclose(conn, "FTP: out of memory!"); /* mark for connection closure */
3310 ftpc->prevpath = NULL; /* no path remembering */
3313 size_t flen = ftpc->file?strlen(ftpc->file):0; /* file is "raw" already */
3314 size_t dlen = strlen(path)-flen;
3315 if(!ftpc->cwdfail) {
3316 if(dlen && (data->set.ftp_filemethod != FTPFILE_NOCWD)) {
3317 ftpc->prevpath = path;
3319 /* if 'path' is not the whole string */
3320 ftpc->prevpath[dlen]=0; /* terminate */
3323 /* we never changed dir */
3324 ftpc->prevpath=strdup("");
3328 infof(data, "Remembering we are in dir \"%s\"\n", ftpc->prevpath);
3331 ftpc->prevpath = NULL; /* no path */
3335 /* free the dir tree and file parts */
3338 /* shut down the socket to inform the server we're done */
3341 shutdown(conn->sock[SECONDARYSOCKET], 2); /* SD_BOTH */
3344 if(conn->sock[SECONDARYSOCKET] != CURL_SOCKET_BAD) {
3345 if(!result && ftpc->dont_check && data->req.maxdownload > 0) {
3346 /* partial download completed */
3347 result = Curl_pp_sendf(pp, "%s", "ABOR");
3349 failf(data, "Failure sending ABOR command: %s",
3350 curl_easy_strerror(result));
3351 ftpc->ctl_valid = FALSE; /* mark control connection as bad */
3352 connclose(conn, "ABOR command failed"); /* connection closure */
3356 if(conn->ssl[SECONDARYSOCKET].use) {
3357 /* The secondary socket is using SSL so we must close down that part
3358 first before we close the socket for real */
3359 Curl_ssl_close(conn, SECONDARYSOCKET);
3361 /* Note that we keep "use" set to TRUE since that (next) connection is
3362 still requested to use SSL */
3364 close_secondarysocket(conn);
3367 if(!result && (ftp->transfer == FTPTRANSFER_BODY) && ftpc->ctl_valid &&
3368 pp->pending_resp && !premature) {
3370 * Let's see what the server says about the transfer we just performed,
3371 * but lower the timeout as sometimes this connection has died while the
3372 * data has been transferred. This happens when doing through NATs etc that
3373 * abandon old silent connections.
3375 long old_time = pp->response_time;
3377 pp->response_time = 60*1000; /* give it only a minute for now */
3378 pp->response = Curl_tvnow(); /* timeout relative now */
3380 result = Curl_GetFTPResponse(&nread, conn, &ftpcode);
3382 pp->response_time = old_time; /* set this back to previous value */
3384 if(!nread && (CURLE_OPERATION_TIMEDOUT == result)) {
3385 failf(data, "control connection looks dead");
3386 ftpc->ctl_valid = FALSE; /* mark control connection as bad */
3387 connclose(conn, "Timeout or similar in FTP DONE operation"); /* close */
3393 if(ftpc->dont_check && data->req.maxdownload > 0) {
3394 /* we have just sent ABOR and there is no reliable way to check if it was
3395 * successful or not; we have to close the connection now */
3396 infof(data, "partial download completed, closing connection\n");
3397 connclose(conn, "Partial download with no ability to check");
3401 if(!ftpc->dont_check) {
3402 /* 226 Transfer complete, 250 Requested file action okay, completed. */
3403 if((ftpcode != 226) && (ftpcode != 250)) {
3404 failf(data, "server did not report OK, got %d", ftpcode);
3405 result = CURLE_PARTIAL_FILE;
3410 if(result || premature)
3411 /* the response code from the transfer showed an error already so no
3412 use checking further */
3414 else if(data->set.upload) {
3415 if((-1 != data->state.infilesize) &&
3416 (data->state.infilesize != *ftp->bytecountp) &&
3418 (ftp->transfer == FTPTRANSFER_BODY)) {
3419 failf(data, "Uploaded unaligned file size (%" CURL_FORMAT_CURL_OFF_T
3420 " out of %" CURL_FORMAT_CURL_OFF_T " bytes)",
3421 *ftp->bytecountp, data->state.infilesize);
3422 result = CURLE_PARTIAL_FILE;
3426 if((-1 != data->req.size) &&
3427 (data->req.size != *ftp->bytecountp) &&
3428 #ifdef CURL_DO_LINEEND_CONV
3429 /* Most FTP servers don't adjust their file SIZE response for CRLFs, so
3430 * we'll check to see if the discrepancy can be explained by the number
3431 * of CRLFs we've changed to LFs.
3433 ((data->req.size + data->state.crlf_conversions) !=
3434 *ftp->bytecountp) &&
3435 #endif /* CURL_DO_LINEEND_CONV */
3436 (data->req.maxdownload != *ftp->bytecountp)) {
3437 failf(data, "Received only partial file: %" CURL_FORMAT_CURL_OFF_T
3438 " bytes", *ftp->bytecountp);
3439 result = CURLE_PARTIAL_FILE;
3441 else if(!ftpc->dont_check &&
3442 !*ftp->bytecountp &&
3443 (data->req.size>0)) {
3444 failf(data, "No data was received!");
3445 result = CURLE_FTP_COULDNT_RETR_FILE;
3449 /* clear these for next connection */
3450 ftp->transfer = FTPTRANSFER_BODY;
3451 ftpc->dont_check = FALSE;
3453 /* Send any post-transfer QUOTE strings? */
3454 if(!status && !result && !premature && data->set.postquote)
3455 result = ftp_sendquote(conn, data->set.postquote);
3460 /***********************************************************************
3464 * Where a 'quote' means a list of custom commands to send to the server.
3465 * The quote list is passed as an argument.
3471 CURLcode ftp_sendquote(struct connectdata *conn, struct curl_slist *quote)
3473 struct curl_slist *item;
3477 struct ftp_conn *ftpc = &conn->proto.ftpc;
3478 struct pingpong *pp = &ftpc->pp;
3483 char *cmd = item->data;
3484 bool acceptfail = FALSE;
3486 /* if a command starts with an asterisk, which a legal FTP command never
3487 can, the command will be allowed to fail without it causing any
3488 aborts or cancels etc. It will cause libcurl to act as if the command
3489 is successful, whatever the server reponds. */
3496 PPSENDF(&conn->proto.ftpc.pp, "%s", cmd);
3498 pp->response = Curl_tvnow(); /* timeout relative now */
3500 result = Curl_GetFTPResponse(&nread, conn, &ftpcode);
3504 if(!acceptfail && (ftpcode >= 400)) {
3505 failf(conn->data, "QUOT string not accepted: %s", cmd);
3506 return CURLE_QUOTE_ERROR;
3516 /***********************************************************************
3520 * Returns TRUE if we in the current situation should send TYPE
3522 static int ftp_need_type(struct connectdata *conn,
3525 return conn->proto.ftpc.transfertype != (ascii_wanted?'A':'I');
3528 /***********************************************************************
3532 * Set TYPE. We only deal with ASCII or BINARY so this function
3534 * If the transfer type is not sent, simulate on OK response in newstate
3536 static CURLcode ftp_nb_type(struct connectdata *conn,
3537 bool ascii, ftpstate newstate)
3539 struct ftp_conn *ftpc = &conn->proto.ftpc;
3541 char want = (char)(ascii?'A':'I');
3543 if(ftpc->transfertype == want) {
3544 state(conn, newstate);
3545 return ftp_state_type_resp(conn, 200, newstate);
3548 PPSENDF(&ftpc->pp, "TYPE %c", want);
3549 state(conn, newstate);
3551 /* keep track of our current transfer type */
3552 ftpc->transfertype = want;
3556 /***************************************************************************
3558 * ftp_pasv_verbose()
3560 * This function only outputs some informationals about this second connection
3561 * when we've issued a PASV command before and thus we have connected to a
3562 * possibly new IP address.
3565 #ifndef CURL_DISABLE_VERBOSE_STRINGS
3567 ftp_pasv_verbose(struct connectdata *conn,
3569 char *newhost, /* ascii version */
3573 Curl_printable_address(ai, buf, sizeof(buf));
3574 infof(conn->data, "Connecting to %s (%s) port %d\n", newhost, buf, port);
3579 Check if this is a range download, and if so, set the internal variables
3583 static CURLcode ftp_range(struct connectdata *conn)
3585 curl_off_t from, to;
3588 struct Curl_easy *data = conn->data;
3589 struct ftp_conn *ftpc = &conn->proto.ftpc;
3591 if(data->state.use_range && data->state.range) {
3592 from=curlx_strtoofft(data->state.range, &ptr, 0);
3593 while(*ptr && (ISSPACE(*ptr) || (*ptr=='-')))
3595 to=curlx_strtoofft(ptr, &ptr2, 0);
3597 /* we didn't get any digit */
3600 if((-1 == to) && (from>=0)) {
3602 data->state.resume_from = from;
3603 DEBUGF(infof(conn->data, "FTP RANGE %" CURL_FORMAT_CURL_OFF_T
3604 " to end of file\n", from));
3608 data->req.maxdownload = -from;
3609 data->state.resume_from = from;
3610 DEBUGF(infof(conn->data, "FTP RANGE the last %" CURL_FORMAT_CURL_OFF_T
3611 " bytes\n", -from));
3615 data->req.maxdownload = (to-from)+1; /* include last byte */
3616 data->state.resume_from = from;
3617 DEBUGF(infof(conn->data, "FTP RANGE from %" CURL_FORMAT_CURL_OFF_T
3618 " getting %" CURL_FORMAT_CURL_OFF_T " bytes\n",
3619 from, data->req.maxdownload));
3621 DEBUGF(infof(conn->data, "range-download from %" CURL_FORMAT_CURL_OFF_T
3622 " to %" CURL_FORMAT_CURL_OFF_T ", totally %"
3623 CURL_FORMAT_CURL_OFF_T " bytes\n",
3624 from, to, data->req.maxdownload));
3625 ftpc->dont_check = TRUE; /* dont check for successful transfer */
3628 data->req.maxdownload = -1;
3636 * This function shall be called when the second FTP (data) connection is
3639 * 'complete' can return 0 for incomplete, 1 for done and -1 for go back
3640 * (which basically is only for when PASV is being sent to retry a failed
3644 static CURLcode ftp_do_more(struct connectdata *conn, int *completep)
3646 struct Curl_easy *data=conn->data;
3647 struct ftp_conn *ftpc = &conn->proto.ftpc;
3648 CURLcode result = CURLE_OK;
3649 bool connected = FALSE;
3650 bool complete = FALSE;
3652 /* the ftp struct is inited in ftp_connect() */
3653 struct FTP *ftp = data->req.protop;
3655 /* if the second connection isn't done yet, wait for it */
3656 if(!conn->bits.tcpconnect[SECONDARYSOCKET]) {
3657 if(conn->tunnel_state[SECONDARYSOCKET] == TUNNEL_CONNECT) {
3658 /* As we're in TUNNEL_CONNECT state now, we know the proxy name and port
3659 aren't used so we blank their arguments. TODO: make this nicer */
3660 result = Curl_proxyCONNECT(conn, SECONDARYSOCKET, NULL, 0, FALSE);
3665 result = Curl_is_connected(conn, SECONDARYSOCKET, &connected);
3667 /* Ready to do more? */
3669 DEBUGF(infof(data, "DO-MORE connected phase starts\n"));
3670 if(conn->bits.proxy) {
3671 infof(data, "Connection to proxy confirmed\n");
3672 result = proxy_magic(conn, ftpc->newhost, ftpc->newport, &connected);
3676 if(result && (ftpc->count1 == 0)) {
3677 *completep = -1; /* go back to DOING please */
3678 /* this is a EPSV connect failing, try PASV instead */
3679 return ftp_epsv_disable(conn);
3686 /* already in a state so skip the intial commands.
3687 They are only done to kickstart the do_more state */
3688 result = ftp_multi_statemach(conn, &complete);
3690 *completep = (int)complete;
3692 /* if we got an error or if we don't wait for a data connection return
3694 if(result || (ftpc->wait_data_conn != TRUE))
3697 if(ftpc->wait_data_conn)
3698 /* if we reach the end of the FTP state machine here, *complete will be
3699 TRUE but so is ftpc->wait_data_conn, which says we need to wait for
3700 the data connection and therefore we're not actually complete */
3704 if(ftp->transfer <= FTPTRANSFER_INFO) {
3705 /* a transfer is about to take place, or if not a file name was given
3706 so we'll do a SIZE on it later and then we need the right TYPE first */
3708 if(ftpc->wait_data_conn == TRUE) {
3711 result = ReceivedServerConnect(conn, &serv_conned);
3713 return result; /* Failed to accept data connection */
3716 /* It looks data connection is established */
3717 result = AcceptServerConnect(conn);
3718 ftpc->wait_data_conn = FALSE;
3720 result = InitiateTransfer(conn);
3725 *completep = 1; /* this state is now complete when the server has
3726 connected back to us */
3729 else if(data->set.upload) {
3730 result = ftp_nb_type(conn, data->set.prefer_ascii, FTP_STOR_TYPE);
3734 result = ftp_multi_statemach(conn, &complete);
3735 if(ftpc->wait_data_conn)
3736 /* if we reach the end of the FTP state machine here, *complete will be
3737 TRUE but so is ftpc->wait_data_conn, which says we need to wait for
3738 the data connection and therefore we're not actually complete */
3741 *completep = (int)complete;
3745 ftp->downloadsize = -1; /* unknown as of yet */
3747 result = ftp_range(conn);
3750 else if(data->set.ftp_list_only || !ftpc->file) {
3751 /* The specified path ends with a slash, and therefore we think this
3752 is a directory that is requested, use LIST. But before that we
3753 need to set ASCII transfer mode. */
3755 /* But only if a body transfer was requested. */
3756 if(ftp->transfer == FTPTRANSFER_BODY) {
3757 result = ftp_nb_type(conn, TRUE, FTP_LIST_TYPE);
3761 /* otherwise just fall through */
3764 result = ftp_nb_type(conn, data->set.prefer_ascii, FTP_RETR_TYPE);
3769 result = ftp_multi_statemach(conn, &complete);
3770 *completep = (int)complete;
3775 if(!result && (ftp->transfer != FTPTRANSFER_BODY))
3776 /* no data to transfer. FIX: it feels like a kludge to have this here
3778 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
3780 if(!ftpc->wait_data_conn) {
3781 /* no waiting for the data connection so this is now complete */
3783 DEBUGF(infof(data, "DO-MORE phase ends with %d\n", (int)result));
3791 /***********************************************************************
3795 * This is the actual DO function for FTP. Get a file/directory according to
3796 * the options previously setup.
3800 CURLcode ftp_perform(struct connectdata *conn,
3801 bool *connected, /* connect status after PASV / PORT */
3804 /* this is FTP and no proxy */
3805 CURLcode result=CURLE_OK;
3807 DEBUGF(infof(conn->data, "DO phase starts\n"));
3809 if(conn->data->set.opt_no_body) {
3810 /* requested no body means no transfer... */
3811 struct FTP *ftp = conn->data->req.protop;
3812 ftp->transfer = FTPTRANSFER_INFO;
3815 *dophase_done = FALSE; /* not done yet */
3817 /* start the first command in the DO phase */
3818 result = ftp_state_quote(conn, TRUE, FTP_QUOTE);
3822 /* run the state-machine */
3823 result = ftp_multi_statemach(conn, dophase_done);
3825 *connected = conn->bits.tcpconnect[SECONDARYSOCKET];
3827 infof(conn->data, "ftp_perform ends with SECONDARY: %d\n", *connected);
3830 DEBUGF(infof(conn->data, "DO phase is complete1\n"));
3835 static void wc_data_dtor(void *ptr)
3837 struct ftp_wc_tmpdata *tmp = ptr;
3839 Curl_ftp_parselist_data_free(&tmp->parser);
3843 static CURLcode init_wc_data(struct connectdata *conn)
3846 char *path = conn->data->state.path;
3847 struct WildcardData *wildcard = &(conn->data->wildcard);
3848 CURLcode result = CURLE_OK;
3849 struct ftp_wc_tmpdata *ftp_tmp;
3851 last_slash = strrchr(conn->data->state.path, '/');
3854 if(last_slash[0] == '\0') {
3855 wildcard->state = CURLWC_CLEAN;
3856 result = ftp_parse_url_path(conn);
3860 wildcard->pattern = strdup(last_slash);
3861 if(!wildcard->pattern)
3862 return CURLE_OUT_OF_MEMORY;
3863 last_slash[0] = '\0'; /* cut file from path */
3866 else { /* there is only 'wildcard pattern' or nothing */
3868 wildcard->pattern = strdup(path);
3869 if(!wildcard->pattern)
3870 return CURLE_OUT_OF_MEMORY;
3873 else { /* only list */
3874 wildcard->state = CURLWC_CLEAN;
3875 result = ftp_parse_url_path(conn);
3880 /* program continues only if URL is not ending with slash, allocate needed
3881 resources for wildcard transfer */
3883 /* allocate ftp protocol specific temporary wildcard data */
3884 ftp_tmp = calloc(1, sizeof(struct ftp_wc_tmpdata));
3886 Curl_safefree(wildcard->pattern);
3887 return CURLE_OUT_OF_MEMORY;
3890 /* INITIALIZE parselist structure */
3891 ftp_tmp->parser = Curl_ftp_parselist_data_alloc();
3892 if(!ftp_tmp->parser) {
3893 Curl_safefree(wildcard->pattern);
3895 return CURLE_OUT_OF_MEMORY;
3898 wildcard->tmp = ftp_tmp; /* put it to the WildcardData tmp pointer */
3899 wildcard->tmp_dtor = wc_data_dtor;
3901 /* wildcard does not support NOCWD option (assert it?) */
3902 if(conn->data->set.ftp_filemethod == FTPFILE_NOCWD)
3903 conn->data->set.ftp_filemethod = FTPFILE_MULTICWD;
3905 /* try to parse ftp url */
3906 result = ftp_parse_url_path(conn);
3908 Curl_safefree(wildcard->pattern);
3909 wildcard->tmp_dtor(wildcard->tmp);
3910 wildcard->tmp_dtor = ZERO_NULL;
3911 wildcard->tmp = NULL;
3915 wildcard->path = strdup(conn->data->state.path);
3916 if(!wildcard->path) {
3917 Curl_safefree(wildcard->pattern);
3918 wildcard->tmp_dtor(wildcard->tmp);
3919 wildcard->tmp_dtor = ZERO_NULL;
3920 wildcard->tmp = NULL;
3921 return CURLE_OUT_OF_MEMORY;
3924 /* backup old write_function */
3925 ftp_tmp->backup.write_function = conn->data->set.fwrite_func;
3926 /* parsing write function */
3927 conn->data->set.fwrite_func = Curl_ftp_parselist;
3928 /* backup old file descriptor */
3929 ftp_tmp->backup.file_descriptor = conn->data->set.out;
3930 /* let the writefunc callback know what curl pointer is working with */
3931 conn->data->set.out = conn;
3933 infof(conn->data, "Wildcard - Parsing started\n");
3937 /* This is called recursively */
3938 static CURLcode wc_statemach(struct connectdata *conn)
3940 struct WildcardData * const wildcard = &(conn->data->wildcard);
3941 CURLcode result = CURLE_OK;
3943 switch (wildcard->state) {
3945 result = init_wc_data(conn);
3946 if(wildcard->state == CURLWC_CLEAN)
3950 wildcard->state = result ? CURLWC_ERROR : CURLWC_MATCHING;
3953 case CURLWC_MATCHING: {
3954 /* In this state is LIST response successfully parsed, so lets restore
3955 previous WRITEFUNCTION callback and WRITEDATA pointer */
3956 struct ftp_wc_tmpdata *ftp_tmp = wildcard->tmp;
3957 conn->data->set.fwrite_func = ftp_tmp->backup.write_function;
3958 conn->data->set.out = ftp_tmp->backup.file_descriptor;
3959 ftp_tmp->backup.write_function = ZERO_NULL;
3960 ftp_tmp->backup.file_descriptor = NULL;
3961 wildcard->state = CURLWC_DOWNLOADING;
3963 if(Curl_ftp_parselist_geterror(ftp_tmp->parser)) {
3964 /* error found in LIST parsing */
3965 wildcard->state = CURLWC_CLEAN;
3966 return wc_statemach(conn);
3968 else if(wildcard->filelist->size == 0) {
3969 /* no corresponding file */
3970 wildcard->state = CURLWC_CLEAN;
3971 return CURLE_REMOTE_FILE_NOT_FOUND;
3973 return wc_statemach(conn);
3976 case CURLWC_DOWNLOADING: {
3977 /* filelist has at least one file, lets get first one */
3978 struct ftp_conn *ftpc = &conn->proto.ftpc;
3979 struct curl_fileinfo *finfo = wildcard->filelist->head->ptr;
3981 char *tmp_path = aprintf("%s%s", wildcard->path, finfo->filename);
3983 return CURLE_OUT_OF_MEMORY;
3985 /* switch default "state.pathbuffer" and tmp_path, good to see
3986 ftp_parse_url_path function to understand this trick */
3987 Curl_safefree(conn->data->state.pathbuffer);
3988 conn->data->state.pathbuffer = tmp_path;
3989 conn->data->state.path = tmp_path;
3991 infof(conn->data, "Wildcard - START of \"%s\"\n", finfo->filename);
3992 if(conn->data->set.chunk_bgn) {
3993 long userresponse = conn->data->set.chunk_bgn(
3994 finfo, wildcard->customptr, (int)wildcard->filelist->size);
3995 switch(userresponse) {
3996 case CURL_CHUNK_BGN_FUNC_SKIP:
3997 infof(conn->data, "Wildcard - \"%s\" skipped by user\n",
3999 wildcard->state = CURLWC_SKIP;
4000 return wc_statemach(conn);
4001 case CURL_CHUNK_BGN_FUNC_FAIL:
4002 return CURLE_CHUNK_FAILED;
4006 if(finfo->filetype != CURLFILETYPE_FILE) {
4007 wildcard->state = CURLWC_SKIP;
4008 return wc_statemach(conn);
4011 if(finfo->flags & CURLFINFOFLAG_KNOWN_SIZE)
4012 ftpc->known_filesize = finfo->size;
4014 result = ftp_parse_url_path(conn);
4018 /* we don't need the Curl_fileinfo of first file anymore */
4019 Curl_llist_remove(wildcard->filelist, wildcard->filelist->head, NULL);
4021 if(wildcard->filelist->size == 0) { /* remains only one file to down. */
4022 wildcard->state = CURLWC_CLEAN;
4023 /* after that will be ftp_do called once again and no transfer
4024 will be done because of CURLWC_CLEAN state */
4030 if(conn->data->set.chunk_end)
4031 conn->data->set.chunk_end(conn->data->wildcard.customptr);
4032 Curl_llist_remove(wildcard->filelist, wildcard->filelist->head, NULL);
4033 wildcard->state = (wildcard->filelist->size == 0) ?
4034 CURLWC_CLEAN : CURLWC_DOWNLOADING;
4035 return wc_statemach(conn);
4038 case CURLWC_CLEAN: {
4039 struct ftp_wc_tmpdata *ftp_tmp = wildcard->tmp;
4042 result = Curl_ftp_parselist_geterror(ftp_tmp->parser);
4044 wildcard->state = result ? CURLWC_ERROR : CURLWC_DONE;
4055 /***********************************************************************
4059 * This function is registered as 'curl_do' function. It decodes the path
4060 * parts etc as a wrapper to the actual DO function (ftp_perform).
4062 * The input argument is already checked for validity.
4064 static CURLcode ftp_do(struct connectdata *conn, bool *done)
4066 CURLcode result = CURLE_OK;
4067 struct ftp_conn *ftpc = &conn->proto.ftpc;
4069 *done = FALSE; /* default to false */
4070 ftpc->wait_data_conn = FALSE; /* default to no such wait */
4072 if(conn->data->set.wildcardmatch) {
4073 result = wc_statemach(conn);
4074 if(conn->data->wildcard.state == CURLWC_SKIP ||
4075 conn->data->wildcard.state == CURLWC_DONE) {
4076 /* do not call ftp_regular_transfer */
4079 if(result) /* error, loop or skipping the file */
4082 else { /* no wildcard FSM needed */
4083 result = ftp_parse_url_path(conn);
4088 result = ftp_regular_transfer(conn, done);
4094 CURLcode Curl_ftpsendf(struct connectdata *conn,
4095 const char *fmt, ...)
4097 ssize_t bytes_written;
4098 #define SBUF_SIZE 1024
4102 CURLcode result = CURLE_OK;
4104 enum protection_level data_sec = conn->data_prot;
4109 write_len = vsnprintf(s, SBUF_SIZE-3, fmt, ap);
4112 strcpy(&s[write_len], "\r\n"); /* append a trailing CRLF */
4117 result = Curl_convert_to_network(conn->data, s, write_len);
4118 /* Curl_convert_to_network calls failf if unsuccessful */
4124 conn->data_prot = PROT_CMD;
4126 result = Curl_write(conn, conn->sock[FIRSTSOCKET], sptr, write_len,
4129 DEBUGASSERT(data_sec > PROT_NONE && data_sec < PROT_LAST);
4130 conn->data_prot = data_sec;
4136 if(conn->data->set.verbose)
4137 Curl_debug(conn->data, CURLINFO_HEADER_OUT,
4138 sptr, (size_t)bytes_written, conn);
4140 if(bytes_written != (ssize_t)write_len) {
4141 write_len -= bytes_written;
4142 sptr += bytes_written;
4151 /***********************************************************************
4155 * This should be called before calling sclose() on an ftp control connection
4156 * (not data connections). We should then wait for the response from the
4157 * server before returning. The calling code should then try to close the
4161 static CURLcode ftp_quit(struct connectdata *conn)
4163 CURLcode result = CURLE_OK;
4165 if(conn->proto.ftpc.ctl_valid) {
4166 result = Curl_pp_sendf(&conn->proto.ftpc.pp, "%s", "QUIT");
4168 failf(conn->data, "Failure sending QUIT command: %s",
4169 curl_easy_strerror(result));
4170 conn->proto.ftpc.ctl_valid = FALSE; /* mark control connection as bad */
4171 connclose(conn, "QUIT command failed"); /* mark for connection closure */
4172 state(conn, FTP_STOP);
4176 state(conn, FTP_QUIT);
4178 result = ftp_block_statemach(conn);
4184 /***********************************************************************
4188 * Disconnect from an FTP server. Cleanup protocol-specific per-connection
4189 * resources. BLOCKING.
4191 static CURLcode ftp_disconnect(struct connectdata *conn, bool dead_connection)
4193 struct ftp_conn *ftpc= &conn->proto.ftpc;
4194 struct pingpong *pp = &ftpc->pp;
4196 /* We cannot send quit unconditionally. If this connection is stale or
4197 bad in any way, sending quit and waiting around here will make the
4198 disconnect wait in vain and cause more problems than we need to.
4200 ftp_quit() will check the state of ftp->ctl_valid. If it's ok it
4201 will try to send the QUIT command, otherwise it will just return.
4204 ftpc->ctl_valid = FALSE;
4206 /* The FTP session may or may not have been allocated/setup at this point! */
4207 (void)ftp_quit(conn); /* ignore errors on the QUIT */
4209 if(ftpc->entrypath) {
4210 struct Curl_easy *data = conn->data;
4211 if(data->state.most_recent_ftp_entrypath == ftpc->entrypath) {
4212 data->state.most_recent_ftp_entrypath = NULL;
4214 free(ftpc->entrypath);
4215 ftpc->entrypath = NULL;
4219 free(ftpc->prevpath);
4220 ftpc->prevpath = NULL;
4221 free(ftpc->server_os);
4222 ftpc->server_os = NULL;
4224 Curl_pp_disconnect(pp);
4233 /***********************************************************************
4235 * ftp_parse_url_path()
4237 * Parse the URL path into separate path components.
4241 CURLcode ftp_parse_url_path(struct connectdata *conn)
4243 struct Curl_easy *data = conn->data;
4244 /* the ftp struct is already inited in ftp_connect() */
4245 struct FTP *ftp = data->req.protop;
4246 struct ftp_conn *ftpc = &conn->proto.ftpc;
4247 const char *slash_pos; /* position of the first '/' char in curpos */
4248 const char *path_to_use = data->state.path;
4249 const char *cur_pos;
4250 const char *filename = NULL;
4252 cur_pos = path_to_use; /* current position in path. point at the begin
4253 of next path component */
4255 ftpc->ctl_valid = FALSE;
4256 ftpc->cwdfail = FALSE;
4258 switch(data->set.ftp_filemethod) {
4260 /* fastest, but less standard-compliant */
4263 The best time to check whether the path is a file or directory is right
4266 the first condition in the if() right here, is there just in case
4267 someone decides to set path to NULL one day
4269 if(path_to_use[0] &&
4270 (path_to_use[strlen(path_to_use) - 1] != '/') )
4271 filename = path_to_use; /* this is a full file path */
4274 ftpc->file is not used anywhere other than for operations on a file.
4275 In other words, never for directory operations.
4276 So we can safely leave filename as NULL here and use it as a
4277 argument in dir/file decisions.
4282 case FTPFILE_SINGLECWD:
4283 /* get the last slash */
4284 if(!path_to_use[0]) {
4285 /* no dir, no file */
4289 slash_pos=strrchr(cur_pos, '/');
4290 if(slash_pos || !*cur_pos) {
4291 size_t dirlen = slash_pos-cur_pos;
4293 ftpc->dirs = calloc(1, sizeof(ftpc->dirs[0]));
4295 return CURLE_OUT_OF_MEMORY;
4300 ftpc->dirs[0] = curl_easy_unescape(conn->data, slash_pos ? cur_pos : "/",
4301 slash_pos ? curlx_uztosi(dirlen) : 1,
4303 if(!ftpc->dirs[0]) {
4305 return CURLE_OUT_OF_MEMORY;
4307 ftpc->dirdepth = 1; /* we consider it to be a single dir */
4308 filename = slash_pos ? slash_pos+1 : cur_pos; /* rest is file name */
4311 filename = cur_pos; /* this is a file name only */
4314 default: /* allow pretty much anything */
4315 case FTPFILE_MULTICWD:
4317 ftpc->diralloc = 5; /* default dir depth to allocate */
4318 ftpc->dirs = calloc(ftpc->diralloc, sizeof(ftpc->dirs[0]));
4320 return CURLE_OUT_OF_MEMORY;
4322 /* we have a special case for listing the root dir only */
4323 if(strequal(path_to_use, "/")) {
4324 cur_pos++; /* make it point to the zero byte */
4325 ftpc->dirs[0] = strdup("/");
4329 /* parse the URL path into separate path components */
4330 while((slash_pos = strchr(cur_pos, '/')) != NULL) {
4331 /* 1 or 0 pointer offset to indicate absolute directory */
4332 ssize_t absolute_dir = ((cur_pos - data->state.path > 0) &&
4333 (ftpc->dirdepth == 0))?1:0;
4335 /* seek out the next path component */
4336 if(slash_pos-cur_pos) {
4337 /* we skip empty path components, like "x//y" since the FTP command
4338 CWD requires a parameter and a non-existent parameter a) doesn't
4339 work on many servers and b) has no effect on the others. */
4340 int len = curlx_sztosi(slash_pos - cur_pos + absolute_dir);
4341 ftpc->dirs[ftpc->dirdepth] =
4342 curl_easy_unescape(conn->data, cur_pos - absolute_dir, len, NULL);
4343 if(!ftpc->dirs[ftpc->dirdepth]) { /* run out of memory ... */
4344 failf(data, "no memory");
4346 return CURLE_OUT_OF_MEMORY;
4348 if(isBadFtpString(ftpc->dirs[ftpc->dirdepth])) {
4349 free(ftpc->dirs[ftpc->dirdepth]);
4351 return CURLE_URL_MALFORMAT;
4355 cur_pos = slash_pos + 1; /* jump to the rest of the string */
4356 if(!ftpc->dirdepth) {
4357 /* path starts with a slash, add that as a directory */
4358 ftpc->dirs[ftpc->dirdepth] = strdup("/");
4359 if(!ftpc->dirs[ftpc->dirdepth++]) { /* run out of memory ... */
4360 failf(data, "no memory");
4362 return CURLE_OUT_OF_MEMORY;
4368 cur_pos = slash_pos + 1; /* jump to the rest of the string */
4369 if(++ftpc->dirdepth >= ftpc->diralloc) {
4372 ftpc->diralloc *= 2; /* double the size each time */
4373 bigger = realloc(ftpc->dirs, ftpc->diralloc * sizeof(ftpc->dirs[0]));
4376 return CURLE_OUT_OF_MEMORY;
4378 ftpc->dirs = bigger;
4382 filename = cur_pos; /* the rest is the file name */
4386 if(filename && *filename) {
4387 ftpc->file = curl_easy_unescape(conn->data, filename, 0, NULL);
4388 if(NULL == ftpc->file) {
4390 failf(data, "no memory");
4391 return CURLE_OUT_OF_MEMORY;
4393 if(isBadFtpString(ftpc->file)) {
4395 return CURLE_URL_MALFORMAT;
4399 ftpc->file=NULL; /* instead of point to a zero byte, we make it a NULL
4402 if(data->set.upload && !ftpc->file && (ftp->transfer == FTPTRANSFER_BODY)) {
4403 /* We need a file name when uploading. Return error! */
4404 failf(data, "Uploading to a URL without a file name!");
4405 return CURLE_URL_MALFORMAT;
4408 ftpc->cwddone = FALSE; /* default to not done */
4410 if(ftpc->prevpath) {
4411 /* prevpath is "raw" so we convert the input path before we compare the
4414 char *path = curl_easy_unescape(conn->data, data->state.path, 0, &dlen);
4417 return CURLE_OUT_OF_MEMORY;
4420 dlen -= ftpc->file?curlx_uztosi(strlen(ftpc->file)):0;
4421 if((dlen == curlx_uztosi(strlen(ftpc->prevpath))) &&
4422 strnequal(path, ftpc->prevpath, dlen)) {
4423 infof(data, "Request has same path as previous transfer\n");
4424 ftpc->cwddone = TRUE;
4432 /* call this when the DO phase has completed */
4433 static CURLcode ftp_dophase_done(struct connectdata *conn,
4436 struct FTP *ftp = conn->data->req.protop;
4437 struct ftp_conn *ftpc = &conn->proto.ftpc;
4441 CURLcode result = ftp_do_more(conn, &completed);
4444 close_secondarysocket(conn);
4449 if(ftp->transfer != FTPTRANSFER_BODY)
4450 /* no data to transfer */
4451 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
4453 /* since we didn't connect now, we want do_more to get called */
4454 conn->bits.do_more = TRUE;
4456 ftpc->ctl_valid = TRUE; /* seems good */
4461 /* called from multi.c while DOing */
4462 static CURLcode ftp_doing(struct connectdata *conn,
4465 CURLcode result = ftp_multi_statemach(conn, dophase_done);
4468 DEBUGF(infof(conn->data, "DO phase failed\n"));
4469 else if(*dophase_done) {
4470 result = ftp_dophase_done(conn, FALSE /* not connected */);
4472 DEBUGF(infof(conn->data, "DO phase is complete2\n"));
4477 /***********************************************************************
4479 * ftp_regular_transfer()
4481 * The input argument is already checked for validity.
4483 * Performs all commands done before a regular transfer between a local and a
4486 * ftp->ctl_valid starts out as FALSE, and gets set to TRUE if we reach the
4487 * ftp_done() function without finding any major problem.
4490 CURLcode ftp_regular_transfer(struct connectdata *conn,
4493 CURLcode result=CURLE_OK;
4494 bool connected=FALSE;
4495 struct Curl_easy *data = conn->data;
4496 struct ftp_conn *ftpc = &conn->proto.ftpc;
4497 data->req.size = -1; /* make sure this is unknown at this point */
4499 Curl_pgrsSetUploadCounter(data, 0);
4500 Curl_pgrsSetDownloadCounter(data, 0);
4501 Curl_pgrsSetUploadSize(data, -1);
4502 Curl_pgrsSetDownloadSize(data, -1);
4504 ftpc->ctl_valid = TRUE; /* starts good */
4506 result = ftp_perform(conn,
4507 &connected, /* have we connected after PASV/PORT */
4508 dophase_done); /* all commands in the DO-phase done? */
4513 /* the DO phase has not completed yet */
4516 result = ftp_dophase_done(conn, connected);
4527 static CURLcode ftp_setup_connection(struct connectdata *conn)
4529 struct Curl_easy *data = conn->data;
4534 if(conn->bits.httpproxy && !data->set.tunnel_thru_httpproxy) {
4535 /* Unless we have asked to tunnel ftp operations through the proxy, we
4536 switch and use HTTP operations only */
4537 #ifndef CURL_DISABLE_HTTP
4538 if(conn->handler == &Curl_handler_ftp)
4539 conn->handler = &Curl_handler_ftp_proxy;
4542 conn->handler = &Curl_handler_ftps_proxy;
4544 failf(data, "FTPS not supported!");
4545 return CURLE_UNSUPPORTED_PROTOCOL;
4548 /* set it up as a HTTP connection instead */
4549 return conn->handler->setup_connection(conn);
4551 failf(data, "FTP over http proxy requires HTTP support built-in!");
4552 return CURLE_UNSUPPORTED_PROTOCOL;
4556 conn->data->req.protop = ftp = malloc(sizeof(struct FTP));
4558 return CURLE_OUT_OF_MEMORY;
4560 data->state.path++; /* don't include the initial slash */
4561 data->state.slash_removed = TRUE; /* we've skipped the slash */
4563 /* FTP URLs support an extension like ";type=<typecode>" that
4564 * we'll try to get now! */
4565 type = strstr(data->state.path, ";type=");
4568 type = strstr(conn->host.rawalloc, ";type=");
4571 *type = 0; /* it was in the middle of the hostname */
4572 command = Curl_raw_toupper(type[6]);
4573 conn->bits.type_set = TRUE;
4576 case 'A': /* ASCII mode */
4577 data->set.prefer_ascii = TRUE;
4580 case 'D': /* directory mode */
4581 data->set.ftp_list_only = TRUE;
4584 case 'I': /* binary mode */
4586 /* switch off ASCII */
4587 data->set.prefer_ascii = FALSE;
4592 /* get some initial data into the ftp struct */
4593 ftp->bytecountp = &conn->data->req.bytecount;
4594 ftp->transfer = FTPTRANSFER_BODY;
4595 ftp->downloadsize = 0;
4597 /* No need to duplicate user+password, the connectdata struct won't change
4598 during a session, but we re-init them here since on subsequent inits
4599 since the conn struct may have changed or been replaced.
4601 ftp->user = conn->user;
4602 ftp->passwd = conn->passwd;
4603 if(isBadFtpString(ftp->user))
4604 return CURLE_URL_MALFORMAT;
4605 if(isBadFtpString(ftp->passwd))
4606 return CURLE_URL_MALFORMAT;
4608 conn->proto.ftpc.known_filesize = -1; /* unknown size for now */
4613 #endif /* CURL_DISABLE_FTP */