.\" nroff -man curl.1
.\" Written by Daniel Stenberg
.\"
-.TH curl 1 "24 March 2001" "Curl 7.7" "Curl Manual"
+.TH curl 1 "20 April 2001" "Curl 7.7.2" "Curl Manual"
.SH NAME
curl \- get a URL with FTP, TELNET, LDAP, GOPHER, DICT, FILE, HTTP or
HTTPS syntax.
.IP "--connect-timeout <seconds>"
Maximum time in seconds that you allow the connection to the server to take.
This only limits the connection phase, once curl has connected this option is
-of no more use. This option doesn't work in win32 systems. See also the
+of no more use. This option didn't work in win32 systems until 7.7.2. See
+also the
.I "--max-time"
option.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-c/--continue"
.B Deprecated. Use '-C -' instead.
Continue/Resume a previous file transfer. This instructs curl to
curl. Upload resume is for FTP only.
HTTP resume is only possible with HTTP/1.1 or later servers.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-d/--data <data>"
(HTTP) Sends the specified data in a POST request to the HTTP server, in a way
that can emulate as if a user has filled in a HTML form and pressed the submit
-d/--data is the same as --data-ascii.
-If this option is used serveral times, the ones following the first will
+If this option is used several times, the ones following the first will
append data.
.IP "--data-ascii <data>"
(HTTP) This is an alias for the -d/--data option.
-If this option is used serveral times, the ones following the first will
+If this option is used several times, the ones following the first will
append data.
.IP "--data-binary <data>"
(HTTP) This posts data in a similar manner as --data-ascii does, although when
want to post a binary file without the strip-newlines feature of the
--data-ascii option, this is for you.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
-If this option is used serveral times, the ones following the first will
+If this option is used several times, the ones following the first will
append data.
.IP "-D/--dump-header <file>"
(HTTP/FTP)
site sends to you. The cookies could then be read in a second curl invoke by
using the -b/--cookie option!
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-e/--referer <URL>"
(HTTP) Sends the "Referer Page" information to the HTTP server. This can also
be set with the -H/--header flag of course. When used with
previous URL when it follows a Location: header. The ";auto" string can be
used alone, even if you don't set an initial referer.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "--egd-file <file>"
(HTTPS) Specify the path name to the Entropy Gathering Daemon socket. The
socket is used to seed the random engine for SSL connections. See also the
the terminal. Note that this certificate is the private key and the private
certificate concatenated!
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "--cacert <CA certificate>"
(HTTPS) Tells curl to use the specified certificate file to verify the
peer. The certificate must be in PEM format.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-f/--fail"
(HTTP)
Fail silently (no output at all) on server errors. This is mostly done
.B "curl --interface eth0:1 http://www.netscape.com/"
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-I/--head"
(HTTP/FTP)
Fetch the HTTP-header only! HTTP-servers feature the command HEAD
should be one of 'clear', 'safe', 'confidential' or 'private'. Should you use
a level that is not one of these, 'private' will instead be used.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-K/--config <config file>"
Specify which config file to read curl arguments from. The config file is a
text file in which command line arguments can be written which then will be
.I "--connect-timeout"
option.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-M/--manual"
Manual. Display the huge help text.
.IP "-n/--netrc"
(any single-letter string) to make it pick the machine's default
.RE
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-q"
If used as the first parameter on the command line, the
.I $HOME/.curlrc
FTP range downloads only support the simple syntax 'start-stop' (optionally
with one of the numbers omitted). It depends on the non-RFC command SIZE.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-s/--silent"
Silent mode. Don't show progress meter or error messages. Makes
Curl mute.
use. That will most likely cause the upload operation to fail. If
this is used on a http(s) server, the PUT command will be used.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-u/--user <user:password>"
Specify user and password to use when fetching. See README.curl for detailed
examples of how to use this. If no password is specified, curl will
ask for it interactively.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-U/--proxy-user <user:password>"
Specify user and password to use for Proxy authentication. If no
password is specified, curl will ask for it interactively.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "--url <URL>"
Specify a URL to fetch. This option is mostly handy when you wanna specify
URL(s) in a config file.
The average upload speed that curl measured for the complete upload.
.RE
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-x/--proxy <proxyhost[:port]>"
Use specified proxy. If the port number is not specified, it is assumed at
port 1080.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-X/--request <command>"
(HTTP)
Specifies a custom request to use when communicating with the HTTP server.
Specifies a custom FTP command to use instead of LIST when doing file lists
with ftp.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-y/--speed-time <time>"
If a download is slower than speed-limit bytes per second during a speed-time
period, the download gets aborted. If speed-time is used, the default
speed-limit will be 1 unless set with -y.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-Y/--speed-limit <speed>"
If a download is slower than this given speed, in bytes per second, for
speed-time seconds it gets aborted. speed-time is set with -Y and is 30 if
not set.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-z/--time-cond <date expression>"
(HTTP)
Request to get a file that has been modified later than the given time and
that is older than the given date/time, default is a document that is newer
than the specified date/time.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.IP "-3/--sslv3"
(HTTPS)
Forces curl to use SSL version 3 when negotiating with a remote SSL server.
is a plain '-', it is instead written to stdout. This option has no point when
you're using a shell with decent redirecting capabilities.
-If this option is used serveral times, the last one will be used.
+If this option is used several times, the last one will be used.
.SH FILES
.I ~/.curlrc
.RS