table of contents
- bookworm 7.88.1-10+deb12u12
- bookworm-backports 8.12.1-3~bpo12+1
- testing 8.12.1-3
- unstable 8.13.0~rc2-1
- experimental 8.13.0~rc-1~exp2
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE(3) | Library Functions Manual | CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE(3) |
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)
2025-03-08 | libcurl |