aboutsummaryrefslogtreecommitdiff
path: root/docs/curl_easy_getinfo.3
blob: c11364e2ac0bab336cd8bf8fcc8e09ddaba318ee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
.\" You can view this file with:
.\" nroff -man [file]
.\" Written by daniel@haxx.se
.\"
.TH curl_easy_init 3 "2 October 2000" "Curl 7.4" "libcurl Manual"
.SH NAME
curl_easy_getinfo - Extract information from a curl session (added in 7.4)
.SH SYNOPSIS
.B #include <curl/easy.h>
.sp
.BI "CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ... );"
.ad
.SH DESCRIPTION
Request internal information from the curl session with this function.  The
third argument
.B MUST
be a pointer to a long, a pointer to a char * 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.  This function is intended to get used *AFTER* a performed transfer,
all results from this function are undefined until the transfer is completed.
.SH AVAILABLE INFORMATION
These are informations that can be extracted:
.TP 0.8i
.B CURLINFO_EFFECTIVE_URL
Pass a pointer to a 'char *' to receive the last used effective URL.
.TP
.B CURLINFO_HTTP_CODE
Add informative text here
.TP
.B CURLINFO_TOTAL_TIME
Add informative text here
.TP
.B CURLINFO_NAMELOOKUP_TIME
Add informative text here
.TP
.B CURLINFO_CONNECT_TIME
Add informative text here
.TP
.B CURLINFO_PRETRANSFER_TIME
Add informative text here
.TP
.B CURLINFO_SIZE_UPLOAD
Add informative text here
.TP
.B CURLINFO_SIZE_DOWNLOAD
Add informative text here
.TP
.B CURLINFO_SPEED_DOWNLOAD
Add informative text here
.TP
.B CURLINFO_SPEED_UPLOAD
Add informative text here
.PP

.SH RETURN VALUE
If the operation was successful, CURLE_OK is returned. Otherwise an
appropriate error code will be returned.
.SH "SEE ALSO"
.BR curl_easy_setopt "(3)"
.SH BUGS
Surely there are some, you tell me!