curl_easy_duphandle(3)	  libcurl Manual   curl_easy_duphandle(3)

NAME
       curl_easy_duphandle - Clone a libcurl session handle

SYNOPSIS
       #include <curl/curl.h>

       CURL *curl_easy_duphandle(CURL *handle);

DESCRIPTION
       This  function will return a new curl handle, a duplicate,
       using all the options previously set  in	 the  input  curl
       handle.	Both  handles  can  subsequently be used indepen-
       dently	and   they    must    both    be    freed    with
       curl_easy_cleanup().

       All  strings  that the input handle has been told to point
       to  (as	opposed	 to  copy)   with   previous   calls   to
       curl_easy_setopt	 using	char * inputs, will be pointed to
       by the new handle as well. You must therefore make sure to
       keep  the data around until both handles have been cleaned
       up.

       The new handle will not inherit any state information,  no
       connections, no SSL sessions and no cookies.

       Note  that  even in multi-threaded programs, this function
       must be called in a synchronous way, the input handle  may
       not be in use when cloned.

       This function was added in libcurl 7.9.

RETURN VALUE
       If this function returns NULL, something went wrong and no
       valid handle was returned.

SEE ALSO
       curl_easy_init(3),curl_easy_cleanup(3),curl_global_init(3)

BUGS
       Surely there are some, you tell me!

libcurl 7.9		18 September 2001  curl_easy_duphandle(3)

Vote for polarhome