summaryrefslogtreecommitdiff
path: root/docs/libcurl
Commit message (Collapse)AuthorAgeFilesLines
* TLS: fix SRP detection by using the proper #ifdefsDaniel Stenberg2020-08-281-1/+2
| | | | | | | | | | | | | | | USE_TLS_SRP will be true if *any* selected TLS backend can use SRP HAVE_OPENSSL_SRP is defined when OpenSSL can use it HAVE_GNUTLS_SRP is defined when GnuTLS can use it Clarify in the curl_verison_info docs that CURL_VERSION_TLSAUTH_SRP is set if at least one of the supported backends offers SRP. Reported-by: Stefan Strogin Fixes #5865 Closes #5870
* docs: non-existing macros in man pagesAlessandro Ghedini2020-08-272-3/+3
| | | | | | | | As reported by man(1) when invoked as: man --warnings -E UTF-8 -l -Tutf8 -Z <file> >/dev/null Closes #5846
* docs/libcurl: update "Added in" version for curl_easy_option*Daniel Stenberg2020-08-273-6/+6
| | | | Follow-up to 6ebe63fac23f38
* options: API for meta-data about easy optionsDaniel Stenberg2020-08-275-8/+186
| | | | | | | | | | | | | | | | const struct curl_easyoption *curl_easy_option_by_name(const char *name); const struct curl_easyoption *curl_easy_option_by_id (CURLoption id); const struct curl_easyoption * curl_easy_option_next(const struct curl_easyoption *prev); The purpose is to provide detailed enough information to allow for example libcurl bindings to get option information at run-time about what easy options that exist and what arguments they expect. Assisted-by: Jeroen Ooms Closes #5365
* sftp: add the option CURLKHSTAT_FINE_REPLACEMichael Musset2020-08-242-2/+10
| | | | | | Replace the old fingerprint of the host with a new. Closes #5685
* sftp: add new quote commands 'atime' and 'mtime'COFFEETALES2020-08-241-0/+8
| | | | Closes #5810
* CURLE_PROXY: new error codeDaniel Stenberg2020-08-244-1/+145
| | | | | | | | | | | | 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
* KNOWN_BUGS: 'no_proxy' string-matches IPv6 numerical addresesDaniel Stenberg2020-08-231-1/+5
| | | | | | | | | Also: the current behavior is now documented in the curl.1 and CURLOPT_NOPROXY.3 man pages. Reported-by: Andrew Barnes Closes #5745 Closes #5841
* docs: clarify MAX_SEND/RECV_SPEED functionalityDaniel Stenberg2020-08-152-4/+17
| | | | | | | | | ... in particular what happens if the maximum speed limit is set to a value that's smaller than the transfer buffer size in use. Reported-by: Tomas Berger Fixes #5788 Closes #5813
* copyright: update/correct the year range on a few filesDaniel Stenberg2020-08-141-1/+1
|
* KNOWN_BUGS: A shared connection cache is not thread-safeDaniel Stenberg2020-08-121-4/+4
| | | | | Closes #4915 Closes #5802
* TLS naming: fix more Winssl and Darwinssl leftoversDaniel Stenberg2020-08-083-4/+4
| | | | | | | | | | | | | The CMake option is now called CMAKE_USE_SCHANNEL The winbuild flag is USE_SCHANNEL The CI jobs and build scripts only use the new names and the new name options Tests now require 'Schannel' (when necessary) Closes #5795
* docs: add date of 7.20 to CURLM_CALL_MULTI_PERFORM mentionsdivinity762020-07-302-2/+2
| | | | | | | | it helps make it obvious that most developers don't have to care about the CURLM_CALL_MULTI_PERFORM value (last release using it is nearly 11 years old, November 4 2009) Closes #5744
* CURLOPT_NOBODY.3: fix the syntax for referring to optionsDaniel Stenberg2020-07-271-3/+3
| | | | | | As test 1140 fails otherwise! Follow-up to e1bac81cc815
* CURLOPT_NOBODY.3: clarify what setting to 0 meansDaniel Stenberg2020-07-271-6/+16
| | | | | | | ... and mention that HTTP with other methods than HEAD might get a body and there's no option available to stop that. Closes #5729
* docs: Update a few leftover mentions of DarwinSSLDaniel Gustafsson2020-07-163-5/+5
| | | | | | | | | Commit 76a9c3c4be10b3d4d379d5b23ca76806bbae536a renamed DarwinSSL to the more correct/common name Secure Transport, but a few mentions in the docs remained. Closes #5688 Reviewed-by: Daniel Stenberg <daniel@haxx.se>
* CURL_PUSH_ERROROUT: allow the push callback to fail the parent streamDaniel Stenberg2020-07-162-0/+4
| | | | | | | | | ... by adding support for a new dedicated return code. Suggested-by: Jonathan Cardoso Assisted-by: Erik Johansson URL: https://curl.haxx.se/mail/lib-2020-06/0099.html Closes #5636
* CURLINFO_EFFECTIVE_METHOD: addedDaniel Stenberg2020-07-144-0/+73
| | | | | | | 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
* windows: add unicode to feature listViktor Szakats2020-07-142-0/+4
| | | | | | | Reviewed-by: Marcel Raad Reviewed-by: Marc Hörsken Closes #5491
* content_encoding: add zstd decoding supportGilles Vollant2020-07-123-4/+15
| | | | | | | | | include zstd curl patch for Makefile.m32 from vszakats and include Add CMake support for zstd from Peter Wu Helped-by: Viktor Szakats Helped-by: Peter Wu Closes #5453
* CURLINFO_CERTINFO.3: fix typoFilip Salomonsson2020-07-061-2/+2
| | | | Closes https://github.com/curl/curl/pull/5655
* curl_version_info.3: CURL_VERSION_KERBEROS4 is deprecatedDaniel Stenberg2020-07-031-1/+1
| | | | | | | This came up in #5640. It make sense to clarify this in the docs! Reminded-by: Kamil Dudka Closes #5642
* terminology: call them null-terminated stringsDaniel Stenberg2020-06-2883-94/+94
| | | | | | | | | | | Updated terminology in docs, comments and phrases to refer to C strings as "null-terminated". Done to unify with how most other C oriented docs refer of them and what users in general seem to prefer (based on a single highly unscientific poll on twitter). Reported-by: coinhubs on github Fixes #5598 Closes #5608
* CURLOPT_READFUNCTION.3: provide the upload data size up frontDaniel Stenberg2020-06-261-1/+6
| | | | | Assisted-by: Jay Satiro Closes #5607
* openssl: Don't ignore CA paths when using Windows CA storeJay Satiro2020-06-221-2/+3
| | | | | | | | | | | | | This commit changes the behavior of CURLSSLOPT_NATIVE_CA so that it does not override CURLOPT_CAINFO / CURLOPT_CAPATH, or the hardcoded default locations. Instead the CA store can now be used at the same time. The change is due to the impending release. The issue is still being discussed. The behavior of CURLSSLOPT_NATIVE_CA is subject to change and is now documented as experimental. Ref: bc052cc (parent commit) Ref: https://github.com/curl/curl/issues/5585
* ABI.md: rename to .md and polish the markdownDaniel Stenberg2020-06-122-19/+14
| | | | Closes #5562
* wording: avoid blacklist/whitelist stereotypesDaniel Stenberg2020-06-105-21/+21
| | | | | | | | Instead of discussing if there's value or meaning (implied or not) in the colors, let's use words without the same possibly negative associations. Closes #5546
* CURLINFO_ACTIVESOCKET.3: clarify the descriptionDaniel Stenberg2020-06-051-9/+11
| | | | | | Reported-by: Jay Satiro Fixes #5299 Closes #5520
* setopt: add CURLOPT_PROXY_ISSUERCERT(_BLOB) for coherencyGilles Vollant2020-05-235-0/+166
| | | | Closes #5431
* setopt: support certificate options in memory with struct curl_blobGilles Vollant2020-05-159-4/+395
| | | | | | | | | | | | | This change introduces a generic way to provide binary data in setopt options, called BLOBs. This change introduces these new setopts: CURLOPT_ISSUERCERT_BLOB, CURLOPT_PROXY_SSLCERT_BLOB, CURLOPT_PROXY_SSLKEY_BLOB, CURLOPT_SSLCERT_BLOB and CURLOPT_SSLKEY_BLOB. Reviewed-by: Daniel Stenberg Closes #5357
* OpenSSL: have CURLOPT_CRLFILE imply CURLSSLOPT_NO_PARTIALCHAINDaniel Stenberg2020-05-131-5/+8
| | | | | | | | ... to avoid an OpenSSL bug that otherwise makes the CRL check to fail. Reported-by: Michael Kaufmann Fixes #5374 Closes #5376
* CURLOPT_SSL_OPTIONS: add *_NATIVE_CA to use Windows CA store (with openssl)Gilles Vollant2020-05-082-0/+5
| | | | Closes #4346
* doc: add missing closing parenthesis in CURLINFO_SSL_VERIFYRESULT.3Emil Engler2020-05-021-1/+1
| | | | Closes #5320
* GnuTLS: Backend support for CURLINFO_SSL_VERIFYRESULTEmil Engler2020-04-301-1/+1
| | | | Closes #5287
* copyright updates: adjust year rangesDaniel Stenberg2020-04-261-1/+1
|
* libcurl-multi.3: added missing full stopi-ky2020-04-231-1/+1
| | | | Closes #5285
* mqtt: add new experimental protocolBjorn Stenberg2020-04-142-1/+2
| | | | Closes #5173
* CURLOPT_WRITEFUNCTION.3: add inline example and new see-alsoDaniel Stenberg2020-04-071-4/+33
| | | | Closes #5192
* 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-052-3/+5
| | | | | | | | | | | 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
* curl.h: remnove CURL_VERSION_ESNI. Never supported nor documentedDaniel Stenberg2020-03-291-1/+0
| | | | | | Considered experimental and therefore we can do this. Closes #5157
* version: add 'cainfo' and 'capath' to version info structDaniel Stenberg2020-03-272-10/+16
| | | | | | | | Suggested-by: Timothe Litt URL: https://curl.haxx.se/mail/lib-2020-03/0090.html Reviewed-by: Jay Satiro Closes #5150
* copyright: fix out-of-date copyright ranges and missing headersDaniel Stenberg2020-03-24120-142/+200
| | | | | | | | | Reported by the new script 'scripts/copyright.pl'. The script has a regex whitelist for the files that don't need copyright headers. Removed three (mostly usesless) README files from docs/ Closes #5141
* schannel: add "best effort" revocation check optionJohannes Schindelin2020-03-183-0/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | - Implement new option CURLSSLOPT_REVOKE_BEST_EFFORT and --ssl-revoke-best-effort to allow a "best effort" revocation check. A best effort revocation check ignores errors that the revocation check was unable to take place. The reasoning is described in detail below and discussed further in the PR. --- When running e.g. with Fiddler, the schannel backend fails with an unhelpful error message: Unknown error (0x80092012) - The revocation function was unable to check revocation for the certificate. Sadly, many enterprise users who are stuck behind MITM proxies suffer the very same problem. This has been discussed in plenty of issues: https://github.com/curl/curl/issues/3727, https://github.com/curl/curl/issues/264, for example. In the latter, a Microsoft Edge developer even made the case that the common behavior is to ignore issues when a certificate has no recorded distribution point for revocation lists, or when the server is offline. This is also known as "best effort" strategy and addresses the Fiddler issue. Unfortunately, this strategy was not chosen as the default for schannel (and is therefore a backend-specific behavior: OpenSSL seems to happily ignore the offline servers and missing distribution points). To maintain backward-compatibility, we therefore add a new flag (`CURLSSLOPT_REVOKE_BEST_EFFORT`) and a new option (`--ssl-revoke-best-effort`) to select the new behavior. Due to the many related issues Git for Windows and GitHub Desktop, the plan is to make this behavior the default in these software packages. The test 2070 was added to verify this behavior, adapted from 310. Based-on-work-by: georgeok <giorgos.n.oikonomou@gmail.com> Co-authored-by: Markus Olsson <j.markus.olsson@gmail.com> Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de> Closes https://github.com/curl/curl/pull/4981
* multi: Improve parameter check for curl_multi_remove_handleJay Satiro2020-03-181-2/+2
| | | | | | | | | - If an easy handle is owned by a multi different from the one specified then return CURLM_BAD_EASY_HANDLE. Prior to this change I assume user error could cause corruption. Closes https://github.com/curl/curl/pull/5116
* docs: add warnings about FILE: URLs on WindowsDaniel Stenberg2020-03-132-2/+32
| | | | | | | | - --url man page section - libcurl-security.3 gets the full text - CURLOPT_URL.3 Reported-by: Tim Sedlmeyer
* curl_share_setopt.3: Note sharing cookies doesn't enable the engineJay Satiro2020-03-061-0/+2
| | | | | | | | | | Follow-up to d0a7ee3 which fixed a bug in 7.66.0 that caused CURL_LOCK_DATA_COOKIE to enable the easy handle's cookie engine. Bug: https://curl.haxx.se/mail/lib-2020-03/0019.html Reported-by: Felipe Gasper Closes https://github.com/curl/curl/pull/5048
* polarssl: remove more references and mentionsDaniel Stenberg2020-03-054-15/+12
| | | | | | Assisted-by: Jay Satiro Follow-up to 6357a19ff29dac04 Closes #5036
* curl_escape.3: Add a link to curl_freeJay Satiro2020-03-021-1/+1
| | | | Ref: https://github.com/curl/curl/pull/5016#issuecomment-593628582
* curl_getenv.3: Fix the memory handling descriptionJay Satiro2020-03-021-4/+4
| | | | | | | | | | | - Tell the user to call curl_free() to free the pointer returned by curl_getenv(). Prior to this change the user was directed to call free(), but that would not work in cases where the library and application use separate C runtimes and therefore have separate heap memory management. Closes https://github.com/curl/curl/pull/5016