table of contents
- bookworm 7.88.1-10+deb12u8
- bookworm-backports 8.10.1-1~bpo12+1
- testing 8.10.1-2
- unstable 8.11.0-1
CURLSHOPT_UNSHARE(3) | Library Functions Manual | CURLSHOPT_UNSHARE(3) |
NAME¶
CURLSHOPT_UNSHARE - remove data to share
SYNOPSIS¶
#include <curl/curl.h> CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_UNSHARE, long type);
DESCRIPTION¶
The type parameter specifies what specific data that should no longer be shared and kept in the share object that was created with curl_share_init(3). In other words, stop sharing that data in this shared object. The given type must be one of the values described below. You can set CURLSHOPT_UNSHARE(3) multiple times with different data arguments to remove multiple types from the shared object. Add data to share again with CURLSHOPT_SHARE(3).
- CURL_LOCK_DATA_COOKIE
- Cookie data is no longer shared across the easy handles using this shared object.
- CURL_LOCK_DATA_DNS
- Cached DNS hosts are no longer shared across the easy handles using this shared object.
- CURL_LOCK_DATA_SSL_SESSION
- SSL session IDs are no longer shared across the easy handles using this shared object.
- CURL_LOCK_DATA_CONNECT
- The connection cache is no longer shared.
- CURL_LOCK_DATA_PSL
- The Public Suffix List is no longer shared.
PROTOCOLS¶
This functionality affects all supported protocols
EXAMPLE¶
int main(void) {
CURLSHcode sh;
CURLSH *share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_UNSHARE, CURL_LOCK_DATA_COOKIE);
if(sh)
printf("Error: %s\n", curl_share_strerror(sh)); }
AVAILABILITY¶
Added in curl 7.10.3
RETURN VALUE¶
CURLSHE_OK (zero) means that the option was set properly, non-zero means an error occurred. See libcurl-errors(3) for the full list with descriptions.
SEE ALSO¶
CURLSHOPT_SHARE(3), curl_share_cleanup(3), curl_share_init(3), curl_share_setopt(3)
2024-11-09 | libcurl |