curl_multi_init(3)

curl_multi_init3

Create a multi handle

Usage

#include <curl/curl.h>
CURLM *curl_multi_init();

Overview

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.

Examples

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);
}

Return value

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

Releases

145 releases since Mac OS X 10.3; the text changed 17 times.

  1. 10.3–10.3.9
  2. 10.4–10.5.8
  3. 10.6–10.6.8
  4. 10.7–10.7.5
  5. 10.8–10.11.6
  6. 10.12–10.12.5
  7. 10.12.6–10.14.6
  8. 10.15–11.5
  9. 12.0.1–12.2
  10. 12.3–12.5
  11. 13.0
  12. 13.1
  13. 13.2
  14. 13.3
  15. 13.4
  16. 13.5–14.1
  17. 14.2–14.4
  18. 14.5–26.5

Availability

Added in 7.9.6

From curl 166.0.0.0.1 in macOS 26.5. Parsed by carta from the page's man source.