curl/docs
Daniel Stenberg 4183b8fe9a
urlapi: provide more detailed return codes
Previously, the return code CURLUE_MALFORMED_INPUT was used for almost
30 different URL format violations. This made it hard for users to
understand why a particular URL was not acceptable. Since the API cannot
point out a specific position within the URL for the problem, this now
instead introduces a number of additional and more fine-grained error
codes to allow the API to return more exactly in what "part" or section
of the URL a problem was detected.

Also bug-fixes curl_url_get() with CURLUPART_ZONEID, which previously
returned CURLUE_OK even if no zoneid existed.

Test cases in 1560 have been adjusted and extended. Tests 1538 and 1559
have been updated.

Updated libcurl-errors.3 and curl_url_strerror() accordingly.

Closes #8049
2021-11-25 08:36:04 +01:00
..
cmdline-opts page-footer: fix typo 2021-11-19 18:11:13 +01:00
examples docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
libcurl urlapi: provide more detailed return codes 2021-11-25 08:36:04 +01:00
.gitignore gitignore: Ignore man page dist files 2017-03-07 23:27:31 +01:00
ALTSVC.md alt-svc: enable by default 2020-10-25 23:08:54 +01:00
BINDINGS.md BINDINGS: URL updates 2021-10-04 22:44:38 +02:00
BUFREF.md docs: correct spelling errors and a broken link 2021-07-18 21:14:36 +02:00
BUG-BOUNTY.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
BUGS.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
CHECKSRC.md docs/checksrc: Add documentation for STRERROR 2021-11-11 15:40:14 +01:00
CIPHERS.md schannel: Support strong crypto option 2021-04-22 17:40:19 -04:00
CMakeLists.txt curl.se: new home 2020-11-04 23:59:47 +01:00
CODE_OF_CONDUCT.md docs: Update to secure URL versions 2017-09-04 14:08:54 +00:00
CODE_REVIEW.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
CODE_STYLE.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
CONTRIBUTE.md tests/CI.md: add more information on CI environments 2021-11-23 09:38:44 +01:00
curl-config.1 curl.se: new home 2020-11-04 23:59:47 +01:00
CURL-DISABLE.md cmake: sync CURL_DISABLE options 2021-08-25 13:05:50 +02:00
DEPRECATE.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
DYNBUF.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
ECH.md docs: correct spelling errors and a broken link 2021-07-18 21:14:36 +02:00
EXPERIMENTAL.md hsts: enable by default 2021-04-19 08:22:16 +02:00
FAQ docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
FEATURES.md metalink: remove 2021-06-07 08:14:25 +02:00
GOVERNANCE.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
HELP-US.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
HISTORY.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
HSTS.md HSTS: not experimental anymore 2021-05-28 12:34:07 +02:00
HTTP2.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
HTTP3.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
HTTP-COOKIES.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
HYPER.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
INSTALL INSTALL: converted to markdown => INSTALL.md 2016-10-21 15:57:29 +02:00
INSTALL.cmake docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
INSTALL.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
INTERNALS.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
KNOWN_BUGS docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
MAIL-ETIQUETTE docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
Makefile.am docs/Makefile.am: repair 'make html' 2021-10-14 07:46:13 +02:00
MANUAL.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
mk-ca-bundle.1 curl.se: new home 2020-11-04 23:59:47 +01:00
MQTT.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
NEW-PROTOCOL.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
options-in-versions mime: use percent-escaping for multipart form field and file names 2021-11-15 10:40:03 +01:00
PARALLEL-TRANSFERS.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
README.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
RELEASE-PROCEDURE.md RELEASE-PROCEDURE: add release dates from now to 8.0.0 in 2023 2021-09-13 16:32:41 +02:00
ROADMAP.md ROADMAP: refreshed 2021-01-14 09:49:17 +01:00
RUSTLS.md zuul.d: update rustls-ffi to version 0.8.2 2021-11-15 09:50:08 +01:00
SECURITY-PROCESS.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
SSL-PROBLEMS.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
SSLCERTS.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
THANKS THANKS: add contributors from the 7.80.0 cycle 2021-11-10 07:32:46 +01:00
THANKS-filter RELEASE-NOTES: synced 2021-08-25 13:13:49 +02:00
TheArtOfHttpScripting.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
TODO docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
URL-SYNTAX.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00
VERSIONS.md docs: reduce/avoid English contractions 2021-11-07 23:16:27 +01:00

curl logo

Documentation

you will find a mix of various documentation in this directory and subdirectories, using several different formats. Some of them are not ideal for reading directly in your browser.

If you would rather see the rendered version of the documentation, check out the curl website's documentation section for general curl stuff or the libcurl section for libcurl related documentation.