| 1234567891011121314151617181920212223242526272829303132333435363738394041424344 |
- .\" generated by cd2nroff 0.1 from CURLMOPT_MAX_PIPELINE_LENGTH.md
- .TH CURLMOPT_MAX_PIPELINE_LENGTH 3 "2025-01-17" libcurl
- .SH NAME
- CURLMOPT_MAX_PIPELINE_LENGTH \- maximum number of requests in a pipeline
- .SH SYNOPSIS
- .nf
- #include <curl/curl.h>
- CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_PIPELINE_LENGTH,
- long max);
- .fi
- .SH DESCRIPTION
- No function since pipelining was removed in 7.62.0.
- Pass a long. The set \fBmax\fP number is used as the maximum amount of
- outstanding requests in an HTTP/1.1 pipeline. This option is only used for
- HTTP/1.1 pipelining, not for HTTP/2 multiplexing.
- When this limit is reached, libcurl creates another connection to the same
- host (see \fICURLMOPT_MAX_HOST_CONNECTIONS(3)\fP), or queue the request until one
- .nf
- of the pipelines to the host is ready to accept a request. Thus, the total
- .fi
- \fICURLMOPT_MAX_PIPELINE_LENGTH(3)\fP.
- .SH DEFAULT
- 5
- .SH PROTOCOLS
- This functionality affects all supported protocols
- .SH EXAMPLE
- .nf
- int main(void)
- {
- CURLM *m = curl_multi_init();
- /* set a more conservative pipe length */
- curl_multi_setopt(m, CURLMOPT_MAX_PIPELINE_LENGTH, 3L);
- }
- .fi
- .SH AVAILABILITY
- Added in curl 7.30.0
- .SH RETURN VALUE
- Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
- .SH SEE ALSO
- .BR CURLMOPT_MAX_HOST_CONNECTIONS (3),
- .BR CURLMOPT_PIPELINING (3)
|
