curl / libcurl / API / curl_easy_getinfo

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.

Available information

The following information can be extracted:

CURLINFO_EFFECTIVE_METHOD

Last used HTTP method. See CURLINFO_EFFECTIVE_METHOD

CURLINFO_EFFECTIVE_URL

Last used URL. See CURLINFO_EFFECTIVE_URL

CURLINFO_RESPONSE_CODE

Last received response code. See CURLINFO_RESPONSE_CODE

CURLINFO_REFERER

Referrer header. See CURLINFO_REFERER

CURLINFO_HTTP_CONNECTCODE

Last proxy CONNECT response code. See CURLINFO_HTTP_CONNECTCODE

CURLINFO_HTTP_VERSION

The http version used in the connection. See CURLINFO_HTTP_VERSION

CURLINFO_FILETIME

Remote time of the retrieved document. See CURLINFO_FILETIME

CURLINFO_FILETIME_T

Remote time of the retrieved document. See CURLINFO_FILETIME_T

CURLINFO_TOTAL_TIME

Total time of previous transfer. See CURLINFO_TOTAL_TIME

CURLINFO_TOTAL_TIME_T

Total time of previous transfer. See CURLINFO_TOTAL_TIME_T

CURLINFO_NAMELOOKUP_TIME

Time from start until name resolving completed. See CURLINFO_NAMELOOKUP_TIME

CURLINFO_NAMELOOKUP_TIME_T

Time from start until name resolving completed. See CURLINFO_NAMELOOKUP_TIME_T

CURLINFO_CONNECT_TIME

Time from start until remote host or proxy completed. See CURLINFO_CONNECT_TIME

CURLINFO_CONNECT_TIME_T

Time from start until remote host or proxy completed. See CURLINFO_CONNECT_TIME_T

CURLINFO_APPCONNECT_TIME

Time from start until SSL/SSH handshake completed. See CURLINFO_APPCONNECT_TIME

CURLINFO_APPCONNECT_TIME_T

Time from start until SSL/SSH handshake completed. See CURLINFO_APPCONNECT_TIME_T

CURLINFO_PRETRANSFER_TIME

Time from start until just before the transfer begins. See CURLINFO_PRETRANSFER_TIME

CURLINFO_PRETRANSFER_TIME_T

Time from start until just before the transfer begins. See CURLINFO_PRETRANSFER_TIME_T

CURLINFO_QUEUE_TIME_T

Time during which this transfer was held in a waiting queue. See CURLINFO_QUEUE_TIME_T

CURLINFO_USED_PROXY

Whether the proxy was used (Added in 8.7.0). See CURLINFO_USED_PROXY(3)

CURLINFO_STARTTRANSFER_TIME

Time from start until just when the first byte is received. See CURLINFO_STARTTRANSFER_TIME

CURLINFO_STARTTRANSFER_TIME_T

Time from start until just when the first byte is received. See CURLINFO_STARTTRANSFER_TIME_T

CURLINFO_REDIRECT_TIME

Time taken for all redirect steps before the final transfer. See CURLINFO_REDIRECT_TIME

CURLINFO_REDIRECT_TIME_T

Time taken for all redirect steps before the final transfer. See CURLINFO_REDIRECT_TIME_T

CURLINFO_REDIRECT_COUNT

Total number of redirects that were followed. See CURLINFO_REDIRECT_COUNT

CURLINFO_REDIRECT_URL

URL a redirect would take you to, had you enabled redirects. See CURLINFO_REDIRECT_URL

CURLINFO_SIZE_UPLOAD

(Deprecated) Number of bytes uploaded. See CURLINFO_SIZE_UPLOAD

CURLINFO_SIZE_UPLOAD_T

Number of bytes uploaded. See CURLINFO_SIZE_UPLOAD_T

CURLINFO_SIZE_DOWNLOAD

(Deprecated) Number of bytes downloaded. See CURLINFO_SIZE_DOWNLOAD

CURLINFO_SIZE_DOWNLOAD_T

Number of bytes downloaded. See CURLINFO_SIZE_DOWNLOAD_T

CURLINFO_SPEED_DOWNLOAD

(Deprecated) Average download speed. See CURLINFO_SPEED_DOWNLOAD

CURLINFO_SPEED_DOWNLOAD_T

Average download speed. See CURLINFO_SPEED_DOWNLOAD_T

CURLINFO_SPEED_UPLOAD

(Deprecated) Average upload speed. See CURLINFO_SPEED_UPLOAD

CURLINFO_SPEED_UPLOAD_T

Average upload speed. See CURLINFO_SPEED_UPLOAD_T

CURLINFO_HEADER_SIZE

Number of bytes of all headers received. See CURLINFO_HEADER_SIZE

CURLINFO_REQUEST_SIZE

Number of bytes sent in the issued HTTP requests. See CURLINFO_REQUEST_SIZE

CURLINFO_SSL_VERIFYRESULT

Certificate verification result. See CURLINFO_SSL_VERIFYRESULT

CURLINFO_PROXY_ERROR

Detailed proxy error. See CURLINFO_PROXY_ERROR

CURLINFO_PROXY_SSL_VERIFYRESULT

