plucky (3) CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE.3.gz

Provided by: libcurl4-doc_8.12.1-2ubuntu1_all bug

NAME
       CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE - chunk length threshold for pipelining


SYNOPSIS
       #include <curl/curl.h>

       CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE,
                                   long size);


DESCRIPTION
       No function since pipelining was removed in 7.62.0.

       Pass  a  long  with  a  size  in  bytes.  If  a  transfer in a pipeline is currently processing a chunked
       (Transfer-encoding:    chunked)    request    with    a    current    chunk    length     larger     than
       CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE(3),  that  pipeline is not considered for additional requests, even if
       it is shorter than CURLMOPT_MAX_PIPELINE_LENGTH(3).


DEFAULT
       0, which means that penalization is inactive.


PROTOCOLS
       This functionality affects http only


EXAMPLE
       int main(void)
       {
         CURLM *m = curl_multi_init();
         long maxchunk = 10000;
         curl_multi_setopt(m, CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE, maxchunk);
       }


AVAILABILITY
       Added in curl 7.30.0


RETURN VALUE
       curl_multi_setopt(3) returns a CURLMcode indicating success or error.

       CURLM_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).


SEE ALSO
       CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE(3), CURLMOPT_MAX_PIPELINE_LENGTH(3), CURLMOPT_PIPELINING(3)