summaryrefslogtreecommitdiff
path: root/docs/libcurl/curl_easy_getinfo.3
Commit message (Collapse)AuthorAgeFilesLines
* http: add support to read and store the referrer headerViktor Szakats2021-02-191-1/+4
| | | | | | | | | - add CURLINFO_REFERER libcurl option - add --write-out '%{referer}' command-line option - extend --xattr command-line option to fill user.xdg.referrer.url extended attribute with the referrer (if there was any) Closes #6591
* curl.se: new homeDaniel Stenberg2020-11-041-1/+1
| | | | Closes #6172
* CURLE_PROXY: new error codeDaniel Stenberg2020-08-241-0/+3
| | | | | | | | | | | | Failures clearly returned from a (SOCKS) proxy now causes this return code. Previously the situation was not very clear as what would be returned and when. In addition: when this error code is returned, an application can use CURLINFO_PROXY_ERROR to query libcurl for the detailed error, which then returns a value from the new 'CURLproxycode' enum. Closes #5770
* CURLINFO_EFFECTIVE_METHOD: addedDaniel Stenberg2020-07-141-0/+3
| | | | | | | Provide the HTTP method that was used on the latest request, which might be relevant for users when there was one or more redirects involved. Closes #5511
* cleanup: correct copyright year range on a few filesDaniel Stenberg2020-04-061-1/+1
|
* CURLINFO_CONDITION_UNMET: return true for 304 http status codeKwon-Young Choi2020-04-051-1/+1
| | | | | | | | | | | In libcurl, CURLINFO_CONDITION_UNMET is used to avoid writing to the output file if the server did not transfered a file based on time condition. In the same manner, getting a 304 HTTP response back from the server, for example after passing a custom If-Match-* header, also fulfill this condition. Fixes #5181 Closes #5183
* CURLINFO_RETRY_AFTER: parse the Retry-After header valueDaniel Stenberg2019-08-071-0/+3
| | | | | | | | This is only the libcurl part that provides the information. There's no user of the parsed value. This change includes three new tests for the parser. Ref: #3794
* curl_easy_getinfo.3: fix minor formatting mistakeDaniel Stenberg2019-04-111-2/+2
|
* getinfo: add microsecond precise timers for various intervalsPhilip Prindeville2018-05-171-9/+37
| | | | | | | | | | | | | | | | | Provide a set of new timers that return the time intervals using integer number of microseconds instead of floats. The new info names are as following: CURLINFO_APPCONNECT_TIME_T CURLINFO_CONNECT_TIME_T CURLINFO_NAMELOOKUP_TIME_T CURLINFO_PRETRANSFER_TIME_T CURLINFO_REDIRECT_TIME_T CURLINFO_STARTTRANSFER_TIME_T CURLINFO_TOTAL_TIME_T Closes #2495
* time: support > year 2038 time stamps for system with 32bit longDaniel Stenberg2018-01-301-3/+4
| | | | | | | | ... with the introduction of CURLOPT_TIMEVALUE_LARGE and CURLINFO_FILETIME_T. Fixes #2238 Closes #2264
* getinfo: return sizes as curl_off_tDaniel Stenberg2017-06-191-8/+24
| | | | | | | | | | | | | | | This change introduces new alternatives for the existing six curl_easy_getinfo() options that return sizes or speeds as doubles. The new versions are named like the old ones but with an appended '_T': CURLINFO_CONTENT_LENGTH_DOWNLOAD_T CURLINFO_CONTENT_LENGTH_UPLOAD_T CURLINFO_SIZE_DOWNLOAD_T CURLINFO_SIZE_UPLOAD_T CURLINFO_SPEED_DOWNLOAD_T CURLINFO_SPEED_UPLOAD_T Closes #1511
* add CURLINFO_SCHEME, CURLINFO_PROTOCOL, and %{scheme}Frank Gevaerts2016-11-251-0/+6
| | | | | | | | | | | | | | Adds access to the effectively used protocol/scheme to both libcurl and curl, both in string and numeric (CURLPROTO_*) form. Note that the string form will be uppercase, as it is just the internal string. As these strings are declared internally as const, and all other strings returned by curl_easy_getinfo() are de-facto const as well, string handling in getinfo.c got const-ified. Closes #1137
* proxy: Support HTTPS proxy and SOCKS+HTTP(s)Alex Rousskov2016-11-241-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * HTTPS proxies: An HTTPS proxy receives all transactions over an SSL/TLS connection. Once a secure connection with the proxy is established, the user agent uses the proxy as usual, including sending CONNECT requests to instruct the proxy to establish a [usually secure] TCP tunnel with an origin server. HTTPS proxies protect nearly all aspects of user-proxy communications as opposed to HTTP proxies that receive all requests (including CONNECT requests) in vulnerable clear text. With HTTPS proxies, it is possible to have two concurrent _nested_ SSL/TLS sessions: the "outer" one between the user agent and the proxy and the "inner" one between the user agent and the origin server (through the proxy). This change adds supports for such nested sessions as well. A secure connection with a proxy requires its own set of the usual SSL options (their actual descriptions differ and need polishing, see TODO): --proxy-cacert FILE CA certificate to verify peer against --proxy-capath DIR CA directory to verify peer against --proxy-cert CERT[:PASSWD] Client certificate file and password --proxy-cert-type TYPE Certificate file type (DER/PEM/ENG) --proxy-ciphers LIST SSL ciphers to use --proxy-crlfile FILE Get a CRL list in PEM format from the file --proxy-insecure Allow connections to proxies with bad certs --proxy-key KEY Private key file name --proxy-key-type TYPE Private key file type (DER/PEM/ENG) --proxy-pass PASS Pass phrase for the private key --proxy-ssl-allow-beast Allow security flaw to improve interop --proxy-sslv2 Use SSLv2 --proxy-sslv3 Use SSLv3 --proxy-tlsv1 Use TLSv1 --proxy-tlsuser USER TLS username --proxy-tlspassword STRING TLS password --proxy-tlsauthtype STRING TLS authentication type (default SRP) All --proxy-foo options are independent from their --foo counterparts, except --proxy-crlfile which defaults to --crlfile and --proxy-capath which defaults to --capath. Curl now also supports %{proxy_ssl_verify_result} --write-out variable, similar to the existing %{ssl_verify_result} variable. Supported backends: OpenSSL, GnuTLS, and NSS. * A SOCKS proxy + HTTP/HTTPS proxy combination: If both --socks* and --proxy options are given, Curl first connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy. TODO: Update documentation for the new APIs and --proxy-* options. Look for "Added in 7.XXX" marks.
* http: add CURLINFO_HTTP_VERSION and %{http_version}Frank Gevaerts2016-05-301-0/+3
| | | | | | | Adds access to the effectively used http version to both libcurl and curl. Closes #799
* curl_easy_getinfo.3: remove superfluous blank linesDaniel Stenberg2016-04-281-46/+0
|
* curl_easy_getinfo.3: added missing mention of CURLINFO_TLS_SESSIONDaniel Stenberg2016-04-281-1/+6
| | | | ... although it is deprecated.
* getinfo: CURLINFO_TLS_SSL_PTR supersedes CURLINFO_TLS_SESSIONJay Satiro2016-02-231-2/+2
| | | | | | | | | | | | | | | | | | | | | The two options are almost the same, except in the case of OpenSSL: CURLINFO_TLS_SESSION OpenSSL session internals is SSL_CTX *. CURLINFO_TLS_SSL_PTR OpenSSL session internals is SSL *. For backwards compatibility we couldn't modify CURLINFO_TLS_SESSION to return an SSL pointer for OpenSSL. Also, add support for the 'internals' member to point to SSL object for the other backends axTLS, PolarSSL, Secure Channel, Secure Transport and wolfSSL. Bug: https://github.com/curl/curl/issues/234 Reported-by: dkjjr89@users.noreply.github.com Bug: https://curl.haxx.se/mail/lib-2015-09/0127.html Reported-by: Michael König
* URLs: change all http:// URLs to https://Daniel Stenberg2016-02-031-1/+1
|
* curl_easy_getinfo.3: Add brief description for each CURLINFOJay Satiro2015-09-251-0/+89
|
* opts: 19 more CURLINFO_* options made into stand-alone man pagesDaniel Stenberg2015-09-121-126/+19
|
* docs: Warn about any-domain cookies and multiple transfersJay Satiro2015-09-031-2/+6
| | | | | | | | | - Warn that cookies without a domain are sent to any domain: CURLOPT_COOKIELIST, CURLOPT_COOKIEFILE, --cookie - Note that imported Set-Cookie cookies without a domain are no longer exported: CURLINFO_COOKIELIST, CURLOPT_COOKIEJAR, --cookie-jar
* opts: 8 more CURLINFO* options as stand-alone man pagesDaniel Stenberg2015-09-021-28/+8
|
* opts: more CURLINFO_* options as stand-alone man pagesDaniel Stenberg2015-08-311-60/+17
|
* getinfo: added CURLINFO_ACTIVESOCKETRazvan Cojocaru2015-08-241-2/+13
| | | | | | | This patch addresses known bug #76, where on 64-bit Windows SOCKET is 64 bits wide, but long is only 32, making CURLINFO_LASTSOCKET unreliable. Signed-off-by: Razvan Cojocaru <rcojocaru@bitdefender.com>
* curl_easy_getinfo.3: fix superfluous spaceDaniel Stenberg2015-08-151-1/+1
| | | | | | ... and changed "oriented" to "related" Closes #378
* curl_easy_getinfo.3: document 'internals' in CURLINFO_TLS_SESSIONDaniel Stenberg2015-04-271-1/+21
| | | | ... as it was previouly undocumented what the pointer was.
* vtls: remove QsoSSLPatrick Monnerat2014-10-131-2/+2
|
* curl_easy_getinfo.3: spell-fixDaniel Stenberg2014-10-071-2/+2
| | | | Reported-By: Luan Cestari
* curl_tlsinfo -> curl_tlssessioninfoMichael Wallner2014-07-301-4/+4
|
* lib man pages: update easy setopt option referencesDaniel Stenberg2014-06-211-23/+24
| | | | | ... by using the "\fIopt(3)\fP" syntax they will be linked properly when the web version of the page is generated.
* curl_easy_getinfo.3: clarify CURLINFO_SIZE_DOWNLOADDaniel Stenberg2014-05-161-2/+4
| | | | It counts "body" data only, no meta data, no headers.
* curl_easy_getinfo: Added CURLINFO_TLS_SESSION for accessing TLS internalsChristian Grothoff2013-11-211-0/+12
| | | | | | Added new API for returning a SSL backend type and pointer, in order to allow access to the TLS internals, that may then be used to obtain X509 certificate information for example.
* NSS: support for CERTINFO featurePatrick Monnerat2013-10-301-3/+3
|
* docs: fix typo in curl_easy_getinfo manpageAlessandro Ghedini2013-06-221-2/+2
|
* docs: fix typos in man pagesKamil Dudka2013-01-281-1/+1
| | | | | Reported by: Jiri Jaburek Bug: https://bugzilla.redhat.com/896544
* SMTP: Added support for returning SMTP response codesSteve Holme2012-02-231-6/+8
| | | | | | Set the conn->data->info.httpcode variable in smtp_statemach_act() to allow Curl_getinfo() to return the SMTP response code via the CURLINFO_RESPONSE_CODE action.
* curl_easy_getinfo.3: clarify some timing infoDaniel Stenberg2011-05-031-6/+7
|
* CURLINFO_FTP_ENTRY_PATH: sftp supportDaniel Stenberg2010-12-301-0/+2
|
* KNOWN_BUG: The SOCKET type in Win64 is 64 bitsDaniel Stenberg2010-07-301-0/+3
| | | | | | | The SOCKET type in Win64 is 64 bits large (and thus so is curl_socket_t on that platform), and long is only 32 bits. It makes it impossible for curl_easy_getinfo() to return a socket properly with the CURLINFO_LASTSOCKET option as for all other operating systems.
* getinfo: added *_PRIMARY_PORT, *_LOCAL_IP and *_LOCAL_PORTFrank Meier2010-06-051-0/+11
|
* remove the CVSish $Id$ linesDaniel Stenberg2010-03-241-1/+0
|
* removed trailing whitespaceYang Tse2010-02-141-3/+3
|
* Chris Conroy brought support for RTSP transfers, and with it comes 8(!) newDaniel Stenberg2010-01-211-0/+22
| | | | | libcurl options for controlling what to get and how to receive posssibly interleaved RTP data. Initial commit.
* - Changed the description of CURLINFO_OS_ERRNO to make it clear that theMichal Marek2009-07-151-1/+2
| | | | errno is not reset on success.
* - Man page *roff problems fixed thanks to input from Colin Watson. ProblemsDaniel Stenberg2009-05-071-2/+2
| | | | reported in the Debian package.
* As Jeff Pohlmeyer suggested: "pointer to 'char *'" is now instead put:Daniel Stenberg2009-04-171-8/+8
| | | | "pointer to a char pointer".
* - After a bug reported by James Cheng I've made curl_easy_getinfo() forDaniel Stenberg2009-02-231-2/+4
| | | | | | CURLINFO_CONTENT_LENGTH_DOWNLOAD and CURLINFO_CONTENT_LENGTH_UPLOAD return -1 if the sizes aren't know. Previously these returned 0, make it impossible to detect the difference between actually zero and unknown.
* - CURLINFO_CONDITION_UNMET was added to allow an application to get to know ifDaniel Stenberg2009-02-111-2/+8
| | | | | | | the condition in the previous request was unmet. This is typically a time condition set with CURLOPT_TIMECONDITION and was previously not possible to reliably figure out. From bug report #2565128 (http://curl.haxx.se/bug/view.cgi?id=2565128)
* mention the openssl requirement for the certinfo dataDaniel Stenberg2008-10-161-1/+2
|
* Added CURLINFO_CERTINFODaniel Stenberg2008-10-161-1/+10
|
View Lorry Controller Status