curl_multi_init.3 1.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. .\" generated by cd2nroff 0.1 from curl_multi_init.md
  2. .TH curl_multi_init 3 "2025-01-17" libcurl
  3. .SH NAME
  4. curl_multi_init \- create a multi handle
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. CURLM *curl_multi_init();
  9. .fi
  10. .SH DESCRIPTION
  11. This function returns a pointer to a \fICURLM\fP handle to be used as input to
  12. all the other multi\-functions, sometimes referred to as a multi handle in some
  13. places in the documentation. This init call MUST have a corresponding call to
  14. \fIcurl_multi_cleanup(3)\fP when the operation is complete.
  15. .SH PROTOCOLS
  16. This functionality affects all supported protocols
  17. .SH EXAMPLE
  18. .nf
  19. int main(void)
  20. {
  21. /* init a multi stack */
  22. CURLM *multi = curl_multi_init();
  23. CURL *curl = curl_easy_init();
  24. CURL *curl2 = curl_easy_init();
  25. /* add individual transfers */
  26. curl_multi_add_handle(multi, curl);
  27. curl_multi_add_handle(multi, curl2);
  28. }
  29. .fi
  30. .SH AVAILABILITY
  31. Added in curl 7.9.6
  32. .SH RETURN VALUE
  33. If this function returns NULL, something went wrong and you cannot use the
  34. other curl functions.
  35. .SH SEE ALSO
  36. .BR curl_easy_init (3),
  37. .BR curl_global_init (3),
  38. .BR curl_multi_add_handle (3),
  39. .BR curl_multi_cleanup (3),
  40. .BR curl_multi_get_handles (3)