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!