CURLMOPT_MAX_PIPELINE_LENGTH(3)

CURLMOPT_MAX_PIPELINE_LENGTH3

Maximum number of requests in a pipeline

Usage

#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_PIPELINE_LENGTH,
                            long max);

Overview

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

HTTP(S)

Examples

int main(void)
{
  CURLM *m = curl_multi_init();
  /* set a more conservative pipe length */
  curl_multi_setopt(m, CURLMOPT_MAX_PIPELINE_LENGTH, 3L);
}

Return value

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

Releases

74 releases since OS X 10.10.5; the text changed 14 times.

  1. 10.10.5–10.11.6
  2. 10.12–10.12.1
  3. 10.12.2–10.12.5
  4. 10.12.6–10.14.6
  5. 10.15–11.5
  6. 12.0.1–12.2
  7. 12.3–12.5
  8. 13.0
  9. 13.1
  10. 13.2
  11. 13.3
  12. 13.4
  13. 13.5–14.1
  14. 14.2–14.4
  15. 14.5–26.5

Availability

Added in 7.30.0

From curl 166.0.0.0.1 in macOS 26.5. Parsed by carta from the page's man source.