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

DEFAULT

28       5
29

PROTOCOLS

31       HTTP(S)
32

EXAMPLE

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

AVAILABILITY

39       Added in 7.30.0
40

RETURN VALUE

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