aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_share_setopt.3
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2017-12-05 08:39:31 +0100
committerDaniel Stenberg <daniel@haxx.se>2017-12-05 23:36:08 +0100
commitea3a5d07dc5d71306c60ad4fd2b8c2a3ccb57d6a (patch)
tree855dd3ce856d02c92a1b2c06ef6d6d642149dd60 /docs/libcurl/curl_share_setopt.3
parent415b8dff8e4b887f7479f16cb415ba8b2d9c20f9 (diff)
conncache: only allow multiplexing within same multi handle
Connections that are used for HTTP/1.1 Pipelining or HTTP/2 multiplexing only get additional transfers added to them if the existing connection is held by the same multi or easy handle. libcurl does not support doing HTTP/2 streams in different threads using a shared connection. Closes #2152
Diffstat (limited to 'docs/libcurl/curl_share_setopt.3')
-rw-r--r--docs/libcurl/curl_share_setopt.311
1 files changed, 9 insertions, 2 deletions
diff --git a/docs/libcurl/curl_share_setopt.3 b/docs/libcurl/curl_share_setopt.3
index 947722806..2e0e785fa 100644
--- a/docs/libcurl/curl_share_setopt.3
+++ b/docs/libcurl/curl_share_setopt.3
@@ -75,8 +75,15 @@ Put the connection cache in the share object and make all easy handles using
this share object share the connection cache. Using this, you can for example
do multi-threaded libcurl use with one handle in each thread, and yet have a
shared pool of unused connections and this way get way better connection
-re-use than if you use one separate pool in each thread. Support for this was
-added in 7.57.0, but the symbol existed long before this.
+re-use than if you use one separate pool in each thread.
+
+Connections that are used for HTTP/1.1 Pipelining or HTTP/2 multiplexing only
+get additional transfers added to them if the existing connection is held by
+the same multi or easy handle. libcurl does not support doing HTTP/2 streams
+in different threads using a shared connection.
+
+Support for \fBCURL_LOCK_DATA_CONNECT\fP was added in 7.57.0, but the symbol
+existed before this.
.RE
.IP CURLSHOPT_UNSHARE
This option does the opposite of \fICURLSHOPT_SHARE\fP. It specifies that