aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_easy_getinfo.3
diff options
context:
space:
mode:
Diffstat (limited to 'docs/libcurl/curl_easy_getinfo.3')
-rw-r--r--docs/libcurl/curl_easy_getinfo.336
1 files changed, 35 insertions, 1 deletions
diff --git a/docs/libcurl/curl_easy_getinfo.3 b/docs/libcurl/curl_easy_getinfo.3
index 75b93e3a5..7c7b7c261 100644
--- a/docs/libcurl/curl_easy_getinfo.3
+++ b/docs/libcurl/curl_easy_getinfo.3
@@ -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.