Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLMOPT_M...INE_LENGTH(3) Library Functions Manual CURLMOPT_M...INE_LENGTH(3)

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 out-
       standing	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 CURLMOPT_MAX_HOST_CONNECTIONS(3)), 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 CURLMcode	indicating success or error.

       CURLM_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-06-03	    CURLMOPT_M...INE_LENGTH(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLMOPT_MAX_PIPELINE_LENGTH&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help