GNURLINFO...KUP_TIME_T(3)

🦋 GNURLINFO...KUP_TIME_T(3) 🦋

okay so bestie, you found the manual page for GNURLINFO...KUP_TIME_T(3) in the curl_easy_getinfo options manual, and it is literally all about getting the name lookup time in microseconds. tiny units, big main character energy ✨

---

🌸 NAME 🌸

CURLINFO_NAMELOOKUP_TIME_T — get the name lookup time in microseconds 💅

✨ SYNOPSIS ✨

       #include <gnurl/curl.h>

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

💖 DESCRIPTION 💖

okay so you pass a pointer to a curl_off_t, and it receives the total time in microseconds from the start until the name resolving was completed. lowkey precise, highkey useful 🫶

When a redirect is followed, the time from each request is added together. no cap, it stacks 💅

also go peek at the TIMES overview in the curl_easy_getinfo(3) man page — it’s giving the big picture 🌈

🦋 PROTOCOLS 🦋

All — every single protocol, slay ✨

🎀 EXAMPLE 🎀

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

🌈 AVAILABILITY 🌈

Added in 7.61.0 — periodt 🎀

🔥 RETURN VALUE 🔥

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

👑 SEE ALSO 👑

curl_easy_getinfo(3), curl_easy_setopt(3), CURLINFO_NAMELOOKUP_TIME(3) — go read them, iykyk 🫶

---

xoxo, your Unix bestie 💖 — source/version: libcurl 7.61.0, date: 28 Apr 2018, footer title: GNURLINFO...KUP_TIME_T(3). now go get those microseconds, bestie 🦋