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  inter-
     face  in  your  C programs. There are specific man pages for
     each function mentioned in here.

     All functions in  the  share  interface  are  prefixed  with
     curlshare.


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 or DNS
     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  curlshareinit(3).  It
     returns a handle for a newly created one.

     You tell the shared object what data you want it to share by
     using curlsharesetopt(3). Currently you can only share DNS
     and/or COKIE data.

     Since you can use this share from multiple threads, and lib-
     curl  has  no internal thread synchronization, you must pro-
     vide mutex callbacks if you're  using  this  multi-threaded.
     You  set lock and unlock functions with curlsharesetopt(3)
     too.

     Then, you make an easy handle to use this share, you set the
     CURLOPTSHARE  option  with curleasysetopt(3), and pass in
     share handle. You can make any number of easy handles  share
     the same share handle.

     To make an easy handle stop using that particular share, you
     set  CURLOPTSHARE  to  NUL for that easy handle. To make a
     handle   stop   sharing   a   particular   data,   you   can
     CURLSHOPTUNSHARE it.

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

SEE ALSO
     curlshareinit(3),                    curlsharesetopt(3),



libcurl 7.10.7       Last change: 8 Aug 2003                    1






libcurl share interface                          libcurl-share(3)



     curlsharecleanup(3)

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWcurl       
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for C-URL is available on http:/opensolaris.org.







































libcurl 7.10.7       Last change: 8 Aug 2003                    2