GNURLINFO_TOTAL_TIME_T(3)

okay bestie, welcome to GNURLINFO_TOTAL_TIME_T(3) — a page straight out of the curl_easy_getinfo options manual, and the main character is literally CURLINFO_TOTAL_TIME_T ⏱️✨

---

✨ NAME ✨

CURLINFO_TOTAL_TIME_T — get the total time of the previous transfer in microseconds. that's the whole vibe, no cap 💅

🦋 SYNOPSIS 🦋

okay so you include this and call it like this:

#include <gnurl/curl.h>

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

🌸 DESCRIPTION 🌸

you pass a pointer to a curl_off_t, and it receives the total time in microseconds for the previous transfer, including name resolving, TCP connect etc. — yes, the whole little journey 🫶 The curl_off_t represents the time in microseconds, fr fr.

When a redirect is followed, the time from each request is added together. so if it hops around, those request times stack up together 💫

also peek at the TIMES overview in the curl_easy_getinfo(3) man page. iykyk 👑

🌈 PROTOCOLS 🌈

All. literally all of them, no protocol left behind 👑✨

🎀 EXAMPLE 🎀

here's the example, untouched because we respect the code around here:

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

💜 AVAILABILITY 💜

Added in 7.61.0. so like, that's when it showed up ✨

🔥 RETURN VALUE 🔥

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. slay 💅

🌟 SEE ALSO 🌟

go peek at these too, bestie:

• curl_easy_getinfo(3)
• curl_easy_setopt(3)
• CURLINFO_TOTAL_TIME(3)

---

kisses and sparkles 🫶 this page is from libcurl 7.61.0, dated 28 Apr 2018, and yes it's still giving GNURLINFO_TOTAL_TIME_T(3) energy 💖🎀🦋