Proxy certificate verification result. See CURLINFO_PROXY_SSL_VERIFYRESULT

CURLINFO_SSL_ENGINES

A list of OpenSSL crypto engines. See CURLINFO_SSL_ENGINES

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

CURLINFO_CONTENT_TYPE

Content type from the Content-Type header. See CURLINFO_CONTENT_TYPE

CURLINFO_RETRY_AFTER

The value from the Retry-After header. See CURLINFO_RETRY_AFTER

CURLINFO_PRIVATE

User's private data pointer. See CURLINFO_PRIVATE

CURLINFO_HTTPAUTH_AVAIL

Available HTTP authentication methods. See CURLINFO_HTTPAUTH_AVAIL

CURLINFO_PROXYAUTH_AVAIL

Available HTTP proxy authentication methods. See CURLINFO_PROXYAUTH_AVAIL

CURLINFO_OS_ERRNO

The errno from the last failure to connect. See CURLINFO_OS_ERRNO

CURLINFO_NUM_CONNECTS

Number of new successful connections used for previous transfer. See CURLINFO_NUM_CONNECTS

CURLINFO_PRIMARY_IP

Destination IP address of the last connection. See CURLINFO_PRIMARY_IP

CURLINFO_PRIMARY_PORT

Destination port of the last connection. See CURLINFO_PRIMARY_PORT

CURLINFO_LOCAL_IP

Source IP address of the last connection. See CURLINFO_LOCAL_IP

CURLINFO_LOCAL_PORT

Source port number of the last connection. See CURLINFO_LOCAL_PORT

CURLINFO_COOKIELIST

List of all known cookies. See CURLINFO_COOKIELIST

CURLINFO_LASTSOCKET

(Deprecated) Last socket used. See CURLINFO_LASTSOCKET

CURLINFO_ACTIVESOCKET

The session's active socket. See CURLINFO_ACTIVESOCKET

CURLINFO_FTP_ENTRY_PATH

The entry path after logging in to an FTP server. See CURLINFO_FTP_ENTRY_PATH

CURLINFO_CAPATH

Get the default value for CURLOPT_CAPATH. See CURLINFO_CAPATH

CURLINFO_CAINFO

Get the default value for CURLOPT_CAINFO. See CURLINFO_CAINFO

CURLINFO_CERTINFO

Certificate chain. See CURLINFO_CERTINFO

CURLINFO_TLS_SSL_PTR

TLS session info that can be used for further processing. See CURLINFO_TLS_SSL_PTR

CURLINFO_TLS_SESSION

TLS session info that can be used for further processing. See CURLINFO_TLS_SESSION. Deprecated option, use CURLINFO_TLS_SSL_PTR instead!

CURLINFO_CONDITION_UNMET

Whether or not a time conditional was met or 304 HTTP response. See CURLINFO_CONDITION_UNMET

CURLINFO_RTSP_SESSION_ID

RTSP session ID. See CURLINFO_RTSP_SESSION_ID

CURLINFO_RTSP_CLIENT_CSEQ

The RTSP client CSeq that is expected next. See CURLINFO_RTSP_CLIENT_CSEQ

CURLINFO_RTSP_SERVER_CSEQ

The RTSP server CSeq that is expected next. See CURLINFO_RTSP_SERVER_CSEQ

CURLINFO_RTSP_CSEQ_RECV

RTSP CSeq last received. See CURLINFO_RTSP_CSEQ_RECV

CURLINFO_PROTOCOL

(Deprecated) The protocol used for the connection. (Added in 7.52.0) See CURLINFO_PROTOCOL

CURLINFO_SCHEME

The scheme used for the connection. (Added in 7.52.0) See CURLINFO_SCHEME

CURLINFO_CONN_ID

The ID of the last connection used by the transfer. (Added in 8.2.0) See CURLINFO_CONN_ID

CURLINFO_XFER_ID

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
    |--|--|--|--|--|--STARTTRANSFER
    |--|--|--|--|--|--|--TOTAL
    |--|--|--|--|--|--|--REDIRECT

CURLINFO_QUEUE_TIME

CURLINFO_QUEUE_TIME_T. The time during which the transfer was held in a waiting queue before it could start for real. (Added in 8.6.0)

CURLINFO_NAMELOOKUP_TIME

CURLINFO_NAMELOOKUP_TIME and CURLINFO_NAMELOOKUP_TIME_T. The time it took from the start until the name resolving was completed.

CURLINFO_CONNECT_TIME

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.

CURLINFO_APPCONNECT_TIME

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)

CURLINFO_PRETRANSFER_TIME

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.

CURLINFO_STARTTRANSFER_TIME

CURLINFO_STARTTRANSFER_TIME and CURLINFO_STARTTRANSFER_TIME_T. The time it took from the start until the first byte is received by libcurl.

CURLINFO_TOTAL_TIME

CURLINFO_TOTAL_TIME and CURLINFO_TOTAL_TIME_T. Total time of the previous request.

CURLINFO_REDIRECT_TIME

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.

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 7.4.1

Return value

If the operation was successful, CURLE_OK is returned. Otherwise an appropriate error code is returned.

See also

curl_easy_setopt(3)

This HTML page was made with roffit.