curl_easy_getinfo - extract information from a curl handle
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ...
);
Request internal information from the curl session with this
function. The third argument MUST be a pointer to a long, a pointer
to a char *, a pointer to a struct curl_slist * or a pointer to a double (as
this documentation describes further down). The data pointed-to will be
filled in accordingly and can be relied upon only if the function returns
CURLE_OK. Use this function AFTER a performed transfer if you want to get
transfer related data.
You should not free the memory returned by this function unless it
is explicitly mentioned below.
An overview of the six time values available from curl_easy_getinfo()
curl_easy_perform()
|
|--NAMELOOKUP
|--|--CONNECT
|--|--|--APPCONNECT
|--|--|--|--PRETRANSFER
|--|--|--|--|--STARTTRANSFER
|--|--|--|--|--|--TOTAL
|--|--|--|--|--|--REDIRECT
- NAMELOOKUP
- CURLINFO_NAMELOOKUP_TIME and fICURLINFO_NAMELOOKUP_TIME_T.
The time it took from the start until the name resolving was
completed.
- CONNECT
- CURLINFO_CONNECT_TIME and CURLINFO_CONNECT_TIME_T. The time
it took from the start until the connect to the remote host (or proxy) was
completed.
- APPCONNECT
- CURLINFO_APPCONNECT_TIME and CURLINFO_APPCONNECT_TIME_T. The
time it took from the start until the SSL connect/handshake with the
remote host was completed. (Added in 7.19.0) The latter is the integer
version (measuring microseconds). (Added in 7.60.0)
- PRETRANSFER
- CURLINFO_PRETRANSFER_TIME and CURLINFO_PRETRANSFER_TIME_T.
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.
- STARTTRANSFER
- CURLINFO_STARTTRANSFER_TIME and
CURLINFO_STARTTRANSFER_TIME_T. The time it took from the start
until the first byte is received by libcurl.
- TOTAL
- CURLINFO_TOTAL_TIME and CURLINFO_TOTAL_TIME_T. Total time of
the previous request.
- REDIRECT
- CURLINFO_REDIRECT_TIME and CURLINFO_REDIRECT_TIME_T. 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.
If the operation was successful, CURLE_OK is returned. Otherwise
an appropriate error code will be returned.