summaryrefslogtreecommitdiff
path: root/docs/libcurl
Commit message (Collapse)AuthorAgeFilesLines
* docs/libcurl: TCP_KEEPALIVE start and interval default to 60Jay Satiro2017-01-022-2/+4
| | | | | | | | Since the TCP keep-alive options were added in 705f0f7 the start and interval default values have been 60, but that wasn't documented. Bug: https://curl.haxx.se/mail/lib-2017-01/0000.html Reported-by: Praveen Pvs
* curl_formadd.3: CURLFORM_CONTENTSLENGTH not needed when chunkedDaniel Stenberg2016-12-281-2/+2
| | | | Mentioned in #1013
* docs/ciphers: link to our own new page about ciphersDaniel Stenberg2016-12-251-6/+2
| | | | ... as the former ones always go stale!
* curl_easy_recv: Improve documentation and example programMichael Kaufmann2016-12-183-18/+35
| | | | | | | | | | | Follow-up to 82245ea: Fix the example program sendrecv.c (handle CURLE_AGAIN, handle incomplete send). Improve the documentation for curl_easy_recv() and curl_easy_send(). Reviewed-by: Frank Meier Assisted-by: Jay Satiro See https://github.com/curl/curl/pull/1134
* curl_easy_setopt.3: removed CURLOPT_SOCKS_PROXYTYPEDaniel Stenberg2016-12-171-2/+0
|
* curl_easy_setopt.3: CURLOPT_PRE_PROXY instead of CURLOPT_SOCKS_PROXYDaniel Stenberg2016-12-171-2/+2
|
* symbols: removed two, added oneDaniel Stenberg2016-12-171-3/+2
|
* CURLINFO_SSL_VERIFYRESULT.3: languageDaniel Stenberg2016-12-161-3/+3
|
* HTTPS-PROXY docs: update/polishDaniel Stenberg2016-12-1612-126/+129
|
* preproxy: renamed what was added as SOCKS_PROXYDaniel Stenberg2016-12-162-12/+16
| | | | | | | CURLOPT_SOCKS_PROXY -> CURLOPT_PRE_PROXY Added the corresponding --preroxy command line option. Sets a SOCKS proxy to connect to _before_ connecting to a HTTP(S) proxy.
* CURLOPT_SOCKS_PROXYTYPE: removedDaniel Stenberg2016-12-163-91/+10
| | | | | | This was added as part of the SOCKS+HTTPS proxy merge but there's no need to support this as we prefer to have the protocol specified as a prefix instead.
* curl_multi_socket.3: fix typoDaniel Stenberg2016-12-151-1/+1
|
* libcurl-multi.3: typoJeremy Pearson2016-12-031-1/+1
| | | | Closes https://github.com/curl/curl/pull/1153
* CURLOPT_PROXY_*.3: polished some proxy option man pagesDaniel Stenberg2016-11-273-25/+26
|
* curl_version_info: add CURL_VERSION_HTTPS_PROXYOkhin Vasilij2016-11-262-0/+4
| | | | Closes #1142
* CURLOPT_PROXY_CAINFO.3: clarify proxy useDaniel Stenberg2016-11-251-7/+13
|
* CURLOPT_PROXY_CRLFILE.3: clarify https proxy and availabilityDaniel Stenberg2016-11-251-3/+7
|
* curl_easy_setopt.3: add CURLOPT_PROXY_PINNEDPUBLICKEYDaniel Stenberg2016-11-251-0/+3
| | | | Follow-up to 4f8b17743d7c55a
* docs: include all opts man pages in distDaniel Stenberg2016-11-251-5/+60
| | | | | | Sorted the lists too. ... and include the new ones in the PDF and HTML generation targets
* HTTPS Proxy: Implement CURLOPT_PROXY_PINNEDPUBLICKEYThomas Glanzmann2016-11-252-0/+100
|
* url: proxy: Use 443 as default port for https proxiesThomas Glanzmann2016-11-251-1/+2
|
* add CURLINFO_SCHEME, CURLINFO_PROTOCOL, and %{scheme}Frank Gevaerts2016-11-254-0/+122
| | | | | | | | | | | | | | Adds access to the effectively used protocol/scheme to both libcurl and curl, both in string and numeric (CURLPROTO_*) form. Note that the string form will be uppercase, as it is just the internal string. As these strings are declared internally as const, and all other strings returned by curl_easy_getinfo() are de-facto const as well, string handling in getinfo.c got const-ified. Closes #1137
* HTTPS-proxy: fixed mbedtls and polishingOkhin Vasilij2016-11-2420-42/+40
|
* proxy: Support HTTPS proxy and SOCKS+HTTP(s)Alex Rousskov2016-11-2423-0/+1223
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * HTTPS proxies: An HTTPS proxy receives all transactions over an SSL/TLS connection. Once a secure connection with the proxy is established, the user agent uses the proxy as usual, including sending CONNECT requests to instruct the proxy to establish a [usually secure] TCP tunnel with an origin server. HTTPS proxies protect nearly all aspects of user-proxy communications as opposed to HTTP proxies that receive all requests (including CONNECT requests) in vulnerable clear text. With HTTPS proxies, it is possible to have two concurrent _nested_ SSL/TLS sessions: the "outer" one between the user agent and the proxy and the "inner" one between the user agent and the origin server (through the proxy). This change adds supports for such nested sessions as well. A secure connection with a proxy requires its own set of the usual SSL options (their actual descriptions differ and need polishing, see TODO): --proxy-cacert FILE CA certificate to verify peer against --proxy-capath DIR CA directory to verify peer against --proxy-cert CERT[:PASSWD] Client certificate file and password --proxy-cert-type TYPE Certificate file type (DER/PEM/ENG) --proxy-ciphers LIST SSL ciphers to use --proxy-crlfile FILE Get a CRL list in PEM format from the file --proxy-insecure Allow connections to proxies with bad certs --proxy-key KEY Private key file name --proxy-key-type TYPE Private key file type (DER/PEM/ENG) --proxy-pass PASS Pass phrase for the private key --proxy-ssl-allow-beast Allow security flaw to improve interop --proxy-sslv2 Use SSLv2 --proxy-sslv3 Use SSLv3 --proxy-tlsv1 Use TLSv1 --proxy-tlsuser USER TLS username --proxy-tlspassword STRING TLS password --proxy-tlsauthtype STRING TLS authentication type (default SRP) All --proxy-foo options are independent from their --foo counterparts, except --proxy-crlfile which defaults to --crlfile and --proxy-capath which defaults to --capath. Curl now also supports %{proxy_ssl_verify_result} --write-out variable, similar to the existing %{ssl_verify_result} variable. Supported backends: OpenSSL, GnuTLS, and NSS. * A SOCKS proxy + HTTP/HTTPS proxy combination: If both --socks* and --proxy options are given, Curl first connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy. TODO: Update documentation for the new APIs and --proxy-* options. Look for "Added in 7.XXX" marks.
* docs: the next release will be 7.52.0Kamil Dudka2016-11-152-2/+2
|
* curl_formadd.3: *_FILECONTENT and *_FILE need the file to be keptDaniel Stenberg2016-11-081-0/+4
| | | | Reported-by: Frank Gevaerts
* vtls: support TLS 1.3 via CURL_SSLVERSION_TLSv1_3Kamil Dudka2016-11-072-0/+3
| | | | | | Fully implemented with the NSS backend only for now. Reviewed-by: Ray Satiro
* unescape: avoid integer overflowDaniel Stenberg2016-10-311-2/+5
| | | | | | | CVE-2016-8622 Bug: https://curl.haxx.se/docs/adv_20161102H.html Reported-by: Cure53
* CURLMOPT_MAX_PIPELINE_LENGTH.3: Clarify it's not for HTTP/2Jay Satiro2016-10-271-2/+2
| | | | | | | | | - Clarify that this option is only for HTTP/1.1 pipelining. Bug: https://github.com/curl/curl/issues/1059 Reported-by: Jeroen Ooms Assisted-by: Daniel Stenberg
* s/cURL/curlDaniel Stenberg2016-10-182-4/+4
| | | | | The tool was never called cURL, only the project. But even so, we have more and more over time switched to just use lower case.
* dist: remove PDF and HTML converted docs from the releasesDaniel Stenberg2016-10-102-3/+3
|
* CURLOPT_DEBUGFUNCTION.3: unused argument warning (#1056)Rainer Müller2016-10-061-0/+1
| | | The 'userp' argument is unused in this example code.
* CURLOPT_KEEP_SENDING_ON_ERROR.3: mention when it is addedDaniel Stenberg2016-10-041-3/+3
|
* New libcurl option to keep sending on errorMichael Kaufmann2016-09-225-1/+59
| | | | | | | | | | | | Add the new option CURLOPT_KEEP_SENDING_ON_ERROR to control whether sending the request body shall be completed when the server responds early with an error status code. This is suitable for manual NTLM authentication. Reviewed-by: Jay Satiro Closes https://github.com/curl/curl/pull/904
* docs: Remove that --proto is just used for initial retrievalJay Satiro2016-09-211-0/+3
| | | | | | | | | .. and add that --proto-redir and CURLOPT_REDIR_PROTOCOLS do not override protocols denied by --proto and CURLOPT_PROTOCOLS. - Add a test to enforce: --proto deny must override --proto-redir allow Closes https://github.com/curl/curl/pull/1031
* curl_global_cleanup.3: don't unload the lib with sub threads runningDaniel Stenberg2016-09-201-2/+8
| | | | | | Discussed in #997 Assisted-by: Jay Satiro
* CURLOPT_PINNEDPUBLICKEY.3: fix the AVAILABILITY formattingJay Satiro2016-09-181-2/+11
|
* errors: new alias CURLE_WEIRD_SERVER_REPLY (8)Jay Satiro2016-09-072-3/+3
| | | | | | | | Since we're using CURLE_FTP_WEIRD_SERVER_REPLY in imap, pop3 and smtp as more of a generic "failed to parse" introduce an alias without FTP in the name. Closes https://github.com/curl/curl/pull/975
* speed caps: not based on average speeds anymoreOlivier Brunel2016-09-042-6/+5
| | | | | | | | | | | | | | | | | | | | | | | | Speed limits (from CURLOPT_MAX_RECV_SPEED_LARGE & CURLOPT_MAX_SEND_SPEED_LARGE) were applied simply by comparing limits with the cumulative average speed of the entire transfer; While this might work at times with good/constant connections, in other cases it can result to the limits simply being "ignored" for more than "short bursts" (as told in man page). Consider a download that goes on much slower than the limit for some time (because bandwidth is used elsewhere, server is slow, whatever the reason), then once things get better, curl would simply ignore the limit up until the average speed (since the beginning of the transfer) reached the limit. This could prove the limit useless to effectively avoid using the entire bandwidth (at least for quite some time). So instead, we now use a "moving starting point" as reference, and every time at least as much as the limit as been transferred, we can reset this starting point to the current position. This gets a good limiting effect that applies to the "current speed" with instant reactivity (in case of sudden speed burst). Closes #971
* CURLMOPT_PIPELINING.3: languageDaniel Stenberg2016-09-011-1/+1
|
* CURLMOPT_PIPELINING.3: extended and clarifiedDaniel Stenberg2016-09-011-14/+26
| | | | Especially in regards to the multiplexing part.
* darwinssl: add documentation stating that the --cainfo option is intended ↵Nick Zitzmann2016-08-281-0/+6
| | | | | | for backward compatibility only In other news, I changed one other reference to "Mac OS X" in the documentation (that I previously wrote) to say "macOS" instead.
* CURLMOPT_MAX_TOTAL_CONNECTIONS.3: mention it can also multiplexDaniel Stenberg2016-08-191-2/+2
|
* CURLOPT_PROXY.3: unsupported schemes cause errors nowDaniel Stenberg2016-08-151-3/+5
| | | | Follow-up to a96319ebb9 (document the new behavior)
* symbols-in-versions: add CURL_STRICTERDaniel Stenberg2016-08-091-0/+1
| | | | Added in 5fce88aa8c12564
* CURLOPT_TCP_NODELAY: now enabled by defaultDaniel Stenberg2016-08-051-6/+6
| | | | | | | | | | | | | | After a few wasted hours hunting down the reason for slowness during a TLS handshake that turned out to be because of TCP_NODELAY not being set, I think we have enough motivation to toggle the default for this option. We now enable TCP_NODELAY by default and allow applications to switch it off. This also makes --tcp-nodelay unnecessary, but --no-tcp-nodelay can be used to disable it. Thanks-to: Tim Rühsen Bug: https://curl.haxx.se/mail/lib-2016-06/0143.html
* docs: distribute the CURLINFO_HTTP_VERSION(3) man page, tooKamil Dudka2016-07-211-0/+1
|
* CURLMOPT_SOCKETFUNCTION.3: fix typoTimothy Polich2016-07-141-1/+1
| | | | Closes https://github.com/curl/curl/pull/914
* curl_global_init.3: improved formatting of the flagsDaniel Stenberg2016-06-291-13/+7
|
* curl_global_init.3: expand on the SSL and WIN32 bits purposeDaniel Stenberg2016-06-291-1/+14
| | | | | Reported-by: Richard Gray Bug: https://curl.haxx.se/mail/lib-2016-06/0136.html