diff options
author | Daniel Stenberg <daniel@haxx.se> | 2015-05-15 22:32:15 +0200 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2015-05-15 22:34:12 +0200 |
commit | 5fa82ca56f005e4c712221aafaa0b61b5a3f4d82 (patch) | |
tree | 4ebabd6f7f3ec13a29b064a3addb6477bb97faae | |
parent | 1c01cee601c4bc967dc5e734cd2b11517a228a33 (diff) |
README.pipelining: removed
All the details mentioned here are better documented in man pages
-rw-r--r-- | lib/Makefile.am | 4 | ||||
-rw-r--r-- | lib/README.pipelining | 44 |
2 files changed, 2 insertions, 46 deletions
diff --git a/lib/Makefile.am b/lib/Makefile.am index 248a6d993..fd2ca585d 100644 --- a/lib/Makefile.am +++ b/lib/Makefile.am @@ -22,8 +22,8 @@ AUTOMAKE_OPTIONS = foreign nostdinc DOCS = README.encoding README.memoryleak README.ares README.curlx \ - README.hostip README.multi_socket README.httpauth README.pipelining \ - README.curl_off_t README.pingpong + README.hostip README.multi_socket README.httpauth README.curl_off_t \ + README.pingpong CMAKE_DIST = CMakeLists.txt curl_config.h.cmake diff --git a/lib/README.pipelining b/lib/README.pipelining deleted file mode 100644 index e5bf6ec33..000000000 --- a/lib/README.pipelining +++ /dev/null @@ -1,44 +0,0 @@ -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. |