consistant with other man pages
This commit is contained in:
parent
9b7c311929
commit
445f54db57
@ -4,12 +4,12 @@
|
|||||||
.\"
|
.\"
|
||||||
.TH curl_easy_getinfo 3 "20 Aug 2003" "libcurl 7.10.8" "libcurl Manual"
|
.TH curl_easy_getinfo 3 "20 Aug 2003" "libcurl 7.10.8" "libcurl Manual"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
curl_easy_getinfo - Extract information from a curl session (added in 7.4)
|
curl_easy_getinfo - extract information from a curl handle
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
.B #include <curl/curl.h>
|
.B #include <curl/curl.h>
|
||||||
.sp
|
|
||||||
.BI "CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ... );"
|
.B "CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ... );"
|
||||||
.ad
|
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
Request internal information from the curl session with this function. The
|
Request internal information from the curl session with this function. The
|
||||||
third argument
|
third argument
|
||||||
@ -21,108 +21,85 @@ CURLE_OK. This function is intended to get used *AFTER* a performed transfer,
|
|||||||
all results from this function are undefined until the transfer is completed.
|
all results from this function are undefined until the transfer is completed.
|
||||||
.SH AVAILABLE INFORMATION
|
.SH AVAILABLE INFORMATION
|
||||||
These are informations that can be extracted:
|
These are informations that can be extracted:
|
||||||
.TP 0.8i
|
.IP CURLINFO_EFFECTIVE_URL
|
||||||
.B CURLINFO_EFFECTIVE_URL
|
|
||||||
Pass a pointer to a 'char *' to receive the last used effective URL.
|
Pass a pointer to a 'char *' to receive the last used effective URL.
|
||||||
.TP
|
.IP CURLINFO_RESPONSE_CODE
|
||||||
.B CURLINFO_RESPONSE_CODE
|
|
||||||
Pass a pointer to a long to receive the last received HTTP or FTP code. This
|
Pass a pointer to a long to receive the last received HTTP or FTP code. This
|
||||||
option was known as CURLINFO_HTTP_CODE in libcurl 7.10.7 and earlier.
|
option was known as CURLINFO_HTTP_CODE in libcurl 7.10.7 and earlier.
|
||||||
.TP
|
.IP CURLINFO_FILETIME
|
||||||
.B CURLINFO_FILETIME
|
|
||||||
Pass a pointer to a long to receive the remote time of the retrieved
|
Pass a pointer to a long to receive the remote time of the retrieved
|
||||||
document. If you get -1, it can be because of many reasons (unknown, the
|
document. If you get -1, it can be because of many reasons (unknown, the
|
||||||
server hides it or the server doesn't support the command that tells document
|
server hides it or the server doesn't support the command that tells document
|
||||||
time etc) and the time of the document is unknown. Note that you must tell the
|
time etc) and the time of the document is unknown. Note that you must tell the
|
||||||
server to collect this information before the transfer is made, by using the
|
server to collect this information before the transfer is made, by using the
|
||||||
CURLOPT_FILETIME option to \fIcurl_easy_setopt(3)\fP. (Added in 7.5)
|
CURLOPT_FILETIME option to \fIcurl_easy_setopt(3)\fP. (Added in 7.5)
|
||||||
.TP
|
.IP CURLINFO_TOTAL_TIME
|
||||||
.B CURLINFO_TOTAL_TIME
|
|
||||||
Pass a pointer to a double to receive the total transaction time in seconds
|
Pass a pointer to a double to receive the total transaction time in seconds
|
||||||
for the previous transfer. This time does not include the connect time, so if
|
for the previous transfer. This time does not include the connect time, so if
|
||||||
you want the complete operation time, you should add the
|
you want the complete operation time, you should add the
|
||||||
CURLINFO_CONNECT_TIME.
|
CURLINFO_CONNECT_TIME.
|
||||||
.TP
|
.IP CURLINFO_NAMELOOKUP_TIME
|
||||||
.B CURLINFO_NAMELOOKUP_TIME
|
|
||||||
Pass a pointer to a double to receive the time, in seconds, it took from the
|
Pass a pointer to a double to receive the time, in seconds, it took from the
|
||||||
start until the name resolving was completed.
|
start until the name resolving was completed.
|
||||||
.TP
|
.IP CURLINFO_CONNECT_TIME
|
||||||
.B CURLINFO_CONNECT_TIME
|
|
||||||
Pass a pointer to a double to receive the time, in seconds, it took from the
|
Pass a pointer to a double to receive the time, in seconds, it took from the
|
||||||
start until the connect to the remote host (or proxy) was completed.
|
start until the connect to the remote host (or proxy) was completed.
|
||||||
.TP
|
.IP CURLINFO_PRETRANSFER_TIME
|
||||||
.B CURLINFO_PRETRANSFER_TIME
|
|
||||||
Pass a pointer to a double to receive the time, in seconds, it took from the
|
Pass a pointer to a double to receive the time, in seconds, it took from the
|
||||||
start until the file transfer is just about to begin. This includes all
|
start until the file transfer is just about to begin. This includes all
|
||||||
pre-transfer commands and negotiations that are specific to the particular
|
pre-transfer commands and negotiations that are specific to the particular
|
||||||
protocol(s) involved.
|
protocol(s) involved.
|
||||||
.TP
|
.IP CURLINFO_STARTTRANSFER_TIME
|
||||||
.B CURLINFO_STARTTRANSFER_TIME
|
|
||||||
Pass a pointer to a double to receive the time, in seconds, it took from the
|
Pass a pointer to a double to receive the time, in seconds, it took from the
|
||||||
start until the first byte is just about to be transfered. This includes
|
start until the first byte is just about to be transfered. This includes
|
||||||
CURLINFO_PRETRANSFER_TIME and also the time the server needs to calculate
|
CURLINFO_PRETRANSFER_TIME and also the time the server needs to calculate
|
||||||
the result.
|
the result.
|
||||||
.TP
|
.IP CURLINFO_REDIRECT_TIME
|
||||||
.B CURLINFO_REDIRECT_TIME
|
|
||||||
Pass a pointer to a double to receive the total time, in seconds, it took for
|
Pass a pointer to a double to receive the total time, in seconds, it took for
|
||||||
all redirection steps include name lookup, connect, pretransfer and transfer
|
all redirection steps include name lookup, connect, pretransfer and transfer
|
||||||
before final transaction was started. CURLINFO_REDIRECT_TIME contains the
|
before final transaction was started. CURLINFO_REDIRECT_TIME contains the
|
||||||
complete execution time for multiple redirections. (Added in 7.9.7)
|
complete execution time for multiple redirections. (Added in 7.9.7)
|
||||||
.TP
|
.IP CURLINFO_REDIRECT_COUNT
|
||||||
.B CURLINFO_REDIRECT_COUNT
|
|
||||||
Pass a pointer to a long to receive the total number of redirections that were
|
Pass a pointer to a long to receive the total number of redirections that were
|
||||||
actually followed. (Added in 7.9.7)
|
actually followed. (Added in 7.9.7)
|
||||||
.TP
|
.IP CURLINFO_SIZE_UPLOAD
|
||||||
.B CURLINFO_SIZE_UPLOAD
|
|
||||||
Pass a pointer to a double to receive the total amount of bytes that were
|
Pass a pointer to a double to receive the total amount of bytes that were
|
||||||
uploaded.
|
uploaded.
|
||||||
.TP
|
.IP CURLINFO_SIZE_DOWNLOAD
|
||||||
.B CURLINFO_SIZE_DOWNLOAD
|
|
||||||
Pass a pointer to a double to receive the total amount of bytes that were
|
Pass a pointer to a double to receive the total amount of bytes that were
|
||||||
downloaded. The amount is only for the latest transfer and will be reset again
|
downloaded. The amount is only for the latest transfer and will be reset again
|
||||||
for each new transfer.
|
for each new transfer.
|
||||||
.TP
|
.IP CURLINFO_SPEED_DOWNLOAD
|
||||||
.B CURLINFO_SPEED_DOWNLOAD
|
|
||||||
Pass a pointer to a double to receive the average download speed that curl
|
Pass a pointer to a double to receive the average download speed that curl
|
||||||
measured for the complete download.
|
measured for the complete download.
|
||||||
.TP
|
.IP CURLINFO_SPEED_UPLOAD
|
||||||
.B CURLINFO_SPEED_UPLOAD
|
|
||||||
Pass a pointer to a double to receive the average upload speed that curl
|
Pass a pointer to a double to receive the average upload speed that curl
|
||||||
measured for the complete upload.
|
measured for the complete upload.
|
||||||
.TP
|
.IP CURLINFO_HEADER_SIZE
|
||||||
.B CURLINFO_HEADER_SIZE
|
|
||||||
Pass a pointer to a long to receive the total size of all the headers
|
Pass a pointer to a long to receive the total size of all the headers
|
||||||
received.
|
received.
|
||||||
.TP
|
.IP CURLINFO_REQUEST_SIZE
|
||||||
.B CURLINFO_REQUEST_SIZE
|
|
||||||
Pass a pointer to a long to receive the total size of the issued
|
Pass a pointer to a long to receive the total size of the issued
|
||||||
requests. This is so far only for HTTP requests. Note that this may be more
|
requests. This is so far only for HTTP requests. Note that this may be more
|
||||||
than one request if FOLLOWLOCATION is true.
|
than one request if FOLLOWLOCATION is true.
|
||||||
.TP
|
.IP CURLINFO_SSL_VERIFYRESULT
|
||||||
.B CURLINFO_SSL_VERIFYRESULT
|
|
||||||
Pass a pointer to a long to receive the result of the certification
|
Pass a pointer to a long to receive the result of the certification
|
||||||
verification that was requested (using the CURLOPT_SSL_VERIFYPEER option to
|
verification that was requested (using the CURLOPT_SSL_VERIFYPEER option to
|
||||||
curl_easy_setopt). (Added in 7.4.2)
|
curl_easy_setopt). (Added in 7.4.2)
|
||||||
.TP
|
.IP CURLINFO_CONTENT_LENGTH_DOWNLOAD
|
||||||
.B CURLINFO_CONTENT_LENGTH_DOWNLOAD
|
|
||||||
Pass a pointer to a double to receive the content-length of the download. This
|
Pass a pointer to a double to receive the content-length of the download. This
|
||||||
is the value read from the Content-Length: field. (Added in 7.6.1)
|
is the value read from the Content-Length: field. (Added in 7.6.1)
|
||||||
.TP
|
.IP CURLINFO_CONTENT_LENGTH_UPLOAD
|
||||||
.B CURLINFO_CONTENT_LENGTH_UPLOAD
|
|
||||||
Pass a pointer to a double to receive the specified size of the upload.
|
Pass a pointer to a double to receive the specified size of the upload.
|
||||||
(Added in 7.6.1)
|
.IP CURLINFO_CONTENT_TYPE
|
||||||
.TP
|
|
||||||
.B CURLINFO_CONTENT_TYPE
|
|
||||||
Pass a pointer to a 'char *' to receive the content-type of the downloaded
|
Pass a pointer to a 'char *' to receive the content-type of the downloaded
|
||||||
object. This is the value read from the Content-Type: field. If you get NULL,
|
object. This is the value read from the Content-Type: field. If you get NULL,
|
||||||
it means that the server didn't send a valid Content-Type header or that the
|
it means that the server didn't send a valid Content-Type header or that the
|
||||||
protocol used doesn't support this. (Added in 7.9.4)
|
protocol used doesn't support this. (Added in 7.9.4)
|
||||||
.TP
|
.IP CURLINFO_PRIVATE
|
||||||
.B CURLINFO_PRIVATE
|
|
||||||
Pass a pointer to a 'char *' to receive the pointer to the private data
|
Pass a pointer to a 'char *' to receive the pointer to the private data
|
||||||
associated with the curl handle (set with the CURLOPT_PRIVATE option to curl_easy_setopt).
|
associated with the curl handle (set with the CURLOPT_PRIVATE option to
|
||||||
(Added in 7.10.3)
|
curl_easy_setopt). (Added in 7.10.3)
|
||||||
.PP
|
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
If the operation was successful, CURLE_OK is returned. Otherwise an
|
If the operation was successful, CURLE_OK is returned. Otherwise an
|
||||||
appropriate error code will be returned.
|
appropriate error code will be returned.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user