summaryrefslogtreecommitdiff
path: root/docs/libcurl
Commit message (Collapse)AuthorAgeFilesLines
* URL-APIURL-APIDaniel Stenberg2018-09-067-1/+419
| | | | | | | See header file and man pages for API. All documented API details work and are tested in the 1560 test case. Closes #2842
* imap: change from "FETCH" to "UID FETCH"Nicklas Avén2018-09-061-1/+4
| | | | | | | | | | | | ... and add "MAILINDEX". As described in #2789, this is a suggested solution. Changing UID=xx to actually get mail with UID xx and add "MAILINDEX" to get a mail with a special index in the mail box (old behavior). So MAILINDEX=1 gives the first non deleted mail in the mail box. Fixes #2789 Closes #2815
* CURLOPT_UPLOAD_BUFFERSIZE: set upload buffer sizeDaniel Stenberg2018-09-064-0/+73
| | | | | | | This is step 3 of #2888. Fixes #2888 Closes #2896
* setopt: add CURLOPT_DOH_URLDaniel Stenberg2018-09-064-0/+75
| | | | Closes #2668
* ssl: deprecate CURLE_SSL_CACERT in favour of a unified error codeHan Han2018-09-061-1/+1
| | | | Long live CURLE_PEER_FAILED_VERIFICATION
* url: default to CURL_HTTP_VERSION_2TLS if built h2-enabledDaniel Stenberg2018-09-051-2/+4
| | | | Closes #2709
* multiplex: enable by defaultDaniel Stenberg2018-09-051-1/+3
| | | | Starting 7.62.0, multiplexing is enabled by default in multi handles.
* pipelining: deprecatedDaniel Stenberg2018-09-051-1/+3
| | | | | | | | | | | | Transparently. The related curl_multi_setopt() options all still returns OK when pipelining is selected. To re-enable the support, the single line change in lib/multi.c needs to be reverted. See docs/DEPRECATE.md Closes #2705
* CURLOPT_SSL_CTX_FUNCTION.3: clarify connection reuse warningJay Satiro2018-08-291-1/+2
| | | | | | Reported-by: Daniel Stenberg Closes https://github.com/curl/curl/issues/2916
* CURLOPT_ACCEPT_ENCODING.3: list them comma-separated [ci skip]Daniel Stenberg2018-08-271-3/+11
|
* CURLOPT_SSL_CTX_FUNCTION.3: might cause unintended connection reuse [ci skip]Daniel Stenberg2018-08-271-2/+7
| | | | | | Added a warning! Closes #2915
* docs: clarify NO_PROXY env variable functionalityDaniel Stenberg2018-08-242-6/+6
| | | | | | Reported-by: Kirill Marchuk Fixes #2773 Closes #2911
* libcurl-thread.3: expand somewhat on the NO_SIGNAL motivationDaniel Stenberg2018-08-231-3/+9
| | | | | | | | | | | Multi-threaded applictions basically MUST set CURLOPT_NO_SIGNAL to 1L to avoid the risk of getting a SIGPIPE. Either way, a multi-threaded application that uses libcurl/openssl needs to have a signhandler for or ignore SIGPIPE on its own. Based on discussions in #2800 Closes #2904
* docs: Improve the manual pages of some callbacksMichael Kaufmann2018-08-115-15/+21
| | | | | | | | | | - CURLOPT_HEADERFUNCTION: add newlines - CURLOPT_INTERLEAVEFUNCTION: fix the description of 'userdata' - CURLOPT_READDATA: mention crashes, same as in CURLOPT_WRITEDATA - CURLOPT_READFUNCTION: rename 'instream' to 'userdata' and explain how to set it Closes https://github.com/curl/curl/pull/2868
* Documentation: fix CURLOPT_SSH_COMPRESSION copy/paste bugDaniel Jelinski2018-08-101-2/+2
| | | | Closes #2867
* docs: mention NULL is fine input to several functionsDaniel Stenberg2018-08-107-7/+26
| | | | | | Fixes #2837 Closes #2858 Reported-by: Markus Elfring
* docs/CURLOPT_URL: fix indentationChristopher Head2018-07-261-0/+1
| | | | | | | | | The statement, “The application does not have to keep the string around after setting this option,” appears to be indented under the RTMP paragraph. It actually applies to all protocols, not just RTMP. Eliminate the extra indentation. Closes #2788
* docs/CURLOPT_WRITEFUNCTION: size is always 1Christopher Head2018-07-261-1/+1
| | | | | | | | | | | | | | | | | | | | For compatibility with `fwrite`, the `CURLOPT_WRITEFUNCTION` callback is passed two `size_t` parameters which, when multiplied, designate the number of bytes of data passed in. In practice, CURL always sets the first parameter (`size`) to 1. This practice is also enshrined in documentation and cannot be changed in future. The documentation states that the default callback is `fwrite`, which means `fwrite` must be a suitable function for this purpose. However, the documentation also states that the callback must return the number of *bytes* it successfully handled, whereas ISO C `fwrite` returns the number of items (each of size `size`) which it wrote. The only way these numbers can be equal is if `size` is 1. Since `size` is 1 and can never be changed in future anyway, document that fact explicitly and let users rely on it. Closes #2787
* docs: fix missed option name markupsDaniel Stenberg2018-06-304-31/+32
|
* openssl: make the requested TLS version the *minimum* wantedDaniel Stenberg2018-06-291-18/+24
| | | | | | | | | | | The code treated the set version as the *exact* version to require in the TLS handshake, which is not what other TLS backends do and probably not what most people expect either. Reported-by: Andreas Olsson Assisted-by: Gaurav Malhotra Fixes #2691 Closes #2694
* CURLINFO_TLS_SSL_PTR.3: improve the exampleAdrian Peniak2018-06-281-8/+27
| | | | | | | | | The previous example was a little bit confusing, because SSL* structure (or other "in use" SSL connection pointer) is not accessible after the transfer is completed, therefore working with the raw TLS library specific pointer needs to be done during transfer. Closes #2690
* CURLOPT_SSL_VERIFYPEER.3: fix syntax mistakeDaniel Stenberg2018-06-241-6/+6
| | | | Follow-up to b6a16afa0aa5
* CURLOPT_SSL_VERIFYPEER.3: Add performance notePatrick Schlangen2018-06-231-1/+11
| | | | Closes #2673
* CURLOPT_INTERFACE.3: interface names not supported on WindowsDaniel Stenberg2018-06-181-1/+4
|
* CURLOPT_HTTPAUTH.3: CURLAUTH_BEARER was added in 7.61.0Daniel Stenberg2018-06-151-1/+3
|
* CURLOPT_RESOLVE: always purge old entry firstAlibek.Jorajev2018-06-011-0/+5
| | | | | | If there's an existing entry using the selected name. Closes #2622
* option: disallow username in URLBjörn Stenberg2018-05-314-0/+60
| | | | | | | Adds CURLOPT_DISALLOW_USERNAME_IN_URL and --disallow-username-in-url. Makes libcurl reject URLs with a username in them. Closes #2340
* libcurl-security.3: improved layout for two rememdy listsDaniel Stenberg2018-05-311-8/+12
|
* libcurl-security.3: refer to URL instead of in-source markdown fileDaniel Stenberg2018-05-311-2/+2
|
* setopt: add TLS 1.3 ciphersuitesDaniel Stenberg2018-05-295-3/+136
| | | | | | | | | | Adds CURLOPT_TLS13_CIPHERS and CURLOPT_PROXY_TLS13_CIPHERS. curl: added --tls13-ciphers and --proxy-tls13-ciphers Fixes #2435 Reported-by: zzq1015 on github Closes #2607
* psl: use latest psl and refresh it periodicallyPatrick Monnerat2018-05-282-0/+10
| | | | | | | | | | | The latest psl is cached in the multi or share handle. It is refreshed before use after 72 hours. New share lock CURL_LOCK_DATA_PSL controls the psl cache sharing. If the latest psl is not available, the builtin psl is used. Reported-by: Yaakov Selkowitz Fixes #2553 Closes #2601
* httpauth: add support for Bearer tokensLinus Lewandowski2018-05-243-4/+9
| | | | Closes #2102
* CURLOPT_ACCEPT_ENCODING.3: add brotli and clarify a bitDaniel Stenberg2018-05-221-6/+14
|
* docs: clarify CURLOPT_HTTPGET somewhatDaniel Stenberg2018-05-213-9/+14
| | | | | Reported-by: bsammon on github Fixes #2590
* curl_fnmatch: only allow two asterisks for matchingDaniel Stenberg2018-05-181-2/+2
| | | | | | | | | | | | | The previous limit of 5 can still end up in situation that takes a very long time and consumes a lot of CPU. If there is still a rare use case for this, a user can provide their own fnmatch callback for a version that allows a larger set of wildcards. This commit was triggered by yet another OSS-Fuzz timeout due to this. Bug: https://bugs.chromium.org/p/oss-fuzz/issues/detail?id=8369 Closes #2587
* docs: mention HAproxy protocol "version 1"Aleks2018-05-182-5/+5
| | | | | | ...as there's also a version 2. Closes #2579
* getinfo: add microsecond precise timers for various intervalsPhilip Prindeville2018-05-1717-16/+492
| | | | | | | | | | | | | | | | | 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
* docs/libcurl/index.html: removedDaniel Stenberg2018-05-152-73/+2
| | | | | | | The HTML files are long gone from the dist, now remove the last HTML file pointing to those missing files. d
* URLs: fix one more http urlDaniel Gustafsson2018-05-051-1/+1
| | | | | | | | This file wasn't included in commit 4af40b3646d3b09 which updated all haxx.se http urls to https. The file was committed prior to that update, but may have been merged after it and hence didn't get updated. Closes #2550
* docs: remove extraneous commas in man pagesDenis Ollier2018-05-033-4/+4
| | | | Closes #2544
* CURLOPT_URL.3: add ENCODING section [ci skip]Daniel Stenberg2018-04-301-1/+11
| | | | Feedback-by: Michael Kilburn
* CURLINFO_PROTOCOL.3: mention the existing defined namesDaniel Stenberg2018-04-271-3/+12
|
* curl_global_sslset: always provide available backendsChristian Schmitz2018-04-231-1/+4
| | | | Closes #2499
* CURLOPT_SSLCERT.3: improve WinSSL-specific usage infoArchangel_SDY2018-04-231-2/+10
| | | | | | Ref: https://github.com/curl/curl/pull/2376#issuecomment-381858780 Closes https://github.com/curl/curl/pull/2504
* schannel: add support for CURLOPT_CAINFODan McNulty2018-04-181-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | - Move verify_certificate functionality in schannel.c into a new file called schannel_verify.c. Additionally, some structure defintions from schannel.c have been moved to schannel.h to allow them to be used in schannel_verify.c. - Make verify_certificate functionality for Schannel available on all versions of Windows instead of just Windows CE. verify_certificate will be invoked on Windows CE or when the user specifies CURLOPT_CAINFO and CURLOPT_SSL_VERIFYPEER. - In verify_certificate, create a custom certificate chain engine that exclusively trusts the certificate store backed by the CURLOPT_CAINFO file. - doc updates of --cacert/CAINFO support for schannel - Use CERT_NAME_SEARCH_ALL_NAMES_FLAG when invoking CertGetNameString when available. This implements a TODO in schannel.c to improve handling of multiple SANs in a certificate. In particular, all SANs will now be searched instead of just the first name. - Update tool_operate.c to not search for the curl-ca-bundle.crt file when using Schannel to maintain backward compatibility. Previously, any curl-ca-bundle.crt file found in that search would have been ignored by Schannel. But, with CAINFO support, the file found by that search would have been used as the certificate store and could cause issues for any users that have curl-ca-bundle.crt in the search path. - Update url.c to not set the build time CURL_CA_BUNDLE if the selected SSL backend is Schannel. We allow setting CA location for schannel only when explicitly specified by the user via CURLOPT_CAINFO / --cacert. - Add new test cases 3000 and 3001. These test cases check that the first and last SAN, respectively, matches the connection hostname. New test certificates have been added for these cases. For 3000, the certificate prefix is Server-localhost-firstSAN and for 3001, the certificate prefix is Server-localhost-secondSAN. - Remove TODO 15.2 (Add support for custom server certificate validation), this commit addresses it. Closes https://github.com/curl/curl/pull/1325
* docs: fix typosJakub Wilk2018-04-1748-65/+65
| | | | Closes https://github.com/curl/curl/pull/2503
* schannel: add client certificate authenticationArchangel_SDY2018-04-171-0/+3
| | | | | | | Users can now specify a client certificate in system certificates store explicitly using expression like `--cert "CurrentUser\MY\<thumbprint>"` Closes #2376
* docs: fix CURLINFO_*_T examples use of CURL_FORMAT_CURL_OFF_TJay Satiro2018-03-316-6/+6
| | | | | | | | | - Put a percent sign before each CURL_FORMAT_CURL_OFF_T in printf. For example "%" CURL_FORMAT_CURL_OFF_T becomes %lld or similar. Bug: https://curl.haxx.se/mail/lib-2018-03/0140.html Reported-by: David L.
* CURLINFO_SSL_VERIFYRESULT.3: fix the example, add some textDaniel Stenberg2018-03-211-3/+5
| | | | | | Reported-by: Michal Trybus Fixes #2400
* CURLINFO_COOKIELIST.3: made the example not leak memoryDaniel Stenberg2018-03-201-4/+5
| | | | Reported-by: Muz Dima