CURLMOPT_MAX_PIPELINE_LENGTH(3)

CURLMOPT_MAX_PIPELINE_LENGTH(3curl_multi_setopt optionCURLMOPT_MAX_PIPELINE_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

     Pass a long. The set max number will be used as the  maximum
     amount of outstanding requests in an HTTP/1.1 pipelined con-
     nection. This option is only used for  HTTP/1.1  pipelining,
     not for HTTP/2 multiplexing.

     When this limit is reached, libcurl will use another connec-
     tion        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 number of  requests  in-flight  is
     CURLMOPT_MAX_HOST_CONNECTIONS(3)                           *
     CURLMOPT_MAX_PIPELINE_LENGTH(3).

DEFAULT

     5

PROTOCOLS

     HTTP(S)

EXAMPLE

     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_PIPELINING(3), CURLMOPT_MAX_HOST_CONNECTIONS(3),

libcurl 7.58.0      Last change: May 27, 2017                   1