CURLINFO_QUEUE_TIME_T(3)

✨ CURLINFO_QUEUE_TIME_T ✨ (3)

okay so real quick — this is a page from the Library Functions Manual, and the star of the show is CURLINFO_QUEUE_TIME_T, bestie 💅

🌸 NAME 🌸

CURLINFO_QUEUE_TIME_T — literally the time this transfer was queued 🕰️

---

🎀 SYNOPSIS 🎀

#include <curl/curl.h>

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

🦋 DESCRIPTION 🦋

so you pass a pointer to a curl_off_t, right? and that gets filled in with the time — in microseconds — that this transfer was just vibing in a waiting queue before it started "for real" ✨

like, a transfer might get put in a queue if, after it got started, it can't create a new connection etc. because of conditions and limits the application set up. so it's just sitting there, in its little waiting room, waiting for its main character moment 😭👑

also pls go peek at the TIMES overview in the curl_easy_getinfo(3) man page, it's a whole thing 💖

🌈 PROTOCOLS 🌈

this functionality affects all supported protocols 🫶

🧚 EXAMPLE 🧚

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_off_t queue;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    result = curl_easy_perform(curl);
    if(CURLE_OK == result) {
      result = curl_easy_getinfo(curl, CURLINFO_QUEUE_TIME_T, &queue);
      if(CURLE_OK == result) {
        printf("Queued: %" CURL_FORMAT_CURL_OFF_T ".%06ld us", queue / 1000000,
               (long)(queue % 1000000));
      }
    }
    /* always cleanup */
    curl_easy_cleanup(curl);
  }
}

⭐ AVAILABILITY ⭐

added in curl 8.6.0 — so if you're on anything older it's giving "not invited to the party" 🙈

💜 RETURN VALUE 💜

curl_easy_getinfo(3) returns a CURLcode indicating success or error.

CURLE_OK (that's 0) means everything was OK 💖 — non-zero means an error occurred, so go check libcurl-errors(3) for the tea 🔥

👑 SEE ALSO 👑

• CURLINFO_STARTTRANSFER_TIME_T(3)
• CURLOPT_TIMEOUT(3)
• curl_easy_getinfo(3)
• curl_easy_setopt(3)

---

k bye bestie, this page is from libcurl, dated 2026-10-12 — go forth and time your queues 💅✨