CURLINFO_CONNECT_TIME(3)

💅 CURLINFO_CONNECT_TIME(3) — time to connect ✨

okay bestie, so this is a libcurl manual page (Library Functions Manual, iykyk) and it's literally all about finding out how long the connect took. buckle up 🎀

---

🌸 NAME 🌸

CURLINFO_CONNECT_TIME — time to connect, periodt 💖

---

✨ SYNOPSIS ✨

#include <curl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONNECT_TIME, double *timep);

---

🦋 DESCRIPTION 🦋

Okay so here's the vibe: you pass a pointer to a double, and curl fills it with the total time in seconds from the start until the connection to the remote host (or proxy, no cap) was completed. ⏱️💅

And when a redirect is followed? The time from each request gets added together. all of them. stacked. the whole journey 🔥

👑 also pls go look at the TIMES overview in the curl_easy_getinfo(3) man page, it's giving main character energy and it's lowkey essential reading 🫶

---

🌈 PROTOCOLS 🌈

This functionality affects all supported protocols ✨ (yes, all of them, we love range 💖)

---

🍓 EXAMPLE 🍓

here's the whole thing, character for character, go off bestie:

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    double connect;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    result = curl_easy_perform(curl);
    if(CURLE_OK == result) {
      result = curl_easy_getinfo(curl, CURLINFO_CONNECT_TIME, &connect);
      if(CURLE_OK == result) {
        printf("Time: %.1f", connect);
      }
    }
    /* always cleanup */
    curl_easy_cleanup(curl);
  }
}

---

🧚 AVAILABILITY 🧚

Added in curl 7.4.1 — a certified classic, we stan a veteran 📅💜

---

⭐ RETURN VALUE ⭐

curl_easy_getinfo(3) returns a CURLcode indicating success or error, that's the whole deal 💀

• CURLE_OK (0) means everything was OK 🎉 slay
• non-zero means an error occurred 😭 see libcurl-errors(3) for the full breakdown

---

💜 SEE ALSO 💜

• CURLINFO_CONNECT_TIME_T(3)
• curl_easy_getinfo(3)
• curl_easy_setopt(3)

---

💖 and that's the page!! brought to you by libcurl, dated 2026-10-12 — go time your connects bestie, mwah 💋🌷