CURLSHOPT_UNSHARE.3 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455
  1. .\" generated by cd2nroff 0.1 from CURLSHOPT_UNSHARE.md
  2. .TH CURLSHOPT_UNSHARE 3 "2025-01-17" libcurl
  3. .SH NAME
  4. CURLSHOPT_UNSHARE \- remove data to share
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_UNSHARE, long type);
  9. .fi
  10. .SH DESCRIPTION
  11. The \fItype\fP parameter specifies what specific data that should no longer be
  12. shared and kept in the share object that was created with
  13. \fIcurl_share_init(3)\fP. In other words, stop sharing that data in this
  14. shared object. The given \fItype\fP must be one of the values described
  15. below. You can set \fICURLSHOPT_UNSHARE(3)\fP multiple times with different
  16. data arguments to remove multiple types from the shared object. Add data to
  17. share again with \fICURLSHOPT_SHARE(3)\fP.
  18. .IP CURL_LOCK_DATA_COOKIE
  19. Cookie data is no longer shared across the easy handles using this shared
  20. object.
  21. .IP CURL_LOCK_DATA_DNS
  22. Cached DNS hosts are no longer shared across the easy handles using this
  23. shared object.
  24. .IP CURL_LOCK_DATA_SSL_SESSION
  25. SSL session IDs are no longer shared across the easy handles using this shared
  26. object.
  27. .IP CURL_LOCK_DATA_CONNECT
  28. The connection cache is no longer shared.
  29. .IP CURL_LOCK_DATA_PSL
  30. The Public Suffix List is no longer shared.
  31. .SH PROTOCOLS
  32. This functionality affects all supported protocols
  33. .SH EXAMPLE
  34. .nf
  35. int main(void)
  36. {
  37. CURLSHcode sh;
  38. CURLSH *share = curl_share_init();
  39. sh = curl_share_setopt(share, CURLSHOPT_UNSHARE, CURL_LOCK_DATA_COOKIE);
  40. if(sh)
  41. printf("Error: %s\\n", curl_share_strerror(sh));
  42. }
  43. .fi
  44. .SH AVAILABILITY
  45. Added in curl 7.10.3
  46. .SH RETURN VALUE
  47. CURLSHE_OK (zero) means that the option was set properly, non\-zero means an
  48. error occurred. See \fIlibcurl\-errors(3)\fP for the full list with
  49. descriptions.
  50. .SH SEE ALSO
  51. .BR CURLSHOPT_SHARE (3),
  52. .BR curl_share_cleanup (3),
  53. .BR curl_share_init (3),
  54. .BR curl_share_setopt (3)