From 13962adcb55a676b0b47925680b2e17b3e4815f0 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Thu, 28 Sep 2000 10:26:44 +0000 Subject: 7.3 commit --- src/hugehelp.c | 298 ++++++++++++++++++++++++++++++++++----------------------- src/version.h | 2 +- 2 files changed, 178 insertions(+), 122 deletions(-) (limited to 'src') diff --git a/src/hugehelp.c b/src/hugehelp.c index c0ceebf6a..8b3de8780 100644 --- a/src/hugehelp.c +++ b/src/hugehelp.c @@ -87,15 +87,15 @@ puts ( " sent to stdout to be in text mode for win32 systems.\n" "\n" " -c/--continue\n" -" Continue/Resume a previous file transfer. This\n" -" instructs curl to continue appending data on the file\n" -" where it was previously left, possibly because of a\n" -" broken connection to the server. There must be a named\n" -" physical file to append to for this to work. Note:\n" -" Upload resume is depening on a command named SIZE not\n" -" always present in all ftp servers! Upload resume is for\n" -" FTP only. HTTP resume is only possible with HTTP/1.1\n" -" or later servers.\n" +" Deprecated. Use '-C -' instead. Continue/Resume a pre­\n" +" vious file transfer. This instructs curl to continue\n" +" appending data on the file where it was previously\n" +" left, possibly because of a broken connection to the\n" +" server. There must be a named physical file to append\n" +" to for this to work. Note: Upload resume is depening\n" +" on a command named SIZE not always present in all ftp\n" +" servers! Upload resume is for FTP only. HTTP resume is\n" +" only possible with HTTP/1.1 or later servers.\n" "\n" " -C/--continue-at \n" " Continue/Resume a previous file transfer at the given\n" @@ -214,20 +214,34 @@ puts ( " (HTTP) Include the HTTP-header in the output. The HTTP-\n" " header includes things like server-name, date of the\n" " document, HTTP-version and more...\n" +" --interface \n" +" Perform an operation using a specified interface. You\n" +" can enter interface name, IP address or host name. An\n" +" example could look like:\n" +"\n" +" curl --interface eth0:1 http://www.netscape.com/\n" +"\n" " -I/--head\n" " (HTTP/FTP) Fetch the HTTP-header only! HTTP-servers\n" " feature the command HEAD which this uses to get nothing\n" " but the header of a document. When used on a FTP file,\n" " curl displays the file size only.\n" "\n" +" --krb4 \n" +" (FTP) Enable kerberos4 authentication and use. The\n" +); + puts( +" level must be entered and should be one of 'clear',\n" +" 'safe', 'confidential' or 'private'. Should you use a\n" +" level that is not one of these, 'private' will instead\n" +" be used.\n" +"\n" " -K/--config \n" " Specify which config file to read curl arguments from.\n" " The config file is a text file in which command line\n" " arguments can be written which then will be used as if\n" " they were written on the actual command line. If the\n" " first column of a config line is a '#' character, the\n" -); - puts( " rest of the line will be treated as a comment.\n" "\n" " Specify the filename as '-' to make curl read the file\n" @@ -302,6 +316,15 @@ puts ( " we get. (Only the file part of the remote file is used,\n" " the path is cut off.)\n" "\n" +" -p/--proxytunnel\n" +" When an HTTP proxy is used, this option will cause non-\n" +" HTTP protocols to attempt to tunnel through the proxy\n" +" instead of merely using it to do HTTP-like operations.\n" +" The tunnel approach is made with the HTTP proxy CONNECT\n" +" request and requires that the proxy allows direct con­\n" +" nect to the remote port number curl wants to tunnel\n" +" through to.\n" +"\n" " -P/--ftpport
\n" " (FTP) Reverses the initiator/listener roles when con­\n" " necting with ftp. This switch makes Curl use the PORT\n" @@ -320,6 +343,7 @@ puts ( "\n" " - (any single-letter string) to make it pick\n" " the machine's default\n" +"\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­\n" " fig file.\n" @@ -347,8 +371,8 @@ puts ( "\n" " -500 specifies the last 500 bytes\n" "\n" -" 9500 specifies the bytes from offset 9500 and for­\n" -" ward\n" +" 9500 specifies the bytes from offset 9500 and\n" +" forward\n" "\n" " 0-0,-1 specifies the first and last byte only(*)(H)\n" "\n" @@ -372,146 +396,147 @@ puts ( " -s/--silent\n" " Silent mode. Don't show progress meter or error mes­\n" " sages. Makes Curl mute.\n" +"\n" " -S/--show-error\n" " When used with -s it makes curl show error message if\n" " it fails.\n" "\n" " -t/--upload\n" -" Transfer the stdin data to the specified file. Curl\n" -" will read everything from stdin until EOF and store\n" -" with the supplied name. If this is used on a http(s)\n" -" server, the PUT command will be used.\n" +" Deprecated. Use '-T -' instead. Transfer the stdin\n" +" data to the specified file. Curl will read everything\n" +" from stdin until EOF and store with the supplied name.\n" +" If this is used on a http(s) server, the PUT command\n" +" will be used.\n" "\n" " -T/--upload-file \n" -" Like -t, but this transfers the specified local file.\n" -" If there is no file part in the specified URL, Curl\n" +" Like -t, but this transfers the specified local file.\n" +" If there is no file part in the specified URL, Curl\n" " will append the local file name. NOTE that you must use\n" -" a trailing / on the last directory to really prove to\n" +" a trailing / on the last directory to really prove to\n" " Curl that there is no file name or curl will think that\n" -" your last directory name is the remote file name to\n" -" use. That will most likely cause the upload operation\n" -" to fail. If this is used on a http(s) server, the PUT\n" +" your last directory name is the remote file name to\n" +" use. That will most likely cause the upload operation\n" +" to fail. If this is used on a http(s) server, the PUT\n" " command will be used.\n" "\n" " -u/--user \n" -" Specify user and password to use when fetching. See\n" -" README.curl for detailed examples of how to use this.\n" -" If no password is specified, curl will ask for it\n" +" Specify user and password to use when fetching. See\n" +" README.curl for detailed examples of how to use this.\n" +" If no password is specified, curl will ask for it\n" " interactively.\n" -"\n" " -U/--proxy-user \n" -" Specify user and password to use for Proxy authentica­\n" +" Specify user and password to use for Proxy authentica­\n" " tion. If no password is specified, curl will ask for it\n" " interactively.\n" "\n" " -v/--verbose\n" -" Makes the fetching more verbose/talkative. Mostly\n" -" usable for debugging. Lines starting with '>' means\n" +" Makes the fetching more verbose/talkative. Mostly\n" +" usable for debugging. Lines starting with '>' means\n" " data sent by curl, '<' means data received by curl that\n" -" is hidden in normal cases and lines starting with '*'\n" +" is hidden in normal cases and lines starting with '*'\n" " means additional info provided by curl.\n" "\n" " -V/--version\n" -" 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" "\n" " -w/--write-out \n" -" Defines what to display after a completed and success­\n" -" ful operation. The format is a string that may contain\n" -" plain text mixed with any number of variables. The\n" +" Defines what to display after a completed and success­\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" +" 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\n" -" substituted by the value or text that curl thinks fit,\n" -" as 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" +" The variables present in the output format will be sub­\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" +" 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" +" 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" +); + puts( " 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" +" 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­\n" +" The time, in seconds, it took from the\n" +" start until the name resolving was com­\n" " pleted.\n" -"\n" -" time_connect The time, in seconds, it took from the\n" -" start until the connect to the remote\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" "\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­\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­\n" " col(s) involved.\n" -); - puts( "\n" -" size_download The total amount of bytes that were\n" +" size_download The total amount of bytes that were\n" " downloaded.\n" "\n" -" size_upload The total amount of bytes that were\n" +" size_upload The total amount of bytes that were\n" " uploaded.\n" "\n" -" speed_download The average download speed that curl\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­\n" +" speed_upload The average upload speed that curl mea­\n" " sured for the complete download.\n" +"\n" " -x/--proxy \n" -" Use specified proxy. If the port number is not speci­\n" +" Use specified proxy. If the port number is not speci­\n" " fied, it is assumed at port 1080.\n" "\n" " -X/--request \n" -" (HTTP) Specifies a custom request to use when communi­\n" -" cating with the HTTP server. The specified request\n" +" (HTTP) Specifies a custom request to use when communi­\n" +" cating with the HTTP server. The specified request\n" " will be used instead of the standard GET. Read the HTTP\n" " 1.1 specification for details and explanations.\n" "\n" -" (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" "\n" " -y/--speed-time