aboutsummaryrefslogtreecommitdiff
path: root/docs/curl_easy_getinfo.3
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2000-10-03 22:05:27 +0000
committerDaniel Stenberg <daniel@haxx.se>2000-10-03 22:05:27 +0000
commit763797ab3cf0480e4c7ac648588e16d3283130a1 (patch)
tree57bffd54a91d383665ea27cf04e3d8c923377c22 /docs/curl_easy_getinfo.3
parent2cdd150723ecb17b58fcd440f05b69c7235b1967 (diff)
introduced in libcurl 7.4
Diffstat (limited to 'docs/curl_easy_getinfo.3')
-rw-r--r--docs/curl_easy_getinfo.362
1 files changed, 62 insertions, 0 deletions
diff --git a/docs/curl_easy_getinfo.3 b/docs/curl_easy_getinfo.3
new file mode 100644
index 000000000..c11364e2a
--- /dev/null
+++ b/docs/curl_easy_getinfo.3
@@ -0,0 +1,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!