.\" generated by cd2nroff 0.1 from CURLMOPT_MAX_PIPELINE_LENGTH.md .TH CURLMOPT_MAX_PIPELINE_LENGTH 3 "2024-12-12" libcurl .SH NAME CURLMOPT_MAX_PIPELINE_LENGTH \- maximum number of requests in a pipeline .SH SYNOPSIS .nf #include 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)