summaryrefslogtreecommitdiff
path: root/docs/libcurl
Commit message (Collapse)AuthorAgeFilesLines
* docs: mention potential leak in curl_slist_appendDaniel Gustafsson2019-01-021-2/+14
| | | | | | | | | | | | | When a non-empty list is appended to, and used as the returnvalue, the list pointer can leak in case of an allocation failure in the curl_slist_append() call. This is correctly handled in curl code usage but we weren't explicitly pointing it out in the API call documentation. Fix by extending the RETURNVALUE manpage section and example code. Closes #3424 Reported-by: dnivras on github Reviewed-by: Daniel Stenberg <daniel@haxx.se>
* http: added options for allowing HTTP/0.9 responsesDaniel Stenberg2018-12-215-2/+65
| | | | | | | | | | | | Added CURLOPT_HTTP09_ALLOWED and --http0.9 for this purpose. For now, both the tool and library allow HTTP/0.9 by default. docs/DEPRECATE.md lays out the plan for when to reverse that default: 6 months after the 7.64.0 release. The options are added already now so that applications/scripts can start using them already now. Fixes #2873 Closes #3383
* http: minor whitespace cleanup from f464535bDaniel Stenberg2018-12-142-38/+19
|
* http: Implement trailing headers for chunked transfersAyoub Boudhar2018-12-145-0/+181
| | | | | | | | | | | | | This adds the CURLOPT_TRAILERDATA and CURLOPT_TRAILERFUNCTION options that allow a callback based approach to sending trailing headers with chunked transfers. The test server (sws) was updated to take into account the detection of the end of transfer in the case of trailing headers presence. Test 1591 checks that trailing headers can be sent using libcurl. Closes #3350
* documentation: curl_formadd field and file names are now escapedPatrick Monnerat2018-12-111-1/+2
| | | | | | | | | | | Prior to 7.56.0, fieldnames and filenames were set in Content-Disposition header without special processing: this may lead to invalid RFC 822 quoted-strings. 7.56.0 introduces escaping of backslashes and double quotes in these names: mention it in the documentation. Reported-by: daboul on github Closes #3361
* CURLOPT_WRITEFUNCTION.3: spell out that it gets called many timesDaniel Stenberg2018-11-231-3/+5
|
* CURLOPT_HEADERFUNCTION.3: match 'nitems' name in synopsis and descriptionUnknownShadow2002018-11-221-1/+1
| | | | Closes #3295
* docs: add more description to unified ssl error codesHan Han2018-11-191-4/+4
|
* docs: expanded on some CURLU detailsDaniel Stenberg2018-11-112-3/+14
|
* setopt: add CURLOPT_CURLUJim Fuller2018-11-094-0/+65
| | | | | | Allows an application to pass in a pre-parsed URL via a URL handle. Closes #3227
* docs: ESCape "\n" codesescape-codes-docsGisle Vanem2018-11-094-6/+6
| | | | | | | | | | | Groff / Troff will display a: printaf("Errno: %ld\n", error); as: printf("Errno: %ld0, error); when a "\n" is not escaped. Use "\\n" instead. Closes #3246
* More "\n" ESCapingGisle Vanem2018-11-071-3/+3
|
* winssl: be consistent in Schannel capitalizationDaniel Gustafsson2018-11-071-2/+2
| | | | | | | | The productname from Microsoft is "Schannel", but in infof/failf reporting we use "schannel". This removes different versions. Closes #3243 Reviewed-by: Daniel Stenberg <daniel@haxx.se>
* urlapi: only skip encoding the first '=' with APPENDQUERY setDaniel Stenberg2018-11-071-5/+6
| | | | | | | | | APPENDQUERY + URLENCODE would skip all equals signs but now it only skip encoding the first to better allow "name=content" for any content. Reported-by: Alexey Melnichuk Fixes #3231 Closes #3231
* netrc: don't ignore the login name specified with "--user"Michael Kaufmann2018-11-051-8/+9
| | | | | | | | | | | | - for "--netrc", don't ignore the login/password specified with "--user", only ignore the login/password in the URL. This restores the netrc behaviour of curl 7.61.1 and earlier. - fix the documentation of CURL_NETRC_REQUIRED - improve the detection of login/password changes when reading .netrc - don't read .netrc if both login and password are already set Fixes #3213 Closes #3224
* symbols-in-versions: add missing CURLU_ symbolsDaniel Stenberg2018-11-041-11/+21
| | | | | | | | ...and fix symbol-scan.pl to also scan urlapi.h Reported-by: Alexey Melnichuk Fixes #3226 Closes #3230
* axtls: removedDaniel Stenberg2018-11-016-10/+6
| | | | | | | | | | As has been outlined in the DEPRECATE.md document, the axTLS code has been disabled for 6 months and is hereby removed. Use a better supported TLS library! Assisted-by: Daniel Gustafsson Closes #3194
* schannel: make CURLOPT_CERTINFO support using Issuer chainmarcosdiazr2018-11-011-1/+1
| | | | Closes #3197
* vtls: add MesaLink to curl_sslbackend enumDaniel Gustafsson2018-10-303-4/+8
| | | | | | | | | MesaLink support was added in commit 57348eb97d1b8fc3742e02c but the backend was never added to the curl_sslbackend enum in curl/curl.h. This adds the new backend to the enum and updates the relevant docs. Closes #3195 Reviewed-by: Daniel Stenberg <daniel@haxx.se>
* docs: add "see also" links for SSL optionsMichael Kaufmann2018-10-106-6/+14
| | | | | | | - link TLS 1.2 and TLS 1.3 options - link proxy and non-proxy options Closes #3121
* CURLOPT_SSL_VERIFYSTATUS: Fix typoDaniel Gustafsson2018-10-091-2/+2
| | | | Changes s/OSCP/OCSP/ and bumps the copyright year due to the change.
* spelling fixes [ci skip]Viktor Szakats2018-10-082-2/+2
| | | | | | | as detected by codespell 1.14.0 Closes https://github.com/curl/curl/pull/3114 Reviewed-by: Marcel Raad <Marcel.Raad@teamviewer.com>
* CURLOPT_SSLVERSION.3: fix typos and consistent spellingDaniel Gustafsson2018-10-031-4/+4
| | | | | | | | | Use TLS vX.Y throughout the document, instead of TLS X.Y, as that was already done in all but a few cases. Also fix a few typos. Closes #3076 Reviewed-by: Marcel Raad <Marcel.Raad@teamviewer.com> Reviewed-by: Daniel Stenberg <daniel@haxx.se>
* CURLOPT_HEADER.3: fix typoJay Satiro2018-10-031-1/+1
|
* whitespace fixesViktor Szakats2018-09-2322-101/+85
| | | | | | | | | | | - replace tabs with spaces where possible - remove line ending spaces - remove double/triple newlines at EOF - fix a non-UTF-8 character - cleanup a few indentations/line continuations in manual examples Closes https://github.com/curl/curl/pull/3037
* urlapi: document the error codes, remove two unused onesDaniel Stenberg2018-09-192-3/+36
| | | | | Assisted-by: Daniel Gustafsson Closes #3019
* urlapi: add CURLU_GUESS_SCHEME and fix hostname acceptanceDaniel Stenberg2018-09-191-0/+10
| | | | | | | | | | | | | | | In order for this API to fully work for libcurl itself, it now offers a CURLU_GUESS_SCHEME flag that makes it "guess" scheme based on the host name prefix just like libcurl always did. If there's no known prefix, it will guess "http://". Separately, it relaxes the check of the host name so that IDN host names can be passed in as well. Both these changes are necessary for libcurl itself to use this API. Assisted-by: Daniel Gustafsson Closes #3018
* curl_url_set.3: properly escape \n in example codeDave Reisner2018-09-131-1/+1
| | | | | | | | | | | | This yields "the scheme is %s\n" instead of "the scheme is %s0 Closes #2970
* curl_url_set.3: fix typo in reference to CURLU_APPENDQUERYDave Reisner2018-09-131-1/+1
|
* libcurl-url.3: overview man page for the URL APIDaniel Stenberg2018-09-102-0/+138
| | | | Closes #2967
* curl_url_set.3: correct descriptionDaniel Stenberg2018-09-081-1/+1
|
* curl_url-docs: fix AVAILABILITY as Added in curl 7.62.0Daniel Stenberg2018-09-085-5/+5
|
* URL-APIDaniel Stenberg2018-09-087-23/+497
| | | | | | | See header file and man pages for API. All documented API details work and are tested in the 1560 test case. Closes #2842
* curl_easy_upkeep: removed 'conn' from the nameDaniel Stenberg2018-09-076-23/+23
| | | | | | | ... including the associated option. Fixes #2951 Closes #2952
* upkeep: add a connection upkeep API: curl_easy_conn_upkeep()Max Dymond2018-09-076-1/+157
| | | | | | | | | Add functionality so that protocols can do custom keepalive on their connections, when an external API function is called. Add docs for the new options in 7.62.0 Closes #1641
* 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
View Lorry Controller Status