1 /***************************************************************************
3 * Project ___| | | | _ \| |
5 * | (__| |_| | _ <| |___
6 * \___|\___/|_| \_\_____|
8 * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
10 * This software is licensed as described in the file COPYING, which
11 * you should have received as part of this distribution. The terms
12 * are also available at http://curl.haxx.se/docs/copyright.html.
14 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 * copies of the Software, and permit persons to whom the Software is
16 * furnished to do so, under the terms of the COPYING file.
18 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 * KIND, either express or implied.
21 ***************************************************************************/
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"
81 #define _MPRINTF_REPLACE /* use our functions only */
82 #include <curl/mprintf.h>
84 #include "curl_memory.h"
85 /* The last #include file should be: */
89 #define NI_MAXHOST 1025
91 #ifndef INET_ADDRSTRLEN
92 #define INET_ADDRSTRLEN 16
95 #ifdef CURL_DISABLE_VERBOSE_STRINGS
96 #define ftp_pasv_verbose(a,b,c,d) Curl_nop_stmt
99 /* Local API functions */
101 static void _state(struct connectdata *conn,
103 #define state(x,y) _state(x,y)
105 static void _state(struct connectdata *conn,
108 #define state(x,y) _state(x,y,__LINE__)
111 static CURLcode ftp_sendquote(struct connectdata *conn,
112 struct curl_slist *quote);
113 static CURLcode ftp_quit(struct connectdata *conn);
114 static CURLcode ftp_parse_url_path(struct connectdata *conn);
115 static CURLcode ftp_regular_transfer(struct connectdata *conn, bool *done);
116 #ifndef CURL_DISABLE_VERBOSE_STRINGS
117 static void ftp_pasv_verbose(struct connectdata *conn,
119 char *newhost, /* ascii version */
122 static CURLcode ftp_state_prepare_transfer(struct connectdata *conn);
123 static CURLcode ftp_state_mdtm(struct connectdata *conn);
124 static CURLcode ftp_state_quote(struct connectdata *conn,
125 bool init, ftpstate instate);
126 static CURLcode ftp_nb_type(struct connectdata *conn,
127 bool ascii, ftpstate newstate);
128 static int ftp_need_type(struct connectdata *conn,
130 static CURLcode ftp_do(struct connectdata *conn, bool *done);
131 static CURLcode ftp_done(struct connectdata *conn,
132 CURLcode, bool premature);
133 static CURLcode ftp_connect(struct connectdata *conn, bool *done);
134 static CURLcode ftp_disconnect(struct connectdata *conn, bool dead_connection);
135 static CURLcode ftp_do_more(struct connectdata *conn, int *completed);
136 static CURLcode ftp_multi_statemach(struct connectdata *conn, bool *done);
137 static int ftp_getsock(struct connectdata *conn, curl_socket_t *socks,
139 static int ftp_domore_getsock(struct connectdata *conn, curl_socket_t *socks,
141 static CURLcode ftp_doing(struct connectdata *conn,
143 static CURLcode ftp_setup_connection(struct connectdata * conn);
145 static CURLcode init_wc_data(struct connectdata *conn);
146 static CURLcode wc_statemach(struct connectdata *conn);
148 static void wc_data_dtor(void *ptr);
150 static CURLcode ftp_state_retr(struct connectdata *conn, curl_off_t filesize);
152 static CURLcode ftp_readresp(curl_socket_t sockfd,
156 static CURLcode ftp_dophase_done(struct connectdata *conn,
159 /* easy-to-use macro: */
160 #define PPSENDF(x,y,z) if((result = Curl_pp_sendf(x,y,z)) != CURLE_OK) \
165 * FTP protocol handler.
168 const struct Curl_handler Curl_handler_ftp = {
170 ftp_setup_connection, /* setup_connection */
173 ftp_do_more, /* do_more */
174 ftp_connect, /* connect_it */
175 ftp_multi_statemach, /* connecting */
176 ftp_doing, /* doing */
177 ftp_getsock, /* proto_getsock */
178 ftp_getsock, /* doing_getsock */
179 ftp_domore_getsock, /* domore_getsock */
180 ZERO_NULL, /* perform_getsock */
181 ftp_disconnect, /* disconnect */
182 ZERO_NULL, /* readwrite */
183 PORT_FTP, /* defport */
184 CURLPROTO_FTP, /* protocol */
185 PROTOPT_DUAL | PROTOPT_CLOSEACTION | PROTOPT_NEEDSPWD
186 | PROTOPT_NOURLQUERY /* flags */
192 * FTPS protocol handler.
195 const struct Curl_handler Curl_handler_ftps = {
197 ftp_setup_connection, /* setup_connection */
200 ftp_do_more, /* do_more */
201 ftp_connect, /* connect_it */
202 ftp_multi_statemach, /* connecting */
203 ftp_doing, /* doing */
204 ftp_getsock, /* proto_getsock */
205 ftp_getsock, /* doing_getsock */
206 ftp_domore_getsock, /* domore_getsock */
207 ZERO_NULL, /* perform_getsock */
208 ftp_disconnect, /* disconnect */
209 ZERO_NULL, /* readwrite */
210 PORT_FTPS, /* defport */
211 CURLPROTO_FTPS, /* protocol */
212 PROTOPT_SSL | PROTOPT_DUAL | PROTOPT_CLOSEACTION |
213 PROTOPT_NEEDSPWD | PROTOPT_NOURLQUERY /* flags */
217 #ifndef CURL_DISABLE_HTTP
219 * HTTP-proxyed FTP protocol handler.
222 static const struct Curl_handler Curl_handler_ftp_proxy = {
224 Curl_http_setup_conn, /* setup_connection */
225 Curl_http, /* do_it */
226 Curl_http_done, /* done */
227 ZERO_NULL, /* do_more */
228 ZERO_NULL, /* connect_it */
229 ZERO_NULL, /* connecting */
230 ZERO_NULL, /* doing */
231 ZERO_NULL, /* proto_getsock */
232 ZERO_NULL, /* doing_getsock */
233 ZERO_NULL, /* domore_getsock */
234 ZERO_NULL, /* perform_getsock */
235 ZERO_NULL, /* disconnect */
236 ZERO_NULL, /* readwrite */
237 PORT_FTP, /* defport */
238 CURLPROTO_HTTP, /* protocol */
239 PROTOPT_NONE /* flags */
245 * HTTP-proxyed FTPS protocol handler.
248 static const struct Curl_handler Curl_handler_ftps_proxy = {
250 Curl_http_setup_conn, /* setup_connection */
251 Curl_http, /* do_it */
252 Curl_http_done, /* done */
253 ZERO_NULL, /* do_more */
254 ZERO_NULL, /* connect_it */
255 ZERO_NULL, /* connecting */
256 ZERO_NULL, /* doing */
257 ZERO_NULL, /* proto_getsock */
258 ZERO_NULL, /* doing_getsock */
259 ZERO_NULL, /* domore_getsock */
260 ZERO_NULL, /* perform_getsock */
261 ZERO_NULL, /* disconnect */
262 ZERO_NULL, /* readwrite */
263 PORT_FTPS, /* defport */
264 CURLPROTO_HTTP, /* protocol */
265 PROTOPT_NONE /* flags */
272 * NOTE: back in the old days, we added code in the FTP code that made NOBODY
273 * requests on files respond with headers passed to the client/stdout that
274 * looked like HTTP ones.
276 * This approach is not very elegant, it causes confusion and is error-prone.
277 * It is subject for removal at the next (or at least a future) soname bump.
278 * Until then you can test the effects of the removal by undefining the
279 * following define named CURL_FTP_HTTPSTYLE_HEAD.
281 #define CURL_FTP_HTTPSTYLE_HEAD 1
283 static void freedirs(struct ftp_conn *ftpc)
287 for(i=0; i < ftpc->dirdepth; i++) {
303 /* Returns non-zero if the given string contains CR (\r) or LF (\n),
304 which are not allowed within RFC 959 <string>.
305 Note: The input string is in the client's encoding which might
306 not be ASCII, so escape sequences \r & \n must be used instead
307 of hex values 0x0d & 0x0a.
309 static bool isBadFtpString(const char *string)
311 return ((NULL != strchr(string, '\r')) ||
312 (NULL != strchr(string, '\n'))) ? TRUE : FALSE;
315 /***********************************************************************
317 * AcceptServerConnect()
319 * After connection request is received from the server this function is
320 * called to accept the connection and close the listening socket
323 static CURLcode AcceptServerConnect(struct connectdata *conn)
325 struct SessionHandle *data = conn->data;
326 curl_socket_t sock = conn->sock[SECONDARYSOCKET];
327 curl_socket_t s = CURL_SOCKET_BAD;
329 struct Curl_sockaddr_storage add;
331 struct sockaddr_in add;
333 curl_socklen_t size = (curl_socklen_t) sizeof(add);
335 if(0 == getsockname(sock, (struct sockaddr *) &add, &size)) {
338 s=accept(sock, (struct sockaddr *) &add, &size);
340 Curl_closesocket(conn, sock); /* close the first socket */
342 if(CURL_SOCKET_BAD == s) {
343 failf(data, "Error accept()ing server connect");
344 return CURLE_FTP_PORT_FAILED;
346 infof(data, "Connection accepted from server\n");
348 conn->sock[SECONDARYSOCKET] = s;
349 curlx_nonblock(s, TRUE); /* enable non-blocking */
350 conn->sock_accepted[SECONDARYSOCKET] = TRUE;
352 if(data->set.fsockopt) {
355 /* activate callback for setting socket options */
356 error = data->set.fsockopt(data->set.sockopt_client,
358 CURLSOCKTYPE_ACCEPT);
361 Curl_closesocket(conn, s); /* close the socket and bail out */
362 conn->sock[SECONDARYSOCKET] = CURL_SOCKET_BAD;
363 return CURLE_ABORTED_BY_CALLBACK;
372 * ftp_timeleft_accept() returns the amount of milliseconds left allowed for
373 * waiting server to connect. If the value is negative, the timeout time has
376 * The start time is stored in progress.t_acceptdata - as set with
377 * Curl_pgrsTime(..., TIMER_STARTACCEPT);
380 static long ftp_timeleft_accept(struct SessionHandle *data)
382 long timeout_ms = DEFAULT_ACCEPT_TIMEOUT;
386 if(data->set.accepttimeout > 0)
387 timeout_ms = data->set.accepttimeout;
391 /* check if the generic timeout possibly is set shorter */
392 other = Curl_timeleft(data, &now, FALSE);
393 if(other && (other < timeout_ms))
394 /* note that this also works fine for when other happens to be negative
395 due to it already having elapsed */
398 /* subtract elapsed time */
399 timeout_ms -= Curl_tvdiff(now, data->progress.t_acceptdata);
401 /* avoid returning 0 as that means no timeout! */
409 /***********************************************************************
411 * ReceivedServerConnect()
413 * After allowing server to connect to us from data port, this function
414 * checks both data connection for connection establishment and ctrl
415 * connection for a negative response regarding a failure in connecting
418 static CURLcode ReceivedServerConnect(struct connectdata *conn, bool *received)
420 struct SessionHandle *data = conn->data;
421 curl_socket_t ctrl_sock = conn->sock[FIRSTSOCKET];
422 curl_socket_t data_sock = conn->sock[SECONDARYSOCKET];
423 struct ftp_conn *ftpc = &conn->proto.ftpc;
424 struct pingpong *pp = &ftpc->pp;
432 timeout_ms = ftp_timeleft_accept(data);
433 infof(data, "Checking for server connect\n");
435 /* if a timeout was already reached, bail out */
436 failf(data, "Accept timeout occurred while waiting server connect");
437 return CURLE_FTP_ACCEPT_TIMEOUT;
440 /* First check whether there is a cached response from server */
441 if(pp->cache_size && pp->cache && pp->cache[0] > '3') {
442 /* Data connection could not be established, let's return */
443 infof(data, "There is negative response in cache while serv connect\n");
444 Curl_GetFTPResponse(&nread, conn, &ftpcode);
445 return CURLE_FTP_ACCEPT_FAILED;
448 result = Curl_socket_check(ctrl_sock, data_sock, CURL_SOCKET_BAD, 0);
450 /* see if the connection request is already here */
454 failf(data, "Error while waiting for server connect");
455 return CURLE_FTP_ACCEPT_FAILED;
456 case 0: /* Server connect is not received yet */
460 if(result & CURL_CSELECT_IN2) {
461 infof(data, "Ready to accept data connection from server\n");
464 else if(result & CURL_CSELECT_IN) {
465 infof(data, "Ctrl conn has data while waiting for data conn\n");
466 Curl_GetFTPResponse(&nread, conn, &ftpcode);
469 return CURLE_FTP_ACCEPT_FAILED;
471 return CURLE_FTP_WEIRD_SERVER_REPLY;
481 /***********************************************************************
485 * After connection from server is accepted this function is called to
486 * setup transfer parameters and initiate the data transfer.
489 static CURLcode InitiateTransfer(struct connectdata *conn)
491 struct SessionHandle *data = conn->data;
492 struct FTP *ftp = data->req.protop;
493 CURLcode result = CURLE_OK;
495 if(conn->ssl[SECONDARYSOCKET].use) {
496 /* since we only have a plaintext TCP connection here, we must now
497 * do the TLS stuff */
498 infof(data, "Doing the SSL/TLS handshake on the data stream\n");
499 result = Curl_ssl_connect(conn, SECONDARYSOCKET);
504 if(conn->proto.ftpc.state_saved == FTP_STOR) {
505 *(ftp->bytecountp)=0;
507 /* When we know we're uploading a specified file, we can get the file
508 size prior to the actual upload. */
510 Curl_pgrsSetUploadSize(data, data->state.infilesize);
512 /* set the SO_SNDBUF for the secondary socket for those who need it */
513 Curl_sndbufset(conn->sock[SECONDARYSOCKET]);
515 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, /* no download */
516 SECONDARYSOCKET, ftp->bytecountp);
520 Curl_setup_transfer(conn, SECONDARYSOCKET,
521 conn->proto.ftpc.retr_size_saved, FALSE,
522 ftp->bytecountp, -1, NULL); /* no upload here */
525 conn->proto.ftpc.pp.pending_resp = TRUE; /* expect server response */
526 state(conn, FTP_STOP);
531 /***********************************************************************
533 * AllowServerConnect()
535 * When we've issue the PORT command, we have told the server to connect to
536 * us. This function checks whether data connection is established if so it is
540 static CURLcode AllowServerConnect(struct connectdata *conn, bool *connected)
542 struct SessionHandle *data = conn->data;
544 CURLcode ret = CURLE_OK;
547 infof(data, "Preparing for accepting server on data port\n");
549 /* Save the time we start accepting server connect */
550 Curl_pgrsTime(data, TIMER_STARTACCEPT);
552 timeout_ms = ftp_timeleft_accept(data);
554 /* if a timeout was already reached, bail out */
555 failf(data, "Accept timeout occurred while waiting server connect");
556 return CURLE_FTP_ACCEPT_TIMEOUT;
559 /* see if the connection request is already here */
560 ret = ReceivedServerConnect(conn, connected);
565 ret = AcceptServerConnect(conn);
569 ret = InitiateTransfer(conn);
574 /* Add timeout to multi handle and break out of the loop */
575 if(ret == CURLE_OK && *connected == FALSE) {
576 if(data->set.accepttimeout > 0)
577 Curl_expire(data, data->set.accepttimeout);
579 Curl_expire(data, DEFAULT_ACCEPT_TIMEOUT);
586 /* macro to check for a three-digit ftp status code at the start of the
588 #define STATUSCODE(line) (ISDIGIT(line[0]) && ISDIGIT(line[1]) && \
591 /* macro to check for the last line in an FTP server response */
592 #define LASTLINE(line) (STATUSCODE(line) && (' ' == line[3]))
594 static bool ftp_endofresp(struct connectdata *conn, char *line, size_t len,
599 if((len > 3) && LASTLINE(line)) {
600 *code = curlx_sltosi(strtol(line, NULL, 10));
607 static CURLcode ftp_readresp(curl_socket_t sockfd,
609 int *ftpcode, /* return the ftp-code if done */
610 size_t *size) /* size of the response */
612 struct connectdata *conn = pp->conn;
613 struct SessionHandle *data = conn->data;
615 char * const buf = data->state.buffer;
617 CURLcode result = CURLE_OK;
620 result = Curl_pp_readresp(sockfd, pp, &code, size);
622 #if defined(HAVE_GSSAPI)
623 /* handle the security-oriented responses 6xx ***/
624 /* FIXME: some errorchecking perhaps... ***/
627 code = Curl_sec_read_msg(conn, buf, PROT_SAFE);
630 code = Curl_sec_read_msg(conn, buf, PROT_PRIVATE);
633 code = Curl_sec_read_msg(conn, buf, PROT_CONFIDENTIAL);
636 /* normal ftp stuff we pass through! */
641 /* store the latest code for later retrieval */
642 data->info.httpcode=code;
648 /* 421 means "Service not available, closing control connection." and FTP
649 * servers use it to signal that idle session timeout has been exceeded.
650 * If we ignored the response, it could end up hanging in some cases.
652 * This response code can come at any point so having it treated
653 * generically is a good idea.
655 infof(data, "We got a 421 - timeout!\n");
656 state(conn, FTP_STOP);
657 return CURLE_OPERATION_TIMEDOUT;
663 /* --- parse FTP server responses --- */
666 * Curl_GetFTPResponse() is a BLOCKING function to read the full response
667 * from a server after a command.
671 CURLcode Curl_GetFTPResponse(ssize_t *nreadp, /* return number of bytes read */
672 struct connectdata *conn,
673 int *ftpcode) /* return the ftp-code */
676 * We cannot read just one byte per read() and then go back to select() as
677 * the OpenSSL read() doesn't grok that properly.
679 * Alas, read as much as possible, split up into lines, use the ending
680 * line in a response or continue reading. */
682 curl_socket_t sockfd = conn->sock[FIRSTSOCKET];
683 long timeout; /* timeout in milliseconds */
685 struct SessionHandle *data = conn->data;
686 CURLcode result = CURLE_OK;
687 struct ftp_conn *ftpc = &conn->proto.ftpc;
688 struct pingpong *pp = &ftpc->pp;
691 int value_to_be_ignored=0;
694 *ftpcode = 0; /* 0 for errors */
696 /* make the pointer point to something for the rest of this function */
697 ftpcode = &value_to_be_ignored;
701 while(!*ftpcode && !result) {
702 /* check and reset timeout value every lap */
703 timeout = Curl_pp_state_timeout(pp);
706 failf(data, "FTP response timeout");
707 return CURLE_OPERATION_TIMEDOUT; /* already too little time */
710 interval_ms = 1000; /* use 1 second timeout intervals */
711 if(timeout < interval_ms)
712 interval_ms = timeout;
715 * Since this function is blocking, we need to wait here for input on the
716 * connection and only then we call the response reading function. We do
717 * timeout at least every second to make the timeout check run.
719 * A caution here is that the ftp_readresp() function has a cache that may
720 * contain pieces of a response from the previous invoke and we need to
721 * make sure we don't just wait for input while there is unhandled data in
722 * that cache. But also, if the cache is there, we call ftp_readresp() and
723 * the cache wasn't good enough to continue we must not just busy-loop
724 * around this function.
728 if(pp->cache && (cache_skip < 2)) {
730 * There's a cache left since before. We then skipping the wait for
731 * socket action, unless this is the same cache like the previous round
732 * as then the cache was deemed not enough to act on and we then need to
733 * wait for more data anyway.
737 switch (Curl_socket_ready(sockfd, CURL_SOCKET_BAD, interval_ms)) {
738 case -1: /* select() error, stop reading */
739 failf(data, "FTP response aborted due to select/poll error: %d",
741 return CURLE_RECV_ERROR;
743 case 0: /* timeout */
744 if(Curl_pgrsUpdate(conn))
745 return CURLE_ABORTED_BY_CALLBACK;
746 continue; /* just continue in our loop for the timeout duration */
748 default: /* for clarity */
752 result = ftp_readresp(sockfd, pp, ftpcode, &nread);
756 if(!nread && pp->cache)
757 /* bump cache skip counter as on repeated skips we must wait for more
761 /* when we got data or there is no cache left, we reset the cache skip
767 } /* while there's buffer left and loop is requested */
769 pp->pending_resp = FALSE;
774 #if defined(DEBUGBUILD) && !defined(CURL_DISABLE_VERBOSE_STRINGS)
775 /* for debug purposes */
776 static const char * const ftp_state_names[]={
815 /* This is the ONLY way to change FTP state! */
816 static void _state(struct connectdata *conn,
823 struct ftp_conn *ftpc = &conn->proto.ftpc;
824 #if defined(DEBUGBUILD) && !defined(CURL_DISABLE_VERBOSE_STRINGS)
825 if(ftpc->state != newstate)
826 infof(conn->data, "FTP %p (line %d) state change from %s to %s\n",
827 (void *)ftpc, lineno, ftp_state_names[ftpc->state],
828 ftp_state_names[newstate]);
830 ftpc->state = newstate;
833 static CURLcode ftp_state_user(struct connectdata *conn)
836 struct FTP *ftp = conn->data->req.protop;
838 PPSENDF(&conn->proto.ftpc.pp, "USER %s", ftp->user?ftp->user:"");
840 state(conn, FTP_USER);
841 conn->data->state.ftp_trying_alternative = FALSE;
846 static CURLcode ftp_state_pwd(struct connectdata *conn)
850 /* send PWD to discover our entry point */
851 PPSENDF(&conn->proto.ftpc.pp, "%s", "PWD");
852 state(conn, FTP_PWD);
857 /* For the FTP "protocol connect" and "doing" phases only */
858 static int ftp_getsock(struct connectdata *conn,
859 curl_socket_t *socks,
862 return Curl_pp_getsock(&conn->proto.ftpc.pp, socks, numsocks);
865 /* For the FTP "DO_MORE" phase only */
866 static int ftp_domore_getsock(struct connectdata *conn, curl_socket_t *socks,
869 struct ftp_conn *ftpc = &conn->proto.ftpc;
872 return GETSOCK_BLANK;
874 /* When in DO_MORE state, we could be either waiting for us to connect to a
875 * remote site, or we could wait for that site to connect to us. Or just
876 * handle ordinary commands.
879 if(FTP_STOP == ftpc->state) {
880 int bits = GETSOCK_READSOCK(0);
882 /* if stopped and still in this state, then we're also waiting for a
883 connect on the secondary connection */
884 socks[0] = conn->sock[FIRSTSOCKET];
886 if(!conn->data->set.ftp_use_port) {
889 /* PORT is used to tell the server to connect to us, and during that we
890 don't do happy eyeballs, but we do if we connect to the server */
891 for(s=1, i=0; i<2; i++) {
892 if(conn->tempsock[i] != CURL_SOCKET_BAD) {
893 socks[s] = conn->tempsock[i];
894 bits |= GETSOCK_WRITESOCK(s++);
899 socks[1] = conn->sock[SECONDARYSOCKET];
900 bits |= GETSOCK_WRITESOCK(1);
906 return Curl_pp_getsock(&conn->proto.ftpc.pp, socks, numsocks);
909 /* This is called after the FTP_QUOTE state is passed.
911 ftp_state_cwd() sends the range of CWD commands to the server to change to
912 the correct directory. It may also need to send MKD commands to create
913 missing ones, if that option is enabled.
915 static CURLcode ftp_state_cwd(struct connectdata *conn)
917 CURLcode result = CURLE_OK;
918 struct ftp_conn *ftpc = &conn->proto.ftpc;
921 /* already done and fine */
922 result = ftp_state_mdtm(conn);
924 ftpc->count2 = 0; /* count2 counts failed CWDs */
926 /* count3 is set to allow a MKD to fail once. In the case when first CWD
927 fails and then MKD fails (due to another session raced it to create the
928 dir) this then allows for a second try to CWD to it */
929 ftpc->count3 = (conn->data->set.ftp_create_missing_dirs==2)?1:0;
931 if(conn->bits.reuse && ftpc->entrypath) {
932 /* This is a re-used connection. Since we change directory to where the
933 transfer is taking place, we must first get back to the original dir
934 where we ended up after login: */
935 ftpc->count1 = 0; /* we count this as the first path, then we add one
936 for all upcoming ones in the ftp->dirs[] array */
937 PPSENDF(&conn->proto.ftpc.pp, "CWD %s", ftpc->entrypath);
938 state(conn, FTP_CWD);
943 /* issue the first CWD, the rest is sent when the CWD responses are
945 PPSENDF(&conn->proto.ftpc.pp, "CWD %s", ftpc->dirs[ftpc->count1 -1]);
946 state(conn, FTP_CWD);
949 /* No CWD necessary */
950 result = ftp_state_mdtm(conn);
963 static CURLcode ftp_state_use_port(struct connectdata *conn,
964 ftpport fcmd) /* start with this */
967 CURLcode result = CURLE_OK;
968 struct ftp_conn *ftpc = &conn->proto.ftpc;
969 struct SessionHandle *data=conn->data;
970 curl_socket_t portsock= CURL_SOCKET_BAD;
971 char myhost[256] = "";
973 struct Curl_sockaddr_storage ss;
974 Curl_addrinfo *res, *ai;
975 curl_socklen_t sslen;
976 char hbuf[NI_MAXHOST];
977 struct sockaddr *sa=(struct sockaddr *)&ss;
978 struct sockaddr_in * const sa4 = (void *)sa;
980 struct sockaddr_in6 * const sa6 = (void *)sa;
983 static const char mode[][5] = { "EPRT", "PORT" };
987 char *string_ftpport = data->set.str[STRING_FTPPORT];
988 struct Curl_dns_entry *h=NULL;
989 unsigned short port_min = 0;
990 unsigned short port_max = 0;
992 bool possibly_non_local = TRUE;
996 /* Step 1, figure out what is requested,
998 * (ipv4|ipv6|domain|interface)?(:port(-range)?)?
1001 if(data->set.str[STRING_FTPPORT] &&
1002 (strlen(data->set.str[STRING_FTPPORT]) > 1)) {
1005 size_t addrlen = INET6_ADDRSTRLEN > strlen(string_ftpport) ?
1006 INET6_ADDRSTRLEN : strlen(string_ftpport);
1008 size_t addrlen = INET_ADDRSTRLEN > strlen(string_ftpport) ?
1009 INET_ADDRSTRLEN : strlen(string_ftpport);
1011 char *ip_start = string_ftpport;
1012 char *ip_end = NULL;
1013 char *port_start = NULL;
1014 char *port_sep = NULL;
1016 addr = calloc(addrlen+1, 1);
1018 return CURLE_OUT_OF_MEMORY;
1021 if(*string_ftpport == '[') {
1022 /* [ipv6]:port(-range) */
1023 ip_start = string_ftpport + 1;
1024 if((ip_end = strchr(string_ftpport, ']')) != NULL )
1025 strncpy(addr, ip_start, ip_end - ip_start);
1029 if(*string_ftpport == ':') {
1031 ip_end = string_ftpport;
1033 else if((ip_end = strchr(string_ftpport, ':')) != NULL) {
1034 /* either ipv6 or (ipv4|domain|interface):port(-range) */
1036 if(Curl_inet_pton(AF_INET6, string_ftpport, sa6) == 1) {
1038 port_min = port_max = 0;
1039 strcpy(addr, string_ftpport);
1040 ip_end = NULL; /* this got no port ! */
1044 /* (ipv4|domain|interface):port(-range) */
1045 strncpy(addr, string_ftpport, ip_end - ip_start );
1048 /* ipv4|interface */
1049 strcpy(addr, string_ftpport);
1051 /* parse the port */
1052 if(ip_end != NULL) {
1053 if((port_start = strchr(ip_end, ':')) != NULL) {
1054 port_min = curlx_ultous(strtoul(port_start+1, NULL, 10));
1055 if((port_sep = strchr(port_start, '-')) != NULL) {
1056 port_max = curlx_ultous(strtoul(port_sep + 1, NULL, 10));
1059 port_max = port_min;
1063 /* correct errors like:
1065 * :-4711 , in this case port_min is (unsigned)-1,
1066 * therefore port_min > port_max for all cases
1067 * but port_max = (unsigned)-1
1069 if(port_min > port_max )
1070 port_min = port_max = 0;
1074 /* attempt to get the address of the given interface name */
1075 switch(Curl_if2ip(conn->ip_addr->ai_family, conn->scope, addr,
1076 hbuf, sizeof(hbuf))) {
1077 case IF2IP_NOT_FOUND:
1078 /* not an interface, use the given string as host name instead */
1081 case IF2IP_AF_NOT_SUPPORTED:
1082 return CURLE_FTP_PORT_FAILED;
1084 host = hbuf; /* use the hbuf for host name */
1088 /* there was only a port(-range) given, default the host */
1090 } /* data->set.ftpport */
1093 /* not an interface and not a host name, get default by extracting
1094 the IP from the control connection */
1097 if(getsockname(conn->sock[FIRSTSOCKET], sa, &sslen)) {
1098 failf(data, "getsockname() failed: %s",
1099 Curl_strerror(conn, SOCKERRNO) );
1100 Curl_safefree(addr);
1101 return CURLE_FTP_PORT_FAILED;
1103 switch(sa->sa_family) {
1106 Curl_inet_ntop(sa->sa_family, &sa6->sin6_addr, hbuf, sizeof(hbuf));
1110 Curl_inet_ntop(sa->sa_family, &sa4->sin_addr, hbuf, sizeof(hbuf));
1113 host = hbuf; /* use this host name */
1114 possibly_non_local = FALSE; /* we know it is local now */
1117 /* resolv ip/host to ip */
1118 rc = Curl_resolv(conn, host, 0, &h);
1119 if(rc == CURLRESOLV_PENDING)
1120 (void)Curl_resolver_wait_resolv(conn, &h);
1123 /* when we return from this function, we can forget about this entry
1124 to we can unlock it now already */
1125 Curl_resolv_unlock(data, h);
1128 res = NULL; /* failure! */
1131 failf(data, "failed to resolve the address provided to PORT: %s", host);
1132 Curl_safefree(addr);
1133 return CURLE_FTP_PORT_FAILED;
1136 Curl_safefree(addr);
1139 /* step 2, create a socket for the requested address */
1141 portsock = CURL_SOCKET_BAD;
1143 for(ai = res; ai; ai = ai->ai_next) {
1144 result = Curl_socket(conn, ai, NULL, &portsock);
1152 failf(data, "socket failure: %s", Curl_strerror(conn, error));
1153 return CURLE_FTP_PORT_FAILED;
1156 /* step 3, bind to a suitable local address */
1158 memcpy(sa, ai->ai_addr, ai->ai_addrlen);
1159 sslen = ai->ai_addrlen;
1161 for(port = port_min; port <= port_max;) {
1162 if(sa->sa_family == AF_INET)
1163 sa4->sin_port = htons(port);
1166 sa6->sin6_port = htons(port);
1168 /* Try binding the given address. */
1169 if(bind(portsock, sa, sslen) ) {
1172 if(possibly_non_local && (error == EADDRNOTAVAIL)) {
1173 /* The requested bind address is not local. Use the address used for
1174 * the control connection instead and restart the port loop
1177 infof(data, "bind(port=%hu) on non-local address failed: %s\n", port,
1178 Curl_strerror(conn, error) );
1181 if(getsockname(conn->sock[FIRSTSOCKET], sa, &sslen)) {
1182 failf(data, "getsockname() failed: %s",
1183 Curl_strerror(conn, SOCKERRNO) );
1184 Curl_closesocket(conn, portsock);
1185 return CURLE_FTP_PORT_FAILED;
1188 possibly_non_local = FALSE; /* don't try this again */
1191 else if(error != EADDRINUSE && error != EACCES) {
1192 failf(data, "bind(port=%hu) failed: %s", port,
1193 Curl_strerror(conn, error) );
1194 Curl_closesocket(conn, portsock);
1195 return CURLE_FTP_PORT_FAILED;
1204 /* maybe all ports were in use already*/
1205 if(port > port_max) {
1206 failf(data, "bind() failed, we ran out of ports!");
1207 Curl_closesocket(conn, portsock);
1208 return CURLE_FTP_PORT_FAILED;
1211 /* get the name again after the bind() so that we can extract the
1212 port number it uses now */
1214 if(getsockname(portsock, (struct sockaddr *)sa, &sslen)) {
1215 failf(data, "getsockname() failed: %s",
1216 Curl_strerror(conn, SOCKERRNO) );
1217 Curl_closesocket(conn, portsock);
1218 return CURLE_FTP_PORT_FAILED;
1221 /* step 4, listen on the socket */
1223 if(listen(portsock, 1)) {
1224 failf(data, "socket failure: %s", Curl_strerror(conn, SOCKERRNO));
1225 Curl_closesocket(conn, portsock);
1226 return CURLE_FTP_PORT_FAILED;
1229 /* step 5, send the proper FTP command */
1231 /* get a plain printable version of the numerical address to work with
1233 Curl_printable_address(ai, myhost, sizeof(myhost));
1236 if(!conn->bits.ftp_use_eprt && conn->bits.ipv6)
1237 /* EPRT is disabled but we are connected to a IPv6 host, so we ignore the
1238 request and enable EPRT again! */
1239 conn->bits.ftp_use_eprt = TRUE;
1242 for(; fcmd != DONE; fcmd++) {
1244 if(!conn->bits.ftp_use_eprt && (EPRT == fcmd))
1245 /* if disabled, goto next */
1248 if((PORT == fcmd) && sa->sa_family != AF_INET)
1249 /* PORT is ipv4 only */
1252 switch (sa->sa_family) {
1254 port = ntohs(sa4->sin_port);
1258 port = ntohs(sa6->sin6_port);
1262 continue; /* might as well skip this */
1267 * Two fine examples from RFC2428;
1269 * EPRT |1|132.235.1.2|6275|
1271 * EPRT |2|1080::8:800:200C:417A|5282|
1274 result = Curl_pp_sendf(&ftpc->pp, "%s |%d|%s|%hu|", mode[fcmd],
1275 sa->sa_family == AF_INET?1:2,
1278 failf(data, "Failure sending EPRT command: %s",
1279 curl_easy_strerror(result));
1280 Curl_closesocket(conn, portsock);
1281 /* don't retry using PORT */
1282 ftpc->count1 = PORT;
1284 state(conn, FTP_STOP);
1289 else if(PORT == fcmd) {
1290 char *source = myhost;
1293 /* translate x.x.x.x to x,x,x,x */
1294 while(source && *source) {
1303 snprintf(dest, 20, ",%d,%d", (int)(port>>8), (int)(port&0xff));
1305 result = Curl_pp_sendf(&ftpc->pp, "%s %s", mode[fcmd], tmp);
1307 failf(data, "Failure sending PORT command: %s",
1308 curl_easy_strerror(result));
1309 Curl_closesocket(conn, portsock);
1311 state(conn, FTP_STOP);
1318 /* store which command was sent */
1319 ftpc->count1 = fcmd;
1321 /* we set the secondary socket variable to this for now, it is only so that
1322 the cleanup function will close it in case we fail before the true
1323 secondary stuff is made */
1324 if(CURL_SOCKET_BAD != conn->sock[SECONDARYSOCKET])
1325 Curl_closesocket(conn, conn->sock[SECONDARYSOCKET]);
1326 conn->sock[SECONDARYSOCKET] = portsock;
1328 /* this tcpconnect assignment below is a hackish work-around to make the
1329 multi interface with active FTP work - as it will not wait for a
1330 (passive) connect in Curl_is_connected().
1332 The *proper* fix is to make sure that the active connection from the
1333 server is done in a non-blocking way. Currently, it is still BLOCKING.
1335 conn->bits.tcpconnect[SECONDARYSOCKET] = TRUE;
1337 state(conn, FTP_PORT);
1341 static CURLcode ftp_state_use_pasv(struct connectdata *conn)
1343 struct ftp_conn *ftpc = &conn->proto.ftpc;
1344 CURLcode result = CURLE_OK;
1346 Here's the excecutive summary on what to do:
1348 PASV is RFC959, expect:
1349 227 Entering Passive Mode (a1,a2,a3,a4,p1,p2)
1351 LPSV is RFC1639, expect:
1352 228 Entering Long Passive Mode (4,4,a1,a2,a3,a4,2,p1,p2)
1354 EPSV is RFC2428, expect:
1355 229 Entering Extended Passive Mode (|||port|)
1359 static const char mode[][5] = { "EPSV", "PASV" };
1363 if(!conn->bits.ftp_use_epsv && conn->bits.ipv6)
1364 /* EPSV is disabled but we are connected to a IPv6 host, so we ignore the
1365 request and enable EPSV again! */
1366 conn->bits.ftp_use_epsv = TRUE;
1369 modeoff = conn->bits.ftp_use_epsv?0:1;
1371 PPSENDF(&ftpc->pp, "%s", mode[modeoff]);
1373 ftpc->count1 = modeoff;
1374 state(conn, FTP_PASV);
1375 infof(conn->data, "Connect data stream passively\n");
1381 * ftp_state_prepare_transfer() starts PORT, PASV or PRET etc.
1383 * REST is the last command in the chain of commands when a "head"-like
1384 * request is made. Thus, if an actual transfer is to be made this is where we
1385 * take off for real.
1387 static CURLcode ftp_state_prepare_transfer(struct connectdata *conn)
1389 CURLcode result = CURLE_OK;
1390 struct FTP *ftp = conn->data->req.protop;
1391 struct SessionHandle *data = conn->data;
1393 if(ftp->transfer != FTPTRANSFER_BODY) {
1394 /* doesn't transfer any data */
1396 /* still possibly do PRE QUOTE jobs */
1397 state(conn, FTP_RETR_PREQUOTE);
1398 result = ftp_state_quote(conn, TRUE, FTP_RETR_PREQUOTE);
1400 else if(data->set.ftp_use_port) {
1401 /* We have chosen to use the PORT (or similar) command */
1402 result = ftp_state_use_port(conn, EPRT);
1405 /* We have chosen (this is default) to use the PASV (or similar) command */
1406 if(data->set.ftp_use_pret) {
1407 /* The user has requested that we send a PRET command
1408 to prepare the server for the upcoming PASV */
1409 if(!conn->proto.ftpc.file) {
1410 PPSENDF(&conn->proto.ftpc.pp, "PRET %s",
1411 data->set.str[STRING_CUSTOMREQUEST]?
1412 data->set.str[STRING_CUSTOMREQUEST]:
1413 (data->set.ftp_list_only?"NLST":"LIST"));
1415 else if(data->set.upload) {
1416 PPSENDF(&conn->proto.ftpc.pp, "PRET STOR %s", conn->proto.ftpc.file);
1419 PPSENDF(&conn->proto.ftpc.pp, "PRET RETR %s", conn->proto.ftpc.file);
1421 state(conn, FTP_PRET);
1424 result = ftp_state_use_pasv(conn);
1430 static CURLcode ftp_state_rest(struct connectdata *conn)
1432 CURLcode result = CURLE_OK;
1433 struct FTP *ftp = conn->data->req.protop;
1434 struct ftp_conn *ftpc = &conn->proto.ftpc;
1436 if((ftp->transfer != FTPTRANSFER_BODY) && ftpc->file) {
1437 /* if a "head"-like request is being made (on a file) */
1439 /* Determine if server can respond to REST command and therefore
1440 whether it supports range */
1441 PPSENDF(&conn->proto.ftpc.pp, "REST %d", 0);
1443 state(conn, FTP_REST);
1446 result = ftp_state_prepare_transfer(conn);
1451 static CURLcode ftp_state_size(struct connectdata *conn)
1453 CURLcode result = CURLE_OK;
1454 struct FTP *ftp = conn->data->req.protop;
1455 struct ftp_conn *ftpc = &conn->proto.ftpc;
1457 if((ftp->transfer == FTPTRANSFER_INFO) && ftpc->file) {
1458 /* if a "head"-like request is being made (on a file) */
1460 /* we know ftpc->file is a valid pointer to a file name */
1461 PPSENDF(&ftpc->pp, "SIZE %s", ftpc->file);
1463 state(conn, FTP_SIZE);
1466 result = ftp_state_rest(conn);
1471 static CURLcode ftp_state_list(struct connectdata *conn)
1473 CURLcode result = CURLE_OK;
1474 struct SessionHandle *data = conn->data;
1476 /* If this output is to be machine-parsed, the NLST command might be better
1477 to use, since the LIST command output is not specified or standard in any
1478 way. It has turned out that the NLST list output is not the same on all
1479 servers either... */
1482 if FTPFILE_NOCWD was specified, we are currently in
1483 the user's home directory, so we should add the path
1484 as argument for the LIST / NLST / or custom command.
1485 Whether the server will support this, is uncertain.
1487 The other ftp_filemethods will CWD into dir/dir/ first and
1488 then just do LIST (in that case: nothing to do here)
1490 char *cmd,*lstArg,*slashPos;
1493 if((data->set.ftp_filemethod == FTPFILE_NOCWD) &&
1495 data->state.path[0] &&
1496 strchr(data->state.path,'/')) {
1498 lstArg = strdup(data->state.path);
1500 return CURLE_OUT_OF_MEMORY;
1502 /* Check if path does not end with /, as then we cut off the file part */
1503 if(lstArg[strlen(lstArg) - 1] != '/') {
1505 /* chop off the file part if format is dir/dir/file */
1506 slashPos = strrchr(lstArg,'/');
1508 *(slashPos+1) = '\0';
1512 cmd = aprintf( "%s%s%s",
1513 data->set.str[STRING_CUSTOMREQUEST]?
1514 data->set.str[STRING_CUSTOMREQUEST]:
1515 (data->set.ftp_list_only?"NLST":"LIST"),
1517 lstArg? lstArg: "" );
1522 return CURLE_OUT_OF_MEMORY;
1525 result = Curl_pp_sendf(&conn->proto.ftpc.pp, "%s", cmd);
1532 if(result != CURLE_OK)
1535 state(conn, FTP_LIST);
1540 static CURLcode ftp_state_retr_prequote(struct connectdata *conn)
1542 CURLcode result = CURLE_OK;
1544 /* We've sent the TYPE, now we must send the list of prequote strings */
1546 result = ftp_state_quote(conn, TRUE, FTP_RETR_PREQUOTE);
1551 static CURLcode ftp_state_stor_prequote(struct connectdata *conn)
1553 CURLcode result = CURLE_OK;
1555 /* We've sent the TYPE, now we must send the list of prequote strings */
1557 result = ftp_state_quote(conn, TRUE, FTP_STOR_PREQUOTE);
1562 static CURLcode ftp_state_type(struct connectdata *conn)
1564 CURLcode result = CURLE_OK;
1565 struct FTP *ftp = conn->data->req.protop;
1566 struct SessionHandle *data = conn->data;
1567 struct ftp_conn *ftpc = &conn->proto.ftpc;
1569 /* If we have selected NOBODY and HEADER, it means that we only want file
1570 information. Which in FTP can't be much more than the file size and
1572 if(data->set.opt_no_body && ftpc->file &&
1573 ftp_need_type(conn, data->set.prefer_ascii)) {
1574 /* The SIZE command is _not_ RFC 959 specified, and therefor many servers
1575 may not support it! It is however the only way we have to get a file's
1578 ftp->transfer = FTPTRANSFER_INFO;
1579 /* this means no actual transfer will be made */
1581 /* Some servers return different sizes for different modes, and thus we
1582 must set the proper type before we check the size */
1583 result = ftp_nb_type(conn, data->set.prefer_ascii, FTP_TYPE);
1588 result = ftp_state_size(conn);
1593 /* This is called after the CWD commands have been done in the beginning of
1595 static CURLcode ftp_state_mdtm(struct connectdata *conn)
1597 CURLcode result = CURLE_OK;
1598 struct SessionHandle *data = conn->data;
1599 struct ftp_conn *ftpc = &conn->proto.ftpc;
1601 /* Requested time of file or time-depended transfer? */
1602 if((data->set.get_filetime || data->set.timecondition) && ftpc->file) {
1604 /* we have requested to get the modified-time of the file, this is a white
1605 spot as the MDTM is not mentioned in RFC959 */
1606 PPSENDF(&ftpc->pp, "MDTM %s", ftpc->file);
1608 state(conn, FTP_MDTM);
1611 result = ftp_state_type(conn);
1617 /* This is called after the TYPE and possible quote commands have been sent */
1618 static CURLcode ftp_state_ul_setup(struct connectdata *conn,
1621 CURLcode result = CURLE_OK;
1622 struct FTP *ftp = conn->data->req.protop;
1623 struct SessionHandle *data = conn->data;
1624 struct ftp_conn *ftpc = &conn->proto.ftpc;
1625 int seekerr = CURL_SEEKFUNC_OK;
1627 if((data->state.resume_from && !sizechecked) ||
1628 ((data->state.resume_from > 0) && sizechecked)) {
1629 /* we're about to continue the uploading of a file */
1630 /* 1. get already existing file's size. We use the SIZE command for this
1631 which may not exist in the server! The SIZE command is not in
1634 /* 2. This used to set REST. But since we can do append, we
1635 don't another ftp command. We just skip the source file
1636 offset and then we APPEND the rest on the file instead */
1638 /* 3. pass file-size number of bytes in the source file */
1639 /* 4. lower the infilesize counter */
1640 /* => transfer as usual */
1642 if(data->state.resume_from < 0 ) {
1643 /* Got no given size to start from, figure it out */
1644 PPSENDF(&ftpc->pp, "SIZE %s", ftpc->file);
1645 state(conn, FTP_STOR_SIZE);
1650 data->set.ftp_append = TRUE;
1652 /* Let's read off the proper amount of bytes from the input. */
1653 if(conn->seek_func) {
1654 seekerr = conn->seek_func(conn->seek_client, data->state.resume_from,
1658 if(seekerr != CURL_SEEKFUNC_OK) {
1659 if(seekerr != CURL_SEEKFUNC_CANTSEEK) {
1660 failf(data, "Could not seek stream");
1661 return CURLE_FTP_COULDNT_USE_REST;
1663 /* seekerr == CURL_SEEKFUNC_CANTSEEK (can't seek to offset) */
1665 curl_off_t passed=0;
1667 size_t readthisamountnow =
1668 (data->state.resume_from - passed > CURL_OFF_T_C(BUFSIZE)) ?
1669 BUFSIZE : curlx_sotouz(data->state.resume_from - passed);
1671 size_t actuallyread =
1672 conn->fread_func(data->state.buffer, 1, readthisamountnow,
1675 passed += actuallyread;
1676 if((actuallyread == 0) || (actuallyread > readthisamountnow)) {
1677 /* this checks for greater-than only to make sure that the
1678 CURL_READFUNC_ABORT return code still aborts */
1679 failf(data, "Failed to read data");
1680 return CURLE_FTP_COULDNT_USE_REST;
1682 } while(passed < data->state.resume_from);
1685 /* now, decrease the size of the read */
1686 if(data->state.infilesize>0) {
1687 data->state.infilesize -= data->state.resume_from;
1689 if(data->state.infilesize <= 0) {
1690 infof(data, "File already completely uploaded\n");
1692 /* no data to transfer */
1693 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
1695 /* Set ->transfer so that we won't get any error in
1696 * ftp_done() because we didn't transfer anything! */
1697 ftp->transfer = FTPTRANSFER_NONE;
1699 state(conn, FTP_STOP);
1703 /* we've passed, proceed as normal */
1706 PPSENDF(&ftpc->pp, data->set.ftp_append?"APPE %s":"STOR %s",
1709 state(conn, FTP_STOR);
1714 static CURLcode ftp_state_quote(struct connectdata *conn,
1718 CURLcode result = CURLE_OK;
1719 struct SessionHandle *data = conn->data;
1720 struct FTP *ftp = data->req.protop;
1721 struct ftp_conn *ftpc = &conn->proto.ftpc;
1723 struct curl_slist *item;
1728 item = data->set.quote;
1730 case FTP_RETR_PREQUOTE:
1731 case FTP_STOR_PREQUOTE:
1732 item = data->set.prequote;
1735 item = data->set.postquote;
1741 * 'count1' to iterate over the commands to send
1742 * 'count2' to store wether to allow commands to fail
1753 /* Skip count1 items in the linked list */
1754 while((i< ftpc->count1) && item) {
1759 char *cmd = item->data;
1762 ftpc->count2 = 1; /* the sent command is allowed to fail */
1765 ftpc->count2 = 0; /* failure means cancel operation */
1767 PPSENDF(&ftpc->pp, "%s", cmd);
1768 state(conn, instate);
1774 /* No more quote to send, continue to ... */
1778 result = ftp_state_cwd(conn);
1780 case FTP_RETR_PREQUOTE:
1781 if(ftp->transfer != FTPTRANSFER_BODY)
1782 state(conn, FTP_STOP);
1784 if(ftpc->known_filesize != -1) {
1785 Curl_pgrsSetDownloadSize(data, ftpc->known_filesize);
1786 result = ftp_state_retr(conn, ftpc->known_filesize);
1789 PPSENDF(&ftpc->pp, "SIZE %s", ftpc->file);
1790 state(conn, FTP_RETR_SIZE);
1794 case FTP_STOR_PREQUOTE:
1795 result = ftp_state_ul_setup(conn, FALSE);
1805 /* called from ftp_state_pasv_resp to switch to PASV in case of EPSV
1807 static CURLcode ftp_epsv_disable(struct connectdata *conn)
1809 CURLcode result = CURLE_OK;
1810 infof(conn->data, "Failed EPSV attempt. Disabling EPSV\n");
1811 /* disable it for next transfer */
1812 conn->bits.ftp_use_epsv = FALSE;
1813 conn->data->state.errorbuf = FALSE; /* allow error message to get
1815 PPSENDF(&conn->proto.ftpc.pp, "%s", "PASV");
1816 conn->proto.ftpc.count1++;
1817 /* remain in/go to the FTP_PASV state */
1818 state(conn, FTP_PASV);
1823 * Perform the necessary magic that needs to be done once the TCP connection
1824 * to the proxy has completed.
1826 static CURLcode proxy_magic(struct connectdata *conn,
1827 char *newhost, unsigned short newport,
1830 CURLcode result = CURLE_OK;
1831 struct SessionHandle *data=conn->data;
1834 switch(conn->proxytype) {
1835 case CURLPROXY_SOCKS5:
1836 case CURLPROXY_SOCKS5_HOSTNAME:
1837 result = Curl_SOCKS5(conn->proxyuser, conn->proxypasswd, newhost,
1838 newport, SECONDARYSOCKET, conn);
1841 case CURLPROXY_SOCKS4:
1842 result = Curl_SOCKS4(conn->proxyuser, newhost, newport,
1843 SECONDARYSOCKET, conn, FALSE);
1846 case CURLPROXY_SOCKS4A:
1847 result = Curl_SOCKS4(conn->proxyuser, newhost, newport,
1848 SECONDARYSOCKET, conn, TRUE);
1851 case CURLPROXY_HTTP:
1852 case CURLPROXY_HTTP_1_0:
1853 /* do nothing here. handled later. */
1856 failf(data, "unknown proxytype option given");
1857 result = CURLE_COULDNT_CONNECT;
1861 if(conn->bits.tunnel_proxy && conn->bits.httpproxy) {
1863 /* We want "seamless" FTP operations through HTTP proxy tunnel */
1865 /* Curl_proxyCONNECT is based on a pointer to a struct HTTP at the
1866 * member conn->proto.http; we want FTP through HTTP and we have to
1867 * change the member temporarily for connecting to the HTTP proxy. After
1868 * Curl_proxyCONNECT we have to set back the member to the original
1869 * struct FTP pointer
1871 struct HTTP http_proxy;
1872 struct FTP *ftp_save = data->req.protop;
1873 memset(&http_proxy, 0, sizeof(http_proxy));
1874 data->req.protop = &http_proxy;
1876 result = Curl_proxyCONNECT(conn, SECONDARYSOCKET, newhost, newport);
1878 data->req.protop = ftp_save;
1883 if(conn->tunnel_state[SECONDARYSOCKET] != TUNNEL_COMPLETE) {
1884 /* the CONNECT procedure is not complete, the tunnel is not yet up */
1885 state(conn, FTP_STOP); /* this phase is completed */
1894 static CURLcode ftp_state_pasv_resp(struct connectdata *conn,
1897 struct ftp_conn *ftpc = &conn->proto.ftpc;
1899 struct SessionHandle *data=conn->data;
1900 struct Curl_dns_entry *addr=NULL;
1902 unsigned short connectport; /* the local port connect() should use! */
1903 char *str=&data->state.buffer[4]; /* start on the first letter */
1905 if((ftpc->count1 == 0) &&
1907 /* positive EPSV response */
1908 char *ptr = strchr(str, '(');
1913 if(5 == sscanf(ptr, "%c%c%c%u%c",
1919 const char sep1 = separator[0];
1922 /* The four separators should be identical, or else this is an oddly
1923 formatted reply and we bail out immediately. */
1924 for(i=1; i<4; i++) {
1925 if(separator[i] != sep1) {
1926 ptr=NULL; /* set to NULL to signal error */
1931 failf(data, "Illegal port number in EPSV reply");
1932 return CURLE_FTP_WEIRD_PASV_REPLY;
1935 ftpc->newport = (unsigned short)(num & 0xffff);
1937 if(conn->bits.tunnel_proxy ||
1938 conn->proxytype == CURLPROXY_SOCKS5 ||
1939 conn->proxytype == CURLPROXY_SOCKS5_HOSTNAME ||
1940 conn->proxytype == CURLPROXY_SOCKS4 ||
1941 conn->proxytype == CURLPROXY_SOCKS4A)
1942 /* proxy tunnel -> use other host info because ip_addr_str is the
1943 proxy address not the ftp host */
1944 snprintf(ftpc->newhost, sizeof(ftpc->newhost), "%s",
1947 /* use the same IP we are already connected to */
1948 snprintf(ftpc->newhost, NEWHOST_BUFSIZE, "%s", conn->ip_addr_str);
1955 failf(data, "Weirdly formatted EPSV reply");
1956 return CURLE_FTP_WEIRD_PASV_REPLY;
1959 else if((ftpc->count1 == 1) &&
1961 /* positive PASV response */
1966 * Scan for a sequence of six comma-separated numbers and use them as
1967 * IP+port indicators.
1969 * Found reply-strings include:
1970 * "227 Entering Passive Mode (127,0,0,1,4,51)"
1971 * "227 Data transfer will passively listen to 127,0,0,1,4,51"
1972 * "227 Entering passive mode. 127,0,0,1,4,51"
1975 if(6 == sscanf(str, "%d,%d,%d,%d,%d,%d",
1976 &ip[0], &ip[1], &ip[2], &ip[3],
1977 &port[0], &port[1]))
1983 failf(data, "Couldn't interpret the 227-response");
1984 return CURLE_FTP_WEIRD_227_FORMAT;
1987 /* we got OK from server */
1988 if(data->set.ftp_skip_ip) {
1989 /* told to ignore the remotely given IP but instead use the one we used
1990 for the control connection */
1991 infof(data, "Skips %d.%d.%d.%d for data connection, uses %s instead\n",
1992 ip[0], ip[1], ip[2], ip[3],
1994 if(conn->bits.tunnel_proxy ||
1995 conn->proxytype == CURLPROXY_SOCKS5 ||
1996 conn->proxytype == CURLPROXY_SOCKS5_HOSTNAME ||
1997 conn->proxytype == CURLPROXY_SOCKS4 ||
1998 conn->proxytype == CURLPROXY_SOCKS4A)
1999 /* proxy tunnel -> use other host info because ip_addr_str is the
2000 proxy address not the ftp host */
2001 snprintf(ftpc->newhost, sizeof(ftpc->newhost), "%s", conn->host.name);
2003 snprintf(ftpc->newhost, sizeof(ftpc->newhost), "%s",
2007 snprintf(ftpc->newhost, sizeof(ftpc->newhost),
2008 "%d.%d.%d.%d", ip[0], ip[1], ip[2], ip[3]);
2009 ftpc->newport = (unsigned short)(((port[0]<<8) + port[1]) & 0xffff);
2011 else if(ftpc->count1 == 0) {
2012 /* EPSV failed, move on to PASV */
2013 return ftp_epsv_disable(conn);
2016 failf(data, "Bad PASV/EPSV response: %03d", ftpcode);
2017 return CURLE_FTP_WEIRD_PASV_REPLY;
2020 if(conn->bits.proxy) {
2022 * This connection uses a proxy and we need to connect to the proxy again
2023 * here. We don't want to rely on a former host lookup that might've
2024 * expired now, instead we remake the lookup here and now!
2026 rc = Curl_resolv(conn, conn->proxy.name, (int)conn->port, &addr);
2027 if(rc == CURLRESOLV_PENDING)
2028 /* BLOCKING, ignores the return code but 'addr' will be NULL in
2030 (void)Curl_resolver_wait_resolv(conn, &addr);
2033 (unsigned short)conn->port; /* we connect to the proxy's port */
2036 failf(data, "Can't resolve proxy host %s:%hu",
2037 conn->proxy.name, connectport);
2038 return CURLE_FTP_CANT_GET_HOST;
2042 /* normal, direct, ftp connection */
2043 rc = Curl_resolv(conn, ftpc->newhost, ftpc->newport, &addr);
2044 if(rc == CURLRESOLV_PENDING)
2046 (void)Curl_resolver_wait_resolv(conn, &addr);
2048 connectport = ftpc->newport; /* we connect to the remote port */
2051 failf(data, "Can't resolve new host %s:%hu", ftpc->newhost, connectport);
2052 return CURLE_FTP_CANT_GET_HOST;
2056 conn->bits.tcpconnect[SECONDARYSOCKET] = FALSE;
2057 result = Curl_connecthost(conn, addr);
2059 Curl_resolv_unlock(data, addr); /* we're done using this address */
2062 if(ftpc->count1 == 0 && ftpcode == 229)
2063 return ftp_epsv_disable(conn);
2070 * When this is used from the multi interface, this might've returned with
2071 * the 'connected' set to FALSE and thus we are now awaiting a non-blocking
2072 * connect to connect.
2075 if(data->set.verbose)
2076 /* this just dumps information about this second connection */
2077 ftp_pasv_verbose(conn, conn->ip_addr, ftpc->newhost, connectport);
2079 conn->bits.do_more = TRUE;
2080 state(conn, FTP_STOP); /* this phase is completed */
2085 static CURLcode ftp_state_port_resp(struct connectdata *conn,
2088 struct SessionHandle *data = conn->data;
2089 struct ftp_conn *ftpc = &conn->proto.ftpc;
2090 ftpport fcmd = (ftpport)ftpc->count1;
2091 CURLcode result = CURLE_OK;
2093 if(ftpcode != 200) {
2094 /* the command failed */
2097 infof(data, "disabling EPRT usage\n");
2098 conn->bits.ftp_use_eprt = FALSE;
2103 failf(data, "Failed to do PORT");
2104 result = CURLE_FTP_PORT_FAILED;
2108 result = ftp_state_use_port(conn, fcmd);
2111 infof(data, "Connect data stream actively\n");
2112 state(conn, FTP_STOP); /* end of DO phase */
2113 result = ftp_dophase_done(conn, FALSE);
2119 static CURLcode ftp_state_mdtm_resp(struct connectdata *conn,
2122 CURLcode result = CURLE_OK;
2123 struct SessionHandle *data=conn->data;
2124 struct FTP *ftp = data->req.protop;
2125 struct ftp_conn *ftpc = &conn->proto.ftpc;
2130 /* we got a time. Format should be: "YYYYMMDDHHMMSS[.sss]" where the
2131 last .sss part is optional and means fractions of a second */
2132 int year, month, day, hour, minute, second;
2133 char *buf = data->state.buffer;
2134 if(6 == sscanf(buf+4, "%04d%02d%02d%02d%02d%02d",
2135 &year, &month, &day, &hour, &minute, &second)) {
2136 /* we have a time, reformat it */
2137 time_t secs=time(NULL);
2138 /* using the good old yacc/bison yuck */
2139 snprintf(buf, sizeof(conn->data->state.buffer),
2140 "%04d%02d%02d %02d:%02d:%02d GMT",
2141 year, month, day, hour, minute, second);
2142 /* now, convert this into a time() value: */
2143 data->info.filetime = (long)curl_getdate(buf, &secs);
2146 #ifdef CURL_FTP_HTTPSTYLE_HEAD
2147 /* If we asked for a time of the file and we actually got one as well,
2148 we "emulate" a HTTP-style header in our output. */
2150 if(data->set.opt_no_body &&
2152 data->set.get_filetime &&
2153 (data->info.filetime>=0) ) {
2154 time_t filetime = (time_t)data->info.filetime;
2156 const struct tm *tm = &buffer;
2158 result = Curl_gmtime(filetime, &buffer);
2162 /* format: "Tue, 15 Nov 1994 12:45:26" */
2163 snprintf(buf, BUFSIZE-1,
2164 "Last-Modified: %s, %02d %s %4d %02d:%02d:%02d GMT\r\n",
2165 Curl_wkday[tm->tm_wday?tm->tm_wday-1:6],
2167 Curl_month[tm->tm_mon],
2172 result = Curl_client_write(conn, CLIENTWRITE_BOTH, buf, 0);
2175 } /* end of a ridiculous amount of conditionals */
2180 infof(data, "unsupported MDTM reply format\n");
2182 case 550: /* "No such file or directory" */
2183 failf(data, "Given file does not exist");
2184 result = CURLE_FTP_COULDNT_RETR_FILE;
2188 if(data->set.timecondition) {
2189 if((data->info.filetime > 0) && (data->set.timevalue > 0)) {
2190 switch(data->set.timecondition) {
2191 case CURL_TIMECOND_IFMODSINCE:
2193 if(data->info.filetime <= data->set.timevalue) {
2194 infof(data, "The requested document is not new enough\n");
2195 ftp->transfer = FTPTRANSFER_NONE; /* mark to not transfer data */
2196 data->info.timecond = TRUE;
2197 state(conn, FTP_STOP);
2201 case CURL_TIMECOND_IFUNMODSINCE:
2202 if(data->info.filetime > data->set.timevalue) {
2203 infof(data, "The requested document is not old enough\n");
2204 ftp->transfer = FTPTRANSFER_NONE; /* mark to not transfer data */
2205 data->info.timecond = TRUE;
2206 state(conn, FTP_STOP);
2213 infof(data, "Skipping time comparison\n");
2218 result = ftp_state_type(conn);
2223 static CURLcode ftp_state_type_resp(struct connectdata *conn,
2227 CURLcode result = CURLE_OK;
2228 struct SessionHandle *data=conn->data;
2230 if(ftpcode/100 != 2) {
2231 /* "sasserftpd" and "(u)r(x)bot ftpd" both responds with 226 after a
2232 successful 'TYPE I'. While that is not as RFC959 says, it is still a
2233 positive response code and we allow that. */
2234 failf(data, "Couldn't set desired mode");
2235 return CURLE_FTP_COULDNT_SET_TYPE;
2238 infof(data, "Got a %03d response code instead of the assumed 200\n",
2241 if(instate == FTP_TYPE)
2242 result = ftp_state_size(conn);
2243 else if(instate == FTP_LIST_TYPE)
2244 result = ftp_state_list(conn);
2245 else if(instate == FTP_RETR_TYPE)
2246 result = ftp_state_retr_prequote(conn);
2247 else if(instate == FTP_STOR_TYPE)
2248 result = ftp_state_stor_prequote(conn);
2253 static CURLcode ftp_state_retr(struct connectdata *conn,
2254 curl_off_t filesize)
2256 CURLcode result = CURLE_OK;
2257 struct SessionHandle *data=conn->data;
2258 struct FTP *ftp = data->req.protop;
2259 struct ftp_conn *ftpc = &conn->proto.ftpc;
2261 if(data->set.max_filesize && (filesize > data->set.max_filesize)) {
2262 failf(data, "Maximum file size exceeded");
2263 return CURLE_FILESIZE_EXCEEDED;
2265 ftp->downloadsize = filesize;
2267 if(data->state.resume_from) {
2268 /* We always (attempt to) get the size of downloads, so it is done before
2269 this even when not doing resumes. */
2270 if(filesize == -1) {
2271 infof(data, "ftp server doesn't support SIZE\n");
2272 /* We couldn't get the size and therefore we can't know if there really
2273 is a part of the file left to get, although the server will just
2274 close the connection when we start the connection so it won't cause
2275 us any harm, just not make us exit as nicely. */
2278 /* We got a file size report, so we check that there actually is a
2279 part of the file left to get, or else we go home. */
2280 if(data->state.resume_from< 0) {
2281 /* We're supposed to download the last abs(from) bytes */
2282 if(filesize < -data->state.resume_from) {
2283 failf(data, "Offset (%" CURL_FORMAT_CURL_OFF_T
2284 ") was beyond file size (%" CURL_FORMAT_CURL_OFF_T ")",
2285 data->state.resume_from, filesize);
2286 return CURLE_BAD_DOWNLOAD_RESUME;
2288 /* convert to size to download */
2289 ftp->downloadsize = -data->state.resume_from;
2290 /* download from where? */
2291 data->state.resume_from = filesize - ftp->downloadsize;
2294 if(filesize < data->state.resume_from) {
2295 failf(data, "Offset (%" CURL_FORMAT_CURL_OFF_T
2296 ") was beyond file size (%" CURL_FORMAT_CURL_OFF_T ")",
2297 data->state.resume_from, filesize);
2298 return CURLE_BAD_DOWNLOAD_RESUME;
2300 /* Now store the number of bytes we are expected to download */
2301 ftp->downloadsize = filesize-data->state.resume_from;
2305 if(ftp->downloadsize == 0) {
2306 /* no data to transfer */
2307 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
2308 infof(data, "File already completely downloaded\n");
2310 /* Set ->transfer so that we won't get any error in ftp_done()
2311 * because we didn't transfer the any file */
2312 ftp->transfer = FTPTRANSFER_NONE;
2313 state(conn, FTP_STOP);
2317 /* Set resume file transfer offset */
2318 infof(data, "Instructs server to resume from offset %"
2319 CURL_FORMAT_CURL_OFF_T "\n", data->state.resume_from);
2321 PPSENDF(&ftpc->pp, "REST %" CURL_FORMAT_CURL_OFF_T,
2322 data->state.resume_from);
2324 state(conn, FTP_RETR_REST);
2328 PPSENDF(&ftpc->pp, "RETR %s", ftpc->file);
2329 state(conn, FTP_RETR);
2335 static CURLcode ftp_state_size_resp(struct connectdata *conn,
2339 CURLcode result = CURLE_OK;
2340 struct SessionHandle *data=conn->data;
2341 curl_off_t filesize;
2342 char *buf = data->state.buffer;
2344 /* get the size from the ascii string: */
2345 filesize = (ftpcode == 213)?curlx_strtoofft(buf+4, NULL, 0):-1;
2347 if(instate == FTP_SIZE) {
2348 #ifdef CURL_FTP_HTTPSTYLE_HEAD
2349 if(-1 != filesize) {
2350 snprintf(buf, sizeof(data->state.buffer),
2351 "Content-Length: %" CURL_FORMAT_CURL_OFF_T "\r\n", filesize);
2352 result = Curl_client_write(conn, CLIENTWRITE_BOTH, buf, 0);
2357 Curl_pgrsSetDownloadSize(data, filesize);
2358 result = ftp_state_rest(conn);
2360 else if(instate == FTP_RETR_SIZE) {
2361 Curl_pgrsSetDownloadSize(data, filesize);
2362 result = ftp_state_retr(conn, filesize);
2364 else if(instate == FTP_STOR_SIZE) {
2365 data->state.resume_from = filesize;
2366 result = ftp_state_ul_setup(conn, TRUE);
2372 static CURLcode ftp_state_rest_resp(struct connectdata *conn,
2376 CURLcode result = CURLE_OK;
2377 struct ftp_conn *ftpc = &conn->proto.ftpc;
2382 #ifdef CURL_FTP_HTTPSTYLE_HEAD
2383 if(ftpcode == 350) {
2384 char buffer[24]= { "Accept-ranges: bytes\r\n" };
2385 result = Curl_client_write(conn, CLIENTWRITE_BOTH, buffer, 0);
2390 result = ftp_state_prepare_transfer(conn);
2394 if(ftpcode != 350) {
2395 failf(conn->data, "Couldn't use REST");
2396 result = CURLE_FTP_COULDNT_USE_REST;
2399 PPSENDF(&ftpc->pp, "RETR %s", ftpc->file);
2400 state(conn, FTP_RETR);
2408 static CURLcode ftp_state_stor_resp(struct connectdata *conn,
2409 int ftpcode, ftpstate instate)
2411 CURLcode result = CURLE_OK;
2412 struct SessionHandle *data = conn->data;
2415 failf(data, "Failed FTP upload: %0d", ftpcode);
2416 state(conn, FTP_STOP);
2417 /* oops, we never close the sockets! */
2418 return CURLE_UPLOAD_FAILED;
2421 conn->proto.ftpc.state_saved = instate;
2423 /* PORT means we are now awaiting the server to connect to us. */
2424 if(data->set.ftp_use_port) {
2427 state(conn, FTP_STOP); /* no longer in STOR state */
2429 result = AllowServerConnect(conn, &connected);
2434 struct ftp_conn *ftpc = &conn->proto.ftpc;
2435 infof(data, "Data conn was not available immediately\n");
2436 ftpc->wait_data_conn = TRUE;
2442 return InitiateTransfer(conn);
2445 /* for LIST and RETR responses */
2446 static CURLcode ftp_state_get_resp(struct connectdata *conn,
2450 CURLcode result = CURLE_OK;
2451 struct SessionHandle *data = conn->data;
2452 struct FTP *ftp = data->req.protop;
2453 char *buf = data->state.buffer;
2455 if((ftpcode == 150) || (ftpcode == 125)) {
2459 150 Opening BINARY mode data connection for /etc/passwd (2241
2460 bytes). (ok, the file is being transferred)
2463 150 Opening ASCII mode data connection for /bin/ls
2466 150 ASCII data connection for /bin/ls (137.167.104.91,37445) (0 bytes).
2469 150 Opening ASCII mode data connection for [file] (0.0.0.0,0) (545 bytes)
2472 125 Data connection already open; Transfer starting. */
2474 curl_off_t size=-1; /* default unknown size */
2478 * It appears that there are FTP-servers that return size 0 for files when
2479 * SIZE is used on the file while being in BINARY mode. To work around
2480 * that (stupid) behavior, we attempt to parse the RETR response even if
2481 * the SIZE returned size zero.
2483 * Debugging help from Salvatore Sorrentino on February 26, 2003.
2486 if((instate != FTP_LIST) &&
2487 !data->set.prefer_ascii &&
2488 (ftp->downloadsize < 1)) {
2490 * It seems directory listings either don't show the size or very
2491 * often uses size 0 anyway. ASCII transfers may very well turn out
2492 * that the transferred amount of data is not the same as this line
2493 * tells, why using this number in those cases only confuses us.
2495 * Example D above makes this parsing a little tricky */
2497 bytes=strstr(buf, " bytes");
2499 long in=(long)(bytes-buf);
2500 /* this is a hint there is size information in there! ;-) */
2502 /* scan for the left parenthesis and break there */
2505 /* skip only digits */
2506 if(!ISDIGIT(*bytes)) {
2510 /* one more estep backwards */
2513 /* if we have nothing but digits: */
2515 /* get the number! */
2516 size = curlx_strtoofft(bytes, NULL, 0);
2520 else if(ftp->downloadsize > -1)
2521 size = ftp->downloadsize;
2523 if(size > data->req.maxdownload && data->req.maxdownload > 0)
2524 size = data->req.size = data->req.maxdownload;
2525 else if((instate != FTP_LIST) && (data->set.prefer_ascii))
2526 size = -1; /* kludge for servers that understate ASCII mode file size */
2528 infof(data, "Maxdownload = %" CURL_FORMAT_CURL_OFF_T "\n",
2529 data->req.maxdownload);
2531 if(instate != FTP_LIST)
2532 infof(data, "Getting file with size: %" CURL_FORMAT_CURL_OFF_T "\n",
2536 conn->proto.ftpc.state_saved = instate;
2537 conn->proto.ftpc.retr_size_saved = size;
2539 if(data->set.ftp_use_port) {
2542 result = AllowServerConnect(conn, &connected);
2547 struct ftp_conn *ftpc = &conn->proto.ftpc;
2548 infof(data, "Data conn was not available immediately\n");
2549 state(conn, FTP_STOP);
2550 ftpc->wait_data_conn = TRUE;
2554 return InitiateTransfer(conn);
2557 if((instate == FTP_LIST) && (ftpcode == 450)) {
2558 /* simply no matching files in the dir listing */
2559 ftp->transfer = FTPTRANSFER_NONE; /* don't download anything */
2560 state(conn, FTP_STOP); /* this phase is over */
2563 failf(data, "RETR response: %03d", ftpcode);
2564 return instate == FTP_RETR && ftpcode == 550?
2565 CURLE_REMOTE_FILE_NOT_FOUND:
2566 CURLE_FTP_COULDNT_RETR_FILE;
2573 /* after USER, PASS and ACCT */
2574 static CURLcode ftp_state_loggedin(struct connectdata *conn)
2576 CURLcode result = CURLE_OK;
2578 if(conn->ssl[FIRSTSOCKET].use) {
2579 /* PBSZ = PROTECTION BUFFER SIZE.
2581 The 'draft-murray-auth-ftp-ssl' (draft 12, page 7) says:
2583 Specifically, the PROT command MUST be preceded by a PBSZ
2584 command and a PBSZ command MUST be preceded by a successful
2585 security data exchange (the TLS negotiation in this case)
2587 ... (and on page 8):
2589 Thus the PBSZ command must still be issued, but must have a
2590 parameter of '0' to indicate that no buffering is taking place
2591 and the data connection should not be encapsulated.
2593 PPSENDF(&conn->proto.ftpc.pp, "PBSZ %d", 0);
2594 state(conn, FTP_PBSZ);
2597 result = ftp_state_pwd(conn);
2602 /* for USER and PASS responses */
2603 static CURLcode ftp_state_user_resp(struct connectdata *conn,
2607 CURLcode result = CURLE_OK;
2608 struct SessionHandle *data = conn->data;
2609 struct FTP *ftp = data->req.protop;
2610 struct ftp_conn *ftpc = &conn->proto.ftpc;
2611 (void)instate; /* no use for this yet */
2613 /* some need password anyway, and others just return 2xx ignored */
2614 if((ftpcode == 331) && (ftpc->state == FTP_USER)) {
2615 /* 331 Password required for ...
2616 (the server requires to send the user's password too) */
2617 PPSENDF(&ftpc->pp, "PASS %s", ftp->passwd?ftp->passwd:"");
2618 state(conn, FTP_PASS);
2620 else if(ftpcode/100 == 2) {
2621 /* 230 User ... logged in.
2622 (the user logged in with or without password) */
2623 result = ftp_state_loggedin(conn);
2625 else if(ftpcode == 332) {
2626 if(data->set.str[STRING_FTP_ACCOUNT]) {
2627 PPSENDF(&ftpc->pp, "ACCT %s", data->set.str[STRING_FTP_ACCOUNT]);
2628 state(conn, FTP_ACCT);
2631 failf(data, "ACCT requested but none available");
2632 result = CURLE_LOGIN_DENIED;
2636 /* All other response codes, like:
2638 530 User ... access denied
2639 (the server denies to log the specified user) */
2641 if(conn->data->set.str[STRING_FTP_ALTERNATIVE_TO_USER] &&
2642 !conn->data->state.ftp_trying_alternative) {
2643 /* Ok, USER failed. Let's try the supplied command. */
2644 PPSENDF(&conn->proto.ftpc.pp, "%s",
2645 conn->data->set.str[STRING_FTP_ALTERNATIVE_TO_USER]);
2646 conn->data->state.ftp_trying_alternative = TRUE;
2647 state(conn, FTP_USER);
2651 failf(data, "Access denied: %03d", ftpcode);
2652 result = CURLE_LOGIN_DENIED;
2658 /* for ACCT response */
2659 static CURLcode ftp_state_acct_resp(struct connectdata *conn,
2662 CURLcode result = CURLE_OK;
2663 struct SessionHandle *data = conn->data;
2664 if(ftpcode != 230) {
2665 failf(data, "ACCT rejected by server: %03d", ftpcode);
2666 result = CURLE_FTP_WEIRD_PASS_REPLY; /* FIX */
2669 result = ftp_state_loggedin(conn);
2675 static CURLcode ftp_statemach_act(struct connectdata *conn)
2678 curl_socket_t sock = conn->sock[FIRSTSOCKET];
2679 struct SessionHandle *data=conn->data;
2681 struct ftp_conn *ftpc = &conn->proto.ftpc;
2682 struct pingpong *pp = &ftpc->pp;
2683 static const char ftpauth[][4] = { "SSL", "TLS" };
2687 return Curl_pp_flushsend(pp);
2689 result = ftp_readresp(sock, pp, &ftpcode, &nread);
2694 /* we have now received a full FTP server response */
2695 switch(ftpc->state) {
2698 /* 230 User logged in - already! */
2699 return ftp_state_user_resp(conn, ftpcode, ftpc->state);
2700 else if(ftpcode != 220) {
2701 failf(data, "Got a %03d ftp-server response when 220 was expected",
2703 return CURLE_FTP_WEIRD_SERVER_REPLY;
2706 /* We have received a 220 response fine, now we proceed. */
2709 /* If not anonymous login, try a secure login. Note that this
2710 procedure is still BLOCKING. */
2712 Curl_sec_request_prot(conn, "private");
2713 /* We set private first as default, in case the line below fails to
2714 set a valid level */
2715 Curl_sec_request_prot(conn, data->set.str[STRING_KRB_LEVEL]);
2717 if(Curl_sec_login(conn) != CURLE_OK)
2718 infof(data, "Logging in with password in cleartext!\n");
2720 infof(data, "Authentication successful\n");
2724 if(data->set.use_ssl && !conn->ssl[FIRSTSOCKET].use) {
2725 /* We don't have a SSL/TLS connection yet, but FTPS is
2726 requested. Try a FTPS connection now */
2729 switch(data->set.ftpsslauth) {
2730 case CURLFTPAUTH_DEFAULT:
2731 case CURLFTPAUTH_SSL:
2732 ftpc->count2 = 1; /* add one to get next */
2735 case CURLFTPAUTH_TLS:
2736 ftpc->count2 = -1; /* subtract one to get next */
2740 failf(data, "unsupported parameter to CURLOPT_FTPSSLAUTH: %d",
2741 (int)data->set.ftpsslauth);
2742 return CURLE_UNKNOWN_OPTION; /* we don't know what to do */
2744 PPSENDF(&ftpc->pp, "AUTH %s", ftpauth[ftpc->count1]);
2745 state(conn, FTP_AUTH);
2748 result = ftp_state_user(conn);
2756 /* we have gotten the response to a previous AUTH command */
2758 /* RFC2228 (page 5) says:
2760 * If the server is willing to accept the named security mechanism,
2761 * and does not require any security data, it must respond with
2762 * reply code 234/334.
2765 if((ftpcode == 234) || (ftpcode == 334)) {
2766 /* Curl_ssl_connect is BLOCKING */
2767 result = Curl_ssl_connect(conn, FIRSTSOCKET);
2768 if(CURLE_OK == result) {
2769 conn->ssl[SECONDARYSOCKET].use = FALSE; /* clear-text data */
2770 result = ftp_state_user(conn);
2773 else if(ftpc->count3 < 1) {
2775 ftpc->count1 += ftpc->count2; /* get next attempt */
2776 result = Curl_pp_sendf(&ftpc->pp, "AUTH %s", ftpauth[ftpc->count1]);
2777 /* remain in this same state */
2780 if(data->set.use_ssl > CURLUSESSL_TRY)
2781 /* we failed and CURLUSESSL_CONTROL or CURLUSESSL_ALL is set */
2782 result = CURLE_USE_SSL_FAILED;
2784 /* ignore the failure and continue */
2785 result = ftp_state_user(conn);
2794 result = ftp_state_user_resp(conn, ftpcode, ftpc->state);
2798 result = ftp_state_acct_resp(conn, ftpcode);
2802 PPSENDF(&ftpc->pp, "PROT %c",
2803 data->set.use_ssl == CURLUSESSL_CONTROL ? 'C' : 'P');
2804 state(conn, FTP_PROT);
2809 if(ftpcode/100 == 2)
2810 /* We have enabled SSL for the data connection! */
2811 conn->ssl[SECONDARYSOCKET].use =
2812 (data->set.use_ssl != CURLUSESSL_CONTROL) ? TRUE : FALSE;
2813 /* FTP servers typically responds with 500 if they decide to reject
2815 else if(data->set.use_ssl > CURLUSESSL_CONTROL)
2816 /* we failed and bails out */
2817 return CURLE_USE_SSL_FAILED;
2819 if(data->set.ftp_ccc) {
2820 /* CCC - Clear Command Channel
2822 PPSENDF(&ftpc->pp, "%s", "CCC");
2823 state(conn, FTP_CCC);
2826 result = ftp_state_pwd(conn);
2834 /* First shut down the SSL layer (note: this call will block) */
2835 result = Curl_ssl_shutdown(conn, FIRSTSOCKET);
2838 failf(conn->data, "Failed to clear the command channel (CCC)");
2843 /* Then continue as normal */
2844 result = ftp_state_pwd(conn);
2850 if(ftpcode == 257) {
2851 char *ptr=&data->state.buffer[4]; /* start on the first letter */
2855 dir = malloc(nread + 1);
2857 return CURLE_OUT_OF_MEMORY;
2859 /* Reply format is like
2860 257<space>[rubbish]"<directory-name>"<space><commentary> and the
2863 The directory name can contain any character; embedded
2864 double-quotes should be escaped by double-quotes (the
2865 "quote-doubling" convention).
2868 /* scan for the first double-quote for non-standard responses */
2869 while(ptr < &data->state.buffer[sizeof(data->state.buffer)]
2870 && *ptr != '\n' && *ptr != '\0' && *ptr != '"')
2874 /* it started good */
2876 for(store = dir; *ptr;) {
2878 if('\"' == ptr[1]) {
2879 /* "quote-doubling" */
2885 *store = '\0'; /* zero terminate */
2886 break; /* get out of this loop */
2895 /* If the path name does not look like an absolute path (i.e.: it
2896 does not start with a '/'), we probably need some server-dependent
2897 adjustments. For example, this is the case when connecting to
2898 an OS400 FTP server: this server supports two name syntaxes,
2899 the default one being incompatible with standard pathes. In
2900 addition, this server switches automatically to the regular path
2901 syntax when one is encountered in a command: this results in
2902 having an entrypath in the wrong syntax when later used in CWD.
2903 The method used here is to check the server OS: we do it only
2904 if the path name looks strange to minimize overhead on other
2907 if(!ftpc->server_os && dir[0] != '/') {
2909 result = Curl_pp_sendf(&ftpc->pp, "%s", "SYST");
2910 if(result != CURLE_OK) {
2914 Curl_safefree(ftpc->entrypath);
2915 ftpc->entrypath = dir; /* remember this */
2916 infof(data, "Entry path is '%s'\n", ftpc->entrypath);
2917 /* also save it where getinfo can access it: */
2918 data->state.most_recent_ftp_entrypath = ftpc->entrypath;
2919 state(conn, FTP_SYST);
2923 Curl_safefree(ftpc->entrypath);
2924 ftpc->entrypath = dir; /* remember this */
2925 infof(data, "Entry path is '%s'\n", ftpc->entrypath);
2926 /* also save it where getinfo can access it: */
2927 data->state.most_recent_ftp_entrypath = ftpc->entrypath;
2930 /* couldn't get the path */
2932 infof(data, "Failed to figure out path\n");
2935 state(conn, FTP_STOP); /* we are done with the CONNECT phase! */
2936 DEBUGF(infof(data, "protocol connect phase DONE\n"));
2940 if(ftpcode == 215) {
2941 char *ptr=&data->state.buffer[4]; /* start on the first letter */
2945 os = malloc(nread + 1);
2947 return CURLE_OUT_OF_MEMORY;
2949 /* Reply format is like
2950 215<space><OS-name><space><commentary>
2954 for(store = os; *ptr && *ptr != ' ';)
2956 *store = '\0'; /* zero terminate */
2958 /* Check for special servers here. */
2960 if(strequal(os, "OS/400")) {
2961 /* Force OS400 name format 1. */
2962 result = Curl_pp_sendf(&ftpc->pp, "%s", "SITE NAMEFMT 1");
2963 if(result != CURLE_OK) {
2967 /* remember target server OS */
2968 Curl_safefree(ftpc->server_os);
2969 ftpc->server_os = os;
2970 state(conn, FTP_NAMEFMT);
2974 /* Nothing special for the target server. */
2975 /* remember target server OS */
2976 Curl_safefree(ftpc->server_os);
2977 ftpc->server_os = os;
2981 /* Cannot identify server OS. Continue anyway and cross fingers. */
2984 state(conn, FTP_STOP); /* we are done with the CONNECT phase! */
2985 DEBUGF(infof(data, "protocol connect phase DONE\n"));
2989 if(ftpcode == 250) {
2990 /* Name format change successful: reload initial path. */
2991 ftp_state_pwd(conn);
2995 state(conn, FTP_STOP); /* we are done with the CONNECT phase! */
2996 DEBUGF(infof(data, "protocol connect phase DONE\n"));
3001 case FTP_RETR_PREQUOTE:
3002 case FTP_STOR_PREQUOTE:
3003 if((ftpcode >= 400) && !ftpc->count2) {
3004 /* failure response code, and not allowed to fail */
3005 failf(conn->data, "QUOT command failed with %03d", ftpcode);
3006 return CURLE_QUOTE_ERROR;
3008 result = ftp_state_quote(conn, FALSE, ftpc->state);
3015 if(ftpcode/100 != 2) {
3016 /* failure to CWD there */
3017 if(conn->data->set.ftp_create_missing_dirs &&
3018 ftpc->count1 && !ftpc->count2) {
3020 ftpc->count2++; /* counter to prevent CWD-MKD loops */
3021 PPSENDF(&ftpc->pp, "MKD %s", ftpc->dirs[ftpc->count1 - 1]);
3022 state(conn, FTP_MKD);
3025 /* return failure */
3026 failf(data, "Server denied you to change to the given directory");
3027 ftpc->cwdfail = TRUE; /* don't remember this path as we failed
3029 return CURLE_REMOTE_ACCESS_DENIED;
3035 if(++ftpc->count1 <= ftpc->dirdepth) {
3037 PPSENDF(&ftpc->pp, "CWD %s", ftpc->dirs[ftpc->count1 - 1]);
3040 result = ftp_state_mdtm(conn);
3048 if((ftpcode/100 != 2) && !ftpc->count3--) {
3049 /* failure to MKD the dir */
3050 failf(data, "Failed to MKD dir: %03d", ftpcode);
3051 return CURLE_REMOTE_ACCESS_DENIED;
3053 state(conn, FTP_CWD);
3055 PPSENDF(&ftpc->pp, "CWD %s", ftpc->dirs[ftpc->count1 - 1]);
3059 result = ftp_state_mdtm_resp(conn, ftpcode);
3066 result = ftp_state_type_resp(conn, ftpcode, ftpc->state);
3072 result = ftp_state_size_resp(conn, ftpcode, ftpc->state);
3077 result = ftp_state_rest_resp(conn, ftpcode, ftpc->state);
3081 if(ftpcode != 200) {
3082 /* there only is this one standard OK return code. */
3083 failf(data, "PRET command not accepted: %03d", ftpcode);
3084 return CURLE_FTP_PRET_FAILED;
3086 result = ftp_state_use_pasv(conn);
3090 result = ftp_state_pasv_resp(conn, ftpcode);
3094 result = ftp_state_port_resp(conn, ftpcode);
3099 result = ftp_state_get_resp(conn, ftpcode, ftpc->state);
3103 result = ftp_state_stor_resp(conn, ftpcode, ftpc->state);
3107 /* fallthrough, just stop! */
3109 /* internal error */
3110 state(conn, FTP_STOP);
3119 /* called repeatedly until done from multi.c */
3120 static CURLcode ftp_multi_statemach(struct connectdata *conn,
3123 struct ftp_conn *ftpc = &conn->proto.ftpc;
3124 CURLcode result = Curl_pp_statemach(&ftpc->pp, FALSE);
3126 /* Check for the state outside of the Curl_socket_ready() return code checks
3127 since at times we are in fact already in this state when this function
3129 *done = (ftpc->state == FTP_STOP) ? TRUE : FALSE;
3134 static CURLcode ftp_block_statemach(struct connectdata *conn)
3136 struct ftp_conn *ftpc = &conn->proto.ftpc;
3137 struct pingpong *pp = &ftpc->pp;
3138 CURLcode result = CURLE_OK;
3140 while(ftpc->state != FTP_STOP) {
3141 result = Curl_pp_statemach(pp, TRUE);
3150 * ftp_connect() should do everything that is to be considered a part of
3151 * the connection phase.
3153 * The variable 'done' points to will be TRUE if the protocol-layer connect
3154 * phase is done when this function returns, or FALSE if not.
3157 static CURLcode ftp_connect(struct connectdata *conn,
3158 bool *done) /* see description above */
3161 struct ftp_conn *ftpc = &conn->proto.ftpc;
3162 struct pingpong *pp = &ftpc->pp;
3164 *done = FALSE; /* default to not done yet */
3166 /* We always support persistent connections on ftp */
3167 connkeep(conn, "FTP default");
3169 pp->response_time = RESP_TIMEOUT; /* set default response time-out */
3170 pp->statemach_act = ftp_statemach_act;
3171 pp->endofresp = ftp_endofresp;
3174 if(conn->handler->flags & PROTOPT_SSL) {
3176 result = Curl_ssl_connect(conn, FIRSTSOCKET);
3181 Curl_pp_init(pp); /* init the generic pingpong data */
3183 /* When we connect, we start in the state where we await the 220
3185 state(conn, FTP_WAIT220);
3187 result = ftp_multi_statemach(conn, done);
3192 /***********************************************************************
3196 * The DONE function. This does what needs to be done after a single DO has
3199 * Input argument is already checked for validity.
3201 static CURLcode ftp_done(struct connectdata *conn, CURLcode status,
3204 struct SessionHandle *data = conn->data;
3205 struct FTP *ftp = data->req.protop;
3206 struct ftp_conn *ftpc = &conn->proto.ftpc;
3207 struct pingpong *pp = &ftpc->pp;
3210 CURLcode result = CURLE_OK;
3211 bool was_ctl_valid = ftpc->ctl_valid;
3213 const char *path_to_use = data->state.path;
3216 /* When the easy handle is removed from the multi while libcurl is still
3217 * trying to resolve the host name, it seems that the ftp struct is not
3218 * yet initialized, but the removal action calls Curl_done() which calls
3219 * this function. So we simply return success if no ftp pointer is set.
3224 case CURLE_BAD_DOWNLOAD_RESUME:
3225 case CURLE_FTP_WEIRD_PASV_REPLY:
3226 case CURLE_FTP_PORT_FAILED:
3227 case CURLE_FTP_ACCEPT_FAILED:
3228 case CURLE_FTP_ACCEPT_TIMEOUT:
3229 case CURLE_FTP_COULDNT_SET_TYPE:
3230 case CURLE_FTP_COULDNT_RETR_FILE:
3231 case CURLE_PARTIAL_FILE:
3232 case CURLE_UPLOAD_FAILED:
3233 case CURLE_REMOTE_ACCESS_DENIED:
3234 case CURLE_FILESIZE_EXCEEDED:
3235 case CURLE_REMOTE_FILE_NOT_FOUND:
3236 case CURLE_WRITE_ERROR:
3237 /* the connection stays alive fine even though this happened */
3239 case CURLE_OK: /* doesn't affect the control connection's status */
3241 ftpc->ctl_valid = was_ctl_valid;
3244 /* until we cope better with prematurely ended requests, let them
3245 * fallback as if in complete failure */
3246 default: /* by default, an error means the control connection is
3247 wedged and should not be used anymore */
3248 ftpc->ctl_valid = FALSE;
3249 ftpc->cwdfail = TRUE; /* set this TRUE to prevent us to remember the
3250 current path, as this connection is going */
3251 connclose(conn, "FTP ended with bad error code");
3252 result = status; /* use the already set error code */
3256 /* now store a copy of the directory we are in */
3258 free(ftpc->prevpath);
3260 if(data->set.wildcardmatch) {
3261 if(data->set.chunk_end && ftpc->file) {
3262 data->set.chunk_end(data->wildcard.customptr);
3264 ftpc->known_filesize = -1;
3267 /* get the "raw" path */
3268 path = curl_easy_unescape(data, path_to_use, 0, NULL);
3270 /* out of memory, but we can limp along anyway (and should try to
3271 * since we may already be in the out of memory cleanup path) */
3273 result = CURLE_OUT_OF_MEMORY;
3274 ftpc->ctl_valid = FALSE; /* mark control connection as bad */
3275 connclose(conn, "FTP: out of memory!"); /* mark for connection closure */
3276 ftpc->prevpath = NULL; /* no path remembering */
3279 size_t flen = ftpc->file?strlen(ftpc->file):0; /* file is "raw" already */
3280 size_t dlen = strlen(path)-flen;
3281 if(!ftpc->cwdfail) {
3282 if(dlen && (data->set.ftp_filemethod != FTPFILE_NOCWD)) {
3283 ftpc->prevpath = path;
3285 /* if 'path' is not the whole string */
3286 ftpc->prevpath[dlen]=0; /* terminate */
3289 /* we never changed dir */
3290 ftpc->prevpath=strdup("");
3294 infof(data, "Remembering we are in dir \"%s\"\n", ftpc->prevpath);
3297 ftpc->prevpath = NULL; /* no path */
3301 /* free the dir tree and file parts */
3304 /* shut down the socket to inform the server we're done */
3307 shutdown(conn->sock[SECONDARYSOCKET],2); /* SD_BOTH */
3310 if(conn->sock[SECONDARYSOCKET] != CURL_SOCKET_BAD) {
3311 if(!result && ftpc->dont_check && data->req.maxdownload > 0) {
3312 /* partial download completed */
3313 result = Curl_pp_sendf(pp, "%s", "ABOR");
3315 failf(data, "Failure sending ABOR command: %s",
3316 curl_easy_strerror(result));
3317 ftpc->ctl_valid = FALSE; /* mark control connection as bad */
3318 connclose(conn, "ABOR command failed"); /* connection closure */
3322 if(conn->ssl[SECONDARYSOCKET].use) {
3323 /* The secondary socket is using SSL so we must close down that part
3324 first before we close the socket for real */
3325 Curl_ssl_close(conn, SECONDARYSOCKET);
3327 /* Note that we keep "use" set to TRUE since that (next) connection is
3328 still requested to use SSL */
3330 if(CURL_SOCKET_BAD != conn->sock[SECONDARYSOCKET]) {
3331 Curl_closesocket(conn, conn->sock[SECONDARYSOCKET]);
3332 conn->sock[SECONDARYSOCKET] = CURL_SOCKET_BAD;
3333 conn->bits.tcpconnect[SECONDARYSOCKET] = FALSE;
3337 if(!result && (ftp->transfer == FTPTRANSFER_BODY) && ftpc->ctl_valid &&
3338 pp->pending_resp && !premature) {
3340 * Let's see what the server says about the transfer we just performed,
3341 * but lower the timeout as sometimes this connection has died while the
3342 * data has been transferred. This happens when doing through NATs etc that
3343 * abandon old silent connections.
3345 long old_time = pp->response_time;
3347 pp->response_time = 60*1000; /* give it only a minute for now */
3348 pp->response = Curl_tvnow(); /* timeout relative now */
3350 result = Curl_GetFTPResponse(&nread, conn, &ftpcode);
3352 pp->response_time = old_time; /* set this back to previous value */
3354 if(!nread && (CURLE_OPERATION_TIMEDOUT == result)) {
3355 failf(data, "control connection looks dead");
3356 ftpc->ctl_valid = FALSE; /* mark control connection as bad */
3357 connclose(conn, "Timeout or similar in FTP DONE operation"); /* close */
3363 if(ftpc->dont_check && data->req.maxdownload > 0) {
3364 /* we have just sent ABOR and there is no reliable way to check if it was
3365 * successful or not; we have to close the connection now */
3366 infof(data, "partial download completed, closing connection\n");
3367 connclose(conn, "Partial download with no ability to check");
3371 if(!ftpc->dont_check) {
3372 /* 226 Transfer complete, 250 Requested file action okay, completed. */
3373 if((ftpcode != 226) && (ftpcode != 250)) {
3374 failf(data, "server did not report OK, got %d", ftpcode);
3375 result = CURLE_PARTIAL_FILE;
3380 if(result || premature)
3381 /* the response code from the transfer showed an error already so no
3382 use checking further */
3384 else if(data->set.upload) {
3385 if((-1 != data->state.infilesize) &&
3386 (data->state.infilesize != *ftp->bytecountp) &&
3388 (ftp->transfer == FTPTRANSFER_BODY)) {
3389 failf(data, "Uploaded unaligned file size (%" CURL_FORMAT_CURL_OFF_T
3390 " out of %" CURL_FORMAT_CURL_OFF_T " bytes)",
3391 *ftp->bytecountp, data->state.infilesize);
3392 result = CURLE_PARTIAL_FILE;
3396 if((-1 != data->req.size) &&
3397 (data->req.size != *ftp->bytecountp) &&
3398 #ifdef CURL_DO_LINEEND_CONV
3399 /* Most FTP servers don't adjust their file SIZE response for CRLFs, so
3400 * we'll check to see if the discrepancy can be explained by the number
3401 * of CRLFs we've changed to LFs.
3403 ((data->req.size + data->state.crlf_conversions) !=
3404 *ftp->bytecountp) &&
3405 #endif /* CURL_DO_LINEEND_CONV */
3406 (data->req.maxdownload != *ftp->bytecountp)) {
3407 failf(data, "Received only partial file: %" CURL_FORMAT_CURL_OFF_T
3408 " bytes", *ftp->bytecountp);
3409 result = CURLE_PARTIAL_FILE;
3411 else if(!ftpc->dont_check &&
3412 !*ftp->bytecountp &&
3413 (data->req.size>0)) {
3414 failf(data, "No data was received!");
3415 result = CURLE_FTP_COULDNT_RETR_FILE;
3419 /* clear these for next connection */
3420 ftp->transfer = FTPTRANSFER_BODY;
3421 ftpc->dont_check = FALSE;
3423 /* Send any post-transfer QUOTE strings? */
3424 if(!status && !result && !premature && data->set.postquote)
3425 result = ftp_sendquote(conn, data->set.postquote);
3430 /***********************************************************************
3434 * Where a 'quote' means a list of custom commands to send to the server.
3435 * The quote list is passed as an argument.
3441 CURLcode ftp_sendquote(struct connectdata *conn, struct curl_slist *quote)
3443 struct curl_slist *item;
3447 struct ftp_conn *ftpc = &conn->proto.ftpc;
3448 struct pingpong *pp = &ftpc->pp;
3453 char *cmd = item->data;
3454 bool acceptfail = FALSE;
3456 /* if a command starts with an asterisk, which a legal FTP command never
3457 can, the command will be allowed to fail without it causing any
3458 aborts or cancels etc. It will cause libcurl to act as if the command
3459 is successful, whatever the server reponds. */
3466 PPSENDF(&conn->proto.ftpc.pp, "%s", cmd);
3468 pp->response = Curl_tvnow(); /* timeout relative now */
3470 result = Curl_GetFTPResponse(&nread, conn, &ftpcode);
3474 if(!acceptfail && (ftpcode >= 400)) {
3475 failf(conn->data, "QUOT string not accepted: %s", cmd);
3476 return CURLE_QUOTE_ERROR;
3486 /***********************************************************************
3490 * Returns TRUE if we in the current situation should send TYPE
3492 static int ftp_need_type(struct connectdata *conn,
3495 return conn->proto.ftpc.transfertype != (ascii_wanted?'A':'I');
3498 /***********************************************************************
3502 * Set TYPE. We only deal with ASCII or BINARY so this function
3504 * If the transfer type is not sent, simulate on OK response in newstate
3506 static CURLcode ftp_nb_type(struct connectdata *conn,
3507 bool ascii, ftpstate newstate)
3509 struct ftp_conn *ftpc = &conn->proto.ftpc;
3511 char want = (char)(ascii?'A':'I');
3513 if(ftpc->transfertype == want) {
3514 state(conn, newstate);
3515 return ftp_state_type_resp(conn, 200, newstate);
3518 PPSENDF(&ftpc->pp, "TYPE %c", want);
3519 state(conn, newstate);
3521 /* keep track of our current transfer type */
3522 ftpc->transfertype = want;
3526 /***************************************************************************
3528 * ftp_pasv_verbose()
3530 * This function only outputs some informationals about this second connection
3531 * when we've issued a PASV command before and thus we have connected to a
3532 * possibly new IP address.
3535 #ifndef CURL_DISABLE_VERBOSE_STRINGS
3537 ftp_pasv_verbose(struct connectdata *conn,
3539 char *newhost, /* ascii version */
3543 Curl_printable_address(ai, buf, sizeof(buf));
3544 infof(conn->data, "Connecting to %s (%s) port %d\n", newhost, buf, port);
3549 Check if this is a range download, and if so, set the internal variables
3553 static CURLcode ftp_range(struct connectdata *conn)
3555 curl_off_t from, to;
3558 struct SessionHandle *data = conn->data;
3559 struct ftp_conn *ftpc = &conn->proto.ftpc;
3561 if(data->state.use_range && data->state.range) {
3562 from=curlx_strtoofft(data->state.range, &ptr, 0);
3563 while(*ptr && (ISSPACE(*ptr) || (*ptr=='-')))
3565 to=curlx_strtoofft(ptr, &ptr2, 0);
3567 /* we didn't get any digit */
3570 if((-1 == to) && (from>=0)) {
3572 data->state.resume_from = from;
3573 DEBUGF(infof(conn->data, "FTP RANGE %" CURL_FORMAT_CURL_OFF_T
3574 " to end of file\n", from));
3578 data->req.maxdownload = -from;
3579 data->state.resume_from = from;
3580 DEBUGF(infof(conn->data, "FTP RANGE the last %" CURL_FORMAT_CURL_OFF_T
3581 " bytes\n", -from));
3585 data->req.maxdownload = (to-from)+1; /* include last byte */
3586 data->state.resume_from = from;
3587 DEBUGF(infof(conn->data, "FTP RANGE from %" CURL_FORMAT_CURL_OFF_T
3588 " getting %" CURL_FORMAT_CURL_OFF_T " bytes\n",
3589 from, data->req.maxdownload));
3591 DEBUGF(infof(conn->data, "range-download from %" CURL_FORMAT_CURL_OFF_T
3592 " to %" CURL_FORMAT_CURL_OFF_T ", totally %"
3593 CURL_FORMAT_CURL_OFF_T " bytes\n",
3594 from, to, data->req.maxdownload));
3595 ftpc->dont_check = TRUE; /* dont check for successful transfer */
3598 data->req.maxdownload = -1;
3606 * This function shall be called when the second FTP (data) connection is
3609 * 'complete' can return 0 for incomplete, 1 for done and -1 for go back
3610 * (which basically is only for when PASV is being sent to retry a failed
3614 static CURLcode ftp_do_more(struct connectdata *conn, int *completep)
3616 struct SessionHandle *data=conn->data;
3617 struct ftp_conn *ftpc = &conn->proto.ftpc;
3618 CURLcode result = CURLE_OK;
3619 bool connected = FALSE;
3620 bool complete = FALSE;
3622 /* the ftp struct is inited in ftp_connect() */
3623 struct FTP *ftp = data->req.protop;
3625 /* if the second connection isn't done yet, wait for it */
3626 if(!conn->bits.tcpconnect[SECONDARYSOCKET]) {
3627 if(conn->tunnel_state[SECONDARYSOCKET] == TUNNEL_CONNECT) {
3628 /* As we're in TUNNEL_CONNECT state now, we know the proxy name and port
3629 aren't used so we blank their arguments. TODO: make this nicer */
3630 result = Curl_proxyCONNECT(conn, SECONDARYSOCKET, NULL, 0);
3635 result = Curl_is_connected(conn, SECONDARYSOCKET, &connected);
3637 /* Ready to do more? */
3639 DEBUGF(infof(data, "DO-MORE connected phase starts\n"));
3640 if(conn->bits.proxy) {
3641 infof(data, "Connection to proxy confirmed\n");
3642 result = proxy_magic(conn, ftpc->newhost, ftpc->newport, &connected);
3646 if(result && (ftpc->count1 == 0)) {
3647 *completep = -1; /* go back to DOING please */
3648 /* this is a EPSV connect failing, try PASV instead */
3649 return ftp_epsv_disable(conn);
3656 /* already in a state so skip the intial commands.
3657 They are only done to kickstart the do_more state */
3658 result = ftp_multi_statemach(conn, &complete);
3660 *completep = (int)complete;
3662 /* if we got an error or if we don't wait for a data connection return
3664 if(result || (ftpc->wait_data_conn != TRUE))
3667 if(ftpc->wait_data_conn)
3668 /* if we reach the end of the FTP state machine here, *complete will be
3669 TRUE but so is ftpc->wait_data_conn, which says we need to wait for
3670 the data connection and therefore we're not actually complete */
3674 if(ftp->transfer <= FTPTRANSFER_INFO) {
3675 /* a transfer is about to take place, or if not a file name was given
3676 so we'll do a SIZE on it later and then we need the right TYPE first */
3678 if(ftpc->wait_data_conn == TRUE) {
3681 result = ReceivedServerConnect(conn, &serv_conned);
3683 return result; /* Failed to accept data connection */
3686 /* It looks data connection is established */
3687 result = AcceptServerConnect(conn);
3688 ftpc->wait_data_conn = FALSE;
3690 result = InitiateTransfer(conn);
3695 *completep = 1; /* this state is now complete when the server has
3696 connected back to us */
3699 else if(data->set.upload) {
3700 result = ftp_nb_type(conn, data->set.prefer_ascii, FTP_STOR_TYPE);
3704 result = ftp_multi_statemach(conn, &complete);
3705 *completep = (int)complete;
3709 ftp->downloadsize = -1; /* unknown as of yet */
3711 result = ftp_range(conn);
3714 else if(data->set.ftp_list_only || !ftpc->file) {
3715 /* The specified path ends with a slash, and therefore we think this
3716 is a directory that is requested, use LIST. But before that we
3717 need to set ASCII transfer mode. */
3719 /* But only if a body transfer was requested. */
3720 if(ftp->transfer == FTPTRANSFER_BODY) {
3721 result = ftp_nb_type(conn, TRUE, FTP_LIST_TYPE);
3725 /* otherwise just fall through */
3728 result = ftp_nb_type(conn, data->set.prefer_ascii, FTP_RETR_TYPE);
3733 result = ftp_multi_statemach(conn, &complete);
3734 *completep = (int)complete;
3739 if((result == CURLE_OK) && (ftp->transfer != FTPTRANSFER_BODY))
3740 /* no data to transfer. FIX: it feels like a kludge to have this here
3742 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
3744 if(!ftpc->wait_data_conn) {
3745 /* no waiting for the data connection so this is now complete */
3747 DEBUGF(infof(data, "DO-MORE phase ends with %d\n", (int)result));
3755 /***********************************************************************
3759 * This is the actual DO function for FTP. Get a file/directory according to
3760 * the options previously setup.
3764 CURLcode ftp_perform(struct connectdata *conn,
3765 bool *connected, /* connect status after PASV / PORT */
3768 /* this is FTP and no proxy */
3769 CURLcode result=CURLE_OK;
3771 DEBUGF(infof(conn->data, "DO phase starts\n"));
3773 if(conn->data->set.opt_no_body) {
3774 /* requested no body means no transfer... */
3775 struct FTP *ftp = conn->data->req.protop;
3776 ftp->transfer = FTPTRANSFER_INFO;
3779 *dophase_done = FALSE; /* not done yet */
3781 /* start the first command in the DO phase */
3782 result = ftp_state_quote(conn, TRUE, FTP_QUOTE);
3786 /* run the state-machine */
3787 result = ftp_multi_statemach(conn, dophase_done);
3789 *connected = conn->bits.tcpconnect[SECONDARYSOCKET];
3791 infof(conn->data, "ftp_perform ends with SECONDARY: %d\n", *connected);
3794 DEBUGF(infof(conn->data, "DO phase is complete1\n"));
3799 static void wc_data_dtor(void *ptr)
3801 struct ftp_wc_tmpdata *tmp = ptr;
3803 Curl_ftp_parselist_data_free(&tmp->parser);
3807 static CURLcode init_wc_data(struct connectdata *conn)
3810 char *path = conn->data->state.path;
3811 struct WildcardData *wildcard = &(conn->data->wildcard);
3812 CURLcode ret = CURLE_OK;
3813 struct ftp_wc_tmpdata *ftp_tmp;
3815 last_slash = strrchr(conn->data->state.path, '/');
3818 if(last_slash[0] == '\0') {
3819 wildcard->state = CURLWC_CLEAN;
3820 ret = ftp_parse_url_path(conn);
3824 wildcard->pattern = strdup(last_slash);
3825 if(!wildcard->pattern)
3826 return CURLE_OUT_OF_MEMORY;
3827 last_slash[0] = '\0'; /* cut file from path */
3830 else { /* there is only 'wildcard pattern' or nothing */
3832 wildcard->pattern = strdup(path);
3833 if(!wildcard->pattern)
3834 return CURLE_OUT_OF_MEMORY;
3837 else { /* only list */
3838 wildcard->state = CURLWC_CLEAN;
3839 ret = ftp_parse_url_path(conn);
3844 /* program continues only if URL is not ending with slash, allocate needed
3845 resources for wildcard transfer */
3847 /* allocate ftp protocol specific temporary wildcard data */
3848 ftp_tmp = calloc(1, sizeof(struct ftp_wc_tmpdata));
3850 Curl_safefree(wildcard->pattern);
3851 return CURLE_OUT_OF_MEMORY;
3854 /* INITIALIZE parselist structure */
3855 ftp_tmp->parser = Curl_ftp_parselist_data_alloc();
3856 if(!ftp_tmp->parser) {
3857 Curl_safefree(wildcard->pattern);
3858 Curl_safefree(ftp_tmp);
3859 return CURLE_OUT_OF_MEMORY;
3862 wildcard->tmp = ftp_tmp; /* put it to the WildcardData tmp pointer */
3863 wildcard->tmp_dtor = wc_data_dtor;
3865 /* wildcard does not support NOCWD option (assert it?) */
3866 if(conn->data->set.ftp_filemethod == FTPFILE_NOCWD)
3867 conn->data->set.ftp_filemethod = FTPFILE_MULTICWD;
3869 /* try to parse ftp url */
3870 ret = ftp_parse_url_path(conn);
3872 Curl_safefree(wildcard->pattern);
3873 wildcard->tmp_dtor(wildcard->tmp);
3874 wildcard->tmp_dtor = ZERO_NULL;
3875 wildcard->tmp = NULL;
3879 wildcard->path = strdup(conn->data->state.path);
3880 if(!wildcard->path) {
3881 Curl_safefree(wildcard->pattern);
3882 wildcard->tmp_dtor(wildcard->tmp);
3883 wildcard->tmp_dtor = ZERO_NULL;
3884 wildcard->tmp = NULL;
3885 return CURLE_OUT_OF_MEMORY;
3888 /* backup old write_function */
3889 ftp_tmp->backup.write_function = conn->data->set.fwrite_func;
3890 /* parsing write function */
3891 conn->data->set.fwrite_func = Curl_ftp_parselist;
3892 /* backup old file descriptor */
3893 ftp_tmp->backup.file_descriptor = conn->data->set.out;
3894 /* let the writefunc callback know what curl pointer is working with */
3895 conn->data->set.out = conn;
3897 infof(conn->data, "Wildcard - Parsing started\n");
3901 /* This is called recursively */
3902 static CURLcode wc_statemach(struct connectdata *conn)
3904 struct WildcardData * const wildcard = &(conn->data->wildcard);
3905 CURLcode ret = CURLE_OK;
3907 switch (wildcard->state) {
3909 ret = init_wc_data(conn);
3910 if(wildcard->state == CURLWC_CLEAN)
3914 wildcard->state = ret ? CURLWC_ERROR : CURLWC_MATCHING;
3917 case CURLWC_MATCHING: {
3918 /* In this state is LIST response successfully parsed, so lets restore
3919 previous WRITEFUNCTION callback and WRITEDATA pointer */
3920 struct ftp_wc_tmpdata *ftp_tmp = wildcard->tmp;
3921 conn->data->set.fwrite_func = ftp_tmp->backup.write_function;
3922 conn->data->set.out = ftp_tmp->backup.file_descriptor;
3923 ftp_tmp->backup.write_function = ZERO_NULL;
3924 ftp_tmp->backup.file_descriptor = NULL;
3925 wildcard->state = CURLWC_DOWNLOADING;
3927 if(Curl_ftp_parselist_geterror(ftp_tmp->parser)) {
3928 /* error found in LIST parsing */
3929 wildcard->state = CURLWC_CLEAN;
3930 return wc_statemach(conn);
3932 else if(wildcard->filelist->size == 0) {
3933 /* no corresponding file */
3934 wildcard->state = CURLWC_CLEAN;
3935 return CURLE_REMOTE_FILE_NOT_FOUND;
3937 return wc_statemach(conn);
3940 case CURLWC_DOWNLOADING: {
3941 /* filelist has at least one file, lets get first one */
3942 struct ftp_conn *ftpc = &conn->proto.ftpc;
3943 struct curl_fileinfo *finfo = wildcard->filelist->head->ptr;
3945 char *tmp_path = aprintf("%s%s", wildcard->path, finfo->filename);
3947 return CURLE_OUT_OF_MEMORY;
3949 /* switch default "state.pathbuffer" and tmp_path, good to see
3950 ftp_parse_url_path function to understand this trick */
3951 Curl_safefree(conn->data->state.pathbuffer);
3952 conn->data->state.pathbuffer = tmp_path;
3953 conn->data->state.path = tmp_path;
3955 infof(conn->data, "Wildcard - START of \"%s\"\n", finfo->filename);
3956 if(conn->data->set.chunk_bgn) {
3957 long userresponse = conn->data->set.chunk_bgn(
3958 finfo, wildcard->customptr, (int)wildcard->filelist->size);
3959 switch(userresponse) {
3960 case CURL_CHUNK_BGN_FUNC_SKIP:
3961 infof(conn->data, "Wildcard - \"%s\" skipped by user\n",
3963 wildcard->state = CURLWC_SKIP;
3964 return wc_statemach(conn);
3965 case CURL_CHUNK_BGN_FUNC_FAIL:
3966 return CURLE_CHUNK_FAILED;
3970 if(finfo->filetype != CURLFILETYPE_FILE) {
3971 wildcard->state = CURLWC_SKIP;
3972 return wc_statemach(conn);
3975 if(finfo->flags & CURLFINFOFLAG_KNOWN_SIZE)
3976 ftpc->known_filesize = finfo->size;
3978 ret = ftp_parse_url_path(conn);
3983 /* we don't need the Curl_fileinfo of first file anymore */
3984 Curl_llist_remove(wildcard->filelist, wildcard->filelist->head, NULL);
3986 if(wildcard->filelist->size == 0) { /* remains only one file to down. */
3987 wildcard->state = CURLWC_CLEAN;
3988 /* after that will be ftp_do called once again and no transfer
3989 will be done because of CURLWC_CLEAN state */
3995 if(conn->data->set.chunk_end)
3996 conn->data->set.chunk_end(conn->data->wildcard.customptr);
3997 Curl_llist_remove(wildcard->filelist, wildcard->filelist->head, NULL);
3998 wildcard->state = (wildcard->filelist->size == 0) ?
3999 CURLWC_CLEAN : CURLWC_DOWNLOADING;
4000 return wc_statemach(conn);
4003 case CURLWC_CLEAN: {
4004 struct ftp_wc_tmpdata *ftp_tmp = wildcard->tmp;
4007 ret = Curl_ftp_parselist_geterror(ftp_tmp->parser);
4009 wildcard->state = ret ? CURLWC_ERROR : CURLWC_DONE;
4020 /***********************************************************************
4024 * This function is registered as 'curl_do' function. It decodes the path
4025 * parts etc as a wrapper to the actual DO function (ftp_perform).
4027 * The input argument is already checked for validity.
4029 static CURLcode ftp_do(struct connectdata *conn, bool *done)
4031 CURLcode retcode = CURLE_OK;
4032 struct ftp_conn *ftpc = &conn->proto.ftpc;
4034 *done = FALSE; /* default to false */
4035 ftpc->wait_data_conn = FALSE; /* default to no such wait */
4037 if(conn->data->set.wildcardmatch) {
4038 retcode = wc_statemach(conn);
4039 if(conn->data->wildcard.state == CURLWC_SKIP ||
4040 conn->data->wildcard.state == CURLWC_DONE) {
4041 /* do not call ftp_regular_transfer */
4044 if(retcode) /* error, loop or skipping the file */
4047 else { /* no wildcard FSM needed */
4048 retcode = ftp_parse_url_path(conn);
4053 retcode = ftp_regular_transfer(conn, done);
4059 CURLcode Curl_ftpsendf(struct connectdata *conn,
4060 const char *fmt, ...)
4062 ssize_t bytes_written;
4063 #define SBUF_SIZE 1024
4067 CURLcode res = CURLE_OK;
4069 enum protection_level data_sec = conn->data_prot;
4074 write_len = vsnprintf(s, SBUF_SIZE-3, fmt, ap);
4077 strcpy(&s[write_len], "\r\n"); /* append a trailing CRLF */
4082 res = Curl_convert_to_network(conn->data, s, write_len);
4083 /* Curl_convert_to_network calls failf if unsuccessful */
4089 conn->data_prot = PROT_CMD;
4091 res = Curl_write(conn, conn->sock[FIRSTSOCKET], sptr, write_len,
4094 DEBUGASSERT(data_sec > PROT_NONE && data_sec < PROT_LAST);
4095 conn->data_prot = data_sec;
4101 if(conn->data->set.verbose)
4102 Curl_debug(conn->data, CURLINFO_HEADER_OUT,
4103 sptr, (size_t)bytes_written, conn);
4105 if(bytes_written != (ssize_t)write_len) {
4106 write_len -= bytes_written;
4107 sptr += bytes_written;
4116 /***********************************************************************
4120 * This should be called before calling sclose() on an ftp control connection
4121 * (not data connections). We should then wait for the response from the
4122 * server before returning. The calling code should then try to close the
4126 static CURLcode ftp_quit(struct connectdata *conn)
4128 CURLcode result = CURLE_OK;
4130 if(conn->proto.ftpc.ctl_valid) {
4131 result = Curl_pp_sendf(&conn->proto.ftpc.pp, "%s", "QUIT");
4133 failf(conn->data, "Failure sending QUIT command: %s",
4134 curl_easy_strerror(result));
4135 conn->proto.ftpc.ctl_valid = FALSE; /* mark control connection as bad */
4136 connclose(conn, "QUIT command failed"); /* mark for connection closure */
4137 state(conn, FTP_STOP);
4141 state(conn, FTP_QUIT);
4143 result = ftp_block_statemach(conn);
4149 /***********************************************************************
4153 * Disconnect from an FTP server. Cleanup protocol-specific per-connection
4154 * resources. BLOCKING.
4156 static CURLcode ftp_disconnect(struct connectdata *conn, bool dead_connection)
4158 struct ftp_conn *ftpc= &conn->proto.ftpc;
4159 struct pingpong *pp = &ftpc->pp;
4161 /* We cannot send quit unconditionally. If this connection is stale or
4162 bad in any way, sending quit and waiting around here will make the
4163 disconnect wait in vain and cause more problems than we need to.
4165 ftp_quit() will check the state of ftp->ctl_valid. If it's ok it
4166 will try to send the QUIT command, otherwise it will just return.
4169 ftpc->ctl_valid = FALSE;
4171 /* The FTP session may or may not have been allocated/setup at this point! */
4172 (void)ftp_quit(conn); /* ignore errors on the QUIT */
4174 if(ftpc->entrypath) {
4175 struct SessionHandle *data = conn->data;
4176 if(data->state.most_recent_ftp_entrypath == ftpc->entrypath) {
4177 data->state.most_recent_ftp_entrypath = NULL;
4179 free(ftpc->entrypath);
4180 ftpc->entrypath = NULL;
4184 if(ftpc->prevpath) {
4185 free(ftpc->prevpath);
4186 ftpc->prevpath = NULL;
4188 if(ftpc->server_os) {
4189 free(ftpc->server_os);
4190 ftpc->server_os = NULL;
4193 Curl_pp_disconnect(pp);
4202 /***********************************************************************
4204 * ftp_parse_url_path()
4206 * Parse the URL path into separate path components.
4210 CURLcode ftp_parse_url_path(struct connectdata *conn)
4212 struct SessionHandle *data = conn->data;
4213 /* the ftp struct is already inited in ftp_connect() */
4214 struct FTP *ftp = data->req.protop;
4215 struct ftp_conn *ftpc = &conn->proto.ftpc;
4216 const char *slash_pos; /* position of the first '/' char in curpos */
4217 const char *path_to_use = data->state.path;
4218 const char *cur_pos;
4219 const char *filename = NULL;
4221 cur_pos = path_to_use; /* current position in path. point at the begin
4222 of next path component */
4224 ftpc->ctl_valid = FALSE;
4225 ftpc->cwdfail = FALSE;
4227 switch(data->set.ftp_filemethod) {
4229 /* fastest, but less standard-compliant */
4232 The best time to check whether the path is a file or directory is right
4235 the first condition in the if() right here, is there just in case
4236 someone decides to set path to NULL one day
4238 if(data->state.path &&
4239 data->state.path[0] &&
4240 (data->state.path[strlen(data->state.path) - 1] != '/') )
4241 filename = data->state.path; /* this is a full file path */
4243 ftpc->file is not used anywhere other than for operations on a file.
4244 In other words, never for directory operations.
4245 So we can safely leave filename as NULL here and use it as a
4246 argument in dir/file decisions.
4250 case FTPFILE_SINGLECWD:
4251 /* get the last slash */
4252 if(!path_to_use[0]) {
4253 /* no dir, no file */
4257 slash_pos=strrchr(cur_pos, '/');
4258 if(slash_pos || !*cur_pos) {
4259 size_t dirlen = slash_pos-cur_pos;
4261 ftpc->dirs = calloc(1, sizeof(ftpc->dirs[0]));
4263 return CURLE_OUT_OF_MEMORY;
4268 ftpc->dirs[0] = curl_easy_unescape(conn->data, slash_pos ? cur_pos : "/",
4269 slash_pos ? curlx_uztosi(dirlen) : 1,
4271 if(!ftpc->dirs[0]) {
4273 return CURLE_OUT_OF_MEMORY;
4275 ftpc->dirdepth = 1; /* we consider it to be a single dir */
4276 filename = slash_pos ? slash_pos+1 : cur_pos; /* rest is file name */
4279 filename = cur_pos; /* this is a file name only */
4282 default: /* allow pretty much anything */
4283 case FTPFILE_MULTICWD:
4285 ftpc->diralloc = 5; /* default dir depth to allocate */
4286 ftpc->dirs = calloc(ftpc->diralloc, sizeof(ftpc->dirs[0]));
4288 return CURLE_OUT_OF_MEMORY;
4290 /* we have a special case for listing the root dir only */
4291 if(strequal(path_to_use, "/")) {
4292 cur_pos++; /* make it point to the zero byte */
4293 ftpc->dirs[0] = strdup("/");
4297 /* parse the URL path into separate path components */
4298 while((slash_pos = strchr(cur_pos, '/')) != NULL) {
4299 /* 1 or 0 pointer offset to indicate absolute directory */
4300 ssize_t absolute_dir = ((cur_pos - data->state.path > 0) &&
4301 (ftpc->dirdepth == 0))?1:0;
4303 /* seek out the next path component */
4304 if(slash_pos-cur_pos) {
4305 /* we skip empty path components, like "x//y" since the FTP command
4306 CWD requires a parameter and a non-existent parameter a) doesn't
4307 work on many servers and b) has no effect on the others. */
4308 int len = curlx_sztosi(slash_pos - cur_pos + absolute_dir);
4309 ftpc->dirs[ftpc->dirdepth] =
4310 curl_easy_unescape(conn->data, cur_pos - absolute_dir, len, NULL);
4311 if(!ftpc->dirs[ftpc->dirdepth]) { /* run out of memory ... */
4312 failf(data, "no memory");
4314 return CURLE_OUT_OF_MEMORY;
4316 if(isBadFtpString(ftpc->dirs[ftpc->dirdepth])) {
4317 free(ftpc->dirs[ftpc->dirdepth]);
4319 return CURLE_URL_MALFORMAT;
4323 cur_pos = slash_pos + 1; /* jump to the rest of the string */
4324 if(!ftpc->dirdepth) {
4325 /* path starts with a slash, add that as a directory */
4326 ftpc->dirs[ftpc->dirdepth] = strdup("/");
4327 if(!ftpc->dirs[ftpc->dirdepth++]) { /* run out of memory ... */
4328 failf(data, "no memory");
4330 return CURLE_OUT_OF_MEMORY;
4336 cur_pos = slash_pos + 1; /* jump to the rest of the string */
4337 if(++ftpc->dirdepth >= ftpc->diralloc) {
4340 ftpc->diralloc *= 2; /* double the size each time */
4341 bigger = realloc(ftpc->dirs, ftpc->diralloc * sizeof(ftpc->dirs[0]));
4344 return CURLE_OUT_OF_MEMORY;
4346 ftpc->dirs = bigger;
4350 filename = cur_pos; /* the rest is the file name */
4354 if(filename && *filename) {
4355 ftpc->file = curl_easy_unescape(conn->data, filename, 0, NULL);
4356 if(NULL == ftpc->file) {
4358 failf(data, "no memory");
4359 return CURLE_OUT_OF_MEMORY;
4361 if(isBadFtpString(ftpc->file)) {
4363 return CURLE_URL_MALFORMAT;
4367 ftpc->file=NULL; /* instead of point to a zero byte, we make it a NULL
4370 if(data->set.upload && !ftpc->file && (ftp->transfer == FTPTRANSFER_BODY)) {
4371 /* We need a file name when uploading. Return error! */
4372 failf(data, "Uploading to a URL without a file name!");
4373 return CURLE_URL_MALFORMAT;
4376 ftpc->cwddone = FALSE; /* default to not done */
4378 if(ftpc->prevpath) {
4379 /* prevpath is "raw" so we convert the input path before we compare the
4382 char *path = curl_easy_unescape(conn->data, data->state.path, 0, &dlen);
4385 return CURLE_OUT_OF_MEMORY;
4388 dlen -= ftpc->file?curlx_uztosi(strlen(ftpc->file)):0;
4389 if((dlen == curlx_uztosi(strlen(ftpc->prevpath))) &&
4390 strnequal(path, ftpc->prevpath, dlen)) {
4391 infof(data, "Request has same path as previous transfer\n");
4392 ftpc->cwddone = TRUE;
4400 /* call this when the DO phase has completed */
4401 static CURLcode ftp_dophase_done(struct connectdata *conn,
4404 struct FTP *ftp = conn->data->req.protop;
4405 struct ftp_conn *ftpc = &conn->proto.ftpc;
4409 CURLcode result = ftp_do_more(conn, &completed);
4412 if(conn->sock[SECONDARYSOCKET] != CURL_SOCKET_BAD) {
4413 /* close the second socket if it was created already */
4414 Curl_closesocket(conn, conn->sock[SECONDARYSOCKET]);
4415 conn->sock[SECONDARYSOCKET] = CURL_SOCKET_BAD;
4421 if(ftp->transfer != FTPTRANSFER_BODY)
4422 /* no data to transfer */
4423 Curl_setup_transfer(conn, -1, -1, FALSE, NULL, -1, NULL);
4425 /* since we didn't connect now, we want do_more to get called */
4426 conn->bits.do_more = TRUE;
4428 ftpc->ctl_valid = TRUE; /* seems good */
4433 /* called from multi.c while DOing */
4434 static CURLcode ftp_doing(struct connectdata *conn,
4437 CURLcode result = ftp_multi_statemach(conn, dophase_done);
4440 DEBUGF(infof(conn->data, "DO phase failed\n"));
4441 else if(*dophase_done) {
4442 result = ftp_dophase_done(conn, FALSE /* not connected */);
4444 DEBUGF(infof(conn->data, "DO phase is complete2\n"));
4449 /***********************************************************************
4451 * ftp_regular_transfer()
4453 * The input argument is already checked for validity.
4455 * Performs all commands done before a regular transfer between a local and a
4458 * ftp->ctl_valid starts out as FALSE, and gets set to TRUE if we reach the
4459 * ftp_done() function without finding any major problem.
4462 CURLcode ftp_regular_transfer(struct connectdata *conn,
4465 CURLcode result=CURLE_OK;
4466 bool connected=FALSE;
4467 struct SessionHandle *data = conn->data;
4468 struct ftp_conn *ftpc = &conn->proto.ftpc;
4469 data->req.size = -1; /* make sure this is unknown at this point */
4471 Curl_pgrsSetUploadCounter(data, 0);
4472 Curl_pgrsSetDownloadCounter(data, 0);
4473 Curl_pgrsSetUploadSize(data, 0);
4474 Curl_pgrsSetDownloadSize(data, 0);
4476 ftpc->ctl_valid = TRUE; /* starts good */
4478 result = ftp_perform(conn,
4479 &connected, /* have we connected after PASV/PORT */
4480 dophase_done); /* all commands in the DO-phase done? */
4482 if(CURLE_OK == result) {
4485 /* the DO phase has not completed yet */
4488 result = ftp_dophase_done(conn, connected);
4499 static CURLcode ftp_setup_connection(struct connectdata *conn)
4501 struct SessionHandle *data = conn->data;
4506 if(conn->bits.httpproxy && !data->set.tunnel_thru_httpproxy) {
4507 /* Unless we have asked to tunnel ftp operations through the proxy, we
4508 switch and use HTTP operations only */
4509 #ifndef CURL_DISABLE_HTTP
4510 if(conn->handler == &Curl_handler_ftp)
4511 conn->handler = &Curl_handler_ftp_proxy;
4514 conn->handler = &Curl_handler_ftps_proxy;
4516 failf(data, "FTPS not supported!");
4517 return CURLE_UNSUPPORTED_PROTOCOL;
4520 /* set it up as a HTTP connection instead */
4521 return conn->handler->setup_connection(conn);
4523 failf(data, "FTP over http proxy requires HTTP support built-in!");
4524 return CURLE_UNSUPPORTED_PROTOCOL;
4528 conn->data->req.protop = ftp = malloc(sizeof(struct FTP));
4530 return CURLE_OUT_OF_MEMORY;
4532 data->state.path++; /* don't include the initial slash */
4533 data->state.slash_removed = TRUE; /* we've skipped the slash */
4535 /* FTP URLs support an extension like ";type=<typecode>" that
4536 * we'll try to get now! */
4537 type = strstr(data->state.path, ";type=");
4540 type = strstr(conn->host.rawalloc, ";type=");
4543 *type = 0; /* it was in the middle of the hostname */
4544 command = Curl_raw_toupper(type[6]);
4545 conn->bits.type_set = TRUE;
4548 case 'A': /* ASCII mode */
4549 data->set.prefer_ascii = TRUE;
4552 case 'D': /* directory mode */
4553 data->set.ftp_list_only = TRUE;
4556 case 'I': /* binary mode */
4558 /* switch off ASCII */
4559 data->set.prefer_ascii = FALSE;
4564 /* get some initial data into the ftp struct */
4565 ftp->bytecountp = &conn->data->req.bytecount;
4566 ftp->transfer = FTPTRANSFER_BODY;
4567 ftp->downloadsize = 0;
4569 /* No need to duplicate user+password, the connectdata struct won't change
4570 during a session, but we re-init them here since on subsequent inits
4571 since the conn struct may have changed or been replaced.
4573 ftp->user = conn->user;
4574 ftp->passwd = conn->passwd;
4575 if(isBadFtpString(ftp->user))
4576 return CURLE_URL_MALFORMAT;
4577 if(isBadFtpString(ftp->passwd))
4578 return CURLE_URL_MALFORMAT;
4580 conn->proto.ftpc.known_filesize = -1; /* unknown size for now */
4585 #endif /* CURL_DISABLE_FTP */