CURLMOPT_MAX_PIPELINE_LENGTH(3)

1CURLMOPT_MAX_PIPELINE_LENGTHc(u3r)l_multi_setopt optCiUoRnLsMOPT_MAX_PIPELINE_LENGTH(3)
2
3
4

NAME

6       CURLMOPT_MAX_PIPELINE_LENGTH - maximum number of requests in a pipeline
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLMcode     curl_multi_setopt(CURLM    *handle,    CURLMOPT_MAX_PIPE‐
12       LINE_LENGTH, long max);
13

DESCRIPTION

15       Pass a long. The set max number will be used as the maximum  amount  of
16       outstanding  requests  in an HTTP/1.1 pipelined connection. This option
17       is only used for HTTP/1.1 pipelining, not for HTTP/2 multiplexing.
18
19       When this limit is reached, libcurl will use another connection to  the
20       same  host (see CURLMOPT_MAX_HOST_CONNECTIONS(3)), or queue the request
21       until one of the pipelines to the host is ready to  accept  a  request.
22       Thus,  the total number of requests in-flight is CURLMOPT_MAX_HOST_CON‐
23       NECTIONS(3) * CURLMOPT_MAX_PIPELINE_LENGTH(3).
24

DEFAULT

26       5
27

PROTOCOLS

29       HTTP(S)
30

EXAMPLE

32       CURLM *m = curl_multi_init();
33       /* set a more conservative pipe length */
34       curl_multi_setopt(m, CURLMOPT_MAX_PIPELINE_LENGTH, 3L);
35

AVAILABILITY

37       Added in 7.30.0
38

RETURN VALUE

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