1 /***************************************************************************
3 * Project ___| | | | _ \| |
5 * | (__| |_| | _ <| |___
6 * \___|\___/|_| \_\_____|
8 * Copyright (C) 1998 - 2011, Daniel Stenberg, <daniel@haxx.se>, et al.
10 * This software is licensed as described in the file COPYING, which
11 * you should have received as part of this distribution. The terms
12 * are also available at http://curl.haxx.se/docs/copyright.html.
14 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 * copies of the Software, and permit persons to whom the Software is
16 * furnished to do so, under the terms of the COPYING file.
18 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 * KIND, either express or implied.
21 ***************************************************************************/
25 /* -- WIN32 approved -- */
32 #include "strtoofft.h"
40 #ifdef HAVE_SYS_SOCKET_H
41 #include <sys/socket.h>
43 #ifdef HAVE_NETINET_IN_H
44 #include <netinet/in.h>
46 #ifdef HAVE_SYS_TIME_H
55 #ifdef HAVE_ARPA_INET_H
56 #include <arpa/inet.h>
61 #ifdef HAVE_SYS_IOCTL_H
62 #include <sys/ioctl.h>
68 #ifdef HAVE_SYS_PARAM_H
69 #include <sys/param.h>
72 #ifdef HAVE_SYS_SELECT_H
73 #include <sys/select.h>
77 #error "We can't compile without socket() support!"
83 #include <curl/curl.h>
86 #include "content_encoding.h"
90 #include "speedcheck.h"
96 #include "http_digest.h"
97 #include "http_ntlm.h"
98 #include "http_negotiate.h"
100 #include "curl_memory.h"
104 #include "non-ascii.h"
106 #define _MPRINTF_REPLACE /* use our functions only */
107 #include <curl/mprintf.h>
109 /* The last #include file should be: */
110 #include "memdebug.h"
112 #define CURL_TIMEOUT_EXPECT_100 1000 /* counting ms here */
115 * This function will call the read callback to fill our buffer with data
118 CURLcode Curl_fillreadbuffer(struct connectdata *conn, int bytes, int *nreadp)
120 struct SessionHandle *data = conn->data;
121 size_t buffersize = (size_t)bytes;
123 #ifdef CURL_DOES_CONVERSIONS
124 bool sending_http_headers = FALSE;
126 if((conn->handler->protocol&(CURLPROTO_HTTP|CURLPROTO_RTSP)) &&
127 (data->state.proto.http->sending == HTTPSEND_REQUEST)) {
128 /* We're sending the HTTP request headers, not the data.
129 Remember that so we don't re-translate them into garbage. */
130 sending_http_headers = TRUE;
134 if(data->req.upload_chunky) {
135 /* if chunked Transfer-Encoding */
136 buffersize -= (8 + 2 + 2); /* 32bit hex + CRLF + CRLF */
137 data->req.upload_fromhere += (8 + 2); /* 32bit hex + CRLF */
140 /* this function returns a size_t, so we typecast to int to prevent warnings
141 with picky compilers */
142 nread = (int)conn->fread_func(data->req.upload_fromhere, 1,
143 buffersize, conn->fread_in);
145 if(nread == CURL_READFUNC_ABORT) {
146 failf(data, "operation aborted by callback");
148 return CURLE_ABORTED_BY_CALLBACK;
150 else if(nread == CURL_READFUNC_PAUSE) {
151 struct SingleRequest *k = &data->req;
152 /* CURL_READFUNC_PAUSE pauses read callbacks that feed socket writes */
153 k->keepon |= KEEP_SEND_PAUSE; /* mark socket send as paused */
154 if(data->req.upload_chunky) {
155 /* Back out the preallocation done above */
156 data->req.upload_fromhere -= (8 + 2);
159 return CURLE_OK; /* nothing was read */
161 else if((size_t)nread > buffersize) {
162 /* the read function returned a too large value */
164 failf(data, "read function returned funny value");
165 return CURLE_READ_ERROR;
168 if(!data->req.forbidchunk && data->req.upload_chunky) {
169 /* if chunked Transfer-Encoding
175 /* On non-ASCII platforms the <DATA> may or may not be
176 translated based on set.prefer_ascii while the protocol
177 portion must always be translated to the network encoding.
178 To further complicate matters, line end conversion might be
179 done later on, so we need to prevent CRLFs from becoming
180 CRCRLFs if that's the case. To do this we use bare LFs
181 here, knowing they'll become CRLFs later on.
185 const char *endofline_native;
186 const char *endofline_network;
188 #ifdef CURL_DO_LINEEND_CONV
189 if((data->set.crlf) || (data->set.prefer_ascii)) {
192 #endif /* CURL_DO_LINEEND_CONV */
193 /* \n will become \r\n later on */
194 endofline_native = "\n";
195 endofline_network = "\x0a";
198 endofline_native = "\r\n";
199 endofline_network = "\x0d\x0a";
201 hexlen = snprintf(hexbuffer, sizeof(hexbuffer),
202 "%x%s", nread, endofline_native);
204 /* move buffer pointer */
205 data->req.upload_fromhere -= hexlen;
208 /* copy the prefix to the buffer, leaving out the NUL */
209 memcpy(data->req.upload_fromhere, hexbuffer, hexlen);
211 /* always append ASCII CRLF to the data */
212 memcpy(data->req.upload_fromhere + nread,
214 strlen(endofline_network));
216 #ifdef CURL_DOES_CONVERSIONS
219 if(data->set.prefer_ascii) {
220 /* translate the protocol and data */
224 /* just translate the protocol portion */
225 length = strlen(hexbuffer);
227 res = Curl_convert_to_network(data, data->req.upload_fromhere, length);
228 /* Curl_convert_to_network calls failf if unsuccessful */
231 #endif /* CURL_DOES_CONVERSIONS */
233 if((nread - hexlen) == 0)
234 /* mark this as done once this chunk is transferred */
235 data->req.upload_done = TRUE;
237 nread+=(int)strlen(endofline_native); /* for the added end of line */
239 #ifdef CURL_DOES_CONVERSIONS
240 else if((data->set.prefer_ascii) && (!sending_http_headers)) {
242 res = Curl_convert_to_network(data, data->req.upload_fromhere, nread);
243 /* Curl_convert_to_network calls failf if unsuccessful */
247 #endif /* CURL_DOES_CONVERSIONS */
256 * Curl_readrewind() rewinds the read stream. This is typically used for HTTP
257 * POST/PUT with multi-pass authentication when a sending was denied and a
258 * resend is necessary.
260 CURLcode Curl_readrewind(struct connectdata *conn)
262 struct SessionHandle *data = conn->data;
264 conn->bits.rewindaftersend = FALSE; /* we rewind now */
266 /* explicitly switch off sending data on this connection now since we are
267 about to restart a new transfer and thus we want to avoid inadvertently
268 sending more data on the existing connection until the next transfer
270 data->req.keepon &= ~KEEP_SEND;
272 /* We have sent away data. If not using CURLOPT_POSTFIELDS or
273 CURLOPT_HTTPPOST, call app to rewind
275 if(data->set.postfields ||
276 (data->set.httpreq == HTTPREQ_POST_FORM))
279 if(data->set.seek_func) {
282 err = (data->set.seek_func)(data->set.seek_client, 0, SEEK_SET);
284 failf(data, "seek callback returned error %d", (int)err);
285 return CURLE_SEND_FAIL_REWIND;
288 else if(data->set.ioctl_func) {
291 err = (data->set.ioctl_func)(data, CURLIOCMD_RESTARTREAD,
292 data->set.ioctl_client);
293 infof(data, "the ioctl callback returned %d\n", (int)err);
296 /* FIXME: convert to a human readable error message */
297 failf(data, "ioctl callback returned error %d", (int)err);
298 return CURLE_SEND_FAIL_REWIND;
302 /* If no CURLOPT_READFUNCTION is used, we know that we operate on a
303 given FILE * stream and we can actually attempt to rewind that
304 ourself with fseek() */
305 if(data->set.fread_func == (curl_read_callback)fread) {
306 if(-1 != fseek(data->set.in, 0, SEEK_SET))
307 /* successful rewind */
311 /* no callback set or failure above, makes us fail at once */
312 failf(data, "necessary data rewind wasn't possible");
313 return CURLE_SEND_FAIL_REWIND;
319 static int data_pending(const struct connectdata *conn)
321 /* in the case of libssh2, we can never be really sure that we have emptied
322 its internal buffers so we MUST always try until we get EAGAIN back */
323 return conn->handler->protocol&(CURLPROTO_SCP|CURLPROTO_SFTP) ||
324 Curl_ssl_data_pending(conn, FIRSTSOCKET);
327 static void read_rewind(struct connectdata *conn,
330 DEBUGASSERT(conn->read_pos >= thismuch);
332 conn->read_pos -= thismuch;
333 conn->bits.stream_was_rewound = TRUE;
340 show = CURLMIN(conn->buf_len - conn->read_pos, sizeof(buf)-1);
341 if(conn->master_buffer) {
342 memcpy(buf, conn->master_buffer + conn->read_pos, show);
349 DEBUGF(infof(conn->data,
350 "Buffer after stream rewind (read_pos = %zu): [%s]",
351 conn->read_pos, buf));
357 * Check to see if CURLOPT_TIMECONDITION was met by comparing the time of the
358 * remote document with the time provided by CURLOPT_TIMEVAL
360 bool Curl_meets_timecondition(struct SessionHandle *data, time_t timeofdoc)
362 if((timeofdoc == 0) || (data->set.timevalue == 0))
365 switch(data->set.timecondition) {
366 case CURL_TIMECOND_IFMODSINCE:
368 if(timeofdoc <= data->set.timevalue) {
370 "The requested document is not new enough\n");
371 data->info.timecond = TRUE;
375 case CURL_TIMECOND_IFUNMODSINCE:
376 if(timeofdoc >= data->set.timevalue) {
378 "The requested document is not old enough\n");
379 data->info.timecond = TRUE;
389 * Go ahead and do a read if we have a readable socket or if
390 * the stream was rewound (in which case we have data in a
393 static CURLcode readwrite_data(struct SessionHandle *data,
394 struct connectdata *conn,
395 struct SingleRequest *k,
396 int *didwhat, bool *done)
398 CURLcode result = CURLE_OK;
399 ssize_t nread; /* number of bytes read */
400 size_t excess = 0; /* excess bytes read */
401 bool is_empty_data = FALSE;
402 bool readmore = FALSE; /* used by RTP to signal for more data */
406 /* This is where we loop until we have read everything there is to
407 read or we get a CURLE_AGAIN */
409 size_t buffersize = data->set.buffer_size?
410 data->set.buffer_size : BUFSIZE;
411 size_t bytestoread = buffersize;
413 if(k->size != -1 && !k->header) {
414 /* make sure we don't read "too much" if we can help it since we
415 might be pipelining and then someone else might want to read what
417 curl_off_t totalleft = k->size - k->bytecount;
418 if(totalleft < (curl_off_t)bytestoread)
419 bytestoread = (size_t)totalleft;
423 /* receive data from the network! */
424 result = Curl_read(conn, conn->sockfd, k->buf, bytestoread, &nread);
426 /* read would've blocked */
427 if(CURLE_AGAIN == result)
428 break; /* get out of loop */
434 /* read nothing but since we wanted nothing we consider this an OK
435 situation to proceed from */
439 if((k->bytecount == 0) && (k->writebytecount == 0)) {
440 Curl_pgrsTime(data, TIMER_STARTTRANSFER);
441 if(k->exp100 > EXP100_SEND_DATA)
442 /* set time stamp to compare with when waiting for the 100 */
443 k->start100 = Curl_tvnow();
446 *didwhat |= KEEP_RECV;
447 /* indicates data of zero size, i.e. empty file */
448 is_empty_data = (bool)((nread == 0) && (k->bodywrites == 0));
450 /* NUL terminate, allowing string ops to be used */
451 if(0 < nread || is_empty_data) {
454 else if(0 >= nread) {
455 /* if we receive 0 or less here, the server closed the connection
456 and we bail out from this! */
457 DEBUGF(infof(data, "nread <= 0, server closed connection, bailing\n"));
458 k->keepon &= ~KEEP_RECV;
462 /* Default buffer to use when we write the buffer, it may be changed
463 in the flow below before the actual storing is done. */
466 if(conn->handler->readwrite) {
467 result = conn->handler->readwrite(data, conn, &nread, &readmore);
474 #ifndef CURL_DISABLE_HTTP
475 /* Since this is a two-state thing, we check if we are parsing
476 headers at the moment or not. */
478 /* we are in parse-the-header-mode */
479 bool stop_reading = FALSE;
480 result = Curl_http_readwrite_headers(data, conn, &nread, &stop_reading);
484 if(conn->handler->readwrite &&
485 (k->maxdownload <= 0 && nread > 0)) {
486 result = conn->handler->readwrite(data, conn, &nread, &readmore);
494 /* We've stopped dealing with input, get out of the do-while loop */
497 if(conn->data->multi && Curl_multi_canPipeline(conn->data->multi)) {
499 "Rewinding stream by : %zd"
500 " bytes on url %s (zero-length body)\n",
501 nread, data->state.path);
502 read_rewind(conn, (size_t)nread);
506 "Excess found in a non pipelined read:"
508 " url = %s (zero-length body)\n",
509 nread, data->state.path);
516 #endif /* CURL_DISABLE_HTTP */
519 /* This is not an 'else if' since it may be a rest from the header
520 parsing, where the beginning of the buffer is headers and the end
522 if(k->str && !k->header && (nread > 0 || is_empty_data)) {
525 #ifndef CURL_DISABLE_HTTP
526 if(0 == k->bodywrites && !is_empty_data) {
527 /* These checks are only made the first time we are about to
528 write a piece of the body */
529 if(conn->handler->protocol&(CURLPROTO_HTTP|CURLPROTO_RTSP)) {
530 /* HTTP-only checks */
532 if(data->req.newurl) {
533 if(conn->bits.close) {
534 /* Abort after the headers if "follow Location" is set
535 and we're set to close anyway. */
536 k->keepon &= ~KEEP_RECV;
540 /* We have a new url to load, but since we want to be able
541 to re-use this connection properly, we read the full
542 response in "ignore more" */
543 k->ignorebody = TRUE;
544 infof(data, "Ignoring the response-body\n");
546 if(data->state.resume_from && !k->content_range &&
547 (data->set.httpreq==HTTPREQ_GET) &&
549 /* we wanted to resume a download, although the server doesn't
550 * seem to support this and we did this with a GET (if it
551 * wasn't a GET we did a POST or PUT resume) */
552 failf(data, "HTTP server doesn't seem to support "
553 "byte ranges. Cannot resume.");
554 return CURLE_RANGE_ERROR;
557 if(data->set.timecondition && !data->state.range) {
558 /* A time condition has been set AND no ranges have been
559 requested. This seems to be what chapter 13.3.4 of
560 RFC 2616 defines to be the correct action for a
563 if(!Curl_meets_timecondition(data, k->timeofdoc)) {
565 /* we abort the transfer before it is completed == we ruin the
566 re-use ability. Close the connection */
567 conn->bits.close = TRUE;
570 } /* we have a time condition */
573 } /* this is the first time we write a body part */
574 #endif /* CURL_DISABLE_HTTP */
577 /* pass data to the debug function before it gets "dechunked" */
578 if(data->set.verbose) {
580 Curl_debug(data, CURLINFO_DATA_IN, data->state.headerbuff,
581 (size_t)k->hbuflen, conn);
582 if(k->badheader == HEADER_PARTHEADER)
583 Curl_debug(data, CURLINFO_DATA_IN,
584 k->str, (size_t)nread, conn);
587 Curl_debug(data, CURLINFO_DATA_IN,
588 k->str, (size_t)nread, conn);
591 #ifndef CURL_DISABLE_HTTP
594 * Here comes a chunked transfer flying and we need to decode this
595 * properly. While the name says read, this function both reads
596 * and writes away the data. The returned 'nread' holds the number
597 * of actual data it wrote to the client.
601 Curl_httpchunk_read(conn, k->str, nread, &nread);
603 if(CHUNKE_OK < res) {
604 if(CHUNKE_WRITE_ERROR == res) {
605 failf(data, "Failed writing data");
606 return CURLE_WRITE_ERROR;
608 failf(data, "Received problem %d in the chunky parser", (int)res);
609 return CURLE_RECV_ERROR;
611 else if(CHUNKE_STOP == res) {
613 /* we're done reading chunks! */
614 k->keepon &= ~KEEP_RECV; /* read no more */
616 /* There are now possibly N number of bytes at the end of the
617 str buffer that weren't written to the client.
619 We DO care about this data if we are pipelining.
620 Push it back to be read on the next pass. */
622 dataleft = conn->chunk.dataleft;
624 infof(conn->data, "Leftovers after chunking: %zu bytes", dataleft);
625 if(conn->data->multi &&
626 Curl_multi_canPipeline(conn->data->multi)) {
627 /* only attempt the rewind if we truly are pipelining */
628 infof(conn->data, "Rewinding %zu bytes\n",dataleft);
629 read_rewind(conn, dataleft);
633 /* If it returned OK, we just keep going */
635 #endif /* CURL_DISABLE_HTTP */
637 /* Account for body content stored in the header buffer */
638 if(k->badheader && !k->ignorebody) {
639 DEBUGF(infof(data, "Increasing bytecount by %zu from hbuflen\n",
641 k->bytecount += k->hbuflen;
644 if((-1 != k->maxdownload) &&
645 (k->bytecount + nread >= k->maxdownload)) {
647 excess = (size_t)(k->bytecount + nread - k->maxdownload);
648 if(excess > 0 && !k->ignorebody) {
649 if(conn->data->multi && Curl_multi_canPipeline(conn->data->multi)) {
650 /* The 'excess' amount below can't be more than BUFSIZE which
651 always will fit in a size_t */
653 "Rewinding stream by : %zu"
654 " bytes on url %s (size = %" FORMAT_OFF_T
655 ", maxdownload = %" FORMAT_OFF_T
656 ", bytecount = %" FORMAT_OFF_T ", nread = %zd)\n",
657 excess, data->state.path,
658 k->size, k->maxdownload, k->bytecount, nread);
659 read_rewind(conn, excess);
663 "Excess found in a non pipelined read:"
665 ", size = %" FORMAT_OFF_T
666 ", maxdownload = %" FORMAT_OFF_T
667 ", bytecount = %" FORMAT_OFF_T "\n",
668 excess, k->size, k->maxdownload, k->bytecount);
672 nread = (ssize_t) (k->maxdownload - k->bytecount);
673 if(nread < 0 ) /* this should be unusual */
676 k->keepon &= ~KEEP_RECV; /* we're done reading */
679 k->bytecount += nread;
681 Curl_pgrsSetDownloadCounter(data, k->bytecount);
683 if(!k->chunk && (nread || k->badheader || is_empty_data)) {
684 /* If this is chunky transfer, it was already written */
686 if(k->badheader && !k->ignorebody) {
687 /* we parsed a piece of data wrongly assuming it was a header
688 and now we output it as body instead */
690 /* Don't let excess data pollute body writes */
691 if(k->maxdownload == -1 || (curl_off_t)k->hbuflen <= k->maxdownload)
692 result = Curl_client_write(conn, CLIENTWRITE_BODY,
693 data->state.headerbuff,
696 result = Curl_client_write(conn, CLIENTWRITE_BODY,
697 data->state.headerbuff,
698 (size_t)k->maxdownload);
703 if(k->badheader < HEADER_ALLBAD) {
704 /* This switch handles various content encodings. If there's an
705 error here, be sure to check over the almost identical code
707 Make sure that ALL_CONTENT_ENCODINGS contains all the
708 encodings handled here. */
710 switch (conn->data->set.http_ce_skip ?
711 IDENTITY : k->auto_decoding) {
714 /* This is the default when the server sends no
715 Content-Encoding header. See Curl_readwrite_init; the
716 memset() call initializes k->auto_decoding to zero. */
719 #ifndef CURL_DISABLE_POP3
720 if(conn->handler->protocol&CURLPROTO_POP3)
721 result = Curl_pop3_write(conn, k->str, nread);
723 #endif /* CURL_DISABLE_POP3 */
725 result = Curl_client_write(conn, CLIENTWRITE_BODY, k->str,
732 /* Assume CLIENTWRITE_BODY; headers are not encoded. */
734 result = Curl_unencode_deflate_write(conn, k, nread);
738 /* Assume CLIENTWRITE_BODY; headers are not encoded. */
740 result = Curl_unencode_gzip_write(conn, k, nread);
745 failf (data, "Unrecognized content encoding type. "
746 "libcurl understands `identity', `deflate' and `gzip' "
747 "content encodings.");
748 result = CURLE_BAD_CONTENT_ENCODING;
753 k->badheader = HEADER_NORMAL; /* taken care of now */
759 } /* if(! header and data to read ) */
761 if(conn->handler->readwrite &&
762 (excess > 0 && !conn->bits.stream_was_rewound)) {
763 /* Parse the excess data */
765 nread = (ssize_t)excess;
767 result = conn->handler->readwrite(data, conn, &nread, &readmore);
772 k->keepon |= KEEP_RECV; /* we're not done reading */
777 /* if we received nothing, the server closed the connection and we
779 k->keepon &= ~KEEP_RECV;
782 } while(data_pending(conn));
784 if(((k->keepon & (KEEP_RECV|KEEP_SEND)) == KEEP_SEND) &&
786 /* When we've read the entire thing and the close bit is set, the server
787 may now close the connection. If there's now any kind of sending going
788 on from our side, we need to stop that immediately. */
789 infof(data, "we are done reading and this is set to close, stop send\n");
790 k->keepon &= ~KEEP_SEND; /* no writing anymore either */
797 * Send data to upload to the server, when the socket is writable.
799 static CURLcode readwrite_upload(struct SessionHandle *data,
800 struct connectdata *conn,
801 struct SingleRequest *k,
805 ssize_t bytes_written;
807 ssize_t nread; /* number of bytes read */
808 bool sending_http_headers = FALSE;
810 if((k->bytecount == 0) && (k->writebytecount == 0))
811 Curl_pgrsTime(data, TIMER_STARTTRANSFER);
813 *didwhat |= KEEP_SEND;
816 * We loop here to do the READ and SEND loop until we run out of
817 * data to send or until we get EWOULDBLOCK back
821 /* only read more data if there's no upload data already
822 present in the upload buffer */
823 if(0 == data->req.upload_present) {
824 /* init the "upload from here" pointer */
825 data->req.upload_fromhere = k->uploadbuf;
827 if(!k->upload_done) {
828 /* HTTP pollution, this should be written nicer to become more
829 protocol agnostic. */
832 if((k->exp100 == EXP100_SENDING_REQUEST) &&
833 (data->state.proto.http->sending == HTTPSEND_BODY)) {
834 /* If this call is to send body data, we must take some action:
835 We have sent off the full HTTP 1.1 request, and we shall now
836 go into the Expect: 100 state and await such a header */
837 k->exp100 = EXP100_AWAITING_CONTINUE; /* wait for the header */
838 k->keepon &= ~KEEP_SEND; /* disable writing */
839 k->start100 = Curl_tvnow(); /* timeout count starts now */
840 *didwhat &= ~KEEP_SEND; /* we didn't write anything actually */
842 /* set a timeout for the multi interface */
843 Curl_expire(data, CURL_TIMEOUT_EXPECT_100);
847 if(conn->handler->protocol&(CURLPROTO_HTTP|CURLPROTO_RTSP)) {
848 if(data->state.proto.http->sending == HTTPSEND_REQUEST)
849 /* We're sending the HTTP request headers, not the data.
850 Remember that so we don't change the line endings. */
851 sending_http_headers = TRUE;
853 sending_http_headers = FALSE;
856 result = Curl_fillreadbuffer(conn, BUFSIZE, &fillcount);
860 nread = (ssize_t)fillcount;
863 nread = 0; /* we're done uploading/reading */
865 if(!nread && (k->keepon & KEEP_SEND_PAUSE)) {
866 /* this is a paused transfer */
871 k->keepon &= ~KEEP_SEND; /* we're done writing */
873 if(conn->bits.rewindaftersend) {
874 result = Curl_readrewind(conn);
881 /* store number of bytes available for upload */
882 data->req.upload_present = nread;
884 #ifndef CURL_DISABLE_SMTP
885 if(conn->handler->protocol & CURLPROTO_SMTP) {
886 result = Curl_smtp_escape_eob(conn, nread);
891 #endif /* CURL_DISABLE_SMTP */
893 /* convert LF to CRLF if so asked */
894 if((!sending_http_headers) &&
895 #ifdef CURL_DO_LINEEND_CONV
896 /* always convert if we're FTPing in ASCII mode */
897 ((data->set.crlf) || (data->set.prefer_ascii))) {
901 if(data->state.scratch == NULL)
902 data->state.scratch = malloc(2*BUFSIZE);
903 if(data->state.scratch == NULL) {
904 failf (data, "Failed to alloc scratch buffer!");
905 return CURLE_OUT_OF_MEMORY;
908 * ASCII/EBCDIC Note: This is presumably a text (not binary)
909 * transfer so the data should already be in ASCII.
910 * That means the hex values for ASCII CR (0x0d) & LF (0x0a)
911 * must be used instead of the escape sequences \r & \n.
913 for(i = 0, si = 0; i < nread; i++, si++) {
914 if(data->req.upload_fromhere[i] == 0x0a) {
915 data->state.scratch[si++] = 0x0d;
916 data->state.scratch[si] = 0x0a;
917 if(!data->set.crlf) {
918 /* we're here only because FTP is in ASCII mode...
919 bump infilesize for the LF we just added */
920 data->set.infilesize++;
924 data->state.scratch[si] = data->req.upload_fromhere[i];
927 /* only perform the special operation if we really did replace
931 /* upload from the new (replaced) buffer instead */
932 data->req.upload_fromhere = data->state.scratch;
934 /* set the new amount too */
935 data->req.upload_present = nread;
938 } /* if 0 == data->req.upload_present */
940 /* We have a partial buffer left from a previous "round". Use
941 that instead of reading more data */
944 /* write to socket (send away data) */
945 result = Curl_write(conn,
946 conn->writesockfd, /* socket to send to */
947 data->req.upload_fromhere, /* buffer pointer */
948 data->req.upload_present, /* buffer size */
949 &bytes_written); /* actually sent */
954 if(data->set.verbose)
955 /* show the data before we change the pointer upload_fromhere */
956 Curl_debug(data, CURLINFO_DATA_OUT, data->req.upload_fromhere,
957 (size_t)bytes_written, conn);
959 k->writebytecount += bytes_written;
961 if(k->writebytecount == data->set.infilesize) {
962 /* we have sent all data we were supposed to */
963 k->upload_done = TRUE;
964 infof(data, "We are completely uploaded and fine\n");
967 if(data->req.upload_present != bytes_written) {
968 /* we only wrote a part of the buffer (if anything), deal with it! */
970 /* store the amount of bytes left in the buffer to write */
971 data->req.upload_present -= bytes_written;
973 /* advance the pointer where to find the buffer when the next send
975 data->req.upload_fromhere += bytes_written;
978 /* we've uploaded that buffer now */
979 data->req.upload_fromhere = k->uploadbuf;
980 data->req.upload_present = 0; /* no more bytes left */
983 /* switch off writing, we're done! */
984 k->keepon &= ~KEEP_SEND; /* we're done writing */
988 Curl_pgrsSetUploadCounter(data, k->writebytecount);
990 } while(0); /* just to break out from! */
996 * Curl_readwrite() is the low-level function to be called when data is to
997 * be read and written to/from the connection.
999 CURLcode Curl_readwrite(struct connectdata *conn,
1002 struct SessionHandle *data = conn->data;
1003 struct SingleRequest *k = &data->req;
1007 curl_socket_t fd_read;
1008 curl_socket_t fd_write;
1009 int select_res = conn->cselect_bits;
1011 conn->cselect_bits = 0;
1013 /* only use the proper socket if the *_HOLD bit is not set simultaneously as
1014 then we are in rate limiting state in that transfer direction */
1016 if((k->keepon & KEEP_RECVBITS) == KEEP_RECV)
1017 fd_read = conn->sockfd;
1019 fd_read = CURL_SOCKET_BAD;
1021 if((k->keepon & KEEP_SENDBITS) == KEEP_SEND)
1022 fd_write = conn->writesockfd;
1024 fd_write = CURL_SOCKET_BAD;
1026 if(!select_res) /* Call for select()/poll() only, if read/write/error
1027 status is not known. */
1028 select_res = Curl_socket_ready(fd_read, fd_write, 0);
1030 if(select_res == CURL_CSELECT_ERR) {
1031 failf(data, "select/poll returned error");
1032 return CURLE_SEND_ERROR;
1035 /* We go ahead and do a read if we have a readable socket or if
1036 the stream was rewound (in which case we have data in a
1038 if((k->keepon & KEEP_RECV) &&
1039 ((select_res & CURL_CSELECT_IN) || conn->bits.stream_was_rewound)) {
1041 result = readwrite_data(data, conn, k, &didwhat, done);
1045 else if(k->keepon & KEEP_RECV) {
1046 DEBUGF(infof(data, "additional stuff not fine %s:%d: %d %d\n",
1048 select_res & CURL_CSELECT_IN,
1049 conn->bits.stream_was_rewound));
1052 /* If we still have writing to do, we check if we have a writable socket. */
1053 if((k->keepon & KEEP_SEND) && (select_res & CURL_CSELECT_OUT)) {
1056 result = readwrite_upload(data, conn, k, &didwhat);
1061 k->now = Curl_tvnow();
1063 /* Update read/write counters */
1065 *k->bytecountp = k->bytecount; /* read count */
1066 if(k->writebytecountp)
1067 *k->writebytecountp = k->writebytecount; /* write count */
1070 /* no read no write, this is a timeout? */
1071 if(k->exp100 == EXP100_AWAITING_CONTINUE) {
1072 /* This should allow some time for the header to arrive, but only a
1073 very short time as otherwise it'll be too much wasted time too
1076 /* Quoting RFC2616, section "8.2.3 Use of the 100 (Continue) Status":
1078 Therefore, when a client sends this header field to an origin server
1079 (possibly via a proxy) from which it has never seen a 100 (Continue)
1080 status, the client SHOULD NOT wait for an indefinite period before
1081 sending the request body.
1085 long ms = Curl_tvdiff(k->now, k->start100);
1086 if(ms > CURL_TIMEOUT_EXPECT_100) {
1087 /* we've waited long enough, continue anyway */
1088 k->exp100 = EXP100_SEND_DATA;
1089 k->keepon |= KEEP_SEND;
1090 infof(data, "Done waiting for 100-continue\n");
1095 if(Curl_pgrsUpdate(conn))
1096 result = CURLE_ABORTED_BY_CALLBACK;
1098 result = Curl_speedcheck(data, k->now);
1103 if(0 > Curl_timeleft(data, &k->now, FALSE)) {
1105 failf(data, "Operation timed out after %ld milliseconds with %"
1106 FORMAT_OFF_T " out of %" FORMAT_OFF_T " bytes received",
1107 Curl_tvdiff(k->now, data->progress.t_startsingle), k->bytecount,
1111 failf(data, "Operation timed out after %ld milliseconds with %"
1112 FORMAT_OFF_T " bytes received",
1113 Curl_tvdiff(k->now, data->progress.t_startsingle), k->bytecount);
1115 return CURLE_OPERATION_TIMEDOUT;
1120 * The transfer has been performed. Just make some general checks before
1124 if(!(data->set.opt_no_body) && (k->size != -1) &&
1125 (k->bytecount != k->size) &&
1126 #ifdef CURL_DO_LINEEND_CONV
1127 /* Most FTP servers don't adjust their file SIZE response for CRLFs,
1128 so we'll check to see if the discrepancy can be explained
1129 by the number of CRLFs we've changed to LFs.
1131 (k->bytecount != (k->size + data->state.crlf_conversions)) &&
1132 #endif /* CURL_DO_LINEEND_CONV */
1133 !data->req.newurl) {
1134 failf(data, "transfer closed with %" FORMAT_OFF_T
1135 " bytes remaining to read",
1136 k->size - k->bytecount);
1137 return CURLE_PARTIAL_FILE;
1139 else if(!(data->set.opt_no_body) &&
1141 (conn->chunk.state != CHUNK_STOP)) {
1143 * In chunked mode, return an error if the connection is closed prior to
1144 * the empty (terminiating) chunk is read.
1146 * The condition above used to check for
1147 * conn->proto.http->chunk.datasize != 0 which is true after reading
1148 * *any* chunk, not just the empty chunk.
1151 failf(data, "transfer closed with outstanding read data remaining");
1152 return CURLE_PARTIAL_FILE;
1154 if(Curl_pgrsUpdate(conn))
1155 return CURLE_ABORTED_BY_CALLBACK;
1158 /* Now update the "done" boolean we return */
1159 *done = (bool)(0 == (k->keepon&(KEEP_RECV|KEEP_SEND|
1160 KEEP_RECV_PAUSE|KEEP_SEND_PAUSE)));
1166 * Curl_single_getsock() gets called by the multi interface code when the app
1167 * has requested to get the sockets for the current connection. This function
1168 * will then be called once for every connection that the multi interface
1169 * keeps track of. This function will only be called for connections that are
1170 * in the proper state to have this information available.
1172 int Curl_single_getsock(const struct connectdata *conn,
1173 curl_socket_t *sock, /* points to numsocks number
1177 const struct SessionHandle *data = conn->data;
1178 int bitmap = GETSOCK_BLANK;
1179 unsigned sockindex = 0;
1181 if(conn->handler->perform_getsock)
1182 return conn->handler->perform_getsock(conn, sock, numsocks);
1185 /* simple check but we might need two slots */
1186 return GETSOCK_BLANK;
1188 /* don't include HOLD and PAUSE connections */
1189 if((data->req.keepon & KEEP_RECVBITS) == KEEP_RECV) {
1191 DEBUGASSERT(conn->sockfd != CURL_SOCKET_BAD);
1193 bitmap |= GETSOCK_READSOCK(sockindex);
1194 sock[sockindex] = conn->sockfd;
1197 /* don't include HOLD and PAUSE connections */
1198 if((data->req.keepon & KEEP_SENDBITS) == KEEP_SEND) {
1200 if((conn->sockfd != conn->writesockfd) ||
1201 !(data->req.keepon & KEEP_RECV)) {
1202 /* only if they are not the same socket or we didn't have a readable
1203 one, we increase index */
1204 if(data->req.keepon & KEEP_RECV)
1205 sockindex++; /* increase index if we need two entries */
1207 DEBUGASSERT(conn->writesockfd != CURL_SOCKET_BAD);
1209 sock[sockindex] = conn->writesockfd;
1212 bitmap |= GETSOCK_WRITESOCK(sockindex);
1219 * Determine optimum sleep time based on configured rate, current rate,
1221 * Returns value in mili-seconds.
1223 * The basic idea is to adjust the desired rate up/down in this method
1224 * based on whether we are running too slow or too fast. Then, calculate
1225 * how many miliseconds to wait for the next packet to achieve this new
1228 long Curl_sleep_time(curl_off_t rate_bps, curl_off_t cur_rate_bps,
1231 curl_off_t min_sleep = 0;
1237 /* If running faster than about .1% of the desired speed, slow
1238 * us down a bit. Use shift instead of division as the 0.1%
1239 * cutoff is arbitrary anyway.
1241 if(cur_rate_bps > (rate_bps + (rate_bps >> 10))) {
1242 /* running too fast, decrease target rate by 1/64th of rate */
1243 rate_bps -= rate_bps >> 6;
1246 else if(cur_rate_bps < (rate_bps - (rate_bps >> 10))) {
1247 /* running too slow, increase target rate by 1/64th of rate */
1248 rate_bps += rate_bps >> 6;
1251 /* Determine number of miliseconds to wait until we do
1252 * the next packet at the adjusted rate. We should wait
1253 * longer when using larger packets, for instance.
1255 rv = ((curl_off_t)((pkt_size * 8) * 1000) / rate_bps);
1257 /* Catch rounding errors and always slow down at least 1ms if
1258 * we are running too fast.
1263 /* Bound value to fit in 'long' on 32-bit platform. That's
1264 * plenty long enough anyway!
1276 * This function is what performs the actual transfer. It is capable of doing
1277 * both ways simultaneously. The transfer must already have been setup by a
1278 * call to Curl_setup_transfer().
1280 * Note that headers are created in a preallocated buffer of a default size.
1281 * That buffer can be enlarged on demand, but it is never shrunken again.
1286 Transfer(struct connectdata *conn)
1289 struct SessionHandle *data = conn->data;
1290 struct SingleRequest *k = &data->req;
1297 if((conn->sockfd == CURL_SOCKET_BAD) &&
1298 (conn->writesockfd == CURL_SOCKET_BAD))
1299 /* nothing to read, nothing to write, we're already OK! */
1302 /* we want header and/or body, if neither then don't do this! */
1303 if(!k->getheader && data->set.opt_no_body)
1307 curl_socket_t fd_read = conn->sockfd;
1308 curl_socket_t fd_write = conn->writesockfd;
1309 int keepon = k->keepon;
1313 /* if waitfor is set, get the RECV and SEND bits from that but keep the
1315 keepon &= ~ (KEEP_RECV|KEEP_SEND);
1316 keepon |= conn->waitfor & (KEEP_RECV|KEEP_SEND);
1319 /* limit-rate logic: if speed exceeds threshold, then do not include fd in
1320 select set. The current speed is recalculated in each Curl_readwrite()
1322 if((keepon & KEEP_SEND) &&
1323 (!data->set.max_send_speed ||
1324 (data->progress.ulspeed < data->set.max_send_speed) )) {
1325 k->keepon &= ~KEEP_SEND_HOLD;
1328 if(data->set.upload && data->set.max_send_speed &&
1329 (data->progress.ulspeed > data->set.max_send_speed) ) {
1330 /* calculate upload rate-limitation timeout. */
1331 buffersize = (int)(data->set.buffer_size ?
1332 data->set.buffer_size : BUFSIZE);
1333 totmp = Curl_sleep_time(data->set.max_send_speed,
1334 data->progress.ulspeed, buffersize);
1335 if(totmp < timeout_ms)
1338 fd_write = CURL_SOCKET_BAD;
1339 if(keepon & KEEP_SEND)
1340 k->keepon |= KEEP_SEND_HOLD; /* hold it */
1343 if((keepon & KEEP_RECV) &&
1344 (!data->set.max_recv_speed ||
1345 (data->progress.dlspeed < data->set.max_recv_speed)) ) {
1346 k->keepon &= ~KEEP_RECV_HOLD;
1349 if((!data->set.upload) && data->set.max_recv_speed &&
1350 (data->progress.dlspeed > data->set.max_recv_speed)) {
1351 /* Calculate download rate-limitation timeout. */
1352 buffersize = (int)(data->set.buffer_size ?
1353 data->set.buffer_size : BUFSIZE);
1354 totmp = Curl_sleep_time(data->set.max_recv_speed,
1355 data->progress.dlspeed, buffersize);
1356 if(totmp < timeout_ms)
1359 fd_read = CURL_SOCKET_BAD;
1360 if(keepon & KEEP_RECV)
1361 k->keepon |= KEEP_RECV_HOLD; /* hold it */
1364 /* pause logic. Don't check descriptors for paused connections */
1365 if(k->keepon & KEEP_RECV_PAUSE)
1366 fd_read = CURL_SOCKET_BAD;
1367 if(k->keepon & KEEP_SEND_PAUSE)
1368 fd_write = CURL_SOCKET_BAD;
1370 /* The *_HOLD and *_PAUSE logic is necessary since even though there might
1371 be no traffic during the select interval, we still call
1372 Curl_readwrite() for the timeout case and if we limit transfer speed we
1373 must make sure that this function doesn't transfer anything while in
1376 The no timeout for the first round is for the protocols for which data
1377 has already been slurped off the socket and thus waiting for action
1378 won't work since it'll wait even though there is already data present
1381 ((fd_read != CURL_SOCKET_BAD) || (fd_write != CURL_SOCKET_BAD)))
1382 /* if this is the first lap and one of the file descriptors is fine
1383 to work with, skip the timeout */
1386 totmp = Curl_timeleft(data, &k->now, FALSE);
1388 return CURLE_OPERATION_TIMEDOUT;
1392 if(totmp < timeout_ms)
1396 switch (Curl_socket_ready(fd_read, fd_write, timeout_ms)) {
1397 case -1: /* select() error, stop reading */
1399 /* The EINTR is not serious, and it seems you might get this more
1400 often when using the lib in a multi-threaded environment! */
1401 if(SOCKERRNO == EINTR)
1404 return CURLE_RECV_ERROR; /* indicate a network problem */
1405 case 0: /* timeout */
1406 default: /* readable descriptors */
1408 result = Curl_readwrite(conn, &done);
1409 /* "done" signals to us if the transfer(s) are ready */
1415 first = FALSE; /* not the first lap anymore */
1421 static CURLcode loadhostpairs(struct SessionHandle *data)
1423 struct curl_slist *hostp;
1428 for(hostp = data->change.resolve; hostp; hostp = hostp->next ) {
1431 if(hostp->data[0] == '-') {
1432 /* TODO: mark an entry for removal */
1434 else if(3 == sscanf(hostp->data, "%255[^:]:%d:%255s", hostname, &port,
1436 struct Curl_dns_entry *dns;
1437 Curl_addrinfo *addr;
1439 addr = Curl_str2addr(address, port);
1441 infof(data, "Resolve %s found illegal!\n", hostp->data);
1444 infof(data, "Added %s:%d:%s to DNS cache\n",
1445 hostname, port, address);
1448 Curl_share_lock(data, CURL_LOCK_DATA_DNS, CURL_LOCK_ACCESS_SINGLE);
1450 /* put this host in the cache */
1451 dns = Curl_cache_addr(data, addr, hostname, port);
1454 Curl_share_unlock(data, CURL_LOCK_DATA_DNS);
1457 return CURLE_OUT_OF_MEMORY;
1460 data->change.resolve = NULL; /* dealt with now */
1467 * Curl_pretransfer() is called immediately before a transfer starts.
1469 CURLcode Curl_pretransfer(struct SessionHandle *data)
1472 if(!data->change.url) {
1473 /* we can't do anything without URL */
1474 failf(data, "No URL set!");
1475 return CURLE_URL_MALFORMAT;
1478 /* Init the SSL session ID cache here. We do it here since we want to do it
1479 after the *_setopt() calls (that could change the size of the cache) but
1480 before any transfer takes place. */
1481 res = Curl_ssl_initsessions(data, data->set.ssl.numsessions);
1485 data->set.followlocation=0; /* reset the location-follow counter */
1486 data->state.this_is_a_follow = FALSE; /* reset this */
1487 data->state.errorbuf = FALSE; /* no error has occurred */
1488 data->state.httpversion = 0; /* don't assume any particular server version */
1490 data->state.ssl_connect_retry = FALSE;
1492 data->state.authproblem = FALSE;
1493 data->state.authhost.want = data->set.httpauth;
1494 data->state.authproxy.want = data->set.proxyauth;
1495 Curl_safefree(data->info.wouldredirect);
1496 data->info.wouldredirect = NULL;
1498 /* If there is a list of cookie files to read, do it now! */
1499 if(data->change.cookielist)
1500 Curl_cookie_loadfiles(data);
1502 /* If there is a list of host pairs to deal with */
1503 if(data->change.resolve)
1504 res = loadhostpairs(data);
1507 /* Allow data->set.use_port to set which port to use. This needs to be
1508 * disabled for example when we follow Location: headers to URLs using
1509 * different ports! */
1510 data->state.allow_port = TRUE;
1512 #if defined(HAVE_SIGNAL) && defined(SIGPIPE) && !defined(HAVE_MSG_NOSIGNAL)
1513 /*************************************************************
1514 * Tell signal handler to ignore SIGPIPE
1515 *************************************************************/
1516 if(!data->set.no_signal)
1517 data->state.prev_signal = signal(SIGPIPE, SIG_IGN);
1520 Curl_initinfo(data); /* reset session-specific information "variables" */
1521 Curl_pgrsStartNow(data);
1523 if(data->set.timeout)
1524 Curl_expire(data, data->set.timeout);
1526 if(data->set.connecttimeout)
1527 Curl_expire(data, data->set.connecttimeout);
1534 * Curl_posttransfer() is called immediately after a transfer ends
1536 CURLcode Curl_posttransfer(struct SessionHandle *data)
1538 #if defined(HAVE_SIGNAL) && defined(SIGPIPE) && !defined(HAVE_MSG_NOSIGNAL)
1539 /* restore the signal handler for SIGPIPE before we get back */
1540 if(!data->set.no_signal)
1541 signal(SIGPIPE, data->state.prev_signal);
1543 (void)data; /* unused parameter */
1549 #ifndef CURL_DISABLE_HTTP
1551 * strlen_url() returns the length of the given URL if the spaces within the
1552 * URL were properly URL encoded.
1554 static size_t strlen_url(const char *url)
1558 bool left=TRUE; /* left side of the ? */
1560 for(ptr=url; *ptr; ptr++) {
1579 /* strcpy_url() copies a url to a output buffer and URL-encodes the spaces in
1580 * the source URL accordingly.
1582 static void strcpy_url(char *output, const char *url)
1584 /* we must add this with whitespace-replacing */
1587 char *optr = output;
1588 for(iptr = url; /* read from here */
1589 *iptr; /* until zero byte */
1600 *optr++='%'; /* add a '%' */
1601 *optr++='2'; /* add a '2' */
1602 *optr++='0'; /* add a '0' */
1605 *optr++='+'; /* add a '+' here */
1609 *optr=0; /* zero terminate output buffer */
1614 * Returns true if the given URL is absolute (as opposed to relative)
1616 static bool is_absolute_url(const char *url)
1618 char prot[16]; /* URL protocol string storage */
1619 char letter; /* used for a silly sscanf */
1621 return (bool)(2 == sscanf(url, "%15[^?&/:]://%c", prot, &letter));
1625 * Concatenate a relative URL to a base URL making it absolute.
1626 * URL-encodes any spaces.
1627 * The returned pointer must be freed by the caller unless NULL
1628 * (returns NULL on out of memory).
1630 static char *concat_url(const char *base, const char *relurl)
1633 TRY to append this new path to the old URL
1634 to the right of the host part. Oh crap, this is doomed to cause
1635 problems in the future...
1642 const char *useurl = relurl;
1645 /* we must make our own copy of the URL to play with, as it may
1646 point to read-only data */
1647 char *url_clone=strdup(base);
1650 return NULL; /* skip out of this NOW */
1652 /* protsep points to the start of the host name */
1653 protsep=strstr(url_clone, "//");
1657 protsep+=2; /* pass the slashes */
1659 if('/' != relurl[0]) {
1662 /* First we need to find out if there's a ?-letter in the URL,
1663 and cut it and the right-side of that off */
1664 pathsep = strchr(protsep, '?');
1668 /* we have a relative path to append to the last slash if there's one
1669 available, or if the new URL is just a query string (starts with a
1670 '?') we append the new one at the end of the entire currently worked
1672 if(useurl[0] != '?') {
1673 pathsep = strrchr(protsep, '/');
1678 /* Check if there's any slash after the host name, and if so, remember
1679 that position instead */
1680 pathsep = strchr(protsep, '/');
1682 protsep = pathsep+1;
1686 /* now deal with one "./" or any amount of "../" in the newurl
1687 and act accordingly */
1689 if((useurl[0] == '.') && (useurl[1] == '/'))
1690 useurl+=2; /* just skip the "./" */
1692 while((useurl[0] == '.') &&
1693 (useurl[1] == '.') &&
1694 (useurl[2] == '/')) {
1696 useurl+=3; /* pass the "../" */
1701 /* cut off one more level from the right of the original URL */
1702 pathsep = strrchr(protsep, '/');
1713 /* We got a new absolute path for this server, cut off from the
1715 pathsep = strchr(protsep, '/');
1717 /* When people use badly formatted URLs, such as
1718 "http://www.url.com?dir=/home/daniel" we must not use the first
1719 slash, if there's a ?-letter before it! */
1720 char *sep = strchr(protsep, '?');
1721 if(sep && (sep < pathsep))
1726 /* There was no slash. Now, since we might be operating on a badly
1727 formatted URL, such as "http://www.url.com?id=2380" which doesn't
1728 use a slash separator as it is supposed to, we need to check for a
1729 ?-letter as well! */
1730 pathsep = strchr(protsep, '?');
1736 /* If the new part contains a space, this is a mighty stupid redirect
1737 but we still make an effort to do "right". To the left of a '?'
1738 letter we replace each space with %20 while it is replaced with '+'
1739 on the right side of the '?' letter.
1741 newlen = strlen_url(useurl);
1743 urllen = strlen(url_clone);
1745 newest = malloc( urllen + 1 + /* possible slash */
1746 newlen + 1 /* zero byte */);
1749 free(url_clone); /* don't leak this */
1753 /* copy over the root url part */
1754 memcpy(newest, url_clone, urllen);
1756 /* check if we need to append a slash */
1757 if(('/' == useurl[0]) || (protsep && !*protsep) || ('?' == useurl[0]))
1760 newest[urllen++]='/';
1762 /* then append the new piece on the right side */
1763 strcpy_url(&newest[urllen], useurl);
1769 #endif /* CURL_DISABLE_HTTP */
1772 * Curl_follow() handles the URL redirect magic. Pass in the 'newurl' string
1773 * as given by the remote server and set up the new URL to request.
1775 CURLcode Curl_follow(struct SessionHandle *data,
1776 char *newurl, /* this 'newurl' is the Location: string,
1777 and it must be malloc()ed before passed
1779 followtype type) /* see transfer.h */
1781 #ifdef CURL_DISABLE_HTTP
1785 /* Location: following will not happen when HTTP is disabled */
1786 return CURLE_TOO_MANY_REDIRECTS;
1789 /* Location: redirect */
1790 bool disallowport = FALSE;
1792 if(type == FOLLOW_REDIR) {
1793 if((data->set.maxredirs != -1) &&
1794 (data->set.followlocation >= data->set.maxredirs)) {
1795 failf(data,"Maximum (%ld) redirects followed", data->set.maxredirs);
1796 return CURLE_TOO_MANY_REDIRECTS;
1799 /* mark the next request as a followed location: */
1800 data->state.this_is_a_follow = TRUE;
1802 data->set.followlocation++; /* count location-followers */
1804 if(data->set.http_auto_referer) {
1805 /* We are asked to automatically set the previous URL as the referer
1806 when we get the next URL. We pick the ->url field, which may or may
1807 not be 100% correct */
1809 if(data->change.referer_alloc)
1810 /* If we already have an allocated referer, free this first */
1811 free(data->change.referer);
1813 data->change.referer = strdup(data->change.url);
1814 if(!data->change.referer) {
1815 data->change.referer_alloc = FALSE;
1816 return CURLE_OUT_OF_MEMORY;
1818 data->change.referer_alloc = TRUE; /* yes, free this later */
1822 if(!is_absolute_url(newurl)) {
1824 *DANG* this is an RFC 2068 violation. The URL is supposed
1825 to be absolute and this doesn't seem to be that!
1827 char *absolute = concat_url(data->change.url, newurl);
1829 return CURLE_OUT_OF_MEMORY;
1834 /* This is an absolute URL, don't allow the custom port number */
1835 disallowport = TRUE;
1837 if(strchr(newurl, ' ')) {
1838 /* This new URL contains at least one space, this is a mighty stupid
1839 redirect but we still make an effort to do "right". */
1841 size_t newlen = strlen_url(newurl);
1843 newest = malloc(newlen+1); /* get memory for this */
1845 return CURLE_OUT_OF_MEMORY;
1846 strcpy_url(newest, newurl); /* create a space-free URL */
1848 free(newurl); /* that was no good */
1849 newurl = newest; /* use this instead now */
1854 if(type == FOLLOW_FAKE) {
1855 /* we're only figuring out the new url if we would've followed locations
1856 but now we're done so we can get out! */
1857 data->info.wouldredirect = newurl;
1862 data->state.allow_port = FALSE;
1864 if(data->change.url_alloc)
1865 free(data->change.url);
1867 data->change.url_alloc = TRUE; /* the URL is allocated */
1869 data->change.url = newurl;
1870 newurl = NULL; /* don't free! */
1872 infof(data, "Issue another request to this URL: '%s'\n", data->change.url);
1875 * We get here when the HTTP code is 300-399 (and 401). We need to perform
1876 * differently based on exactly what return code there was.
1878 * News from 7.10.6: we can also get here on a 401 or 407, in case we act on
1879 * a HTTP (proxy-) authentication scheme other than Basic.
1881 switch(data->info.httpcode) {
1882 /* 401 - Act on a WWW-Authenticate, we keep on moving and do the
1883 Authorization: XXXX header in the HTTP request code snippet */
1884 /* 407 - Act on a Proxy-Authenticate, we keep on moving and do the
1885 Proxy-Authorization: XXXX header in the HTTP request code snippet */
1886 /* 300 - Multiple Choices */
1887 /* 306 - Not used */
1888 /* 307 - Temporary Redirect */
1889 default: /* for all above (and the unknown ones) */
1890 /* Some codes are explicitly mentioned since I've checked RFC2616 and they
1891 * seem to be OK to POST to.
1894 case 301: /* Moved Permanently */
1895 /* (quote from RFC2616, section 10.3.2):
1897 * Note: When automatically redirecting a POST request after receiving a
1898 * 301 status code, some existing HTTP/1.0 user agents will erroneously
1899 * change it into a GET request.
1903 * Warning: Because most of importants user agents do this obvious RFC2616
1904 * violation, many webservers expect this misbehavior. So these servers
1905 * often answers to a POST request with an error page. To be sure that
1906 * libcurl gets the page that most user agents would get, libcurl has to
1909 * This behaviour can be overridden with CURLOPT_POSTREDIR.
1911 if((data->set.httpreq == HTTPREQ_POST
1912 || data->set.httpreq == HTTPREQ_POST_FORM)
1913 && !data->set.post301) {
1915 "Violate RFC 2616/10.3.2 and switch from POST to GET\n");
1916 data->set.httpreq = HTTPREQ_GET;
1919 case 302: /* Found */
1922 Note: RFC 1945 and RFC 2068 specify that the client is not allowed
1923 to change the method on the redirected request. However, most
1924 existing user agent implementations treat 302 as if it were a 303
1925 response, performing a GET on the Location field-value regardless
1926 of the original request method. The status codes 303 and 307 have
1927 been added for servers that wish to make unambiguously clear which
1928 kind of reaction is expected of the client.
1932 Note: Many pre-HTTP/1.1 user agents do not understand the 303
1933 status. When interoperability with such clients is a concern, the
1934 302 status code may be used instead, since most user agents react
1935 to a 302 response as described here for 303.
1937 This behaviour can be overriden with CURLOPT_POSTREDIR
1939 if((data->set.httpreq == HTTPREQ_POST
1940 || data->set.httpreq == HTTPREQ_POST_FORM)
1941 && !data->set.post302) {
1943 "Violate RFC 2616/10.3.3 and switch from POST to GET\n");
1944 data->set.httpreq = HTTPREQ_GET;
1948 case 303: /* See Other */
1949 /* Disable both types of POSTs, since doing a second POST when
1950 * following isn't what anyone would want! */
1951 if(data->set.httpreq != HTTPREQ_GET) {
1952 data->set.httpreq = HTTPREQ_GET; /* enforce GET request */
1953 infof(data, "Disables POST, goes with %s\n",
1954 data->set.opt_no_body?"HEAD":"GET");
1957 case 304: /* Not Modified */
1958 /* 304 means we did a conditional request and it was "Not modified".
1959 * We shouldn't get any Location: header in this response!
1962 case 305: /* Use Proxy */
1963 /* (quote from RFC2616, section 10.3.6):
1964 * "The requested resource MUST be accessed through the proxy given
1965 * by the Location field. The Location field gives the URI of the
1966 * proxy. The recipient is expected to repeat this single request
1967 * via the proxy. 305 responses MUST only be generated by origin
1972 Curl_pgrsTime(data, TIMER_REDIRECT);
1973 Curl_pgrsResetTimes(data);
1976 #endif /* CURL_DISABLE_HTTP */
1980 connect_host(struct SessionHandle *data,
1981 struct connectdata **conn)
1983 CURLcode res = CURLE_OK;
1986 bool protocol_done=TRUE; /* will be TRUE always since this is only used
1987 within the easy interface */
1988 Curl_pgrsTime(data, TIMER_STARTSINGLE);
1989 res = Curl_connect(data, conn, &async, &protocol_done);
1991 if((CURLE_OK == res) && async) {
1992 /* Now, if async is TRUE here, we need to wait for the name
1994 res = Curl_resolver_wait_resolv(*conn, NULL);
1996 /* Resolved, continue with the connection */
1997 res = Curl_async_resolved(*conn, &protocol_done);
1999 /* if we can't resolve, we kill this "connection" now */
2000 (void)Curl_disconnect(*conn, /* dead_connection */ FALSE);
2007 Curl_reconnect_request(struct connectdata **connp)
2009 CURLcode result = CURLE_OK;
2010 struct connectdata *conn = *connp;
2011 struct SessionHandle *data = conn->data;
2013 /* This was a re-use of a connection and we got a write error in the
2014 * DO-phase. Then we DISCONNECT this connection and have another attempt to
2015 * CONNECT and then DO again! The retry cannot possibly find another
2016 * connection to re-use, since we only keep one possible connection for
2019 infof(data, "Re-used connection seems dead, get a new one\n");
2021 conn->bits.close = TRUE; /* enforce close of this connection */
2022 result = Curl_done(&conn, result, FALSE); /* we are so done with this */
2024 /* conn may no longer be a good pointer */
2027 * According to bug report #1330310. We need to check for CURLE_SEND_ERROR
2028 * here as well. I figure this could happen when the request failed on a FTP
2029 * connection and thus Curl_done() itself tried to use the connection
2030 * (again). Slight Lack of feedback in the report, but I don't think this
2031 * extra check can do much harm.
2033 if((CURLE_OK == result) || (CURLE_SEND_ERROR == result)) {
2035 bool protocol_done = TRUE;
2037 /* Now, redo the connect and get a new connection */
2038 result = Curl_connect(data, connp, &async, &protocol_done);
2039 if(CURLE_OK == result) {
2040 /* We have connected or sent away a name resolve query fine */
2042 conn = *connp; /* setup conn to again point to something nice */
2044 /* Now, if async is TRUE here, we need to wait for the name
2046 result = Curl_resolver_wait_resolv(conn, NULL);
2050 /* Resolved, continue with the connection */
2051 result = Curl_async_resolved(conn, &protocol_done);
2061 /* Returns CURLE_OK *and* sets '*url' if a request retry is wanted.
2063 NOTE: that the *url is malloc()ed. */
2064 CURLcode Curl_retry_request(struct connectdata *conn,
2067 struct SessionHandle *data = conn->data;
2071 /* if we're talking upload, we can't do the checks below, unless the protocol
2072 is HTTP as when uploading over HTTP we will still get a response */
2073 if(data->set.upload &&
2074 !(conn->handler->protocol&(CURLPROTO_HTTP|CURLPROTO_RTSP)))
2077 if(/* workaround for broken TLS servers */ data->state.ssl_connect_retry ||
2078 ((data->req.bytecount +
2079 data->req.headerbytecount == 0) &&
2081 !data->set.opt_no_body &&
2082 data->set.rtspreq != RTSPREQ_RECEIVE)) {
2083 /* We got no data, we attempted to re-use a connection and yet we want a
2084 "body". This might happen if the connection was left alive when we were
2085 done using it before, but that was closed when we wanted to read from
2086 it again. Bad luck. Retry the same request on a fresh connect! */
2087 infof(conn->data, "Connection died, retrying a fresh connect\n");
2088 *url = strdup(conn->data->change.url);
2090 return CURLE_OUT_OF_MEMORY;
2092 conn->bits.close = TRUE; /* close this connection */
2093 conn->bits.retry = TRUE; /* mark this as a connection we're about
2094 to retry. Marking it this way should
2095 prevent i.e HTTP transfers to return
2096 error just because nothing has been
2099 if(data->state.proto.http->writebytecount)
2100 Curl_readrewind(conn);
2105 static CURLcode Curl_do_perform(struct SessionHandle *data)
2109 struct connectdata *conn=NULL;
2110 char *newurl = NULL; /* possibly a new URL to follow to! */
2111 followtype follow = FOLLOW_NONE;
2113 data->state.used_interface = Curl_if_easy;
2115 res = Curl_pretransfer(data);
2120 * It is important that there is NO 'return' from this function at any other
2121 * place than falling down to the end of the function! This is because we
2122 * have cleanup stuff that must be done before we get back, and that is only
2123 * performed after this do-while loop.
2127 res = connect_host(data, &conn); /* primary connection */
2129 if(res == CURLE_OK) {
2131 if(data->set.connect_only) {
2132 /* keep connection open for application to use the socket */
2133 conn->bits.close = FALSE;
2134 res = Curl_done(&conn, CURLE_OK, FALSE);
2137 res = Curl_do(&conn, &do_done);
2139 if(res == CURLE_OK) {
2140 if(conn->data->set.wildcardmatch) {
2141 if(conn->data->wildcard.state == CURLWC_DONE ||
2142 conn->data->wildcard.state == CURLWC_SKIP) {
2143 /* keep connection open for application to use the socket */
2144 conn->bits.close = FALSE;
2145 res = Curl_done(&conn, CURLE_OK, FALSE);
2149 res = Transfer(conn); /* now fetch that URL please */
2150 if((res == CURLE_OK) || (res == CURLE_RECV_ERROR)) {
2152 CURLcode rc = Curl_retry_request(conn, &newurl);
2156 retry = (newurl?TRUE:FALSE);
2159 /* we know (newurl != NULL) at this point */
2161 follow = FOLLOW_RETRY;
2163 else if(res == CURLE_OK) {
2165 * We must duplicate the new URL here as the connection data may
2166 * be free()ed in the Curl_done() function. We prefer the newurl
2167 * one since that's used for redirects or just further requests
2168 * for retries or multi-stage HTTP auth methods etc.
2170 if(data->req.newurl) {
2171 follow = FOLLOW_REDIR;
2172 newurl = strdup(data->req.newurl);
2174 res = CURLE_OUT_OF_MEMORY;
2176 else if(data->req.location) {
2177 follow = FOLLOW_FAKE;
2178 newurl = strdup(data->req.location);
2180 res = CURLE_OUT_OF_MEMORY;
2184 /* in the above cases where 'newurl' gets assigned, we have a fresh
2185 * allocated memory pointed to */
2187 if(res != CURLE_OK) {
2188 /* The transfer phase returned error, we mark the connection to get
2189 * closed to prevent being re-used. This is because we can't
2190 * possibly know if the connection is in a good shape or not now. */
2191 conn->bits.close = TRUE;
2193 if(CURL_SOCKET_BAD != conn->sock[SECONDARYSOCKET]) {
2194 /* if we failed anywhere, we must clean up the secondary socket if
2196 Curl_closesocket(conn, conn->sock[SECONDARYSOCKET]);
2197 conn->sock[SECONDARYSOCKET] = CURL_SOCKET_BAD;
2201 /* Always run Curl_done(), even if some of the previous calls
2202 failed, but return the previous (original) error code */
2203 res2 = Curl_done(&conn, res, FALSE);
2209 /* Curl_do() failed, clean up left-overs in the done-call, but note
2210 that at some cases the conn pointer is NULL when Curl_do() failed
2211 and the connection cache is very small so only call Curl_done() if
2212 conn is still "alive". */
2213 /* ignore return code since we already have an error to return */
2214 (void)Curl_done(&conn, res, FALSE);
2217 * Important: 'conn' cannot be used here, since it may have been closed
2218 * in 'Curl_done' or other functions.
2221 if((res == CURLE_OK) && follow) {
2222 res = Curl_follow(data, newurl, follow);
2223 if(CURLE_OK == res) {
2224 /* if things went fine, Curl_follow() freed or otherwise took
2225 responsibility for the newurl pointer */
2227 if(follow >= FOLLOW_RETRY) {
2228 follow = FOLLOW_NONE;
2231 /* else we break out of the loop below */
2235 break; /* it only reaches here when this shouldn't loop */
2237 } /* loop if Location: */
2242 if(res && !data->state.errorbuf) {
2244 * As an extra precaution: if no error string has been set and there was
2245 * an error, use the strerror() string or if things are so bad that not
2246 * even that is good, set a bad string that mentions the error code.
2248 const char *str = curl_easy_strerror(res);
2250 failf(data, "unspecified error %d", (int)res);
2252 failf(data, "%s", str);
2255 /* run post-transfer unconditionally, but don't clobber the return code if
2256 we already have an error code recorder */
2257 res2 = Curl_posttransfer(data);
2265 * Curl_perform() is the internal high-level function that gets called by the
2266 * external curl_easy_perform() function. It inits, performs and cleans up a
2267 * single file transfer.
2269 CURLcode Curl_perform(struct SessionHandle *data)
2272 if(!data->set.wildcardmatch)
2273 return Curl_do_perform(data);
2275 /* init main wildcard structures */
2276 res = Curl_wildcard_init(&data->wildcard);
2280 res = Curl_do_perform(data);
2282 Curl_wildcard_dtor(&data->wildcard);
2287 while(!res && data->wildcard.state != CURLWC_DONE)
2288 res = Curl_do_perform(data);
2290 Curl_wildcard_dtor(&data->wildcard);
2292 /* wildcard download finished or failed */
2293 data->wildcard.state = CURLWC_INIT;
2298 * Curl_setup_transfer() is called to setup some basic properties for the
2299 * upcoming transfer.
2302 Curl_setup_transfer(
2303 struct connectdata *conn, /* connection data */
2304 int sockindex, /* socket index to read from or -1 */
2305 curl_off_t size, /* -1 if unknown at this point */
2306 bool getheader, /* TRUE if header parsing is wanted */
2307 curl_off_t *bytecountp, /* return number of bytes read or NULL */
2308 int writesockindex, /* socket index to write to, it may very well be
2309 the same we read from. -1 disables */
2310 curl_off_t *writecountp /* return number of bytes written or NULL */
2313 struct SessionHandle *data;
2314 struct SingleRequest *k;
2316 DEBUGASSERT(conn != NULL);
2321 DEBUGASSERT((sockindex <= 1) && (sockindex >= -1));
2323 /* now copy all input parameters */
2324 conn->sockfd = sockindex == -1 ?
2325 CURL_SOCKET_BAD : conn->sock[sockindex];
2326 conn->writesockfd = writesockindex == -1 ?
2327 CURL_SOCKET_BAD:conn->sock[writesockindex];
2328 k->getheader = getheader;
2331 k->bytecountp = bytecountp;
2332 k->writebytecountp = writecountp;
2334 /* The code sequence below is placed in this function just because all
2335 necessary input is not always known in do_complete() as this function may
2336 be called after that */
2341 Curl_pgrsSetDownloadSize(data, size);
2343 /* we want header and/or body, if neither then don't do this! */
2344 if(k->getheader || !data->set.opt_no_body) {
2346 if(conn->sockfd != CURL_SOCKET_BAD)
2347 k->keepon |= KEEP_RECV;
2349 if(conn->writesockfd != CURL_SOCKET_BAD) {
2352 Even if we require a 100-return code before uploading data, we might
2353 need to write data before that since the REQUEST may not have been
2354 finished sent off just yet.
2356 Thus, we must check if the request has been sent before we set the
2357 state info where we wait for the 100-return code
2359 if((data->state.expect100header) &&
2360 (data->state.proto.http->sending == HTTPSEND_BODY)) {
2361 /* wait with write until we either got 100-continue or a timeout */
2362 k->exp100 = EXP100_AWAITING_CONTINUE;
2363 k->start100 = k->start;
2365 /* set a timeout for the multi interface */
2366 Curl_expire(data, CURL_TIMEOUT_EXPECT_100);
2369 if(data->state.expect100header)
2370 /* when we've sent off the rest of the headers, we must await a
2371 100-continue but first finish sending the request */
2372 k->exp100 = EXP100_SENDING_REQUEST;
2374 /* enable the write bit when we're not waiting for continue */
2375 k->keepon |= KEEP_SEND;
2377 } /* if(conn->writesockfd != CURL_SOCKET_BAD) */
2378 } /* if(k->getheader || !data->set.opt_no_body) */