plucky (3) CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE.3.gz

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

NAME

       CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE - size threshold for pipelining penalty

SYNOPSIS

       #include <curl/curl.h>

       CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_CONTENT_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 request with a
       Content-Length larger than this CURLMOPT_CONTENT_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 the size penalization is inactive.

PROTOCOLS

       This functionality affects http only

EXAMPLE

       int main(void)
       {
         CURLM *m = curl_multi_init();
         long maxlength = 10000;
         curl_multi_setopt(m, CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE, maxlength);
       }

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_CHUNK_LENGTH_PENALTY_SIZE(3), CURLMOPT_PIPELINING(3)