curl/lib
Daniel Stenberg 138b4f27b4 - Manfred Schwarb reported that socks5 support was broken and help us pinpoint
the problem. The code now tries harder to use httproxy and proxy where
  apppropriate, as not all proxies are HTTP...
2007-02-03 09:33:54 +00:00
..
.cvsignore ignore curllib.dsp 2004-08-10 10:43:41 +00:00
Makefile.Watcom Dmitriy Sergeyev provided a patch that made the SOCKS[45] code work better as 2006-09-23 19:07:20 +00:00
Makefile.am Support for FTP third party transfers is now dropped 2006-09-30 20:31:11 +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 James Housley brought support for SCP transfers 2006-11-02 21:56:40 +00:00
Makefile.m32 fixed segfault when compiled with MingW32 and cmd or command shell. 2007-01-29 00:51:02 +00:00
Makefile.netware enabled build with hardcoded ca-bundle path; 2007-01-28 15:31:06 +00:00
Makefile.riscos GnuTLS updates 2005-04-07 21:10:31 +00:00
Makefile.vc6 Fix misplaced runtime library specification for 'release-dll' target 2006-10-21 16:25:31 +00:00
README.ares Update the information about what c-ares version that's required. 1.3.1 had 2006-11-03 10:56:37 +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 Made the copyright year match the latest modification's year. 2006-01-09 13:17:14 +00:00
amigaos.h Made the copyright year match the latest modification's year. 2006-01-09 13:17:14 +00:00
arpa_telnet.h Make some more arrays of pointers const. 2004-12-20 18:23:43 +00:00
base64.c Suppress the "'convbuf' might be used uninitialized in this function" warning. 2007-02-01 12:23:00 +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 Define HAVE_SIGNAL_H, HAVE_SIG_ATOMIC_T and HAVE_SIG_ATOMIC_T_VOLATILE 2006-11-24 16:38:58 +00:00
config-mac.h Make sure RETSIGTYPE is properly defined 2006-11-25 01:02:52 +00:00
config-riscos.h Define HAVE_SIGNAL_H, HAVE_SIG_ATOMIC_T and HAVE_SIG_ATOMIC_T_VOLATILE 2006-11-24 16:38:58 +00:00
config-tpf.h Define HAVE_SIGNAL_H, HAVE_SIG_ATOMIC_T and HAVE_SIG_ATOMIC_T_VOLATILE 2006-11-24 16:38:58 +00:00
config-win32.h better preprocessor check for recent MSVC versions 2006-12-05 15:24:18 +00:00
config-win32ce.h Make sure RETSIGTYPE is properly defined 2006-11-25 01:02:52 +00:00
config.dos Define HAVE_SIGNAL_H, HAVE_SIG_ATOMIC_T and HAVE_SIG_ATOMIC_T_VOLATILE 2006-11-24 16:38:58 +00:00
connect.c - David McCreedy fixed a bad call to getsockname() that wrongly used a size_t 2006-12-22 13:30:54 +00:00
connect.h Constify some arguments in Curl_connecthost() and singleipconnect(). 2006-07-21 06:50:39 +00:00
content_encoding.c Based on a patch by Armel Asselin, the FTP code no longer re-issues the TYPE 2006-08-19 21:18:36 +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 make Curl_cookie_clearall() survive getting called with a NULL pointer 2007-01-13 23:32:14 +00:00
cookie.h Removed "#ifndef__WATCOMC__". Use "#ifdef HAVE_SYS_TIME_H" instead. 2006-08-30 16:17:06 +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 Remove redundant __CYGWIN__ symbol check 2006-10-11 16:01:16 +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 add debug messages for initialization failures 2007-01-31 19:47:49 +00:00
easyif.h Update copyright year, since the file has been modified 2006-10-27 03:47:57 +00:00
escape.c Avoid typecasting a signed char to an int when using is*() functions, as that 2006-10-17 21:32:56 +00:00
escape.h First commit of David McCreedy's EBCDIC and TPF changes. 2006-04-07 21:50:47 +00:00
file.c - Armel Asselin improved libcurl to behave a lot better when an easy handle 2007-01-16 22:22:10 +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 update copyright year notice 2007-01-27 03:43:05 +00:00
formdata.h update copyright year notice 2007-01-27 03:43:05 +00:00
ftp.c compiler warning fix 2007-02-01 15:36:56 +00:00
ftp.h update copyright year notice 2007-01-27 03:43:05 +00:00
getenv.c Made the copyright year match the latest modification's year. 2006-01-09 13:17:14 +00:00
getinfo.c Curl_getinfo() now checks for a NULL SessionHandle pointer 2006-12-22 13:44:10 +00:00
getinfo.h updated year in the copyright string 2004-01-07 09:19:33 +00:00
gtls.c - Linus Nielsen Feltzing introduced the --ftp-ssl-ccc command line option to 2007-01-05 23:11:14 +00:00
gtls.h - Linus Nielsen Feltzing introduced the --ftp-ssl-ccc command line option to 2007-01-05 23:11:14 +00:00
hash.c Added a useful debug function within #if 0. The function makes it easy to 2006-09-10 22:12:24 +00:00
hash.h Use plain structs and not typedef'ed ones in the hash and linked-list code. 2005-01-25 00:06:29 +00:00
hostares.c Jeff helped me pinpoint that we didn't properly set the expire timer during 2006-10-17 08:06:27 +00:00
hostasyn.c Simplify check for NEED_MALLOC_H, and make more explicit that NEED_MALLOC_H shall be defined if <malloc.h> header file must be included even when including <stdlib.h>. 2006-07-25 13:49:49 +00:00
hostip.c Workaround for Cray UNICOS 9.0 to fix ftp. 2006-08-21 22:28:19 +00:00
hostip.h Compilation fix 2006-09-08 05:18:07 +00:00
hostip4.c compiler warning fix 2007-02-02 17:16:06 +00:00
hostip6.c put back the correct logic, as the change dated July 11th 2006 added bad 2006-07-27 22:28:53 +00:00
hostsyn.c Simplify check for NEED_MALLOC_H, and make more explicit that NEED_MALLOC_H shall be defined if <malloc.h> header file must be included even when including <stdlib.h>. 2006-07-25 13:49:49 +00:00
hostthre.c clear the struct size not the pointer size, pointed out in bug report 2006-10-17 20:34:11 +00:00
http.c - Michael Wallner reported that when doing a CONNECT with a custom User-Agent 2007-01-29 09:26:36 +00:00
http.h update copyright year notice 2007-01-27 03:43:05 +00:00
http_chunks.c David McCreedy fixed a flaw from his previous non-ascii HTTP patch 2007-01-16 22:26:50 +00:00
http_chunks.h Adrian Schuur added trailer support in the chunked encoding stream. The 2005-07-12 18:15:34 +00:00
http_digest.c - David McCreedy provided libcurl changes for doing HTTP communication on 2007-01-14 14:57:51 +00:00
http_digest.h Major overhaul introducing http pipelining support and shared connection 2006-09-07 21:49:20 +00:00
http_negotiate.c - David McCreedy made changes to allow base64 encoding/decoding to work on 2007-01-03 23:04:38 +00:00
http_negotiate.h updated year in the copyright string 2004-01-07 09:19:33 +00:00
http_ntlm.c - David McCreedy did NTLM changes mainly for non-ASCII platforms: 2007-01-23 22:57:42 +00:00
http_ntlm.h only enable NTLM if HTTP and NTLM is not disabled, and if NTLM is disabled 2005-11-23 11:51:31 +00:00
if2ip.c updated copyright year 2006-10-25 07:19:45 +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 Check for USE_WINSOCK instead of WIN32 where the check was done 2006-10-18 21:05:40 +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 Check for USE_WINSOCK instead of WIN32 where the check was done 2006-10-18 21:05:40 +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 cleaned up Curl_write() and the sub functions it uses for various protocols. 2006-11-11 21:34:43 +00:00
ldap.c - David McCreedy made changes to allow base64 encoding/decoding to work on 2007-01-03 23:04:38 +00:00
ldap.h FTP code turned into state machine. Not completely yet, but a good start. 2005-02-09 13:06:40 +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 added project header to lib resource file; fixed header copyright. 2007-01-26 08:53:03 +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 Don't include zlib headers in dependency output. 2006-08-29 18:13:54 +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 Prevent multiple initialization of memdebug configuration variables. 2006-11-05 12:42:50 +00:00
memdebug.h Update copyright year, since the file has been modified 2006-10-27 03:47:57 +00:00
memory.h removed tabs and trailing whitespace from source 2004-10-06 07:50:18 +00:00
mprintf.c compiler warning fix 2007-02-01 01:42:13 +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 Compiler warning fix 2007-01-27 03:14:25 +00:00
multiif.h Reported in #1561470 (http://curl.haxx.se/bug/view.cgi?id=1561470), libcurl 2006-09-28 21:26:06 +00:00
netrc.c corrected copyright year 2005-05-02 14:33:07 +00:00
netrc.h updated year in the copyright string 2004-01-07 09:19:33 +00:00
nwlib.c converted to UNIX format. 2004-06-10 21:20:15 +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 Update copyright year, since the file has been modified 2006-10-27 03:47:57 +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
security.c cleaned up Curl_write() and the sub functions it uses for various protocols. 2006-11-11 21:34:43 +00:00
select.c Include <dos.h> for delay() on MSDOS. 2007-01-05 15:56:28 +00:00
select.h Cory Nelson made libcurl use the WSAPoll() function if built for Windows 2006-09-24 10:41:00 +00:00
sendf.c prefer using the (upcoming) non-blocking libssh2 API 2007-02-02 15:26:57 +00:00
sendf.h Update copyright year, since the file has been modified 2006-10-27 03:47:57 +00:00
setup.h move DEBUGF macro definition to setup_once.h 2007-02-02 15:31:32 +00:00
setup_once.h move DEBUGF macro definition to setup_once.h 2007-02-02 15:31:32 +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 Compiler warning fix 2006-10-27 02:18:29 +00:00
socks.h standard curl source code headers 2006-09-23 19:09:39 +00:00
speedcheck.c make the low_speed check set the expire timer so that it has a chance to work 2006-10-17 09:05:44 +00:00
speedcheck.h updated year in the copyright string 2004-01-07 09:19:33 +00:00
splay.c Jari Sundell's minor cleanup, added comments and some extra error-checkings 2006-09-04 22:19:13 +00:00
splay.h don't use 'new' in the proto 2006-07-15 18:57:51 +00:00
ssh.c prefer using the (upcoming) non-blocking libssh2 API 2007-02-02 15:26:57 +00:00
ssh.h - Armel Asselin improved libcurl to behave a lot better when an easy handle 2007-01-16 22:22:10 +00:00
sslgen.c compiler warning fix 2007-02-01 15:36:56 +00:00
sslgen.h fix compiler warnings for SSL-disabled builds 2007-01-25 21:00:03 +00:00
ssluse.c Display crypto engine name correctly in debug message. 2007-01-10 21:21:53 +00:00
ssluse.h - Linus Nielsen Feltzing introduced the --ftp-ssl-ccc command line option to 2007-01-05 23:11:14 +00:00
strdup.c Return NULL if argument is NULL. 2006-07-17 15:25:37 +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 Update copyright year, since the file has been modified 2006-10-27 03:47:57 +00:00
strequal.h modified this year 2005-04-22 20:48:07 +00:00
strerror.c Correct error code for CCC/SSL shutdown failure 2007-01-08 11:24:11 +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 Avoid typecasting a signed char to an int when using is*() functions, as that 2006-10-17 21:32:56 +00:00
strtoofft.h Watcom uses 'i64' suffix. 2004-12-17 18:33:09 +00:00
telnet.c - Armel Asselin improved libcurl to behave a lot better when an easy handle 2007-01-16 22:22:10 +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 - Armel Asselin improved libcurl to behave a lot better when an easy handle 2007-01-16 22:22:10 +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 Made the copyright year match the latest modification's year. 2006-01-09 13:17:14 +00:00
timeval.h Update copyright year, since the file has been modified 2006-10-27 03:47:57 +00:00
transfer.c Fixed compiler warning. 2007-01-26 17:50:06 +00:00
transfer.h Update copyright year, since the file has been modified 2006-10-27 03:47:57 +00:00
url.c - Manfred Schwarb reported that socks5 support was broken and help us pinpoint 2007-02-03 09:33:54 +00:00
url.h fogot to change Curl_mk_connc in header file 2007-02-01 11:27:42 +00:00
urldata.h - Manfred Schwarb reported that socks5 support was broken and help us pinpoint 2007-02-03 09:33:54 +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 James Housley did lots of work and introduced SFTP downloads. 2006-11-24 22:14:39 +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.