summaryrefslogtreecommitdiff
path: root/docs
Commit message (Collapse)AuthorAgeFilesLines
* THANKS: contributors from the 8.1.0 releaseDaniel Stenberg2023-05-171-0/+35
|
* aws-sigv4.d: fix region identifier in exampleThomas Taylor2023-05-161-1/+1
| | | | Closes #11117
* ssh: Add support for libssh2 read timeoutDaniel Silverstone2023-05-151-1/+4
| | | | | | | | | | | | Hook the new (1.11.0 or newer) libssh2 support for setting a read timeout into the SERVER_RESPONSE_TIMEOUT option. With this done, clients can use the standard curl response timeout setting to also control the time that libssh2 will wait for packets from a slow server. This is necessary to enable use of very slow SFTP servers. Signed-off-by: Daniel Silverstone <daniel.silverstone@codethink.co.uk> Closes #10965
* write-out.d: Use response_code in exampleVítor Galvão2023-05-121-1/+1
| | | | Closes #11107
* ngtcp2: use 0.15.0Daniel Stenberg2023-05-121-8/+8
| | | | | | | | | - nghttp3 0.11.0 - nghttp2 1.53.0 Adapt to new API calls Closes #11031
* CURLOPT_DNS_CACHE_TIMEOUT.3: fix spellingDaniel Stenberg2023-05-101-1/+1
| | | | | | Follow-up to 9ed7d56e044f5aa1b29 Closes #11096
* compressed.d: clarify the words on "not notifying headers"Daniel Stenberg2023-05-091-1/+5
| | | | | | Reported-by: Dylan Anthony Fixes #11091 Closes #11092
* CURLOPT_IPRESOLVE.3: clarify that this for host names, not IP addressesDaniel Stenberg2023-05-081-2/+7
| | | | | Reported-by: Harry Sintonen Closes #11087
* hostip: enforce a maximum DNS cache size independent of timeout valueDaniel Stenberg2023-05-081-2/+10
| | | | | | | | | | To reduce the damage an application can cause if using -1 or other ridiculous timeout values and letting the cache live long times. The maximum number of entries in the DNS cache is now totally arbitrarily and hard-coded set to 29999. Closes #11084
* ipv4.d/ipv6.d: they are "mutex", not "boolean"Daniel Stenberg2023-05-082-6/+6
| | | | | | | | ... which for example means they do not have --no-* versions. Reported-by: Harry Sintonen Fixes #11085 Closes #11086
* docs/SECURITY-ADVISORY.md: how to write a curl security advisoryDaniel Stenberg2023-05-083-1/+132
| | | | Closes #11080
* MANUAL.md: add dict example for looking up a single definitionnobedee on github2023-05-051-2/+5
| | | | Closes #11077
* docs: minor polishDaniel Stenberg2023-04-2711-25/+24
| | | | | | | | | - "an HTTP*" (not "a") - remove a few contractions - remove a spurious "a" - reduce use of "I" in texts Closes #11040
* tests/http: more tests with specific clientsStefan Eissing2023-04-261-4/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | - Makefile support for building test specific clients in tests/http/clients - auto-make of clients when invoking pytest - added test_09_02 for server PUSH_PROMISEs using clients/h2-serverpush - added test_02_21 for lib based downloads and pausing/unpausing transfers curl url parser: - added internal method `curl_url_set_authority()` for setting the authority part of a url (used for PUSH_PROMISE) http2: - made logging of PUSH_PROMISE handling nicer Placing python test requirements in requirements.txt files - separate files to base test suite and http tests since use and module lists differ - using the files in the gh workflows websocket test cases, fixes for we and bufq - bufq: account for spare chunks in space calculation - bufq: reset chunks that are skipped empty - ws: correctly encode frames with 126 bytes payload - ws: update frame meta information on first call of collect callback that fills user buffer - test client ws-data: some test/reporting improvements Closes #11006
* docs: clarify that more backends have HTTPS proxy supportDaniel Stenberg2023-04-263-3/+11
| | | | Closes #11033
* KNOWN_BUGS: remove two not-bugsDaniel Stenberg2023-04-261-23/+0
| | | | | | | | | | | | | - 11.7 signal-based resolver timeouts Not considered a bug anymore but just implementation details. People should avoid using timeouts with the synchronous name resolver. - 11.16 libcurl uses renames instead of locking for atomic operations Not a bug, just a description of how it works Closes #11032
* docs/libcurl/curl_*escape.3: rename "url" argument to "input"/"string"Emanuele Torre2023-04-263-14/+14
| | | | | | | Also reword the DESCRIPTION section to mention "input"/"string" argument in bold. Closes #11027
* docs/libcurl: minor cleanupsEmanuele Torre2023-04-265-10/+10
| | | | | | | | | | | | | | | | | | | | | | | | | I was reading curl_unescape(3) and I noticed that there was an extra space after the open parenthesis in the SYNOPSIS; I removed the extra space. I also ran a few grep -r commands to find and remove extra spaces after '(' in other files, and to find and replace uses of `T*' instead of `T *'. Some of the instances of `T*` where unnecessary casts that I removed. I also fixed a comment that was misaligned in CURLMOPT_SOCKETFUNCTION.3. And I fixed some formatting inconsistencies: in curl_unescape(3), all function parameter were mentioned with bold text except length, that was mentioned as 'length'; and, in curl_easy_unescape(3), all parameters were mentioned in bold text except url that was italicised. Now they are all mentioned in bold. Documentation is not very consistent in how function parameter are formatted: many pages italicise them, and others display them in bold text; but I think it makes sense to at least be consistent with formatting within the same page. Closes #11027
* man pages: simplify the .TH sectionsDaniel Stenberg2023-04-26485-486/+486
| | | | | | | | | | - remove the version numbers - simplify the texts The date and version number will be put there for releases when maketgz runs the updatemanpages.pl script. Closes #11029
* HTTP3: document the ngtcp2/nghttp3 versions to use for building curlStefan Eissing2023-04-251-6/+15
| | | | | | - refs #11011 to clarify this for people building curl themselves Closes #11019
* docs/examples/protofeats.c: Outputs all protocols and featuresDaniel Stenberg2023-04-182-0/+53
| | | | | | | Showing off one way to get to char pointer arrays of info returned by curl_version_info() Closes #10991
* curl_easy_unescape.3: rename the argumentDaniel Stenberg2023-04-171-5/+5
| | | | | | and highlight it appropriately in the text. Closes #10979
* libcurl-thread.3: improved name resolver wordingDaniel Stenberg2023-04-141-20/+24
| | | | | | And make better .SH sections Closes #10966
* CURLOPT_PROXY_SSL_VERIFYPEER.3: fix minor grammar mistakeColman Mbuya2023-04-141-1/+1
| | | | Closes #10968
* curl: add --proxy-http2Daniel Stenberg2023-04-143-0/+20
| | | | | | For trying HTTP/2 with an HTTPS proxy. Closes #10926
* KNOWN_BUGS: remove fixed or outdated issues, move non-bugsDaniel Stenberg2023-04-144-146/+69
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | - remove h3 issues believed to be fixed - make the flaky CI issue be generic and not Windows specific - "TLS session cache does not work with TFO" now documented This is now a documented restriction and not a bug. TFO in general is rarely used and has other problems, making it a low-priotity thing to work on. - remove "Renegotiate from server may cause hang for OpenSSL backend" This is an OpenSSL issue, not a curl one. Even if it taints curl. - rm "make distclean loops forever" - rm "configure finding libs in wrong directory" Added a section to docs/INSTALL.md about it. - "A shared connection cache is not thread-safe" Moved over to TODO and expanded for other sharing improvements we could do - rm "CURLOPT_OPENSOCKETPAIRFUNCTION is missing" - rm "Blocking socket operations in non-blocking API" Already listed as a TODO - rm "curl compiled on OSX 10.13 failed to run on OSX 10.10" Water under the bridge. No one cares about this anymore. - rm "build on Linux links libcurl to libdl" Verified to not be true (anymore). - rm "libpsl is not supported" The cmake build supports it since cafb356e19cda22 Closes #10963
* gen.pl: error on duplicated See-Also fieldsDaniel Stenberg2023-04-112-3/+6
| | | | | | Updated http2.d accordingly. Closes #10925
* curl_url_set.3: mention that users can set content rather freelyDaniel Stenberg2023-04-111-0/+5
| | | | | | ... which then might render bad URLs if you extract a URL later. Closes #10921
* CURLPROXY_HTTPS2: for HTTPS proxy that may speak HTTP/2Daniel Stenberg2023-04-082-1/+4
| | | | | | | Setting this proxy type allows curl to negotiate and use HTTP/2 with HTTPS proxies. Closes #10900
* write-out.d: add missing periodsAli Khodkar2023-04-081-3/+3
| | | | Closes #10897
* tool_writeout: add URL component variablesDaniel Stenberg2023-04-041-0/+64
| | | | | | | | | | | | | | | | | Output specific components from the used URL. The following variables are added for this purpose: url.scheme, url.user, url.password, url.options, url.host, url.port, url.path, url.query, url.fragment, url.zoneid Add the following for outputting parts of the "effective URL": urle.scheme, urle.user, urle.password, urle.options, urle.host, urle.port, urle.path, urle.query, urle.fragment, urle.zoneid Added test 423 and 424 to verify. Closes #10853
* docs: bump the minimum perl version to 5.6Dan Fandrich2023-03-301-1/+1
| | | | | | It's actually been this way since at least 2012 (when a 3-argument open was added to runtests.pl). Given the lack of complaints in the interim, it's safe to call this 23 year old perl version the minimum.
* docs: add documentation for bufqStefan Eissing2023-03-301-0/+144
| | | | Closes #10869
* hostip: refuse to resolve the .onion TLDMatt Jolly2023-03-301-9/+0
| | | | | | | | | | | | | | | | | RFC 7686 states that: > Applications that do not implement the Tor > protocol SHOULD generate an error upon the use of .onion and > SHOULD NOT perform a DNS lookup. Let's do that. https://www.rfc-editor.org/rfc/rfc7686#section-2 Add test 1471 and 1472 to verify Fixes #543 Closes #10705
* openssl: interop with AWS-LCJim King2023-03-304-2/+5
| | | | | | | | | | | | | * Configure changes to detect AWS-LC * CMakeLists.txt changes to detect AWS-LC * Compile-time branches needed to support AWS-LC * Correctly set OSSL_VERSION and report AWS-LC release number * GitHub Actions script to build with autoconf and cmake against AWS-LC AWS-LC is a BoringSSL/OpenSSL derivative For more information see https://github.com/awslabs/aws-lc/ Closes #10320
* curl_easy_getinfo.3: typo fix (duplicated "from the")Frank Gevaerts2023-03-281-1/+1
| | | | Closes #10850
* docs/cmdline-opts: document the dotless config pathRonan Pigott2023-03-281-1/+1
| | | | | | | | The real xdg config path is $XDG_CONFIG_HOME/curlrc, without the dot. The dotless name seems preferable, so let's match the documentation to the behavior. Closes #10849
* HTTP-COOKIES.md: mention the #HttpOnly_ prefixDaniel Stenberg2023-03-281-1/+3
| | | | | | Fixes #10847 Reported-by: Harry Sintonen Closes #10848
* RELEASE-PROCEDURE: update to new scheduleDaniel Stenberg2023-03-262-25/+26
| | | | | | | | | Ref: https://curl.se/mail/lib-2023-03/0062.html Assisted-by: Andy Alt Assisted-by: Dan Frandrich Closes #10827
* doc: curl_mime_init() strong easy handle binding has been relaxed in 7.87.0Patrick Monnerat2023-03-261-2/+2
| | | | | | Reported-by: Chloe Kudryavtsev Fixes #10834 Closes #10835
* CURLOPT_WRITEFUNCTION.3: fix typoJay Satiro2023-03-251-1/+1
| | | | | | Reported-by: Osaila@users.noreply.github.com Fixes https://github.com/curl/curl/issues/10839
* data.d: emphasize no conversionDaniel Stenberg2023-03-231-0/+4
| | | | | | | When asking curl to send a POST, curl does not encode or change the data. Ref: #10820 Closes #10823
* THANKS: from the 8.0.0 releaseDaniel Stenberg2023-03-201-2/+23
|
* SECURITY-PROCESS.md: Busy-loops are not security problemsDaniel Stenberg2023-03-181-0/+8
| | | | Closes #10790
* lib2305: deal with CURLE_AGAINDaniel Stenberg2023-03-161-0/+4
| | | | | | | | | | | The test does a slightly ugly busy-loop for this case but should be managable due to it likely being a very short moment. Mention CURLE_AGAIN in curl_ws_recv.3 Fixes #10760 Reported-by: Jay Satiro Closes #10781
* aws_sigv4: fall back to UNSIGNED-PAYLOAD for sign_as_s3Casey Bodley2023-03-141-0/+4
| | | | | | | | | | all s3 requests default to UNSIGNED-PAYLOAD and add the required x-amz-content-sha256 header. this allows CURLAUTH_AWS_SIGV4 to correctly sign s3 requests to amazon with no additional configuration Signed-off-by: Casey Bodley <cbodley@redhat.com> Closes #9995
* RELEASE-PROCEDURE.md: update coming release datesDaniel Stenberg2023-03-131-5/+4
|
* http: don't send 100-continue for short PUT requestsDan Fandrich2023-03-111-5/+4
| | | | | | | | | This is already how curl is documented to behave in Everything curl, but in actuality only short POSTs skip this. This should knock 30 seconds off a full run of the test suite since the 100-continue timeout will no longer be hit. Closes #10740
* CURLOPT_PROXY.3: curl+NSS does not handle HTTPS over unix domain socketDaniel Stenberg2023-03-101-0/+3
| | | | | | | | | | It results in error "NSS error -5985 (PR_ADDRESS_NOT_SUPPORTED_ERROR)" Disabled test 1470 for NSS builds and documented the restriction. Reported-by: Dan Fandrich Fixes #10723 Closes #10734
* CURLSHOPT_SHARE.3: HSTS sharing is not thread-safeDaniel Stenberg2023-03-101-2/+3
| | | | | Reported-by: Hiroki Kurosawa Closes #10732