CURLINFO_TOTAL_TIME(3)

1CURLINFO_TOTAL_TIME(3)     curl_easy_getinfo options    CURLINFO_TOTAL_TIME(3)
2
3
4

NAME

6       CURLINFO_TOTAL_TIME - get total time of previous transfer
7

SYNOPSIS

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

DESCRIPTION

14       Pass a pointer to a double to receive the total time in seconds for the
15       previous transfer, including name resolving, TCP connect etc. The  dou‐
16       ble represents the time in seconds, including fractions.
17
18       When  a  redirect  is followed, the time from each request is added to‐
19       gether.
20
21       See also the TIMES overview in the curl_easy_getinfo(3) man page.
22

PROTOCOLS

24       All
25

EXAMPLE

27       curl = curl_easy_init();
28       if(curl) {
29         double total;
30         curl_easy_setopt(curl, CURLOPT_URL, url);
31         res = curl_easy_perform(curl);
32         if(CURLE_OK == res) {
33           res = curl_easy_getinfo(curl, CURLINFO_TOTAL_TIME, &total);
34           if(CURLE_OK == res) {
35             printf("Time: %.1f", total);
36           }
37         }
38         /* always cleanup */
39         curl_easy_cleanup(curl);
40       }
41

AVAILABILITY

43       Added in 7.4.1
44

RETURN VALUE

46       Returns CURLE_OK if the option is supported,  and  CURLE_UNKNOWN_OPTION
47       if not.
48