curl_easy_getinfo - extract information from a curl handle
Name
curl_easy_getinfo - extract information from a curl handle
Synopsis
#include <curl/curl.h> CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ... );
Description
Get the info kept in the curl handle. The third argument MUST be pointing to the specific type of the used option which is documented in each man page of the info option. The data is stored accordingly and can be relied upon only if this 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.
Options
The following information can be extracted:
The session's active socket. See CURLINFO_ACTIVESOCKET
The time it took from the start until the SSL connect/handshake with the remote host was completed as a double in number of seconds. (Added in 7.19.0)
The time it took from the start until the SSL connect/handshake with the remote host was completed in number of microseconds. (Added in 7.60.0) See CURLINFO_APPCONNECT_TIME_T
Get the default value for CURLOPT_CAINFO. See CURLINFO_CAINFO
Get the default value for CURLOPT_CAPATH. See CURLINFO_CAPATH
Certificate chain. See CURLINFO_CERTINFO
Whether or not a time conditional was met or 304 HTTP response. See CURLINFO_CONDITION_UNMET
The time it took from the start until the connect to the remote host (or proxy) was completed. As a double. See CURLINFO_CONNECT_TIME
The time it took from the start until the connect to the remote host (or proxy) was completed. In microseconds. See CURLINFO_CONNECT_TIME_T.
The ID of the last connection used by the transfer. (Added in 8.2.0) See CURLINFO_CONN_ID
CURLINFO_CONTENT_LENGTH_DOWNLOAD
(Deprecated) Content length from the Content-Length header. See CURLINFO_CONTENT_LENGTH_DOWNLOAD
CURLINFO_CONTENT_LENGTH_DOWNLOAD_T
Content length from the Content-Length header. See CURLINFO_CONTENT_LENGTH_DOWNLOAD_T
CURLINFO_CONTENT_LENGTH_UPLOAD
(Deprecated) Upload size. See CURLINFO_CONTENT_LENGTH_UPLOAD
CURLINFO_CONTENT_LENGTH_UPLOAD_T
Upload size. See CURLINFO_CONTENT_LENGTH_UPLOAD_T
Content type from the Content-Type: header. We recommend using curl_easy_header instead. See CURLINFO_CONTENT_TYPE
List of all known cookies. See CURLINFO_COOKIELIST
Amount of TLS early data sent (in number of bytes) when CURLSSLOPT_EARLYDATA is enabled.
Last used HTTP method. See CURLINFO_EFFECTIVE_METHOD
Last used URL. See CURLINFO_EFFECTIVE_URL
Remote time of the retrieved document. See CURLINFO_FILETIME
Remote time of the retrieved document. See CURLINFO_FILETIME_T
The entry path after logging in to an FTP server. See CURLINFO_FTP_ENTRY_PATH
Number of bytes of all headers received. See CURLINFO_HEADER_SIZE
Available HTTP authentication methods. See CURLINFO_HTTPAUTH_AVAIL
Last proxy CONNECT response code. See CURLINFO_HTTP_CONNECTCODE
The http version used in the connection. See CURLINFO_HTTP_VERSION
(Deprecated) Last socket used. See CURLINFO_LASTSOCKET
Source IP address of the last connection. See CURLINFO_LOCAL_IP
Source port number of the last connection. See CURLINFO_LOCAL_PORT
Time from start until name resolving completed as a double. See CURLINFO_NAMELOOKUP_TIME
Time from start until name resolving completed in number of microseconds. See CURLINFO_NAMELOOKUP_TIME_T
Number of new successful connections used for previous transfer. See CURLINFO_NUM_CONNECTS
The errno from the last failure to connect. See CURLINFO_OS_ERRNO
The time it took from the start until the last byte is sent by libcurl. In microseconds. (Added in 8.10.0) See CURLINFO_POSTTRANSFER_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. See 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. In microseconds. See CURLINFO_PRETRANSFER_TIME_T
Destination IP address of the last connection. See CURLINFO_PRIMARY_IP
Destination port of the last connection. See CURLINFO_PRIMARY_PORT
User's private data pointer. See CURLINFO_PRIVATE
(Deprecated) The protocol used for the connection. (Added in 7.52.0) See CURLINFO_PROTOCOL
Available HTTP proxy authentication methods. See CURLINFO_PROXYAUTH_AVAIL
Detailed proxy error. See CURLINFO_PROXY_ERROR
CURLINFO_PROXY_SSL_VERIFYRESULT
Proxy certificate verification result. See CURLINFO_PROXY_SSL_VERIFYRESULT
The time during which the transfer was held in a waiting queue before it could start for real in number of microseconds. (Added in 8.6.0) See CURLINFO_QUEUE_TIME_T
Total number of redirects that were followed. See CURLINFO_REDIRECT_COUNT
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. As a double. See 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. In number of microseconds. See CURLINFO_REDIRECT_TIME_T
URL a redirect would take you to, had you enabled redirects. See CURLINFO_REDIRECT_URL
Referrer header. See CURLINFO_REFERER
Number of bytes sent in the issued HTTP requests. See CURLINFO_REQUEST_SIZE
Last received response code. See CURLINFO_RESPONSE_CODE
The value from the Retry-After header. See CURLINFO_RETRY_AFTER
The RTSP client CSeq that is expected next. See CURLINFO_RTSP_CLIENT_CSEQ
RTSP CSeq last received. See CURLINFO_RTSP_CSEQ_RECV
The RTSP server CSeq that is expected next. See CURLINFO_RTSP_SERVER_CSEQ
RTSP session ID. See CURLINFO_RTSP_SESSION_ID
The scheme used for the connection. (Added in 7.52.0) See CURLINFO_SCHEME
(Deprecated) Number of bytes downloaded. See CURLINFO_SIZE_DOWNLOAD
Number of bytes downloaded. See CURLINFO_SIZE_DOWNLOAD_T
(Deprecated) Number of bytes uploaded. See CURLINFO_SIZE_UPLOAD
Number of bytes uploaded. See CURLINFO_SIZE_UPLOAD_T
(Deprecated) Average download speed. See CURLINFO_SPEED_DOWNLOAD
Average download speed. See CURLINFO_SPEED_DOWNLOAD_T
(Deprecated) Average upload speed. See CURLINFO_SPEED_UPLOAD
Average upload speed in number of bytes per second. See CURLINFO_SPEED_UPLOAD_T
A list of OpenSSL crypto engines. See CURLINFO_SSL_ENGINES
Certificate verification result. See CURLINFO_SSL_VERIFYRESULT
The time it took from the start until the first byte is received by libcurl. As a double. See CURLINFO_STARTTRANSFER_TIME
The time it took from the start until the first byte is received by libcurl. In microseconds. See CURLINFO_STARTTRANSFER_TIME_T
(Deprecated) TLS session info that can be used for further processing. See CURLINFO_TLS_SESSION. Use CURLINFO_TLS_SSL_PTR instead.
TLS session info that can be used for further processing. See CURLINFO_TLS_SSL_PTR
Total time of previous transfer. See CURLINFO_TOTAL_TIME
Total time of previous transfer. See CURLINFO_TOTAL_TIME_T
Whether the proxy was used (Added in 8.7.0). See CURLINFO_USED_PROXY
The ID of the transfer. (Added in 8.2.0) See CURLINFO_XFER_ID
Times
An overview of the time values available from curl_easy_getinfo
curl_easy_perform() | |--QUEUE |--|--NAMELOOKUP |--|--|--CONNECT |--|--|--|--APPCONNECT |--|--|--|--|--PRETRANSFER |--|--|--|--|--|--POSTTRANSFER |--|--|--|--|--|--|--STARTTRANSFER |--|--|--|--|--|--|--|--TOTAL |--|--|--|--|--|--|--|--REDIRECT
CURLINFO_QUEUE_TIME_T, CURLINFO_NAMELOOKUP_TIME_T, CURLINFO_CONNECT_TIME_T, CURLINFO_APPCONNECT_TIME_T, CURLINFO_PRETRANSFER_TIME_T, CURLINFO_POSTTRANSFER_TIME_T, CURLINFO_STARTTRANSFER_TIME_T, CURLINFO_TOTAL_TIME_T, CURLINFO_REDIRECT_TIME_T
Protocols
This functionality affects all supported protocols
Example
int main(void)
{
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://www.example.com/");
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
char *ct;
/* ask for the content-type */
res = curl_easy_getinfo(curl, CURLINFO_CONTENT_TYPE, &ct);
if((CURLE_OK == res) && ct)
printf("We received Content-Type: %s\n", ct);
}
/* always cleanup */
curl_easy_cleanup(curl);
}
}
Availability
Added in curl 7.4.1
Return value
If the operation was successful, CURLE_OK is returned. Otherwise an appropriate error code is returned.
See also
This HTML page was made with roffit.