GNURLOPT_CONNECTTIMEOUT(3)

okay so bestie, welcome to GNURLOPT_CONNECTTIMEOUT(3) from the curl_easy_setopt options manual 💖 we're talking about CURLOPT_CONNECTTIMEOUT, aka the “how long do I wait for this connection, omg” knob, and it's lowkey iconic ✨

🌸 NAME 🌸

CURLOPT_CONNECTTIMEOUT — timeout for the connect phase. That's the name, that's the vibe, periodt 🎀

🦋 SYNOPSIS 🦋

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECTTIMEOUT, long
timeout);

💖 DESCRIPTION 💖

Pass a long. That long should contain the maximum time in seconds that you allow the connection phase to the server to take. This only limits the connection phase — once it has connected, it has no impact. No cap. ⏳

Set it to zero to switch to the default built-in connection timeout — 300 seconds. Also see the CURLOPT_TIMEOUT(3) option if you're doing timeout lore 👀

🚨 caveat, bestie: in unix-like systems, this might cause signals to be used unless CURLOPT_NOSIGNAL(3) is set.

If both CURLOPT_CONNECTTIMEOUT(3) and CURLOPT_CONNECTTIMEOUT_MS(3) are set, the value set last will be used. Last one wins, fr fr 👑

🍓 DEFAULT 🍓

300 — literally 300 seconds, the built-in default 😌

🌈 PROTOCOLS 🌈

All — all the protocols, no gatekeeping 💫

✨ EXAMPLE ✨

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

  /* complete connection within 10 seconds */
  curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 10L);

  curl_easy_perform(curl);
}

🔥 AVAILABILITY 🔥

Always. Like, always always. 💅

👑 RETURN VALUE 👑

Returns CURLE_OK. Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a negative value or a value that when converted to milliseconds is too large. So don't set it to a negative gremlin number, mwah 💋

🧚 SEE ALSO 🧚

• CURLOPT_CONNECTTIMEOUT_MS(3)
• CURLOPT_TIMEOUT(3)
• CURLOPT_LOW_SPEED_LIMIT(3)

---

source/version: libcurl 7.37.0 · date: 17 Jun 2014 · page: GNURLOPT_CONNECTTIMEOUT(3) — folded into this cute lil sign-off instead of a boring footer 🫶 bye bestie, go set your timeouts responsibly 💖🦋