Skip to content

Commit 11d183e

Browse files
committed
helpers/sharing.md: sync share options with CURLSHOPT_SHARE
- Add CURL_LOCK_DATA_PSL and CURL_LOCK_DATA_HSTS. - Explain that some option values are not supported multi-threaded: CURL_LOCK_DATA_COOKIE, CURL_LOCK_DATA_CONNECT, CURL_LOCK_DATA_HSTS. Bug: curl/curl#17774 Reported-by: [email protected] Closes #551
1 parent 97d124f commit 11d183e

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

helpers/sharing.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,8 @@ the same share object.
4040

4141
`CURL_LOCK_DATA_COOKIE` - set this bit to share cookie jar. Note that each
4242
easy handle still needs to get its cookie "engine" started properly to start
43-
using cookies.
43+
using cookies. It is not supported to use this option with multiple concurrent
44+
threads.
4445

4546
`CURL_LOCK_DATA_DNS` - the DNS cache is where libcurl stores addresses for
4647
resolved hostnames for a while to make subsequent lookups faster.
@@ -52,7 +53,18 @@ connection faster.
5253
`CURL_LOCK_DATA_CONNECT` - when set, this handle uses a shared connection
5354
cache and thus is more likely to find existing connections to re-use etc,
5455
which may result in faster performance when doing multiple transfers to the
55-
same host in a serial manner.
56+
same host in a serial manner. It is not supported to use this option with
57+
multiple concurrent threads.
58+
59+
`CURL_LOCK_DATA_PSL` - this bit shares the Public Suffix List between handles.
60+
The list of public suffixes, aka top-level Internet domains, is used to help
61+
manage the security of cookies. Sharing the list prevents overhead from having
62+
to process multiple copies of the list.
63+
64+
`CURL_LOCK_DATA_HSTS` - this bit shares the in-memory HSTS (HTTP Strict
65+
Transport Security) cache. HSTS is used by websites to indicate that HTTP
66+
requests should instead be accessed securely using HTTPS. It is not supported
67+
to use this option with multiple concurrent threads.
5668

5769
## Locking
5870

0 commit comments

Comments
 (0)