Loading docs/curl.1 +28 −27 Original line number Diff line number Diff line Loading @@ -2,7 +2,7 @@ .\" 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. Loading Loading @@ -94,11 +94,12 @@ If this option is used twice, the second one will disable ASCII usage. .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 Loading @@ -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. 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 Loading @@ -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. 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 Loading @@ -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 --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) Loading @@ -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 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 Loading @@ -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 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 Loading @@ -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 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 Loading Loading @@ -256,7 +257,7 @@ name, IP address or host name. An example could look like: .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 Loading @@ -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 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 Loading Loading @@ -307,7 +308,7 @@ See also the .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" Loading Loading @@ -385,7 +386,7 @@ i.e "my.host.domain" to specify machine (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 Loading Loading @@ -444,7 +445,7 @@ document. 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. Loading @@ -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 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. Loading Loading @@ -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. .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. Loading @@ -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 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 Loading @@ -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 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. Loading @@ -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 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 Loading Loading
docs/curl.1 +28 −27 Original line number Diff line number Diff line Loading @@ -2,7 +2,7 @@ .\" 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. Loading Loading @@ -94,11 +94,12 @@ If this option is used twice, the second one will disable ASCII usage. .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 Loading @@ -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. 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 Loading @@ -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. 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 Loading @@ -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 --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) Loading @@ -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 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 Loading @@ -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 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 Loading @@ -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 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 Loading Loading @@ -256,7 +257,7 @@ name, IP address or host name. An example could look like: .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 Loading @@ -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 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 Loading Loading @@ -307,7 +308,7 @@ See also the .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" Loading Loading @@ -385,7 +386,7 @@ i.e "my.host.domain" to specify machine (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 Loading Loading @@ -444,7 +445,7 @@ document. 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. Loading @@ -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 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. Loading Loading @@ -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. .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. Loading @@ -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 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 Loading @@ -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 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. Loading @@ -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 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 Loading
