CURLINFO_CONNECT_TIME_T(3)

1CURLINFO_CONNECT_TIME_T(3) curl_easy_getinfo optionsCURLINFO_CONNECT_TIME_T(3)
2
3
4

NAME

6       CURLINFO_CONNECT_TIME_T - get the time until connect
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode   curl_easy_getinfo(CURL   *handle,   CURLINFO_CONNECT_TIME_T,
12       curl_off_t *timep);
13

DESCRIPTION

15       Pass a pointer to a curl_off_t to receive the total time  in  microsec‐
16       onds  from the start until the connection to the remote host (or proxy)
17       was completed.  See also the TIMES overview in the curl_easy_getinfo(3)
18       man page.
19

PROTOCOLS

21       All
22

EXAMPLE

24       curl = curl_easy_init();
25       if(curl) {
26         curl_off_t connect;
27         curl_easy_setopt(curl, CURLOPT_URL, url);
28         res = curl_easy_perform(curl);
29         if(CURLE_OK == res) {
30           res = curl_easy_getinfo(curl, CURLINFO_CONNECT_TIME_T, &connect);
31           if(CURLE_OK == res) {
32             printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", connect / 1000000,
33                    (long)(connect % 1000000));
34           }
35         }
36         /* always cleanup */
37         curl_easy_cleanup(curl);
38       }
39

AVAILABILITY

41       Added in 7.61.0
42

RETURN VALUE

44       Returns  CURLE_OK  if the option is supported, and CURLE_UNKNOWN_OPTION
45       if not.
46