curl/lib
Daniel Stenberg ec08e2f9f2 Alex Fishman reported a curl_easy_escape() problem that was made the
function do wrong on all input bytes that are >= 0x80 (decimal 128) due to a
signed / unsigned mistake in the code. I fixed it and added test case 543 to
verify.
2007-09-30 22:40:24 +00:00
..
.cvsignore ignore curllib.dsp 2004-08-10 10:43:41 +00:00
Makefile.Watcom Patrick Monnerat modified the LDAP code and approach in curl. Starting now, 2007-08-11 20:57:54 +00:00
Makefile.am added the two new os400 files 2007-08-23 14:58:10 +00:00
Makefile.b32 Static lib is libcurl.lib and import lib libcurl_imp.lib. 2004-11-14 13:48:15 +00:00
Makefile.inc Patrick Monnerat modified the LDAP code and approach in curl. Starting now, 2007-08-11 20:57:54 +00:00
Makefile.m32 only link with -lwldap32 if we dont use other LDAP SDKs. 2007-08-25 12:08:38 +00:00
Makefile.netware compile with ldaps by default since it seems to work fine so far. 2007-08-20 16:34:04 +00:00
Makefile.riscos GnuTLS updates 2005-04-07 21:10:31 +00:00
Makefile.vc6 fixed VC6 makefiles for new ldap linkage. 2007-09-15 20:02:22 +00:00
README.ares When transferring 500 downloads in parallel with a c-ares enabled build only 2007-05-31 11:34:32 +00:00
README.curlx updated with more and new info 2004-04-30 08:51:19 +00:00
README.encoding Fixed a lingering omission of gzip support. 2005-12-08 18:59:19 +00:00
README.hostip Added README.hostip 2005-01-14 13:43:29 +00:00
README.httpauth HTTP "auth done right". See lib/README.httpauth 2004-11-24 16:11:35 +00:00
README.memoryleak corrected how tests/memanalyze.pl is used 2006-10-29 23:00:52 +00:00
README.multi_socket updated to current status 2006-10-29 09:18:32 +00:00
README.pipelining updated to reflect reality 2006-10-29 09:11:44 +00:00
amigaos.c proper symbol definition check for all AmigaOS flavours 2007-02-28 14:45:48 +00:00
amigaos.h proper symbol definition check for all AmigaOS flavours 2007-02-28 14:45:48 +00:00
arpa_telnet.h Make some more arrays of pointers const. 2004-12-20 18:23:43 +00:00
base64.c Renamed several libcurl error codes and options to make them more general 2007-08-30 20:34:57 +00:00
base64.h - David McCreedy made changes to allow base64 encoding/decoding to work on 2007-01-03 23:04:38 +00:00
ca-bundle.crt Removed the "TC TrustCenter, Germany, Class 0 CA." certificate: 2003-03-24 11:06:57 +00:00
config-amigaos.h proper symbol definition check for all AmigaOS flavours 2007-02-28 14:45:48 +00:00
config-mac.h Make sure RETSIGTYPE is properly defined 2006-11-25 01:02:52 +00:00
config-os400.h Porting library to OS/400 2007-08-23 14:30:24 +00:00
config-riscos.h Patrick Monnerat modified the LDAP code and approach in curl. Starting now, 2007-08-11 20:57:54 +00:00
config-tpf.h Patrick Monnerat modified the LDAP code and approach in curl. Starting now, 2007-08-11 20:57:54 +00:00
config-win32.h added a define for Win32 to detect already defined ssize_t. 2007-09-18 18:18:34 +00:00
config-win32ce.h Patrick Monnerat modified the LDAP code and approach in curl. Starting now, 2007-08-11 20:57:54 +00:00
config.dos DOS targets do have setmode(). 2007-04-03 10:18:38 +00:00
connect.c Minix doesn't support getsockopt on UDP sockets or send/recv on TCP 2007-09-05 22:01:57 +00:00
connect.h use macros ERRNO, SET_ERRNO(), SOCKERRNO and SET_SOCKERRNO() for errno handling 2007-02-16 18:19:35 +00:00
content_encoding.c Song Ma noted a zlib memory leak in the illegal compressed header 2007-08-08 17:51:40 +00:00
content_encoding.h Based on a patch by Armel Asselin, the FTP code no longer re-issues the TYPE 2006-08-19 21:18:36 +00:00
cookie.c Added lots of consts 2007-08-29 05:36:53 +00:00
cookie.h Added lots of consts 2007-08-29 05:36:53 +00:00
curl_ldap.h Patrick Monnerat modified the LDAP code and approach in curl. Starting now, 2007-08-11 20:57:54 +00:00
curllib.dsw Hanno L. Kranzhoff fixed them 2002-06-14 09:36:09 +00:00
curlx.h Update copyright year, since the file has been modified 2006-10-27 03:47:57 +00:00
dict.c Fixed some minor mismatched types found by splint. 2007-08-26 05:53:26 +00:00
dict.h FTP code turned into state machine. Not completely yet, but a good start. 2005-02-09 13:06:40 +00:00
easy.c Fixed some minor mismatched types found by splint. 2007-08-26 05:53:26 +00:00
easyif.h Update copyright year, since the file has been modified 2006-10-27 03:47:57 +00:00
escape.c Alex Fishman reported a curl_easy_escape() problem that was made the 2007-09-30 22:40:24 +00:00
escape.h First commit of David McCreedy's EBCDIC and TPF changes. 2006-04-07 21:50:47 +00:00
file.c Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
file.h - Armel Asselin improved libcurl to behave a lot better when an easy handle 2007-01-16 22:22:10 +00:00
formdata.c Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
formdata.h update copyright year notice 2007-01-27 03:43:05 +00:00
ftp.c Renamed a few variables to avoid shadowing global declarations. 2007-09-27 02:45:58 +00:00
ftp.h update copyright year notice 2007-01-27 03:43:05 +00:00
getenv.c Don't strdup an empty string 2007-09-27 18:39:10 +00:00
getinfo.c Patrick Monnerat and I modified libcurl so that now it *copies* all strings 2007-08-01 21:20:01 +00:00
getinfo.h updated year in the copyright string 2004-01-07 09:19:33 +00:00
gtls.c Renamed several libcurl error codes and options to make them more general 2007-08-30 20:34:57 +00:00
gtls.h Renamed a few variables to avoid shadowing global declarations. 2007-09-27 02:45:58 +00:00
hash.c Renamed a few variables to avoid shadowing global declarations. 2007-09-27 18:12:03 +00:00
hash.h Robert Iakobashvili re-arranged the internal hash code to work with a custom 2007-06-26 21:09:28 +00:00
hostares.c a name resolve that times out is still a failed name resolve 2007-09-27 12:05:39 +00:00
hostasyn.c Adapted the c-ares code to the API change c-ares 1.5.0 brings in the 2007-09-28 21:48:28 +00:00
hostip.c Renamed a variable to avoid shadowing a global declarations. 2007-09-28 18:47:59 +00:00
hostip.h Adapted the c-ares code to the API change c-ares 1.5.0 brings in the 2007-09-28 21:48:28 +00:00
hostip4.c removed now obsolete NETDB_DEFINE_CONTEXT macro calls. 2007-07-11 21:47:31 +00:00
hostip6.c Thomas J. Moore provided a patch that introduces Kerberos5 support in 2007-07-01 22:01:18 +00:00
hostsyn.c update copyright year 2007-04-03 18:25:18 +00:00
hostthre.c constify 'hostname' in init_thread_sync_data(). Simply clear 2007-06-11 04:33:21 +00:00
http.c Mark Davies fixed Negotiate authentication over proxy, and also introduced 2007-09-21 11:05:31 +00:00
http.h Fixed some minor type mismatches and missing consts mainly found by splint. 2007-08-27 06:31:28 +00:00
http_chunks.c Shmulik Regev: 2007-07-10 22:45:01 +00:00
http_chunks.h - Ravi Pratap provided work on libcurl making pipelining more robust and 2007-02-21 21:59:40 +00:00
http_digest.c Fixed some minor type mismatches and missing consts mainly found by splint. 2007-08-27 06:31:28 +00:00
http_digest.h Fixed some minor type mismatches and missing consts mainly found by splint. 2007-08-27 06:31:28 +00:00
http_negotiate.c Mark Davies fixed Negotiate authentication over proxy, and also introduced 2007-09-21 11:05:31 +00:00
http_negotiate.h Mark Davies fixed Negotiate authentication over proxy, and also introduced 2007-09-21 11:05:31 +00:00
http_ntlm.c Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
http_ntlm.h Fixed some minor type mismatches and missing consts mainly found by splint. 2007-08-27 06:31:28 +00:00
if2ip.c Song Ma found a memory leak in the if2ip code if you pass in an interface 2007-04-12 20:09:19 +00:00
if2ip.h build fix for Interix 2006-03-04 22:39:31 +00:00
inet_ntoa_r.h provide the proper copyright texts for these 2005-05-26 20:56:25 +00:00
inet_ntop.c Porting library to OS/400 2007-08-23 14:30:24 +00:00
inet_ntop.h Yang Tse: fixes the use of Curl_inet_ntop and Curl_inet_pton with no 2005-11-25 22:20:02 +00:00
inet_pton.c fix compiler warning 2007-04-13 07:57:31 +00:00
inet_pton.h Yang Tse's changes to provide an inet_pton() proto for the platforms who 2005-11-28 20:21:35 +00:00
krb4.c - David McCreedy made changes to allow base64 encoding/decoding to work on 2007-01-03 23:04:38 +00:00
krb4.h Thomas J. Moore provided a patch that introduces Kerberos5 support in 2007-07-01 22:01:18 +00:00
krb5.c Fix getsockname argument type 2007-08-08 10:37:07 +00:00
ldap.c fixed ldap support for winldap. 2007-09-15 20:03:03 +00:00
libcurl.def Yang Tse: msvc7+ has deprecated the 'DESCRIPTION' section in 2005-11-14 07:48:05 +00:00
libcurl.framework.make Nir Soffer updated libcurl.framework.make: fix symlinks, should link to 2006-11-09 21:58:28 +00:00
libcurl.imp there's an curl_easy_unescape too now 2006-04-18 09:23:03 +00:00
libcurl.plist Matt Veenstra updated to 7.12.3. Starting now, we'll update the version number 2004-12-08 23:09:23 +00:00
libcurl.rc Take in account that it can be built with compiler debug info and 2007-04-13 08:22:56 +00:00
llist.c updated copyright year 2006-10-25 07:19:45 +00:00
llist.h Use plain structs and not typedef'ed ones in the hash and linked-list code. 2005-01-25 00:06:29 +00:00
makefile.amiga Diego Casorran patches to make (lib)curl build fine on Amiga again 2005-07-13 18:06:40 +00:00
makefile.dj Added TOPDIR variable. Put dependencies in external file. 2007-02-27 15:24:32 +00:00
md5.c corrected copyright year 2005-05-02 14:33:07 +00:00
md5.h Add 'const' to immutable arrays. 2004-12-15 01:38:25 +00:00
memdebug.c Fix getsockname argument type 2007-08-08 10:37:07 +00:00
memdebug.h Using fdopen() is a more correct way to implement the CURLOPT_NEW_FILE_PREMS 2007-06-28 11:11:29 +00:00
memory.h removed tabs and trailing whitespace from source 2004-10-06 07:50:18 +00:00
mprintf.c fixed a warning which MingW gcc 4.2.1. 2007-08-09 21:05:05 +00:00
msvcproj.foot new attempt at an improved DSP-file generation 2004-05-11 07:54:55 +00:00
msvcproj.head Use the more correct BUILDING_LIBCURL define instead of CURLLIB_EXPORTS. 2005-08-29 20:56:20 +00:00
multi.c Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
multiif.h Fixed some minor mismatched types found by splint. 2007-08-26 05:53:26 +00:00
netrc.c Steve Little's fixes to allow compilation on VMS 64-bit mode 2007-04-25 03:00:10 +00:00
netrc.h updated year in the copyright string 2004-01-07 09:19:33 +00:00
nss.c Rob Crittenden provided an NSS update with the following highlights: 2007-09-18 22:21:54 +00:00
nssg.h Renamed a few variables to avoid shadowing global declarations. 2007-09-27 02:45:58 +00:00
nwlib.c removed now obsolete NETDB_DEFINE_CONTEXT macro calls. 2007-07-11 21:47:31 +00:00
nwos.c fixed warning with gcc 4.x (hopefully); dynamincally imported UseAccurateCaseForPaths() for CLIB port to be stonetime-compatible (NW 3.x). 2007-08-09 22:33:49 +00:00
parsedate.c Martin Skinner brought back bug report #1230118 to haunt us once again. 2006-12-05 14:57:43 +00:00
parsedate.h Updated the copyright year since changes have been this year. 2005-03-31 07:02:02 +00:00
progress.c - Prevent the internal progress meter from updating more frequently than once 2007-04-18 20:02:41 +00:00
progress.h clean up start time and t_startsingle use so that redirect_time works properly 2004-11-15 11:27:03 +00:00
qssl.c Patrick Monnerat's cleanup fix after my alloc-strings commit 2007-08-02 14:42:16 +00:00
qssl.h Patrick Monnerat restored qssl successful compilation and loading 2007-07-30 21:41:12 +00:00
security.c Thomas J. Moore made it build with less warnings 2007-07-06 22:14:29 +00:00
select.c When transferring 500 downloads in parallel with a c-ares enabled build only 2007-05-31 11:34:32 +00:00
select.h Make our own definitions of the POLL* defiens and the pollfd struct only get 2007-06-14 11:21:48 +00:00
sendf.c Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
sendf.h Platforms that lack autotools support should define HAVE_VARIADIC_MACROS_C99 2007-03-27 04:17:26 +00:00
setup-os400.h Porting library to OS/400 2007-08-23 14:30:24 +00:00
setup.h Porting library to OS/400 2007-08-23 14:30:24 +00:00
setup_once.h Minix doesn't support getsockopt on UDP sockets or send/recv on TCP 2007-09-05 22:01:57 +00:00
share.c Dan Fandrich added the --disable-cookies option to configure to build 2004-12-05 23:59:32 +00:00
share.h Added support for Salford-C under Win32 (scc). HAVE_MALLOC_H and 2006-04-26 17:11:05 +00:00
sockaddr.h oops * 2 2005-11-12 22:13:20 +00:00
socks.c Fixed some minor type mismatches and missing consts mainly found by splint. 2007-08-27 06:31:28 +00:00
socks.h Fixed some minor type mismatches and missing consts mainly found by splint. 2007-08-27 06:31:28 +00:00
speedcheck.c Renamed several libcurl error codes and options to make them more general 2007-08-30 20:34:57 +00:00
speedcheck.h updated year in the copyright string 2004-01-07 09:19:33 +00:00
splay.c Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
splay.h Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
ssh.c Immanuel Gregoire fixed a problem with persistent transfers over SFTP - the 2007-09-29 21:34:34 +00:00
ssh.h The SSH code now only works with libssh2 0.16 or later. Thus we must not 2007-08-03 08:14:51 +00:00
sslgen.c #ifdef out a few more functions when SSL is disabled. 2007-09-25 06:45:05 +00:00
sslgen.h Fixed some minor type mismatches and missing consts mainly found by splint. 2007-08-27 06:31:28 +00:00
ssluse.c #ifdef out a few more functions when SSL is disabled. 2007-09-25 06:45:05 +00:00
ssluse.h Bug report #1759542 (http://curl.haxx.se/bug/view.cgi?id=1759542). A bad use 2007-07-29 12:54:05 +00:00
strdup.c Use memcpy instead of strcpy to improve performance. 2007-05-01 20:50:50 +00:00
strdup.h Moved strdup replacement from src/main.c into src/strdup.c so it's available 2006-07-11 17:02:06 +00:00
strequal.c Make glibc define the prototype for strcasestr 2007-09-25 17:33:56 +00:00
strequal.h modified this year 2005-04-22 20:48:07 +00:00
strerror.c Renamed the CURLE_FTP_SSL_FAILED error code to CURLE_USE_SSL_FAILED. 2007-08-31 19:36:32 +00:00
strerror.h removed trailing whitespace 2004-10-11 17:26:24 +00:00
strtok.c Dan Fandrich's cleanup patch to make pedantic compiler options cause less 2004-01-29 13:56:45 +00:00
strtok.h updated year in the copyright string 2004-01-07 09:19:33 +00:00
strtoofft.c Patrick Monnerat fixed curl_easy_escape() and curlx_strtoll() to work on 2007-08-04 20:47:59 +00:00
strtoofft.h Some #if --> #ifdef 2007-08-07 12:44:38 +00:00
telnet.c Renamed several libcurl error codes and options to make them more general 2007-08-30 20:34:57 +00:00
telnet.h - Armel Asselin improved libcurl to behave a lot better when an easy handle 2007-01-16 22:22:10 +00:00
tftp.c TFTP now reports the "not defined" TFTP error code 0 as an error, 2007-09-07 20:35:37 +00:00
tftp.h - Armel Asselin improved libcurl to behave a lot better when an easy handle 2007-01-16 22:22:10 +00:00
timeval.c moved includes to setup.h so that the project headers also pick them up (eleminate gcc warning). 2007-06-30 23:45:57 +00:00
timeval.h update copyright year 2007-04-03 18:25:18 +00:00
transfer.c Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
transfer.h Fixed some minor type mismatches and missing consts mainly found by splint. 2007-08-27 06:31:28 +00:00
url.c Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
url.h Enabled a few more gcc warnings with --enable-debug. Renamed a few 2007-09-27 01:45:22 +00:00
urldata.h Philip Langdale provided the new CURLOPT_POST301 option for 2007-09-26 12:44:59 +00:00
vc8proj.foot Use DOS line-endings. 2007-01-29 19:08:04 +00:00
vc8proj.head Use DOS line-endings. 2007-01-29 19:08:04 +00:00
version.c Remove leading space in curl_version_info ss_version field. 2007-08-24 09:06:17 +00:00

README.pipelining

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.