aboutsummaryrefslogtreecommitdiff
path: root/docs/curl.1
AgeCommit message (Collapse)Author
2009-08-14I think it's worth clarifying that curl DOES NOT validate a given URL moreDaniel Stenberg
than what's absolutely necessary: curl will do its best to use what you pass to it as a URL. It is not trying to validate it as a syntactically correct URL by any means but is instead VERY liberal with what it accepts.
2009-08-04RFC1867 was updated by RFC2388Daniel Stenberg
2009-06-30silly typo, pointed out by Fabian KeilDaniel Stenberg
2009-06-29- Markus Koetter made CURLOPT_FTPPORT (and curl's -P/--ftpport) support a portDaniel Stenberg
range if given colon-separated after the host name/address part. Like "192.168.0.1:2000-10000"
2009-04-23- bug report #2779245 (http://curl.haxx.se/bug/view.cgi?id=2779245) by RainerDaniel Stenberg
Koenig pointed out that the man page didn't tell that the *_proxy environment variables can be specified lower case or UPPER CASE and the lower case takes precedence,
2009-02-27mention the '-o -' trickDaniel Stenberg
2009-02-20clarified the FTP passive/active mode options somewhatDaniel Stenberg
2009-02-04Fixed a typo (spotted in the FreeBSD ports).Dan Fandrich
2009-02-02- Craig A West brought us: libcurl now defaults to do CONNECT with HTTPDaniel Stenberg
version 1.1 instead of 1.0 like before. This change also introduces the new proxy type for libcurl called 'CURLPROXY_HTTP_1_0' that then allows apps to switch (back) to CONNECT 1.0 requests. The curl tool also got a --proxy1.0 option that works exactly like --proxy but sets CURLPROXY_HTTP_1_0. I updated all test cases cases that use CONNECT and I tried to do some using --proxy1.0 and some updated to do CONNECT 1.1 to get both versions run.
2009-01-28- Markus Moeller introduced two new options to libcurl:Daniel Stenberg
CURLOPT_SOCKS5_GSSAPI_SERVICE and CURLOPT_SOCKS5_GSSAPI_NEC to allow libcurl to do GSS-style authentication with SOCKS5 proxies. The curl tool got the options called --socks5-gssapi-service and --socks5-gssapi-nec to enable these.
2009-01-25- Craig A West brought CURLOPT_NOPROXY and the corresponding --noproxy option.Daniel Stenberg
They basically offer the same thing the NO_PROXY environment variable only offered previously: list a set of host names that shall not use the proxy even if one is specified.
2008-12-22- Anthony Bryan provided a set of patches that cleaned up manual language,Daniel Stenberg
corrected spellings and more.
2008-10-29--ftp-method was added in 7.15.1. This mention ends up a bit oddly formattedDaniel Stenberg
but I'm not in the mood to fight nroff right now...
2008-10-09Update docs now that SFTP supports file ranges.Dan Fandrich
2008-09-10Checked in some grammatical and minor other fixes in the documentation andDan Fandrich
examples that I found in the FreeBSD ports system.
2008-09-09Mike Revi discovered some swapped speed switches documented in the curl manDan Fandrich
page.
2008-09-05- Martin Drasar provided the CURLOPT_POSTREDIR patch. It renamesDaniel Stenberg
CURLOPT_POST301 (but adds a define for backwards compatibility for you who don't define CURL_NO_OLDIES). This option allows you to now also change the libcurl behavior for a HTTP response 302 after a POST to not use GET in the subsequent request (when CURLOPT_FOLLOWLOCATION is enabled). I edited the patch somewhat before commit. The curl tool got a matching --post302 option. Test case 1076 was added to verify this.
2008-08-20the .netrc curl checks for is called _netrc on windows bug report #2061610Daniel Stenberg
2008-08-20Added an edited version of Vincent Le Normand's documentation of SFTP quoteDan Fandrich
commands to the man pages.
2008-08-01Added support for --append on SFTP uploads. Unfortunately, OpenSSH doesn'tDan Fandrich
support this so it goes untested.
2008-07-30- Made the curl tool's -w option support the %{ssl_verify_result} variableDaniel Stenberg
2008-07-11document the exit codes 82 and 83 that are new in 7.19.0Daniel Stenberg
2008-07-10s/muse/mustDaniel Stenberg
2008-07-10document --remote-name-allDaniel Stenberg
2008-07-03Introcuding a new timestamp for curl_easy_getinfo():Daniel Stenberg
CURLINFO_APPCONNECT_TIME. This is set with the "application layer" handshake/connection is completed (typically SSL, TLS or SSH). By using this you can figure out the application layer's own connect time. You can extract the time stamp using curl's -w option and the new variable named 'time_appconnect'. This feature was sponsored by Lenny Rachitsky at NeuStar.
2008-06-08the next release is now called 7.19.0Daniel Stenberg
2008-06-08- curl the tool now deals with its command line options somewhat differently!Daniel Stenberg
All boolean options (such as -O, -I, -v etc), both short and long versions, now always switch on/enable the option named. Using the same option multiple times thus make no difference. To switch off one of those options, you need to use the long version of the option and type --no-OPTION. Like to disable verbose mode you use --no-verbose! - Added --remote-name-all to curl, which if used changes the default for all given URLs to be dealt with as if -O is used. So if you want to disable that for a specific URL after --remote-name-all has been used, you muse use -o - or --no-remote-name.
2008-04-30- To make it easier for applications that want lots of magic stuff done onDaniel Stenberg
redirections and thus cannot use CURLOPT_FOLLOWLOCATION easily, we now introduce the new CURLINFO_REDIRECT_URL option that lets applications extract the URL libcurl would've redirected to if it had been told to. This then enables the application to continue to that URL as it thinks is suitable, without having to re-implement the magic of creating the new URL from the Location: header etc. Test 1029 verifies it.
2008-03-13--ftp-create-dirs works on SFTP as wellDan Fandrich
2008-02-18just mention in --cacert that curl normally has a default ca cert path built-inDaniel Stenberg
2008-01-25using anyauth isn't unconditionally an extra roundtripDaniel Stenberg
2008-01-15Michal Marek's improved .curlrc syntax descriptionDaniel Stenberg
2008-01-12Eric Landes provided the patch (edited by me) that introduces theDaniel Stenberg
--keepalive-time to curl to set the keepalive probe interval. I also took the opportunity to rename the recently added no-keep-alive option to no-keepalive to keep a consistent naming and to avoid getting two dashes in these option names. Eric also provided an update to the man page for the new option.
2008-01-11Daniel Egger made CURLOPT_RANGE work on file:// URLs the very same way itDaniel Stenberg
already worked for FTP:// URLs
2008-01-08Introducing curl_easy_pause() and new magic return codes for both the readDaniel Stenberg
and the write callbacks that now can make a connection's reading and/or writing get paused.
2008-01-05Based on further discussion on curl-library, I reverted yesterday's SOCKS5Daniel Stenberg
code to instead introduce support for a new proxy type called CURLPROXY_SOCKS5_HOSTNAME that is used to send the host name to the proxy instead of IP address and there's thus no longer any need for a new curl_easy_setopt() option. The default SOCKS5 proxy is again back to sending the IP address to the proxy. The new curl command line option for enabling sending host name to a SOCKS5 proxy is now --socks5-hostname.
2008-01-04Based on Maxim Perenesenko's patch, we now do SOCKS5 operations and let theDaniel Stenberg
proxy do the host name resolving and only if --socks5ip (or CURLOPT_SOCKS5_RESOLVE_LOCAL) is used we resolve the host name locally and pass on the IP address only to the proxy.
2008-01-02Richard Atterer brought a patch that added support for SOCKS4a proxies, whichDaniel Stenberg
is an inofficial PROXY4 variant that sends the hostname to the proxy instead of the resolved address (which is already supported by SOCKS5). --socks4a is the curl command line option for it and CURLOPT_PROXYTYPE can now be set to CURLPROXY_SOCKS4A as well.
2007-12-27--libcurl was added in 7.16.1, a useful informationDaniel Stenberg
2007-12-14-u addition: If you just give the user name (without entering a colon) curlDaniel Stenberg
will prompt for a password. Denis Bredelet pointed out!
2007-12-12Gilles Blanc made the curl tool enable SO_KEEPALIVE for the connections andDaniel Stenberg
added the --no-keep-alive option that can disable that on demand.
2007-11-22Alessandro Vesely helped me improve the --data-urlencode's syntax, parserDaniel Stenberg
and documentation.
2007-11-20rephrasedDaniel Stenberg
2007-11-20Introuced --data-urlencode to the curl tool for easier url encoding of theDaniel Stenberg
data sent in a post.
2007-10-13Chris Leighton:Daniel Stenberg
My understanding is that we use "number" for discrete variables and "amount" for continuous variables. So you can say "The amount of flour required depends on..." or, "Last night I consumed a large amount of beer!". And, "That tank contains a large number of fish" or, "Over the week I consumed a number of cases of beer." I think that features are discrete, so the man page would read "...the number of features will make your head spin!".
2007-10-09Documented error codes 77-80, and fixed the one for 60.Dan Fandrich
2007-10-09Michal Marek removed the no longer existing return codes from the curl.1Daniel Stenberg
man page.
2007-10-03I renamed the CURLE_SSL_PEER_CERTIFICATE error code toDaniel Stenberg
CURLE_PEER_FAILED_VERIFICATION (standard CURL_NO_OLDIES style), and made this return code get used by the previous SSH MD5 fingerprint check in case it fails.
2007-10-03Based on a patch brought by Johnny Luong, libcurl now offersDaniel Stenberg
CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 and the curl tool --hostpubmd5. They both make the SCP or SFTP connection verify the remote host's md5 checksum of the public key before doing a connect, to reduce the risk of a man-in-the-middle attack.
2007-10-02document --post301, based on the phrasing in curl_easy_setopt.3 forDaniel Stenberg
CURLOPT_POST301 written by Philip Langdale