oracular (3) curl_multi_init.3.gz

Provided by: libcurl4-doc_8.9.1-2ubuntu2.2_all bug

NAME

       curl_multi_init - create a multi handle

SYNOPSIS

       #include <curl/curl.h>

       CURLM *curl_multi_init();

DESCRIPTION

       This  function  returns a pointer to a CURLM handle to be used as input to all the other multi-functions,
       sometimes referred to as a multi handle in some places in the documentation. This init call MUST  have  a
       corresponding call to curl_multi_cleanup(3) when the operation is complete.

PROTOCOLS

       This functionality affects all supported protocols

EXAMPLE

       int main(void)
       {
         /* init a multi stack */
         CURLM *multi = curl_multi_init();
         CURL *curl = curl_easy_init();
         CURL *curl2 = curl_easy_init();

         /* add individual transfers */
         curl_multi_add_handle(multi, curl);
         curl_multi_add_handle(multi, curl2);
       }

AVAILABILITY

       Added in curl 7.9.6

RETURN VALUE

       If this function returns NULL, something went wrong and you cannot use the other curl functions.

SEE ALSO

       curl_easy_init(3),       curl_global_init(3),       curl_multi_add_handle(3),      curl_multi_cleanup(3),
       curl_multi_get_handles(3)