GNURLMOPT...NALTY_SIZE(3)

✨ GNURLMOPT...NALTY_SIZE(3) ✨

okay bestie, grab your iced coffee ☕ — this one comes from the curl_multi_setopt options squad, and it used to be a whole thing. Let's get into it 💅

🌸 NAME 🌸

CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE — the size threshold for the pipelining penalty. yeah. that's the vibe. 🦋

🎀 SYNOPSIS 🎀

#include <gnurl/curl.h>

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

💖 DESCRIPTION 💖

so here's the tea ☕ — no function since pipelining was removed in 7.62.0. like, she's gone, the whole feature is gone. but the option is still documented, so we're still gonna document it, periodt 💅

You'd pass a long with a size in bytes. The lore was: if a pipelined connection is currently processing a request with a Content-Length larger than this CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE(3), then that pipeline will not be considered for additional requests — even if it's shorter than CURLMOPT_MAX_PIPELINE_LENGTH(3). like, it gets benched. no more extra work for you, bestie 🪑✨

🦋 DEFAULT 🦋

The default value is 0, which means the size penalization is inactive. so by default, nobody's getting penalized — everyone's invited to the party 🎉 (well. everyone who was invited in 7.30.0, anyway 🙈).

🌈 PROTOCOLS 🌈

HTTP(S) — that's it, that's the list 👑

⭐ EXAMPLE ⭐

CURLM *m = curl_multi_init();
long maxlength = 10000;
curl_multi_setopt(m, CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE, maxlength);

it's giving "I wrote three lines and called it a day" and honestly? iconic 🎀

🔥 AVAILABILITY 🔥

Added in 7.30.0. a classic. a legend. a whole era 💜

👑 RETURN VALUE 👑

Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. simple as that, no cap 🧢

💀 SEE ALSO 💀

• CURLMOPT_PIPELINING(3)
• CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE(3)

---

and that's the whole page, bestie 🫶 this lil cutie was brought to you by libcurl 7.39.0, dated 4 Nov 2014 — yeah she's vintage, we stan a retro icon 💖✨🎀