libcurl Manual curl_multi_add_handle(3)
NAME
curl_multi_add_handle - add an easy handle to a multi ses-
sionSYNOPSIS
#include
CURLMcode curl_multi_add_handle(CURLM *multi_handle, CURL
*easy_handle);
DESCRIPTION
Adds a standard easy handle to the multi stack. This func-
tion call will make this multi_handle control the specified
easy_handle. Furthermore, libcurl now initiates the connec-
tion associated with the specified easy_handle.
When an easy handle has been added to a multi stack, you cannot and you must not use curl_easy_perform(3) on that han-
dle! If the easy handle is not set to use a shared(CURLOPT_SHARE) or global DNS cache
(CURLOPT_DNS_USE_GLOBAL_CACHE), it will be made to use the
DNS cache that is shared between all easy handles within themulti handle when curl_multi_add_handle(3) is called.
The easy handle will remain added until you remove it againwith 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)
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes: libcurl 7.9.5 Last change: 4 March 2002 1libcurl Manual curl_multi_add_handle(3)
_______________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE|
|____________________|__________________|_
| Availability | web/curl ||____________________|__________________|_
| Interface Stability| Uncommitted ||____________________|_________________|
NOTESSource for C-URL is available on http://opensolaris.org.
libcurl 7.9.5 Last change: 4 March 2002 2