curl/lib
Gisle Vanem 89fa3b3efb lib/Makefile.b32: updates
* Rename the object object directory from 'objs' to 'BCC_obj'. I feel
 it should be named properly. Ref. Makefile.Watcom where it's called
 'WC_Win32.obj'.

* Turn off these warnings to keep the build totally silent (with CBuilder-6
 that is).
  -w-inl    8026 Functions X are not expanded inline.
  -w-pia   8060 Possibly incorrect assignment
  -w-pin  8061 Initialization is only partially bracketed

I'm sure the warnings could be fixed the "proper" way or with some added
"#pragma" statements. But that just clutters the sources IMHO.

* $(MKDIR) and $(RMDIR) have been replaced with the shell-commands 'md'
 and 'rd'. When having MingW/Msys programs 'mkdir.exe' and 'rmdir.exe' in
$PATH, this confuses Borland's make and the result (the cleaning etc.) would
 not be as expected.

* Added a ".path.int = $(OBJDIR)" to tell make where the $(PREPROCESSED)
 files are. Why we need the preprocess step in the fist place is beyond me
(Yang?). But I'll leave that for now.
2011-04-07 15:17:58 +02:00
..
.gitignore gitignore: ignore Makefile.vc10.dist made by maketgz 2010-10-13 00:26:19 +02:00
amigaos.c
amigaos.h
arpa_telnet.h
axtls.c Fixed include: memory.h -> curl_memory.h. 2010-12-22 03:34:13 +01:00
axtls.h return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
base64.c
CMakeLists.txt
config-amigaos.h build: provide SIZEOF_SIZE_T definition for non-configure builds 2010-12-02 21:41:23 +01:00
config-dos.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-mac.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-os400.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-riscos.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-symbian.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-tpf.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-vms.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-vxworks.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-win32.h sources: update source headers 2011-03-10 12:04:33 +01:00
config-win32ce.h sources: update source headers 2011-03-10 12:04:33 +01:00
connect.c SOCKOPTFUNCTION: callback can say already-connected 2011-02-17 22:32:01 +01:00
connect.h Curl_timeleft: s/conn/data in first argument 2011-01-04 23:13:10 +01:00
content_encoding.c
content_encoding.h
cookie.c disable cookies: remove ifdefs, move code 2011-04-04 19:27:26 +02:00
cookie.h disable cookies: remove ifdefs, move code 2011-04-04 19:27:26 +02:00
curl_addrinfo.c Curl_getaddrinfo_ex: sanitize function results follow-up. 2010-11-24 04:36:57 +01:00
curl_addrinfo.h CURLOPT_RESOLVE: added 2010-11-08 08:56:21 +01:00
curl_base64.h
curl_config.h.cmake
curl_fnmatch.c
curl_fnmatch.h
curl_gethostname.c
curl_gethostname.h
curl_hmac.h
curl_ldap.h Fixed libcurl to honour the --disable-ldaps configure option 2011-03-07 17:45:33 -08:00
curl_md4.h
curl_md5.h
curl_memory.h
curl_memrchr.c
curl_memrchr.h
curl_rand.c
curl_rand.h
curl_rtmp.c protocols: use CURLPROTO_ internally 2011-03-14 22:52:14 +01:00
curl_rtmp.h
curl_sspi.c
curl_sspi.h
curl_threads.c
curl_threads.h
curlx.h Typo fixes. 2010-12-21 22:39:56 +01:00
cyassl.c cyassl: fix compiler warnings 2011-03-08 14:09:20 +01:00
cyassl.h return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
dict.c protocols: use CURLPROTO_ internally 2011-03-14 22:52:14 +01:00
dict.h
easy.c disable cookies: remove ifdefs, move code 2011-04-04 19:27:26 +02:00
easyif.h
escape.c curl_easy_escape: don't escape "unreserved" characters 2010-09-28 23:49:32 +02:00
escape.h
file.c protocols: use CURLPROTO_ internally 2011-03-14 22:52:14 +01:00
file.h
fileinfo.c
fileinfo.h
firefox-db2pem.sh
formdata.c fix compiler warning 2010-11-08 04:03:11 +01:00
formdata.h formdata: provide error message 2010-10-20 14:57:43 +02:00
ftp.c return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
ftp.h
ftplistparser.c ftp_parselist: fix compiler warning 2010-12-19 00:15:12 +01:00
ftplistparser.h
getenv.c
getinfo.c fix getinfo CURLINFO_LOCAL* for reused connections (take 2) 2010-11-30 22:14:37 +01:00
getinfo.h
gopher.c protocols: use CURLPROTO_ internally 2011-03-14 22:52:14 +01:00
gopher.h
gtls.c CURLE_TLSAUTH_FAILED: removed 2011-02-09 23:34:30 +01:00
gtls.h return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
hash.c
hash.h
hmac.c fix compiler warning 2010-11-08 04:03:11 +01:00
hostares.c ares_query_completed_cb: don't touch invalid data 2011-01-27 14:41:07 +01:00
hostasyn.c ares: memory leak fix 2011-01-27 14:41:07 +01:00
hostip4.c ip_version: moved to connection struct 2010-11-11 15:16:21 +01:00
hostip6.c ipv6: only probe once 2011-03-23 11:10:55 +01:00
hostip.c fix compiler warning: conversion may lose significant bits 2010-12-01 23:33:43 +01:00
hostip.h ipv6: only probe once 2011-03-23 11:10:55 +01:00
hostsyn.c
hostthre.c ipv6: only probe once 2011-03-23 11:10:55 +01:00
http_chunks.c http_chunks: remove debug output 2010-10-17 18:50:38 +02:00
http_chunks.h
http_digest.c fix compiler warning 2010-11-08 04:03:11 +01:00
http_digest.h
http_negotiate_sspi.c Added casts to silent gcc warnings. 2011-01-14 12:39:54 +01:00
http_negotiate.c
http_negotiate.h HTTP: HTTP Negotiate authentication using SSPI 2011-01-07 23:48:40 +01:00
http_ntlm.c
http_ntlm.h
http_proxy.c http-proxy: move proxy code to http_proxy.c 2011-04-04 19:38:00 +02:00
http_proxy.h Don't list NTLM in curl-config when HTTP is disabled 2011-04-05 22:29:21 -07:00
http.c http-proxy: move proxy code to http_proxy.c 2011-04-04 19:38:00 +02:00
http.h http-proxy: move proxy code to http_proxy.c 2011-04-04 19:38:00 +02:00
idn_win32.c IDN: use win32 API if told to 2010-12-28 20:01:03 +01:00
if2ip.c
if2ip.h
imap.c http-proxy: move proxy code to http_proxy.c 2011-04-04 19:38:00 +02:00
imap.h IMAP in multi mode: use Curl_ssl_connect_nonblocking() when upgrading the connection to TLS/SSL. 2011-02-20 21:11:12 +01:00
inet_ntop.c
inet_ntop.h
inet_pton.c inet_pton: fix compiler warning 2010-11-25 02:20:14 +01:00
inet_pton.h
krb4.c urldata: Capitalize enum protect_level values. 2010-11-13 14:42:34 -08:00
krb4.h security: tighten enum protection_level usage. 2010-11-13 14:12:43 -08:00
krb5.c compiler warnings fixed 2011-03-16 00:08:32 +01:00
ldap.c buildfix: spell define correctly 2011-03-15 16:49:27 +01:00
libcurl.def
libcurl.imp
libcurl.plist
libcurl.rc
llist.c
llist.h
Makefile.am unittesting: build a separate static lib 2011-01-03 22:16:16 +01:00
makefile.amiga
Makefile.b32 lib/Makefile.b32: updates 2011-04-07 15:17:58 +02:00
makefile.dj build: lib/config.dos renamed to lib/config-dos.h 2010-12-03 04:13:33 +01:00
Makefile.inc http-proxy: move proxy code to http_proxy.c 2011-04-04 19:38:00 +02:00
Makefile.m32 Updated OpenSSL version, added links to docu. 2011-02-13 12:13:21 +01:00
Makefile.netware Set -fpcc-struct-return only for gcc compiler. 2011-02-17 11:46:41 +01:00
Makefile.vc6 http-proxy: move proxy code to http_proxy.c 2011-04-04 19:38:00 +02:00
Makefile.vxworks
Makefile.Watcom Updated OpenSSL version, added links to docu. 2011-02-13 12:13:21 +01:00
md4.c
md5.c
memdebug.c
memdebug.h
mk-ca-bundle.pl Increased script version. 2011-04-01 15:04:53 +02:00
mk-ca-bundle.vbs mk-ca-bundle.vbs: use new cacert url 2011-02-03 09:59:00 +01:00
mprintf.c
msvcproj.foot
msvcproj.head
multi.c multi: shorten lines 2011-04-03 00:07:32 +02:00
multiif.h
netrc.c netrc: Removed _NETRC_DEBUG code. 2011-02-20 21:11:53 -08:00
netrc.h test1304: Added some unit tests for Curl_parsenetrc. 2011-02-10 07:38:48 -08:00
nonblock.c
nonblock.h
nss.c nss: fix a crash within SSL_AuthCertificate() 2011-04-04 18:34:19 +02:00
nssg.h return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
nwlib.c
nwos.c
openldap.c http-proxy: move proxy code to http_proxy.c 2011-04-04 19:38:00 +02:00
parsedate.c gmtime: remove define 2011-02-14 13:42:01 +01:00
parsedate.h Curl_gmtime: added a portable gmtime 2011-02-07 15:00:48 +01:00
pingpong.c Trival comment fix. 2010-12-18 17:08:23 +01:00
pingpong.h
polarssl.c PolarSSL: Return 0 on receiving TLS CLOSE_NOTIFY alert 2011-02-18 09:17:32 +01:00
polarssl.h return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
pop3.c [pop3 starttls] PASS command was not sent after upgrade to TLS. 2011-04-05 13:38:31 +02:00
pop3.h Added support for LISTing a single POP3 message 2011-03-17 16:59:30 -07:00
progress.c progress: don't print the last update on a separate line. 2011-03-21 21:00:56 -07:00
progress.h
qssl.c Curl_timeleft: s/conn/data in first argument 2011-01-04 23:13:10 +01:00
qssl.h return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
rawstr.c
rawstr.h cpp: correct #endif placement 2011-03-06 23:00:28 +01:00
README.ares README.ares: we know require c-ares 1.6.0 2010-09-30 23:14:58 +02:00
README.curl_off_t
README.curlx
README.encoding
README.hostip
README.httpauth
README.memoryleak
README.multi_socket
README.pingpong
README.pipelining
rtsp.c rtsp: move protocol code to dedicated file 2011-03-23 17:27:58 +01:00
rtsp.h rtsp: move protocol code to dedicated file 2011-03-23 17:27:58 +01:00
security.c urldata: Capitalize enum protect_level values. 2010-11-13 14:42:34 -08:00
select.c
select.h
sendf.c protocols: use CURLPROTO_ internally 2011-03-14 22:52:14 +01:00
sendf.h
setup_once.h gmtime: remove define 2011-02-14 13:42:01 +01:00
setup-os400.h
setup.h SSL: (part 2) Added CyaSSL to SSL abstraction layer 2011-03-08 13:54:58 +01:00
share.c disable cookies: remove ifdefs, move code 2011-04-04 19:27:26 +02:00
share.h
slist.c
slist.h
smtp.c http-proxy: move proxy code to http_proxy.c 2011-04-04 19:38:00 +02:00
smtp.h SMTP-multi: non-blocking connect 2011-03-15 20:10:02 +01:00
sockaddr.h
socks_gssapi.c Changed some nonportable types 2011-04-05 22:31:45 -07:00
socks_sspi.c Changed some nonportable types 2011-04-05 22:31:45 -07:00
socks.c Curl_timeleft: s/conn/data in first argument 2011-01-04 23:13:10 +01:00
socks.h return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
speedcheck.c
speedcheck.h
splay.c
splay.h
ssh.c protocols: use CURLPROTO_ internally 2011-03-14 22:52:14 +01:00
ssh.h
sslgen.c SSL: (part 2) Added CyaSSL to SSL abstraction layer 2011-03-08 13:54:58 +01:00
sslgen.h return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
ssluse.c TSL-SRP: enabled with OpenSSL 2011-03-25 23:09:28 +01:00
ssluse.h
strdup.c
strdup.h
strequal.c
strequal.h
strerror.c return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
strerror.h
strtok.c
strtok.h
strtoofft.c
strtoofft.h Typo fixes. 2010-12-21 22:39:56 +01:00
telnet.c protocols: use CURLPROTO_ internally 2011-03-14 22:52:14 +01:00
telnet.h
tftp.c protocols: use CURLPROTO_ internally 2011-03-14 22:52:14 +01:00
tftp.h
timeval.c
timeval.h
transfer.c HTTP pipelining: Fix handling of zero-length responses 2011-04-07 14:18:07 +02:00
transfer.h transfer: avoid insane conversion of time_t 2011-03-04 21:17:08 +01:00
url.c return code cleanup: build, init and run-time errors 2011-04-05 15:14:02 +02:00
url.h url: provide dead_connection flag in Curl_handler::disconnect 2010-12-06 14:35:42 +01:00
urldata.h fix: re-use of bound connections 2011-03-25 16:03:37 +01:00
vc6libcurl.dsw
vc8proj.foot
vc8proj.head
version.c Fixed libcurl to honour the --disable-ldaps configure option 2011-03-07 17:45:33 -08:00
warnless.c fix compiler warning: conversion may lose significant bits 2010-12-04 05:53:07 +01:00
warnless.h fix compiler warning: conversion may lose significant bits 2010-12-04 05:53:07 +01:00
wildcard.c
wildcard.h

