Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

curl_multi_init (3)

Name

curl_multi_init - create a multi handle

Synopsis

#include <curl/curl.h>

CURLM *curl_multi_init();

Description

curl_multi_init(3)              libcurl Manual              curl_multi_init(3)



NAME
       curl_multi_init - create a multi handle

SYNOPSIS
       #include <curl/curl.h>

       CURLM *curl_multi_init();

DESCRIPTION
       This  function  returns  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.

EXAMPLE
       /* init a multi stack */
       multi_handle = curl_multi_init();

       /* add individual transfers */
       curl_multi_add_handle(multi_handle, http_handle);
       curl_multi_add_handle(multi_handle, http_handle2);

AVAILABILITY
       Added in 7.9.6

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       curl_multi_cleanup(3),curl_global_init(3),curl_easy_init(3)



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source       was       downloaded      from       https://curl.se/down-
       load/curl-7.83.1.tar.bz2.

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.



libcurl 7.83.1                 January 04, 2022             curl_multi_init(3)