@@ -75,6 +75,11 @@ puts (
" format of the file to read cookies from should be plain \n " " format of the file to read cookies from should be plain \n "
" HTTP headers or the netscape cookie file format. \n " " HTTP headers or the netscape cookie file format. \n "
" \n " " \n "
" NOTE that the file specified with -b/--cookie is only \n "
" used as input. No cookies will be stored in the file. \n "
" To store cookies, save the HTTP headers to a file using \n "
" -D/--dump-header! \n "
" \n "
" -B/--ftp-ascii \n " " -B/--ftp-ascii \n "
" (FTP/LDAP) Use ASCII transfer when getting an FTP file \n " " (FTP/LDAP) Use ASCII transfer when getting an FTP file \n "
" or LDAP info. For FTP, this can also be enforced by \n " " or LDAP info. For FTP, this can also be enforced by \n "
@@ -118,6 +123,11 @@ puts (
" (HTTP/FTP) Write the HTTP headers to this file. Write \n " " (HTTP/FTP) Write the HTTP headers to this file. Write \n "
" the FTP file info to this file if -I/--head is used. \n " " the FTP file info to this file if -I/--head is used. \n "
" \n " " \n "
" This option is handy to use when you want to store the \n "
" cookies that a HTTP site sends to you. The cookies \n "
" could then be read in a second curl invoke by using the \n "
" -b/--cookie option! \n "
" \n "
" -e/--referer <URL> \n " " -e/--referer <URL> \n "
" (HTTP) Sends the \" Referer Page \" information to the HTTP \n " " (HTTP) Sends the \" Referer Page \" information to the HTTP \n "
" server. Some badly done CGIs fail if it's not set. This \n " " server. Some badly done CGIs fail if it's not set. This \n "
@@ -153,7 +163,6 @@ puts (
" /etc/passwd will be the input: \n " " /etc/passwd will be the input: \n "
" \n " " \n "
" curl -F password=@/etc/passwd www.mypasswords.com \n " " curl -F password=@/etc/passwd www.mypasswords.com \n "
" \n "
" To read the file's content from stdin insted of a file, \n " " To read the file's content from stdin insted of a file, \n "
" use - where the file name should've been. \n " " use - where the file name should've been. \n "
" \n " " \n "
@@ -214,6 +223,7 @@ puts (
" jobs from hanging for hours due to slow networks or \n " " jobs from hanging for hours due to slow networks or \n "
" links going down. This doesn't work properly in win32 \n " " links going down. This doesn't work properly in win32 \n "
" systems. \n " " systems. \n "
" \n "
" -M/--manual \n " " -M/--manual \n "
" Manual. Display the huge help text. \n " " Manual. Display the huge help text. \n "
" \n " " \n "
@@ -233,10 +243,18 @@ puts (
" \n " " \n "
" machine host.domain.com user myself password secret \n " " machine host.domain.com user myself password secret \n "
" \n " " \n "
" -N/--no-buffer \n "
" Disables the buffering of the output stream. In normal \n "
" work situations, curl will use a standard buffered out<75> \n "
" put stream that will have the effect that it will out<75> \n "
" put the data in chunks, not necessarily exactly when \n "
" the data arrives. Using this option will disable that \n "
" buffering. \n "
" \n "
" -o/--output <file> \n " " -o/--output <file> \n "
" Write output to <file> instead of stdout. If you are \n " " Write output to <file> instead of stdout. If you are \n "
" using {} or [] to fetch multiple documents, you can use \n " " using {} or [] to fetch multiple documents, you can use \n "
" #< num> in the <file> specifier. That variable will be \n " " #[ num] in the <file> specifier. That variable will be \n "
" replaced with the current string for the URL being \n " " replaced with the current string for the URL being \n "
" fetched. Like in: \n " " fetched. Like in: \n "
" \n " " \n "
@@ -252,19 +270,24 @@ puts (
" the path is cut off.) \n " " the path is cut off.) \n "
" \n " " \n "
" -P/--ftpport <address> \n " " -P/--ftpport <address> \n "
" (FTP) Reverses the initiator/listeno r roles when con<EFBFBD> \n " " (FTP) Reverses the initiator/listene r roles when con<6F> \n "
" necting with ftp. This switch makes Curl use the PORT \n " " necting with ftp. This switch makes Curl use the PORT \n "
" command instead of PASV. In practice, PORT tells the \n " " command instead of PASV. In practice, PORT tells the \n "
" server to connect to the client's specified address and \n " " server to connect to the client's specified address and \n "
" port, while PASV asks the server for an ip address and \n " " port, while PASV asks the server for an ip address and \n "
" port to connect to. <address> should be one of: \n " " port to connect to. <address> should be one of: \n "
" interface - i.e \" eth0 \" to specify which interface's IP \n " " \n "
" interface i.e \" eth0 \" to specify which interface's IP \n "
" address you want to use (Unix only) \n " " address you want to use (Unix only) \n "
" IP address - i.e \" 192.168.10.1 \" to specify exact IP \n " " \n "
" number \n " " IP address i.e \" 192.168.10.1 \" to specify exact IP num<75> \n "
" host name - i.e \" my.host.domain \" to specify machine \n " " ber \n "
" \" - \" - (any single-letter string) to make it pick \n " " \n "
" host name i.e \" my.host.domain \" to specify machine \n "
" \n "
" - (any single-letter string) to make it pick \n "
" the machine's default \n " " the machine's default \n "
" \n "
" -q If used as the first parameter on the command line, the \n " " -q If used as the first parameter on the command line, the \n "
" $HOME/.curlrc file will not be read and used as a con<6F> \n " " $HOME/.curlrc file will not be read and used as a con<6F> \n "
" fig file. \n " " fig file. \n "
@@ -285,28 +308,33 @@ puts (
" (HTTP/FTP) Retrieve a byte range (i.e a partial docu<63> \n " " (HTTP/FTP) Retrieve a byte range (i.e a partial docu<63> \n "
" ment) from a HTTP/1.1 or FTP server. Ranges can be \n " " ment) from a HTTP/1.1 or FTP server. Ranges can be \n "
" specified in a number of ways. \n " " specified in a number of ways. \n "
" 0-499 - specifies the first 500 bytes \n "
" 500-999 - specifies the second 500 bytes \n "
" -500 - specifies the last 500 bytes \n "
" 9500- - specifies the bytes from offset 9500 \n "
" and forward \n "
" 0-0,-1 - specifies the first and last byte \n "
" only(*)(H) \n "
" 500-700,600-799 - specifies 300 bytes from offset \n "
" 500(H) \n "
" 100-199,500-599 - specifies two separate 100 bytes \n "
" ranges(*)(H) \n "
" \n " " \n "
" (*) = NOTE that this will cause the server to reply \n " " 0-499 specifies the first 500 bytes \n "
" with a multipart response! \n "
" \n " " \n "
" You should also be aware that many HTTP/1.1 servers do \n " " 500-999 specifies the second 500 bytes \n "
" not have this feature enabled, so that when you attempt \n "
" to get a range, you'll instead get the whole document. \n "
" \n " " \n "
" FTP range downloads only support the simple syntax \n " " -500 specifies the last 500 bytes \n "
" 'start-stop' (optionally with one of the numbers omit<69> \n " " \n "
" ted). It depends on the non-RFC command SIZE. \n " " 9500 specifies the bytes from offset 9500 and for<6F> \n "
" ward \n "
" \n "
" 0-0,-1 specifies the first and last byte only(*)(H) \n "
" 500-700,600-799 \n "
" specifies 300 bytes from offset 500(H) \n "
" \n "
" 100-199,500-599 \n "
" specifies two separate 100 bytes ranges(*)(H) \n "
" \n "
" (*) = NOTE that this will cause the server to reply with a \n "
" multipart response! \n "
" \n "
" You should also be aware that many HTTP/1.1 servers do not \n "
" have this feature enabled, so that when you attempt to get a \n "
" range, you'll instead get the whole document. \n "
" \n "
" FTP range downloads only support the simple syntax 'start- \n "
" stop' (optionally with one of the numbers omitted). It \n "
" depends on the non-RFC command SIZE. \n "
" \n " " \n "
" -s/--silent \n " " -s/--silent \n "
" Silent mode. Don't show progress meter or error mes<65> \n " " Silent mode. Don't show progress meter or error mes<65> \n "
@@ -343,7 +371,6 @@ puts (
" Specify user and password to use for Proxy authentica<63> \n " " Specify user and password to use for Proxy authentica<63> \n "
" tion. If no password is specified, curl will ask for it \n " " tion. If no password is specified, curl will ask for it \n "
" interactively. \n " " interactively. \n "
" \n "
" -v/--verbose \n " " -v/--verbose \n "
" Makes the fetching more verbose/talkative. Mostly \n " " Makes the fetching more verbose/talkative. Mostly \n "
" usable for debugging. Lines starting with '>' means \n " " usable for debugging. Lines starting with '>' means \n "
@@ -355,6 +382,66 @@ puts (
" Displays the full version of curl, libcurl and other \n " " Displays the full version of curl, libcurl and other \n "
" 3rd party libraries linked with the executable. \n " " 3rd party libraries linked with the executable. \n "
" \n " " \n "
" -w/--write-out <format> \n "
" Defines what to display after a completed and success<73> \n "
" ful operation. The format is a string that may contain \n "
" plain text mixed with any number of variables. The \n "
" string can be specified as \" string \" , to get read from a \n "
" particular file you specify it \" @filename \" and to tell \n "
" curl to read the format from stdin you write \" @- \" . \n "
" \n "
" The variables present in the output format will be sub<75> \n "
" stituted by the value or text that curl thinks fit, as \n "
" described below. All variables are specified like \n "
" %{variable_name} and to output a normal % you just \n "
" write them like %%. You can output a newline by using \n "
" \\ n, a carrige return with \\ r and a tab space with \\ t. \n "
" \n "
" NOTE: The %-letter is a special letter in the \n "
" win32-environment, where all occurrences of % must be \n "
" doubled when using this option. \n "
" \n "
" Available variables are at this point: \n "
" \n "
" url_effective The URL that was fetched last. This is \n "
" mostly meaningful if you've told curl to \n "
" follow location: headers. \n "
" \n "
" http_code The numerical code that was found in the \n "
" last retrieved HTTP(S) page. \n "
" \n "
" time_total The total time, in seconds, that the \n "
" full operation lasted. The time will be \n "
" displayed with millisecond resolution. \n "
" \n "
" time_namelookup \n "
" The time, in seconds, it took from the \n "
" start until the name resolving was com<6F> \n "
" pleted. \n "
" \n "
" time_connect The time, in seconds, it took from the \n "
" start until the connect to the remote \n "
" host (or proxy) was completed. \n "
" time_pretransfer \n "
" The time, in seconds, it took from the \n "
" start until the file transfer is just \n "
" about to begin. This includes all pre- \n "
" transfer commands and negotiations that \n "
" are specific to the particular proto<74> \n "
" col(s) involved. \n "
" \n "
" size_download The total amount of bytes that were \n "
" downloaded. \n "
" \n "
" size_upload The total amount of bytes that were \n "
" uploaded. \n "
" \n "
" speed_download The average download speed that curl \n "
" measured for the complete download. \n "
" \n "
" speed_upload The average upload speed that curl mea<65> \n "
" sured for the complete download. \n "
" \n "
" -x/--proxy <proxyhost[:port]> \n " " -x/--proxy <proxyhost[:port]> \n "
" Use specified proxy. If the port number is not speci<63> \n " " Use specified proxy. If the port number is not speci<63> \n "
" fied, it is assumed at port 1080. \n " " fied, it is assumed at port 1080. \n "
@@ -368,17 +455,16 @@ puts (
" (FTP) Specifies a custom FTP command to use instead of \n " " (FTP) Specifies a custom FTP command to use instead of \n "
" LIST when doing file lists with ftp. \n " " LIST when doing file lists with ftp. \n "
" \n " " \n "
" -y/--speed-time <speed > \n " " -y/--speed-time <time > \n "
" Speed Limit. If a download is slower than this given \n " " If a download is slower than speed-limit bytes per sec<65> \n "
" speed, in bytes per second, for Speed Time seconds it \n " " ond during a speed-time period, the download gets \n "
" gets aborted. S peed T ime is set with -Y and is 30 if \n " " aborted. If s peed-t ime is u sed, the default speed-limit \n "
" not set . \n " " will be 1 unless set with -y . \n "
" \n " " \n "
" -Y/--speed-limit <time > \n " " -Y/--speed-limit <speed > \n "
" Speed Time. If a download is slower than Speed Limit \n " " If a download is slower than this given speed, in bytes \n "
" bytes per second during a S peed T ime period, the down<77> \n " " per second, for s peed-t ime seconds it gets aborted. \n "
" load gets aborted. If S peed T ime is u sed, the default \n " " s peed-t ime is set with -Y and is 30 if not set. \n "
" Speed Limit will be 1 unless set with -y. \n "
" \n " " \n "
" -z/--time-cond <date expression> \n " " -z/--time-cond <date expression> \n "
" (HTTP) Request to get a file that has been modified \n " " (HTTP) Request to get a file that has been modified \n "
@@ -388,7 +474,6 @@ puts (
" internal ones, it tries to get the time from a given \n " " internal ones, it tries to get the time from a given \n "
" file name instead! See the GNU date(1) man page for \n " " file name instead! See the GNU date(1) man page for \n "
" date expression details. \n " " date expression details. \n "
" \n "
" Start the date expression with a dash (-) to make it \n " " Start the date expression with a dash (-) to make it \n "
" request for a document that is older than the given \n " " request for a document that is older than the given \n "
" date/time, default is a document that is newer than the \n " " date/time, default is a document that is newer than the \n "
@@ -419,6 +504,7 @@ puts (
" FILES \n " " FILES \n "
" ~/.curlrc \n " " ~/.curlrc \n "
" Default config file. \n " " Default config file. \n "
" \n "
" ENVIRONMENT \n " " ENVIRONMENT \n "
" HTTP_PROXY [protocol://]<host>[:port] \n " " HTTP_PROXY [protocol://]<host>[:port] \n "
" Sets proxy server to use for HTTP. \n " " Sets proxy server to use for HTTP. \n "
@@ -439,7 +525,6 @@ puts (
" NO_PROXY <comma-separated list of hosts> \n " " NO_PROXY <comma-separated list of hosts> \n "
" list of host names that shouldn't go through any proxy. \n " " list of host names that shouldn't go through any proxy. \n "
" If set to a asterisk '*' only, it matches all hosts. \n " " If set to a asterisk '*' only, it matches all hosts. \n "
" \n "
" COLUMNS <integer> \n " " COLUMNS <integer> \n "
" The width of the terminal. This variable only affects \n " " The width of the terminal. This variable only affects \n "
" curl when the --progress-bar option is used. \n " " curl when the --progress-bar option is used. \n "
@@ -471,6 +556,7 @@ puts (
" couldn't parse. \n " " couldn't parse. \n "
" \n " " \n "
" 9 FTP access denied. The server denied login. \n " " 9 FTP access denied. The server denied login. \n "
" \n "
" 10 FTP user/password incorrect. Either one or both were \n " " 10 FTP user/password incorrect. Either one or both were \n "
" not accepted by the server. \n " " not accepted by the server. \n "
" \n " " \n "
@@ -491,7 +577,6 @@ puts (
" \n " " \n "
" 16 FTP can't reconnect. Couldn't connect to the host we \n " " 16 FTP can't reconnect. Couldn't connect to the host we \n "
" got in the 227-line. \n " " got in the 227-line. \n "
" \n "
" 17 FTP couldn't set binary. Couldn't change transfer \n " " 17 FTP couldn't set binary. Couldn't change transfer \n "
" method to binary. \n " " method to binary. \n "
" \n " " \n "
@@ -522,6 +607,7 @@ puts (
" \n " " \n "
" 28 Operation timeout. The specified time-out period was \n " " 28 Operation timeout. The specified time-out period was \n "
" reached according to the conditions. \n " " reached according to the conditions. \n "
" \n "
" 29 FTP couldn't set ASCII. The server returned an unknown \n " " 29 FTP couldn't set ASCII. The server returned an unknown \n "
" reply. \n " " reply. \n "
" \n " " \n "
@@ -542,7 +628,6 @@ puts (
" \n " " \n "
" 36 FTP bad download resume. Couldn't continue an earlier \n " " 36 FTP bad download resume. Couldn't continue an earlier \n "
" aborted download. \n " " aborted download. \n "
" \n "
" 37 FILE couldn't read file. Failed to open the file. Per<65> \n " " 37 FILE couldn't read file. Failed to open the file. Per<65> \n "
" missions? \n " " missions? \n "
" \n " " \n "
@@ -597,6 +682,11 @@ puts (
" - Dan Zitter <dzitter@zitter.net> \n " " - Dan Zitter <dzitter@zitter.net> \n "
" - Jongki Suwandi <Jongki.Suwandi@eng.sun.com> \n " " - Jongki Suwandi <Jongki.Suwandi@eng.sun.com> \n "
" - Chris Maltby <chris@aurema.com> \n " " - Chris Maltby <chris@aurema.com> \n "
" - Ron Zapp <rzapper@yahoo.com> \n "
" - Paul Marquis <pmarquis@iname.com> \n "
" - Ellis Pritchard <ellis@citria.com> \n "
" - Damien Adant <dams@usa.net> \n "
" - Chris <cbayliss@csc.come> \n "
" \n " " \n "
" WWW \n " " WWW \n "
" http://curl.haxx.nu \n " " http://curl.haxx.nu \n "
@@ -921,27 +1011,32 @@ puts (
" \n " " \n "
" PROGRESS METER \n " " PROGRESS METER \n "
" \n " " \n "
" The progress meter was introduced to better show a user that something \n " " The progress meter exists to show a user that something actually is \n "
" actually is happening. The different fields in the output have the following \n " " happening. The different fields in the output have the following meaning: \n "
" meaning: \n "
" \n " " \n "
" % Received Total Speed Time left Total Curr.Speed \n " " % Total % Received % Xferd Average Speed Time Curr. \n "
" 13 524140 3841536 4296 0:12:52 0:14:54 292 \n " " Dload Upload Total Current Left Speed \n "
" 0 151M 0 38608 0 0 9406 0 4:41:43 0:00:04 4:41:39 9287 \n "
" \n " " \n "
" From left-to-right: \n " " From left-to-right: \n "
" - The first column, is the percentage of the file currently transfered. \n " " % - percentage completed of the whole transfer \n "
" - Received means the total number of bytes that has been transfered. \n " " Total - total size of the whole expected transfer \n "
" - Total is the total number of bytes expected to transfer. \n " " % - percentage completed of the download \n "
" - Speed is average speed in bytes per second for the whole transfer so far. \n " " Received - currently downloaded amount of bytes \n "
" - Time left is the estimated time left for this transfer to finnish if the \n " " % - percentage completed of the upload \n "
" current average speed will remain steady. \n " " Xferd - currently uploaded amount of bytes \n "
" - Total is the estimated total transfer time. \n " " Average Speed \n "
" - Curr.Speed is the average transfer speed the last 5 seconds (the first \n " " Dload - the average transfer speed of the download \n "
" Average Speed \n "
" Upload - the average transfer speed of the upload \n "
" Time Total - expected time to complete the operation \n "
" Time Current - time passed since the invoke \n "
" Time Left - expected time left to completetion \n "
" Curr.Speed - the average transfer speed the last 5 seconds (the first \n "
" 5 seconds of a transfer is based on less time of course.) \n " " 5 seconds of a transfer is based on less time of course.) \n "
" \n " " \n "
" NOTE: Much of the output is based on the fact that the size of the transfer \n " " The -# option will display a totally different progress bar that doesn't \n "
" is known before it takes place. If it isn't, a much less fancy display will \n " " need much explanation! \n "
" be used. \n "
" \n " " \n "
" SPEED LIMIT \n " " SPEED LIMIT \n "
" \n " " \n "
Daniel Stenberg