HTTP Pipelining with libcurl
============================

Background

Since pipelining implies that one or more requests are sent to a server before
the previous response(s) have been received, we only support it for multi
interface use.

Considerations

When using the multi interface, you create one easy handle for each transfer.
Bascially any number of handles can be created, added and used with the multi
interface - simultaneously. It is an interface designed to allow many
simultaneous transfers while still using a single thread. Pipelining does not
change any of these details.

API

We've added a new option to curl_multi_setopt() called CURLMOPT_PIPELINING
that enables "attempted pipelining" and then all easy handles used on that
handle will attempt to use an existing pipeline.

Details

- A pipeline is only created if a previous connection exists to the same IP
  address that the new request is being made to use.

- Pipelines are only supported for HTTP(S) as no other currently supported
  protocol has features resemembling this, but we still name this feature
  plain 'pipelining' to possibly one day support it for other protocols as
  well.

- HTTP Pipelining is for GET and HEAD requests only.

- When a pipeline is in use, we must take precautions so that when used easy
  handles (i.e those who still wait for a response) are removed from the multi
  handle, we must deal with the outstanding response nicely.

- Explicitly asking for pipelining handle X and handle Y won't be supported.
  It isn't easy for an app to do this association. The lib should probably
  still resolve the second one properly to make sure that they actually _can_
  be considered for pipelining. Also, asking for explicit pipelining on handle
  X may be tricky when handle X get a closed connection.

- We need options to control max pipeline length, and probably how to behave
  if we reach that limit. As was discussed on the list, it can probably be
  made very complicated, so perhaps we can think of a way to pass all
  variables involved to a callback and let the application decide how to act
  in specific situations. Either way, these fancy options are only interesting
  to work on when everything is working and we have working apps to test with.