GNURLMOPT...ONNECTIONS(3)

💅 GNURLMOPT_MAX_TOTAL_CONNECTIONS(3) — curl_multi_setopt options

okay bestie, listen — this is the gnurl flavor of the curl_multi_setopt options page, and today's main character is CURLMOPT_MAX_TOTAL_CONNECTIONS. she's the bouncer at the club door of your multi handle and she will count everyone. no cap. 🎀

---

✨ NAME ✨

CURLMOPT_MAX_TOTAL_CONNECTIONS — the max number of simultaneously open connections, like, total. not per host, not per vibe, total. 💅

---

🌸 SYNOPSIS 🌸

#include <gnurl/curl.h>

CURLMcode curl_multi_setopt(CURLM *handle,
CURLMOPT_MAX_TOTAL_CONNECTIONS, long amount);

---

🦋 DESCRIPTION 🦋

okay so you pass a long in as the amount, right? that number becomes the maximum number of simultaneously open connections in total using this multi handle. literally the whole squad, one cap. 👑

so for every new session, libcurl opens a new connection — but only up to the limit you set with CURLMOPT_MAX_TOTAL_CONNECTIONS(3). once you hit that limit? the sessions just... wait. pending. hanging out in the group chat until a connection frees up. 😭 no cutting the line, bestie.

and if CURLMOPT_PIPELINING(3) is enabled, libcurl will try to pipeline or use multiplexing if the host is capable of it — like carpooling to the function instead of everyone driving separately. iconic behavior honestly. 🚗✨

---

💜 DEFAULT 💜

the default value is 0, which means there is no limit. ngl, wild. in that case it's simply controlled by the number of easy handles you added — so the easy handles are running the show. main character energy from them, I guess. 🙈

---

🌈 PROTOCOLS 🌈

All — every single one. she's versatile like that. ⭐

---

💖 EXAMPLE 💖

CURLM *m = curl_multi_init();
/* never do more than 15 connections */
curl_multi_setopt(m, CURLMOPT_MAX_TOTAL_CONNECTIONS, 15L);

see that? fifteen. that's the ceiling. the whole squad of 15 and not one more, periodt. 🔥

---

🎀 AVAILABILITY 🎀

Added in 7.30.0 — she's been serving since then, iykyk. 💫

---

👑 RETURN VALUE 👑

returns CURLM_OK if the option is supported — slay, we're so back — and CURLM_UNKNOWN_OPTION if it's not. 😭💀

lowkey important: CURLM_UNKNOWN_OPTION is your sign that this build just doesn't know her. don't take it personally, bestie. 🫶

---

🔥 SEE ALSO 🔥

• CURLMOPT_MAXCONNECTS(3)
• CURLMOPT_MAX_HOST_CONNECTIONS(3)

---

that's the whole page, bestie — go forth and cap your connections responsibly 💜✨

libcurl 7.39.0 · 4 Nov 2014 — yeah that's the version and date down at the bottom, mwah, bye! 🍓🧚