Added the info from getinfo-times as it really belongs in this man page.
authorDaniel Stenberg <daniel@haxx.se>
Thu, 6 Oct 2005 08:58:44 +0000 (08:58 +0000)
committerDaniel Stenberg <daniel@haxx.se>
Thu, 6 Oct 2005 08:58:44 +0000 (08:58 +0000)
docs/libcurl/curl_easy_getinfo.3

index 75b93e3..7c7b7c2 100644 (file)
@@ -2,7 +2,7 @@
 .\" 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
@@ -141,6 +141,40 @@ cookies cURL knows (expired ones, too). Don't forget to
 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.