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 outstand-
     ing 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 			   2026-06-11	      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+15.1.quarterly>

home | help