|
|
This manual page is for Mac OS X version 10.6If you are running a different version of Mac OS X, view the documentation locally:
Reading manual pagesManual pages are intended as a quick reference for people who already understand a technology.
|
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. Furthermore, libcurl now initiates the connection associated with
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)
|
The way to report a problem with this manual page depends on the type of problem: