CURLMOPT_MAX_PIPELINE_LENGTH(3) Library Functions Manual
NAME
CURLMOPT_MAX_PIPELINE_LENGTH - maximum number of requests in a pipeline
SYNOPSIS
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_PIPELINE_LENGTH,
long max);
DESCRIPTION
No function since pipelining was removed in 7.62.0.
Pass a long. The set max 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 (s)), or queue the request
until one
of the pipelines to the host is ready to accept a request. Thus, the total
CURLMOPT_MAX_PIPELINE_LENGTH(3).
DEFAULT
5
PROTOCOLS
This functionality affects all supported protocols
EXAMPLE
int main(void)
{
CURLM *m = curl_multi_init();
/* set a more conservative pipe length */
curl_multi_setopt(m, CURLMOPT_MAX_PIPELINE_LENGTH, 3L);
}
AVAILABILITY
Added in curl 7.30.0
RETURN VALUE
curl_multi_setopt(3) returns a CURLcode indicating success or error.
CURLE_OK (0) means everything was OK, non-zero means an error occurred,
see libcurl-errors(3).
SEE ALSO
CURLMOPT_MAX_HOST_CONNECTIONS(3), CURLMOPT_PIPELINING(3)
libcurl 2025-02-08 CURLMOPT_MAX_PIPELINE_LENGTH(3)
curl 8.12.0 - Generated Tue Feb 11 15:04:58 CST 2025