GNURLINFO...NNECT_TIME(3)

🎀 NAME 🎀

• CURLINFO_APPCONNECT_TIME — get the time until the SSL/SSH handshake is completed.

okay so bestie, you're in the curl_easy_getinfo options part of the gnurl manual — the running head is GNURLINFO...NNECT_TIME(3) because long names get terminal-squished, not because we're being mysterious 💅. This lookup hands you the SSL/SSH handshake time, and it's lowkey iconic.

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

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

💖 DESCRIPTION 💖

Pass a pointer to a double to receive the time, in seconds, it took from the start until the SSL/SSH connect/handshake to the remote host was completed. Yep: literally seconds, from the very start, until that handshake said "we're done here." 💅

This time is most often very near to the CURLINFO_PRETRANSFER_TIME(3) time, except for cases such as HTTP pipelining where the pretransfer time can be delayed due to waits in line for the pipeline and more. No cap, that caveat is real and it matters.

When a redirect is followed, the time from each request is added together. So it's cumulative, not a single-request-only number — important.

See also the TIMES overview in the curl_easy_getinfo(3) man page. It's giving reference-table realness.

🦋 PROTOCOLS 🦋

• All — that's the whole protocol guest list. Everyone's invited. ✨

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

🎀 AVAILABILITY 🎀

• Added in 7.19.0 — vintage, but make it fashion. 💖

🔥 RETURN VALUE 🔥

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. So check your return value, bestie — don't just vibe and hope. 😭

💜 SEE ALSO 💜

• curl_easy_getinfo(3)
• curl_easy_setopt(3)
• CURLINFO_APPCONNECT_TIME_T(3)

💖 That's the whole page, bestie. This manpage moment comes from libcurl 7.44.0, dated 28 Aug 2015 — iconic vintage, no cap. 🎀✨