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 (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
       All

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 7.30.0

RETURN VALUE
       Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION
       if not.

SEE ALSO
       CURLMOPT_MAX_HOST_CONNECTIONS(3), CURLMOPT_PIPELINING(3)

libcurl                          April 26 2024 CURLMOPT_MAX_PIPELINE_LENGTH(3)