1curl_multi_add_handle(3)        libcurl Manual        curl_multi_add_handle(3)
2
3
4

NAME

6       curl_multi_add_handle - add an easy handle to a multi session
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLMcode  curl_multi_add_handle(CURLM  *multi_handle,  CURL *easy_han‐
12       dle);
13

DESCRIPTION

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

RETURN VALUE

40       CURLMcode type, general libcurl multi interface error code.
41

SEE ALSO

43       curl_multi_cleanup(3),curl_multi_init(3)
44
45
46
47libcurl 7.9.5                    4 March 2002         curl_multi_add_handle(3)
Impressum