curl/lib
Daniel Stenberg f01df19798 checkconnection: don't call with NULL pointer
When checking if an existing RTSP connection is alive or not, the
checkconnection function might be called with a SessionHandle pointer
being NULL and then referenced causing a crash. This happened only using
the multi interface.

Reported by: Tinus van den Berg

Bug: http://curl.haxx.se/bug/view.cgi?id=3280739
2011-04-11 13:17:55 +02:00
..
.gitignore
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 checkconnection: don't call with NULL pointer 2011-04-11 13:17:55 +02: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_addrinfo.h
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
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
formdata.h
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
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
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.h
http_digest.c
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.h
krb4.c
krb4.h
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 mk-ca-bundle.pl: show full URL in output 2011-04-07 22:42:22 +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: allow to use multiple client certificates for a single host 2011-04-08 13:35:26 +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.curl_off_t
README.curlx
README.encoding
README.hostip
README.httpauth
README.memoryleak
README.multi_socket
README.pingpong
README.pipelining
rtsp.c checkconnection: don't call with NULL pointer 2011-04-11 13:17:55 +02:00
rtsp.h rtsp: move protocol code to dedicated file 2011-03-23 17:27:58 +01:00
security.c
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 OpenSSL: no-sslv2 aware 2011-04-10 19:14:22 +02: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.