summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2015-05-15 22:32:15 +0200
committerDaniel Stenberg <daniel@haxx.se>2015-05-15 22:32:15 +0200
commit3d0531397cc7a629b495f04b965bcb17fad8821d (patch)
treec9299f64b66583e5c244e4d76f5dddffef9464b7
parent4d233220fcc71317719d49711304b3545af5198f (diff)
downloadcurl-3d0531397cc7a629b495f04b965bcb17fad8821d.tar.gz
README.pipelining: removed
All the details mentioned here are better documented in man pages
-rw-r--r--lib/Makefile.am4
-rw-r--r--lib/README.pipelining44
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.