Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   3616 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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  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
     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 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  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). Currently you can only share DNS
     and/or COOKIE 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 curl_share_setopt(3)
     too.

     Then, you make an easy handle to use this share, you set the
     CURLOPT_SHARE  option  with curl_easy_setopt(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  CURLOPT_SHARE	 to  NULL for that easy handle. To make a
     handle   stop   sharing   a   particular	data,	you   can
     CURLSHOPT_UNSHARE it.

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

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

libcurl 7.10.7	     Last change: 8 Aug 2003			1

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

     curl_share_cleanup(3)

libcurl 7.10.7	     Last change: 8 Aug 2003			2

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome