Daniel Stenberg 042cc1f69e - David Kierznowski notified us about a security flaw
(http://curl.haxx.se/docs/adv_20090303.html also known as CVE-2009-0037) in
  which previous libcurl versions (by design) can be tricked to access an
  arbitrary local/different file instead of a remote one when
  CURLOPT_FOLLOWLOCATION is enabled. This flaw is now fixed in this release
  together this the addition of two new setopt options for controlling this
  new behavior:

  o CURLOPT_REDIR_PROTOCOLS controls what protocols libcurl is allowed to
  follow to when CURLOPT_FOLLOWLOCATION is enabled. By default, this option
  excludes the FILE and SCP protocols and thus you nee to explicitly allow
  them in your app if you really want that behavior.

  o CURLOPT_PROTOCOLS controls what protocol(s) libcurl is allowed to fetch
  using the primary URL option. This is useful if you want to allow a user or
  other outsiders control what URL to pass to libcurl and yet not allow all
  protocols libcurl may have been built to support.
2009-03-02 23:05:31 +00:00
..
2009-01-30 01:54:22 +00:00
2008-10-08 01:17:51 +00:00
2007-10-30 23:00:40 +00:00
2008-12-20 22:51:57 +00:00
2008-09-12 11:18:17 +00:00
2004-01-07 09:19:33 +00:00
2008-10-27 05:29:17 +00:00
2008-10-24 01:27:00 +00:00
2009-02-28 01:11:57 +00:00
2008-11-13 01:39:10 +00:00
2008-08-23 21:31:09 +00:00
2008-08-01 00:49:29 +00:00
2008-10-17 22:33:08 +00:00
2007-11-07 09:21:35 +00:00
2008-05-20 10:21:50 +00:00
2004-04-30 08:51:19 +00:00
2005-01-14 13:43:29 +00:00
2006-10-29 09:18:32 +00:00
2006-10-29 09:11:44 +00:00
2008-12-20 22:51:57 +00:00
2005-11-12 22:13:20 +00:00
2008-12-28 05:49:39 +00:00
2008-12-22 18:46:12 +00:00
2008-11-11 22:19:27 +00:00
2004-10-11 17:26:24 +00:00
2007-11-07 09:21:35 +00:00
2007-04-03 18:25:18 +00:00
2007-01-29 19:08:04 +00: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.

- 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.