1
0
mirror of https://github.com/moparisthebest/curl synced 2025-01-03 18:08:02 -05:00

minor corrections

This commit is contained in:
Daniel Stenberg 2001-04-20 06:05:33 +00:00
parent a508e73a8d
commit 97ad165a63

View File

@ -2,7 +2,7 @@
.\" nroff -man curl.1 .\" nroff -man curl.1
.\" Written by Daniel Stenberg .\" 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 .SH NAME
curl \- get a URL with FTP, TELNET, LDAP, GOPHER, DICT, FILE, HTTP or curl \- get a URL with FTP, TELNET, LDAP, GOPHER, DICT, FILE, HTTP or
HTTPS syntax. HTTPS syntax.
@ -94,11 +94,12 @@ If this option is used twice, the second one will disable ASCII usage.
.IP "--connect-timeout <seconds>" .IP "--connect-timeout <seconds>"
Maximum time in seconds that you allow the connection to the server to take. 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 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" .I "--max-time"
option. 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" .IP "-c/--continue"
.B Deprecated. Use '-C -' instead. .B Deprecated. Use '-C -' instead.
Continue/Resume a previous file transfer. This instructs curl to Continue/Resume a previous file transfer. This instructs curl to
@ -117,7 +118,7 @@ If used with uploads, the ftp server command SIZE will not be used by
curl. Upload resume is for FTP only. curl. Upload resume is for FTP only.
HTTP resume is only possible with HTTP/1.1 or later servers. 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>" .IP "-d/--data <data>"
(HTTP) Sends the specified data in a POST request to the HTTP server, in a way (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 that can emulate as if a user has filled in a HTML form and pressed the submit
@ -139,12 +140,12 @@ To post data purely binary, you should instead use the --data-binary option.
-d/--data is the same as --data-ascii. -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. append data.
.IP "--data-ascii <data>" .IP "--data-ascii <data>"
(HTTP) This is an alias for the -d/--data option. (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. append data.
.IP "--data-binary <data>" .IP "--data-binary <data>"
(HTTP) This posts data in a similar manner as --data-ascii does, although when (HTTP) This posts data in a similar manner as --data-ascii does, although when
@ -152,9 +153,9 @@ using this option the entire context of the posted data is kept as-is. If you
want to post a binary file without the strip-newlines feature of the want to post a binary file without the strip-newlines feature of the
--data-ascii option, this is for you. --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. append data.
.IP "-D/--dump-header <file>" .IP "-D/--dump-header <file>"
(HTTP/FTP) (HTTP/FTP)
@ -165,7 +166,7 @@ This option is handy to use when you want to store the cookies that a HTTP
site sends to you. The cookies could then be read in a second curl invoke by site sends to you. The cookies could then be read in a second curl invoke by
using the -b/--cookie option! 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>" .IP "-e/--referer <URL>"
(HTTP) Sends the "Referer Page" information to the HTTP server. This can also (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 be set with the -H/--header flag of course. When used with
@ -174,7 +175,7 @@ you can append ";auto" to the referer URL to make curl automatically set the
previous URL when it follows a Location: header. The ";auto" string can be previous URL when it follows a Location: header. The ";auto" string can be
used alone, even if you don't set an initial referer. 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>" .IP "--egd-file <file>"
(HTTPS) Specify the path name to the Entropy Gathering Daemon socket. The (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 socket is used to seed the random engine for SSL connections. See also the
@ -188,12 +189,12 @@ If the optional password isn't specified, it will be queried for on
the terminal. Note that this certificate is the private key and the private the terminal. Note that this certificate is the private key and the private
certificate concatenated! 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>" .IP "--cacert <CA certificate>"
(HTTPS) Tells curl to use the specified certificate file to verify the (HTTPS) Tells curl to use the specified certificate file to verify the
peer. The certificate must be in PEM format. 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" .IP "-f/--fail"
(HTTP) (HTTP)
Fail silently (no output at all) on server errors. This is mostly done Fail silently (no output at all) on server errors. This is mostly done
@ -256,7 +257,7 @@ name, IP address or host name. An example could look like:
.B "curl --interface eth0:1 http://www.netscape.com/" .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" .IP "-I/--head"
(HTTP/FTP) (HTTP/FTP)
Fetch the HTTP-header only! HTTP-servers feature the command HEAD Fetch the HTTP-header only! HTTP-servers feature the command HEAD
@ -269,7 +270,7 @@ If this option is used twice, the second will again disable header only.
should be one of 'clear', 'safe', 'confidential' or 'private'. Should you use 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. 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>" .IP "-K/--config <config file>"
Specify which config file to read curl arguments from. The config file is a 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 text file in which command line arguments can be written which then will be
@ -307,7 +308,7 @@ See also the
.I "--connect-timeout" .I "--connect-timeout"
option. 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" .IP "-M/--manual"
Manual. Display the huge help text. Manual. Display the huge help text.
.IP "-n/--netrc" .IP "-n/--netrc"
@ -385,7 +386,7 @@ i.e "my.host.domain" to specify machine
(any single-letter string) to make it pick the machine's default (any single-letter string) to make it pick the machine's default
.RE .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" .IP "-q"
If used as the first parameter on the command line, the If used as the first parameter on the command line, the
.I $HOME/.curlrc .I $HOME/.curlrc
@ -444,7 +445,7 @@ document.
FTP range downloads only support the simple syntax 'start-stop' (optionally 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. 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" .IP "-s/--silent"
Silent mode. Don't show progress meter or error messages. Makes Silent mode. Don't show progress meter or error messages. Makes
Curl mute. Curl mute.
@ -471,18 +472,18 @@ think that your last directory name is the remote file name to
use. That will most likely cause the upload operation to fail. If 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. 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>" .IP "-u/--user <user:password>"
Specify user and password to use when fetching. See README.curl for detailed 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 examples of how to use this. If no password is specified, curl will
ask for it interactively. 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>" .IP "-U/--proxy-user <user:password>"
Specify user and password to use for Proxy authentication. If no Specify user and password to use for Proxy authentication. If no
password is specified, curl will ask for it interactively. 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>" .IP "--url <URL>"
Specify a URL to fetch. This option is mostly handy when you wanna specify Specify a URL to fetch. This option is mostly handy when you wanna specify
URL(s) in a config file. URL(s) in a config file.
@ -565,12 +566,12 @@ The average download speed that curl measured for the complete download.
The average upload speed that curl measured for the complete upload. The average upload speed that curl measured for the complete upload.
.RE .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]>" .IP "-x/--proxy <proxyhost[:port]>"
Use specified proxy. If the port number is not specified, it is assumed at Use specified proxy. If the port number is not specified, it is assumed at
port 1080. 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>" .IP "-X/--request <command>"
(HTTP) (HTTP)
Specifies a custom request to use when communicating with the HTTP server. Specifies a custom request to use when communicating with the HTTP server.
@ -581,19 +582,19 @@ HTTP 1.1 specification for details and explanations.
Specifies a custom FTP command to use instead of LIST when doing file lists Specifies a custom FTP command to use instead of LIST when doing file lists
with ftp. 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>" .IP "-y/--speed-time <time>"
If a download is slower than speed-limit bytes per second during a speed-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 period, the download gets aborted. If speed-time is used, the default
speed-limit will be 1 unless set with -y. 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>" .IP "-Y/--speed-limit <speed>"
If a download is slower than this given speed, in bytes per second, for 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 speed-time seconds it gets aborted. speed-time is set with -Y and is 30 if
not set. 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>" .IP "-z/--time-cond <date expression>"
(HTTP) (HTTP)
Request to get a file that has been modified later than the given time and Request to get a file that has been modified later than the given time and
@ -609,7 +610,7 @@ Start the date expression with a dash (-) to make it request for a document
that is older than the given date/time, default is a document that is newer that is older than the given date/time, default is a document that is newer
than the specified date/time. 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" .IP "-3/--sslv3"
(HTTPS) (HTTPS)
Forces curl to use SSL version 3 when negotiating with a remote SSL server. Forces curl to use SSL version 3 when negotiating with a remote SSL server.
@ -630,7 +631,7 @@ Redirect all writes to stderr to the specified file instead. If the file name
is a plain '-', it is instead written to stdout. This option has no point when is a plain '-', it is instead written to stdout. This option has no point when
you're using a shell with decent redirecting capabilities. 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 .SH FILES
.I ~/.curlrc .I ~/.curlrc
.RS .RS