curl_easy_duphandle(3)    libcurl Manual   curl_easy_duphandle(3)



NAME
       curl_easy_duphandle - Clone a libcurl session handle

SYNOPSIS
       #include 

       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(3).

       All  strings  that the input handle has been told to point
       to  (as  opposed  to  copy)   with   previous   calls   to
       curl_easy_setopt(3)  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.

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)




libcurl 7.9             18 September 2001  curl_easy_duphandle(3)