curl/lib
Daniel Stenberg 0ff0a994ad Curl_thread_create: use Curl_safefree to allow NULL better
free() itself allows a NULL input but our memory debug system requires
Curl_safefree() to be used instead when a "legitimate" NULL may be freed. Like
in the code here.

Pointed-out-by: Steve Holme
2013-12-25 00:53:15 +01:00
..
vtls vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
.gitignore
amigaos.c
amigaos.h
arpa_telnet.h
asyn-ares.c ares: Fixed compilation under Visual Studio 2012 2013-11-10 17:37:32 +00:00
asyn-thread.c dns: fix compilation with MinGW from commit df69440d05 2013-09-17 20:59:43 +01:00
asyn.h
base64.c base64: Corrected typo from commit f3ee587775 2013-12-01 16:43:57 +00:00
bundles.c
bundles.h
checksrc.pl
CMakeLists.txt
config-amigaos.h
config-dos.h
config-mac.h
config-os400.h OS400: sync RPG wrapper, zlib support, fix header file names, ... 2013-10-25 18:37:37 +02:00
config-riscos.h
config-symbian.h
config-tpf.h
config-vxworks.h
config-win32.h win32: fix Visual Studio 2010 build with WINVER >= 0x600 2013-09-28 23:18:19 +02:00
config-win32ce.h
conncache.c
conncache.h
connect.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
connect.h connect.h: Updated copyright year for last edit 2013-11-05 07:15:01 +00:00
content_encoding.c
content_encoding.h
cookie.c cookies: add expiration 2013-09-17 23:25:56 +02:00
cookie.h
curl_addrinfo.c
curl_addrinfo.h
curl_base64.h
curl_config.h.cmake
curl_fnmatch.c
curl_fnmatch.h
curl_gethostname.c
curl_gethostname.h
curl_gssapi.c
curl_gssapi.h
curl_hmac.h
curl_ldap.h
curl_md4.h
curl_md5.h
curl_memory.h
curl_memrchr.c
curl_memrchr.h
curl_multibyte.c
curl_multibyte.h
curl_ntlm_core.c
curl_ntlm_core.h
curl_ntlm_msgs.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
curl_ntlm_msgs.h
curl_ntlm_wb.c winbind: Fixed ntlm_auth expecting eol following commit e17c1b25bc 2013-11-04 20:12:22 +00:00
curl_ntlm_wb.h
curl_ntlm.c http: Added authentication message header value extraction 2013-10-31 19:15:33 +00:00
curl_ntlm.h
curl_rtmp.c
curl_rtmp.h
curl_sasl.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
curl_sasl.h email: Added support for cancelling NTLM authentication 2013-10-27 22:25:18 +00:00
curl_sec.h security.h: rename to curl_sec.h to avoid name collision 2013-08-26 11:51:18 +02:00
curl_setup_once.h curl_setup_once: fix errno access for lwip on Windows 2013-10-09 14:45:42 +02:00
curl_setup.h
curl_sspi.c
curl_sspi.h
curl_threads.c Curl_thread_create: use Curl_safefree to allow NULL better 2013-12-25 00:53:15 +01:00
curl_threads.h threaded resolver: Use pthread_t * for curl_thread_t 2013-12-25 00:28:28 +01:00
curlx.h
dict.c
dict.h
dotdot.c
dotdot.h
easy.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
easyif.h curl_easy_perform_ev: make it CURL_EXTERN 2013-08-21 22:19:52 +02:00
escape.c
escape.h
file.c SessionHandle: the protocol specific pointer is now a void * 2013-08-12 13:17:57 +02:00
file.h
fileinfo.c
fileinfo.h
firefox-db2pem.sh
formdata.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
formdata.h
ftp.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
ftp.h FTP: make the data connection work when going through proxy 2013-10-26 23:33:06 +02:00
ftplistparser.c
ftplistparser.h
getenv.c
getinfo.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
getinfo.h
gopher.c
gopher.h
hash.c
hash.h
hmac.c
hostasyn.c
hostcheck.c NSS: support for CERTINFO feature 2013-10-30 11:12:06 +01:00
hostcheck.h
hostip4.c NI_MAXSERV: remove all use of it 2013-09-10 23:18:43 +02:00
hostip6.c NI_MAXSERV: remove all use of it 2013-09-10 23:18:43 +02:00
hostip.c hostip: don't prune DNS cache entries that are in use 2013-11-25 00:10:23 +01:00
hostip.h dns: fix compilation with MinGW from commit df69440d05 2013-09-17 20:59:43 +01:00
hostsyn.c dns: fix compilation with MinGW from commit df69440d05 2013-09-17 20:59:43 +01:00
http2.c http2: use the support HTTP2 draft version in the upgrade header 2013-09-10 23:06:20 +02:00
http2.h http2: first embryo toward Upgrade: 2013-09-07 11:28:12 +02:00
http_chunks.c
http_chunks.h
http_digest.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
http_digest.h
http_negotiate_sspi.c http: Post base64 decoding tidy up 2013-11-03 10:17:26 +00:00
http_negotiate.c http: Post base64 decoding tidy up 2013-11-03 10:17:26 +00:00
http_negotiate.h
http_proxy.c http: Post base64 decoding tidy up 2013-11-03 10:17:26 +00:00
http_proxy.h
http.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
http.h http: Post base64 decoding tidy up 2013-11-03 10:17:26 +00:00
idn_win32.c
if2ip.c
if2ip.h
imap.c imap: Fixed auth preference not being honored when CAPABILITY not supported 2013-12-24 22:50:33 +00:00
imap.h imap: Fixed incorrect fallback to clear text authentication 2013-12-13 23:15:43 +00:00
inet_ntop.c
inet_ntop.h
inet_pton.c
inet_pton.h
krb5.c security.h: rename to curl_sec.h to avoid name collision 2013-08-26 11:51:18 +02:00
ldap.c ldap.c: Fix compilation warning 2013-09-10 20:27:52 +01:00
libcurl.def
libcurl.plist
libcurl.rc
libcurl.vers.in
llist.c
llist.h
Makefile.am vtls: created subdir, moved sslgen.[ch] there, updated all include lines 2013-12-20 17:12:42 +01:00
makefile.amiga
Makefile.b32
makefile.dj
Makefile.inc Makefile.inc: use standard source header 2013-12-20 17:12:42 +01:00
Makefile.m32
Makefile.netware
Makefile.vc6 Removed reference to krb4.c. 2013-08-31 19:12:35 +02:00
Makefile.vxworks
Makefile.Watcom
md4.c
md5.c md5: remove use of CommonCrypto-to-OpenSSL macros for the benefit of Leopard 2013-08-05 19:47:56 -06:00
memdebug.c
memdebug.h
mk-ca-bundle.pl Simplify check for trusted certificates. 2013-08-05 13:02:27 +02:00
mk-ca-bundle.vbs Simplify check for trusted certificates. 2013-08-05 13:02:27 +02:00
mprintf.c
multi.c FILE: don't wait due to CURLOPT_MAX_RECV_SPEED_LARGE 2013-12-22 23:44:14 +01:00
multihandle.h multi: rename all Curl_one_easy to SessionHandle 2013-08-03 22:51:35 +02:00
multiif.h multi: add timer inaccuracy margin to timeout/connecttimeout 2013-12-15 22:53:41 +01:00
netrc.c Curl_parsenetrc: document that the arguments must be allocated 2013-08-29 12:49:56 +02:00
netrc.h netrc: handle longer username and password 2013-08-20 11:16:38 +02:00
non-ascii.c
non-ascii.h
nonblock.c
nonblock.h
nwlib.c
nwos.c
objnames-test08.sh
objnames-test10.sh
objnames.inc
openldap.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
parsedate.c parsedate: avoid integer overflow 2013-12-11 16:32:21 +01:00
parsedate.h
pingpong.c Curl_pp_readresp: use memmove not memcpy, possibly overlapping areas 2013-12-24 21:29:18 +01:00
pingpong.h
pipeline.c
pipeline.h
pop3.c pop3: Fixed auth preference not being honored when CAPA not supported 2013-12-24 22:49:36 +00:00
pop3.h pop3: Fix POP3_TYPE_ANY signed compilation warning 2013-12-04 20:18:44 +00:00
progress.c
progress.h
rawstr.c
rawstr.h
README.ares
README.curl_off_t
README.curlx
README.encoding
README.hostip
README.http2 README.http2: explain nghttp2 a little 2013-09-10 00:21:27 +02:00
README.httpauth
README.memoryleak
README.multi_socket
README.pingpong
README.pipelining
rtsp.c SessionHandle: the protocol specific pointer is now a void * 2013-08-12 13:17:57 +02:00
rtsp.h
security.c security.h: rename to curl_sec.h to avoid name collision 2013-08-26 11:51:18 +02:00
select.c
select.h
sendf.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
sendf.h
setup-os400.h OS400: coding style standards 2013-10-28 12:00:22 +01:00
setup-vms.h
share.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
share.h
sigpipe.h sigpipe: factor out sigpipe_reset from easy.c 2013-11-27 22:46:55 +01:00
slist.c
slist.h
smtp.c email: Fixed segfault introduced in commit 195b63f99c 2013-12-22 00:16:52 +00:00
smtp.h smtp: Added support for VRFY and EXPN commands 2013-11-15 18:25:29 +00:00
sockaddr.h
socks_gssapi.c
socks_sspi.c
socks.c FTP: make the data connection work when going through proxy 2013-10-26 23:33:06 +02:00
socks.h
speedcheck.c
speedcheck.h
splay.c
splay.h
ssh.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
ssh.h
strdup.c
strdup.h
strequal.c
strequal.h
strerror.c CURLM_ADDED_ALREADY: new error code 2013-08-20 23:13:19 +02:00
strerror.h
strtok.c
strtok.h
strtoofft.c
strtoofft.h
telnet.c SessionHandle: the protocol specific pointer is now a void * 2013-08-12 13:17:57 +02:00
telnet.h
tftp.c TFTP: let tftp_multi_statemach()'s return codes through 2013-12-07 15:53:08 +01:00
tftp.h
timeval.c
timeval.h
transfer.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
transfer.h
url.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
url.h FTP: make the data connection work when going through proxy 2013-10-26 23:33:06 +02:00
urldata.h curl_easy_getinfo: Post CURLINFO_TLS_SESSION tidy up 2013-11-30 11:08:56 +00:00
version.c vtls: renamed sslgen.[ch] to vtls.[ch] 2013-12-20 17:12:42 +01:00
warnless.c
warnless.h
wildcard.c
wildcard.h
x509asn1.c x509asn1.c: Fixed compilation warnings 2013-11-03 16:24:17 +00:00
x509asn1.h NSS: support for CERTINFO feature 2013-10-30 11:12:06 +01:00

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.