GNURLINFO_...ECT_TIME_T(3)

💅 NAME 💅

CURLINFO_CONNECT_TIME_T — bestie, this is the one that tells you how long it took to connect, like actually connect, to the remote host. no cap.

---

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONNECT_TIME_T,
curl_off_t *timep);

---

🦋 DESCRIPTION 🦋

okay so here's the vibe 💖 — you pass in a pointer to a curl_off_t, and it gets filled with the total time in microseconds from the start until the connection to the remote host (or proxy) was completed. that's it, that's the whole thing, and honestly? iconic.

the way that redirects work tho — when a redirect is followed, the time from each request is added together. so it's a cumulative situation, not a "just the last one" situation. iykyk 🫶

also like, pls go peek at the TIMES overview in the curl_easy_getinfo(3) man page, it's the main character of this whole times-adjacent friend group 🌈

---

🧚 PROTOCOLS 🧚

All 💀 (literally all of them, she does not discriminate, periodt)

---

🎀 EXAMPLE 🎀

here's the code, exactly as it is, no notes, she ate:

curl = curl_easy_init();
if(curl) {
  curl_off_t connect;
  curl_easy_setopt(curl, CURLOPT_URL, url);
  res = curl_easy_perform(curl);
  if(CURLE_OK == res) {
    res = curl_easy_getinfo(curl, CURLINFO_CONNECT_TIME_T, &connect);
    if(CURLE_OK == res) {
      printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", connect / 1000000,
             (long)(connect % 1000000));
    }
  }
  /* always cleanup */
  curl_easy_cleanup(curl);
}

lowkey obsessed with that /* always cleanup */ comment — she's reminding you to be a responsible lil dev 🧼✨

---

⭐ AVAILABILITY ⭐

Added in 7.61.0 🎂 (yes she's been around, respect her)

---

🔥 RETURN VALUE 🔥

returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if it's not 😭 — so like, check your return codes bestie, don't just vibe and assume.

---

🌸 SEE ALSO 🌸

• curl_easy_getinfo(3)
• curl_easy_setopt(3)
• CURLINFO_CONNECT_TIME(3)

---

and that's the whole page 💜 this was written by the libcurl 7.61.0 girlies, dated 28 Apr 2018 — go forth and time your connects, you gorgeous nerd 🫶✨🎀