CURLMOPT_MAX_CONCURRENT_STREAMS.3 1.1 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. .\" generated by cd2nroff 0.1 from CURLMOPT_MAX_CONCURRENT_STREAMS.md
  2. .TH CURLMOPT_MAX_CONCURRENT_STREAMS 3 "2025-01-17" libcurl
  3. .SH NAME
  4. CURLMOPT_MAX_CONCURRENT_STREAMS \- max concurrent streams for http2
  5. .SH SYNOPSIS
  6. .nf
  7. #include <curl/curl.h>
  8. CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_CONCURRENT_STREAMS,
  9. long max);
  10. .fi
  11. .SH DESCRIPTION
  12. Pass a long indicating the \fBmax\fP. The set number is used as the maximum
  13. number of concurrent streams libcurl should support on connections done using
  14. HTTP/2 or HTTP/3.
  15. Valid values range from 1 to 2147483647 (2^31 \- 1) and defaults to 100. The
  16. value passed here would be honored based on other system resources properties.
  17. .SH DEFAULT
  18. 100
  19. .SH PROTOCOLS
  20. This functionality affects http only
  21. .SH EXAMPLE
  22. .nf
  23. int main(void)
  24. {
  25. CURLM *m = curl_multi_init();
  26. /* max concurrent streams 200 */
  27. curl_multi_setopt(m, CURLMOPT_MAX_CONCURRENT_STREAMS, 200L);
  28. }
  29. .fi
  30. .SH AVAILABILITY
  31. Added in curl 7.67.0
  32. .SH RETURN VALUE
  33. Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
  34. .SH SEE ALSO
  35. .BR CURLMOPT_MAXCONNECTS (3),
  36. .BR CURLOPT_MAXCONNECTS (3)