This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

curl_multi_add_handle(3)                       libcurl Manual                       curl_multi_add_handle(3)



NAME
       curl_multi_add_handle - add an easy handle to a multi session

SYNOPSIS
       #include <curl/curl.h>

       CURLMcode curl_multi_add_handle(CURLM *multi_handle, CURL *easy_handle);

DESCRIPTION
       Adds  a  standard easy handle to the multi stack. This function call will make this multi_handle con-trol control
       trol the specified easy_handle.

       When an easy handle has been added to a multi stack, you can not and you must not use  curl_easy_per-form(3) curl_easy_perform(3)
       form(3) on that handle!

       If  the  easy  handle  is  not  set  to  use  a  shared  (CURLOPT_SHARE)  or  global  DNS cache (CUR-LOPT_DNS_USE_GLOBAL_CACHE), (CURLOPT_DNS_USE_GLOBAL_CACHE),
       LOPT_DNS_USE_GLOBAL_CACHE), it will be made to use the DNS cache that is shared between all easy han-dles handles
       dles within the multi handle when curl_multi_add_handle(3) is called.

       The  easy  handle  will  remain added until you remove it again with curl_multi_remove_handle(3). You
       should remove the easy handle from the multi stack before you terminate first  the  easy  handle  and
       then the multi handle:

       1 - curl_multi_remove_handle(3)

       2 - curl_easy_cleanup(3)

       3 - curl_multi_cleanup(3)

RETURN VALUE
       CURLMcode type, general libcurl multi interface error code.

SEE ALSO
       curl_multi_cleanup(3),curl_multi_init(3)



libcurl 7.9.5                                   4 March 2002                        curl_multi_add_handle(3)