GNURLINFO_CONNECT_TIME(3)

📦 version 7.72.0, in nixos 26.05, nixpkgs unstable

🦋 GNURLINFO_CONNECT_TIME(3) 🦋

okay so bestie, welcome to the GNURLINFO_CONNECT_TIME(3) page — it lives in the curl_easy_getinfo options manual section, and it’s literally all about timing your connection. no cap, this one is short and sweet. 💅

✨ NAME ✨

CURLINFO_CONNECT_TIME — get the time until connect ⏱️✨

💻 SYNOPSIS 💻

#include <gnurl/curl.h>

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

🌸 DESCRIPTION 🌸

okay so you pass a pointer to a double, and it receives the total time in seconds from the start until the connection to the remote host (or proxy) was completed. 🫶

when a redirect is followed, the time from each request is added together. yes bestie, it stacks. 💅

also check out the TIMES overview in the curl_easy_getinfo(3) man page — that’s where the timing lore lives. 👑

🌈 PROTOCOLS 🌈

All 💯 — every protocol, no gatekeeping.

🎀 EXAMPLE 🎀

curl = curl_easy_init();
if(curl) {
  double 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, &connect);
    if(CURLE_OK == res) {
      printf("Time: %.1f", connect);
    }
  }
  /* always cleanup */
  curl_easy_cleanup(curl);
}

🦋 AVAILABILITY 🦋

Added in 7.4.1 — vintage but iconic. ✨

💜 RETURN VALUE 💜

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. that’s the whole vibe check. 💅

🔥 SEE ALSO 🔥

mwah 💋 okay bestie, that’s the page. this one is from libcurl 7.44.0, dated 28 Aug 2015, and the footer title is GNURLINFO_CONNECT_TIME(3) — bye, love you, go time those connections fr fr 🫶✨

📦 where this page comes from