From e5b2f33b4f90741e895c19a5e43ed4a1923e0475 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Thu, 6 Oct 2005 08:58:44 +0000 Subject: [PATCH] Added the info from getinfo-times as it really belongs in this man page. --- docs/libcurl/curl_easy_getinfo.3 | 36 +++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) 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.