Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

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

CURLSHOPT_UNSHARE(3)            libcurl 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 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  will  no  longer be shared across the easy handles
              using this shared object.

       CURL_LOCK_DATA_DNS
              Cached DNS hosts will be no longer be  shared  across  the  easy
              handles using this shared object.

       CURL_LOCK_DATA_SSL_SESSION
              SSL session IDs will no longer be 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
       All

EXAMPLE
         CURLSHcode sh;
         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 7.10

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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       CURLSHOPT_SHARE(3),    curl_share_setopt(3),     curl_share_cleanup(3),
       curl_share_init(3)



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source       was       downloaded      from       https://curl.se/down-
       load/curl-7.83.1.tar.bz2.

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.



libcurl 7.83.1                  April 15, 2022            CURLSHOPT_UNSHARE(3)