GNURLMOPT...INE_LENGTH(3)

🎀 GNURLMOPT...INE_LENGTH(3) 🎀

okay so bestie, this page lives in the curl_multi_setopt options family — it's the whole manual-name vibe, that's the collection it belongs to. Buckle up, it's a short one but there's lore 💅

---

✨ NAME ✨

CURLMOPT_MAX_PIPELINE_LENGTH — the max number of requests you can cram into a pipeline, literally that's it 🫶

---

📜 SYNOPSIS 📜

#include <gnurl/curl.h>

CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_PIPELINE_LENGTH,
long max);

---

💖 DESCRIPTION 💖

Okay so first thing's first, and this is kind of the whole ~storyline~: there is no function anymore 😭 pipelining got removed way back in 7.62.0, so this option is giving "ghost of options past" energy.

But for the historical record ngl: you pass a long. That max number you set gets used as the maximum amount of outstanding requests allowed on an HTTP/1.1 pipelined connection. Key detail bestie — this option is only used for HTTP/1.1 pipelining, not for HTTP/2 multiplexing. Two totally different vibes, don't mix them up 💀

When you actually hit that limit, libcurl goes and grabs another connection to the same host (peep CURLMOPT_MAX_HOST_CONNECTIONS(3)), or it just queues your request until one of the pipelines to that host is ready to accept it. Patience era ✨

So the total number of requests in-flight works out to:

CURLMOPT_MAX_HOST_CONNECTIONS(3) * CURLMOPT_MAX_PIPELINE_LENGTH(3)

That's the math, no cap 🧮

---

🌸 DEFAULT 🌸

5

(five, that's the number, iconic, love that for us)

---

🦋 PROTOCOLS 🦋

HTTP(S)

---

⭐ EXAMPLE ⭐

CURLM *m = curl_multi_init();
/* set a more conservative pipe length */
curl_multi_setopt(m, CURLMOPT_MAX_PIPELINE_LENGTH, 3L);

look at that, three, so conservative, so demure 🎀

---

🌈 AVAILABILITY 🌈

Added in 7.30.0 — a real one, she existed 💜

---

💅 RETURN VALUE 💅

Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. Simple, clean, no drama 👑

---

👀 SEE ALSO 👀

• CURLMOPT_PIPELINING(3)
• CURLMOPT_MAX_HOST_CONNECTIONS(3),

(yeah the trailing comma is in the original, she's just like that, leave her alone 🙈)

---

so yeah that's the whole page bestie, short and sweet 🍓 this iconic little number comes to you straight from libcurl 7.39.0, dated 4 Nov 2014, filed under GNURLMOPT...INE_LENGTH(3) — mwah, go forth and pipeline (or don't, apparently, since 7.62.0 😭) 💖✨