.\" nroff -man [file]
.\" $Id$
.\"
-.TH curl_easy_getinfo 3 "22 Dec 2004" "libcurl 7.12.3" "libcurl Manual"
+.TH curl_easy_getinfo 3 "6 Oct 2005" "libcurl 7.12.3" "libcurl Manual"
.SH NAME
curl_easy_getinfo - extract information from a curl handle
.SH SYNOPSIS
cookies (cookies for the handle have not been enabled or simply none have been
received) 'struct curl_slist *' will be set to point to NULL. (Added in
7.14.1)
+.SH TIMES
+.NF
+An overview of the six time values available from curl_easy_getinfo()
+
+curk_easy_perform()
+ |
+ |--NT
+ |--|--CT
+ |--|--|--PT
+ |--|--|--|--ST
+ |--|--|--TT
+ |--|--|--|--|--RT
+
+.IP NT
+CURLINFO_NAMELOOKUP_TIME. The time it took from the start until the name
+resolving was completed.
+.IP CT
+CURLINFO_CONNECT_TIME. The time it took from the start until the connect to
+the remote host (or proxy) was completed.
+.IP PT
+CURLINFO_PRETRANSFER_TIME. The time it took from the start until the file
+transfer is just about to begin. This includes all pre-transfer commands and
+negotiations that are specific to the particular protocol(s) involved.
+.IP ST
+CURLINFO_STARTTRANSFER_TIME. The time it took from the start until the first
+byte is just about to be transferred.
+.IP TT
+CURLINFO_TOTAL_TIME. Time of the previous transfer. This time does not include
+the connect time (CT), so if you want the complete operation time, you should
+add that.
+.IP RT
+CURLINFO_REDIRECT_TIME. The time it took for all redirection steps include
+name lookup, connect, pretransfer and transfer before final transaction was
+started. So, this is zero if no redirection took place.
.SH RETURN VALUE
If the operation was successful, CURLE_OK is returned. Otherwise an
appropriate error code will be returned.