Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

libcurl-share (3)

Name

libcurl-share - how to use the share interface

Synopsis

Please see following description for synopsis

Description

libcurl-share(3)            libcurl share interface           libcurl-share(3)



NAME
       libcurl-share - how to use the share interface

DESCRIPTION
       This is an overview on how to use the libcurl share interface in your C
       programs. There are specific man pages for each function  mentioned  in
       here.

       All functions in the share interface are prefixed with curl_share.


OBJECTIVES
       The  share  interface  was added to enable sharing of data between curl
       "handles".

ONE SET OF DATA - MANY TRANSFERS
       You can have multiple easy handles share data between them.  Have  them
       update  and  use the same cookie database, DNS cache, TLS session cache
       and/or connection cache! This  way,  each  single  transfer  will  take
       advantage from data updates made by the other transfer(s).

SHARE OBJECT
       You create a shared object with curl_share_init(3). It returns a handle
       for a newly created one.

       You tell the shared object what data you want  it  to  share  by  using
       curl_share_setopt(3).

       Since  you can use this share from multiple threads, and libcurl has no
       internal thread synchronization, you must provide  mutex  callbacks  if
       you  are  using  this multi-threaded. You set lock and unlock functions
       with curl_share_setopt(3) too.

       Then, you make an easy handle to use  this  share,  you  set  the  CUR-
       LOPT_SHARE(3)  option  with curl_easy_setopt(3), and pass in share han-
       dle. You can make any number of easy handles share the same share  han-
       dle.

       To  make  an easy handle stop using that particular share, you set CUR-
       LOPT_SHARE(3) to NULL for that easy handle. To make a handle stop shar-
       ing a particular data, you can CURLSHOPT_UNSHARE it.

       When  you  are  done  using the share, make sure that no easy handle is
       still using it, and call curl_share_cleanup(3) on the handle.


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


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

SEE ALSO
       curl_share_init(3),     curl_share_setopt(3),     curl_share_cleanup(3)
       libcurl-errors(3), libcurl-easy(3), libcurl-multi(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                 October 31, 2021               libcurl-share(3)