1curl_multi_add_handle(3) libcurl Manual curl_multi_add_handle(3)
2
3
4
6 curl_multi_add_handle - add an easy handle to a multi session
7
9 #include <curl/curl.h>
10
11 CURLMcode curl_multi_add_handle(CURLM *multi_handle, CURL *easy_han‐
12 dle);
13
15 Adds a standard easy handle to the multi stack. This function call will
16 make this multi_handle control the specified easy_handle. Furthermore,
17 libcurl now initiates the connection associated with the specified
18 easy_handle.
19
20 When an easy handle has been added to a multi stack, you can not and
21 you must not use curl_easy_perform(3) on that handle!
22
23 If the easy handle is not set to use a shared (CURLOPT_SHARE) or global
24 DNS cache (CURLOPT_DNS_USE_GLOBAL_CACHE), it will be made to use the
25 DNS cache that is shared between all easy handles within the multi han‐
26 dle when curl_multi_add_handle(3) is called.
27
28 The easy handle will remain added until you remove it again with
29 curl_multi_remove_handle(3). You should remove the easy handle from the
30 multi stack before you terminate first the easy handle and then the
31 multi handle:
32
33 1 - curl_multi_remove_handle(3)
34
35 2 - curl_easy_cleanup(3)
36
37 3 - curl_multi_cleanup(3)
38
40 CURLMcode type, general libcurl multi interface error code.
41
43 curl_multi_cleanup(3),curl_multi_init(3)
44
45
46
47libcurl 7.9.5 4 March 2002 curl_multi_add_handle(3)