#include "setup.h" #ifndef HAVE_LIBZ /* * NEVER EVER edit this manually, fix the mkhelp.pl script instead! * Generation time: Fri Aug 22 10:00:28 2008 */ #include "setup.h" #ifdef USE_MANUAL #include "hugehelp.h" #include void hugehelp(void) { fputs( " _ _ ____ _ \n" " Project ___| | | | _ \\| | \n" " / __| | | | |_) | | \n" " | (__| |_| | _ <| |___ \n" " \\___|\\___/|_| \\_\\_____|\n" "\n" "NAME\n" " curl - transfer a URL\n" "\n" "SYNOPSIS\n" " curl [options] [URL...]\n" "\n" "DESCRIPTION\n" " curl is a tool to transfer data from or to a server, using one of the\n" , stdout); fputs( " supported protocols (HTTP, HTTPS, FTP, FTPS, SCP, SFTP, TFTP, DICT,\n" " TELNET, LDAP or FILE). The command is designed to work without user\n" " interaction.\n" "\n" " curl offers a busload of useful tricks like proxy support, user authen-\n" " tication, ftp upload, HTTP post, SSL connections, cookies, file trans-\n" " fer resume and more. As you will see below, the number of features will\n" " make your head spin!\n" "\n" , stdout); fputs( " curl is powered by libcurl for all transfer-related features. See\n" " libcurl(3) for details.\n" "\n" "URL\n" " The URL syntax is protocol dependent. You'll find a detailed descrip-\n" " tion in RFC 3986.\n" "\n" " You can specify multiple URLs or parts of URLs by writing part sets\n" " within braces as in:\n" "\n" " http://site.{one,two,three}.com\n" "\n" " or you can get sequences of alphanumeric series by using [] as in:\n" "\n" " ftp://ftp.numericals.com/file[1-100].txt\n" , stdout); fputs( " ftp://ftp.numericals.com/file[001-100].txt (with leading zeros)\n" " ftp://ftp.letters.com/file[a-z].txt\n" "\n" " No nesting of the sequences is supported at the moment, but you can use\n" " several ones next to each other:\n" "\n" " http://any.org/archive[1996-1999]/vol[1-4]/part{a,b,c}.html\n" "\n" " You can specify any amount of URLs on the command line. They will be\n" " fetched in a sequential manner in the specified order.\n" "\n" , stdout); fputs( " Since curl 7.15.1 you can also specify step counter for the ranges, so\n" " that you can get every Nth number or letter:\n" " http://www.numericals.com/file[1-100:10].txt\n" " http://www.letters.com/file[a-z:2].txt\n" "\n" " If you specify URL without protocol:// prefix, curl will attempt to\n" " guess what protocol you might want. It will then default to HTTP but\n" " try other protocols based on often-used host name prefixes. For exam-\n" , stdout); fputs( " ple, for host names starting with \"ftp.\" curl will assume you want to\n" " speak FTP.\n" "\n" " Curl will attempt to re-use connections for multiple file transfers, so\n" " that getting many files from the same server will not do multiple con-\n" " nects / handshakes. This improves speed. Of course this is only done on\n" " files specified on a single command line and cannot be used between\n" " separate curl invokes.\n" "\n" "PROGRESS METER\n" , stdout); fputs( " curl normally displays a progress meter during operations, indicating\n" " amount of transferred data, transfer speeds and estimated time left\n" " etc.\n" "\n" " However, since curl displays data to the terminal by default, if you\n" " invoke curl to do an operation and it is about to write data to the\n" " terminal, it disables the progress meter as otherwise it would mess up\n" " the output mixing progress meter and response data.\n" "\n" , stdout); fputs( " If you want a progress meter for HTTP POST or PUT requests, you need to\n" " redirect the response output to a file, using shell redirect (>), -o\n" " [file] or similar.\n" "\n" " It is not the same case for FTP upload as that operation is not spit-\n" " ting out any response data to the terminal.\n" "\n" " If you prefer a progress \"bar\" instead of the regular meter, -# is your\n" " friend.\n" "OPTIONS\n" " In general, all boolean options are enabled with --option and yet again\n" , stdout); fputs( " disabled with --no-option. That is, you use the exact same option name\n" " but prefix it with \"no-\". However, in this list we mostly only list and\n" " show the --option version of them. (This concept with --no options was\n" " added in 7.19.0. Previously most options were toggled on/off on\n" " repeated use of the same command line option.)\n" "\n" " -a/--append\n" " (FTP/SFTP) When used in an upload, this will tell curl to append\n" , stdout); fputs( " to the target file instead of overwriting it. If the file\n" " doesn't exist, it will be created. Note that this flag is\n" " ignored by some SSH servers (including OpenSSH).\n" "\n" " -A/--user-agent \n" " (HTTP) Specify the User-Agent string to send to the HTTP server.\n" " Some badly done CGIs fail if this field isn't set to\n" " \"Mozilla/4.0\". To encode blanks in the string, surround the\n" , stdout); fputs( " string with single quote marks. This can also be set with the\n" " -H/--header option of course.\n" "\n" " If this option is set more than once, the last one will be the\n" " one that's used.\n" "\n" " --anyauth\n" " (HTTP) Tells curl to figure out authentication method by itself,\n" " and use the most secure one the remote site claims it supports.\n" " This is done by first doing a request and checking the response-\n" , stdout); fputs( " headers, thus possibly inducing an extra network round-trip.\n" " This is used instead of setting a specific authentication\n" " method, which you can do with --basic, --digest, --ntlm, and\n" " --negotiate.\n" "\n" " Note that using --anyauth is not recommended if you do uploads\n" " from stdin, since it may require data to be sent twice and then\n" , stdout); fputs( " the client must be able to rewind. If the need should arise when\n" " uploading from stdin, the upload operation will fail.\n" "\n" " -b/--cookie \n" " (HTTP) Pass the data to the HTTP server as a cookie. It is sup-\n" " posedly the data previously received from the server in a \"Set-\n" " Cookie:\" line. The data should be in the format \"NAME1=VALUE1;\n" " NAME2=VALUE2\".\n" "\n" , stdout); fputs( " If no '=' letter is used in the line, it is treated as a file-\n" " name to use to read previously stored cookie lines from, which\n" " should be used in this session if they match. Using this method\n" " also activates the \"cookie parser\" which will make curl record\n" " incoming cookies too, which may be handy if you're using this in\n" " combination with the -L/--location option. The file format of\n" , stdout); fputs( " the file to read cookies from should be plain HTTP headers or\n" " the Netscape/Mozilla cookie file format.\n" "\n" " NOTE that the file specified with -b/--cookie is only used as\n" " input. No cookies will be stored in the file. To store cookies,\n" " use the -c/--cookie-jar option or you could even save the HTTP\n" " headers to a file using -D/--dump-header!\n" "\n" , stdout); fputs( " If this option is set more than once, the last one will be the\n" " one that's used.\n" "\n" " -B/--use-ascii\n" " Enable ASCII transfer when using FTP or LDAP. For FTP, this can\n" " also be enforced by using an URL that ends with \";type=A\". This\n" " option causes data sent to stdout to be in text mode for win32\n" " systems.\n" "\n" " --basic\n" " (HTTP) Tells curl to use HTTP Basic authentication. This is the\n" , stdout); fputs( " default and this option is usually pointless, unless you use it\n" " to override a previously set option that sets a different\n" " authentication method (such as --ntlm, --digest and --negoti-\n" " ate).\n" "\n" " --ciphers \n" " (SSL) Specifies which ciphers to use in the connection. The list\n" " of ciphers must be using valid ciphers. Read up on SSL cipher\n" , stdout); fputs( " list details on this URL:\n" " http://www.openssl.org/docs/apps/ciphers.html\n" "\n" " NSS ciphers are done differently than OpenSSL and GnuTLS. The\n" " full list of NSS ciphers is in the NSSCipherSuite entry at this\n" " URL: http://directory.fedora.redhat.com/docs/mod_nss.html#Direc-\n" " tives\n" "\n" " If this option is used several times, the last one will override\n" , stdout); fputs( " the others.\n" "\n" " --compressed\n" " (HTTP) Request a compressed response using one of the algorithms\n" " libcurl supports, and return the uncompressed document. If this\n" " option is used and the server sends an unsupported encoding,\n" " curl will report an error.\n" "\n" " --connect-timeout \n" " Maximum time in seconds that you allow the connection to the\n" , stdout); fputs( " server to take. This only limits the connection phase, once\n" " curl has connected this option is of no more use. See also the\n" " -m/--max-time option.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " -c/--cookie-jar \n" " Specify to which file you want curl to write all cookies after a\n" " completed operation. Curl writes all cookies previously read\n" , stdout); fputs( " from a specified file as well as all cookies received from\n" " remote server(s). If no cookies are known, no file will be writ-\n" " ten. The file will be written using the Netscape cookie file\n" " format. If you set the file name to a single dash, \"-\", the\n" " cookies will be written to stdout.\n" "\n" " NOTE If the cookie jar can't be created or written to, the whole\n" , stdout); fputs( " curl operation won't fail or even report an error clearly. Using\n" " -v will get a warning displayed, but that is the only visible\n" " feedback you get about this possibly lethal situation.\n" "\n" " If this option is used several times, the last specified file\n" " name will be used.\n" "\n" " -C/--continue-at \n" " Continue/Resume a previous file transfer at the given offset.\n" , stdout); fputs( " The given offset is the exact number of bytes that will be\n" " skipped counted from the beginning of the source file before it\n" " is transferred to the destination. If used with uploads, the\n" " ftp server command SIZE will not be used by curl.\n" "\n" " Use \"-C -\" to tell curl to automatically find out where/how to\n" " resume the transfer. It then uses the given output/input files\n" " to figure that out.\n" "\n" , stdout); fputs( " If this option is used several times, the last one will be used.\n" "\n" " --create-dirs\n" " When used in conjunction with the -o option, curl will create\n" " the necessary local directory hierarchy as needed. This option\n" " creates the dirs mentioned with the -o option, nothing else. If\n" " the -o file name uses no dir or if the dirs it mentions already\n" " exist, no dir will be created.\n" "\n" , stdout); fputs( " To create remote directories when using FTP or SFTP, try --ftp-\n" " create-dirs.\n" "\n" " --crlf (FTP) Convert LF to CRLF in upload. Useful for MVS (OS/390).\n" "\n" " -d/--data \n" " (HTTP) Sends the specified data in a POST request to the HTTP\n" " server, in the same way that a browser does when a user has\n" " filled in an HTML form and presses the submit button. This will\n" , stdout); fputs( " cause curl to pass the data to the server using the content-type\n" " application/x-www-form-urlencoded. Compare to -F/--form.\n" "\n" " -d/--data is the same as --data-ascii. To post data purely\n" " binary, you should instead use the --data-binary option. To URL\n" " encode the value of a form field you may use --data-urlencode.\n" "\n" " If any of these options is used more than once on the same com-\n" , stdout); fputs( " mand line, the data pieces specified will be merged together\n" " with a separating &-letter. Thus, using '-d name=daniel -d\n" " skill=lousy' would generate a post chunk that looks like\n" " 'name=daniel&skill=lousy'.\n" "\n" " If you start the data with the letter @, the rest should be a\n" " file name to read the data from, or - if you want curl to read\n" , stdout); fputs( " the data from stdin. The contents of the file must already be\n" " url-encoded. Multiple files can also be specified. Posting data\n" " from a file named 'foobar' would thus be done with --data @foo-\n" " bar.\n" "\n" " --data-binary \n" " (HTTP) This posts data exactly as specified with no extra pro-\n" " cessing whatsoever.\n" "\n" " If you start the data with the letter @, the rest should be a\n" , stdout); fputs( " filename. Data is posted in a similar manner as --data-ascii\n" " does, except that newlines are preserved and conversions are\n" " never done.\n" "\n" " If this option is used several times, the ones following the\n" " first will append data. As described in -d/--data.\n" "\n" " --data-urlencode \n" " (HTTP) This posts data, similar to the other --data options with\n" , stdout); fputs( " the exception that this performs URL encoding. (Added in 7.18.0)\n" " To be CGI compliant, the part should begin with a name\n" " followed by a separator and a content specification. The \n" " part can be passed to curl using one of the following syntaxes:\n" "\n" " content\n" " This will make curl URL encode the content and pass that\n" " on. Just be careful so that the content doesn't contain\n" , stdout); fputs( " any = or @ letters, as that will then make the syntax\n" " match one of the other cases below!\n" "\n" " =content\n" " This will make curl URL encode the content and pass that\n" " on. The preceding = letter is not included in the data.\n" "\n" " name=content\n" " This will make curl URL encode the content part and pass\n" , stdout); fputs( " that on. Note that the name part is expected to be URL\n" " encoded already.\n" "\n" " @filename\n" " This will make curl load data from the given file\n" " (including any newlines), URL encode that data and pass\n" " it on in the POST.\n" "\n" " name@filename\n" " This will make curl load data from the given file\n" , stdout); fputs( " (including any newlines), URL encode that data and pass\n" " it on in the POST. The name part gets an equal sign\n" " appended, resulting in name=urlencoded-file-content. Note\n" " that the name is expected to be URL encoded already.\n" "\n" " --digest\n" " (HTTP) Enables HTTP Digest authentication. This is a authentica-\n" " tion that prevents the password from being sent over the wire in\n" , stdout); fputs( " clear text. Use this in combination with the normal -u/--user\n" " option to set user name and password. See also --ntlm, --negoti-\n" " ate and --anyauth for related options.\n" "\n" " If this option is used several times, the following occurrences\n" " make no difference.\n" "\n" " --disable-eprt\n" " (FTP) Tell curl to disable the use of the EPRT and LPRT commands\n" , stdout); fputs( " when doing active FTP transfers. Curl will normally always first\n" " attempt to use EPRT, then LPRT before using PORT, but with this\n" " option, it will use PORT right away. EPRT and LPRT are exten-\n" " sions to the original FTP protocol, may not work on all servers\n" " but enable more functionality in a better way than the tradi-\n" " tional PORT command.\n" "\n" , stdout); fputs( " Since curl 7.19.0, --eprt can be used to explicitly enable EPRT\n" " again and --no-eprt is an alias for --disable-eprt.\n" "\n" " --disable-epsv\n" " (FTP) Tell curl to disable the use of the EPSV command when\n" " doing passive FTP transfers. Curl will normally always first\n" " attempt to use EPSV before PASV, but with this option, it will\n" " not try using EPSV.\n" "\n" , stdout); fputs( " Since curl 7.19.0, --epsv can be used to explicitly enable EPRT\n" " again and --no-epsv is an alias for --disable-epsv.\n" "\n" " -D/--dump-header \n" " Write the protocol headers to the specified file.\n" "\n" " This option is handy to use when you want to store the headers\n" " that a HTTP site sends to you. Cookies from the headers could\n" " then be read in a second curl invoke by using the -b/--cookie\n" , stdout); fputs( " option! The -c/--cookie-jar option is however a better way to\n" " store cookies.\n" "\n" " When used on FTP, the ftp server response lines are considered\n" " being \"headers\" and thus are saved there.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " -e/--referer \n" " (HTTP) Sends the \"Referer Page\" information to the HTTP server.\n" , stdout); fputs( " This can also be set with the -H/--header flag of course. When\n" " used with -L/--location you can append \";auto\" to the --referer\n" " URL to make curl automatically set the previous URL when it fol-\n" " lows a Location: header. The \";auto\" string can be used alone,\n" " even if you don't set an initial --referer.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --engine \n" , stdout); fputs( " Select the OpenSSL crypto engine to use for cipher operations.\n" " Use --engine list to print a list of build-time supported\n" " engines. Note that not all (or none) of the engines may be\n" " available at run-time.\n" "\n" " --environment\n" " (RISC OS ONLY) Sets a range of environment variables, using the\n" " names the -w option supports, to easier allow extraction of use-\n" , stdout); fputs( " ful information after having run curl.\n" "\n" " --egd-file \n" " (SSL) Specify the path name to the Entropy Gathering Daemon\n" " socket. The socket is used to seed the random engine for SSL\n" " connections. See also the --random-file option.\n" "\n" " -E/--cert \n" " (SSL) Tells curl to use the specified certificate file when get-\n" " ting a file with HTTPS or FTPS. The certificate must be in PEM\n" , stdout); fputs( " format. If the optional password isn't specified, it will be\n" " queried for on the terminal. Note that this option assumes a\n" " \"certificate\" file that is the private key and the private cer-\n" " tificate concatenated! See --cert and --key to specify them\n" " independently.\n" "\n" " If curl is built against the NSS SSL library then this option\n" , stdout); fputs( " tells curl the nickname of the certificate to use within the NSS\n" " database defined by the environment variable SSL_DIR (or by\n" " default /etc/pki/nssdb). If the NSS PEM PKCS#11 module (lib-\n" " nsspem.so) is available then PEM files may be loaded.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --cert-type \n" " (SSL) Tells curl what certificate type the provided certificate\n" , stdout); fputs( " is in. PEM, DER and ENG are recognized types. If not specified,\n" " PEM is assumed.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --cacert \n" " (SSL) Tells curl to use the specified certificate file to verify\n" " the peer. The file may contain multiple CA certificates. The\n" " certificate(s) must be in PEM format. Normally curl is built to\n" , stdout); fputs( " use a default file for this, so this option is typically used to\n" " alter that default file.\n" "\n" " curl recognizes the environment variable named 'CURL_CA_BUNDLE'\n" " if that is set, and uses the given path as a path to a CA cert\n" " bundle. This option overrides that variable.\n" "\n" " The windows version of curl will automatically look for a CA\n" " certs file named 'curl-ca-bundle.crt', either in the same\n" , stdout); fputs( " directory as curl.exe, or in the Current Working Directory, or\n" " in any folder along your PATH.\n" "\n" " If curl is built against the NSS SSL library then this option\n" " tells curl the nickname of the CA certificate to use within the\n" " NSS database defined by the environment variable SSL_DIR (or by\n" " default /etc/pki/nssdb). If the NSS PEM PKCS#11 module (lib-\n" , stdout); fputs( " nsspem.so) is available then PEM files may be loaded.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --capath \n" " (SSL) Tells curl to use the specified certificate directory to\n" " verify the peer. The certificates must be in PEM format, and the\n" " directory must have been processed using the c_rehash utility\n" , stdout); fputs( " supplied with openssl. Using --capath can allow curl to make\n" " SSL-connections much more efficiently than using --cacert if the\n" " --cacert file contains many CA certificates.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " -f/--fail\n" " (HTTP) Fail silently (no output at all) on server errors. This\n" " is mostly done like this to better enable scripts etc to better\n" , stdout); fputs( " deal with failed attempts. In normal cases when a HTTP server\n" " fails to deliver a document, it returns an HTML document stating\n" " so (which often also describes why and more). This flag will\n" " prevent curl from outputting that and return error 22.\n" "\n" " This method is not fail-safe and there are occasions where non-\n" " successful response codes will slip through, especially when\n" , stdout); fputs( " authentication is involved (response codes 401 and 407).\n" "\n" " --ftp-account [data]\n" " (FTP) When an FTP server asks for \"account data\" after user name\n" " and password has been provided, this data is sent off using the\n" " ACCT command. (Added in 7.13.0)\n" "\n" " If this option is used twice, the second will override the pre-\n" " vious use.\n" "\n" " --ftp-create-dirs\n" , stdout); fputs( " (FTP/SFTP) When an FTP or SFTP URL/operation uses a path that\n" " doesn't currently exist on the server, the standard behavior of\n" " curl is to fail. Using this option, curl will instead attempt to\n" " create missing directories.\n" "\n" " --ftp-method [method]\n" " (FTP) Control what method curl should use to reach a file on a\n" " FTP(S) server. The method argument should be one of the follow-\n" " ing alternatives:\n" "\n" , stdout); fputs( " multicwd\n" " curl does a single CWD operation for each path part in\n" " the given URL. For deep hierarchies this means very many\n" " commands. This is how RFC1738 says it should be done.\n" " This is the default but the slowest behavior.\n" "\n" " nocwd curl does no CWD at all. curl will do SIZE, RETR, STOR\n" " etc and give a full path to the server for all these com-\n" , stdout); fputs( " mands. This is the fastest behavior.\n" "\n" " singlecwd\n" " curl does one CWD with the full target directory and then\n" " operates on the file \"normally\" (like in the multicwd\n" " case). This is somewhat more standards compliant than\n" " 'nocwd' but without the full penalty of 'multicwd'.\n" "\n" " --ftp-pasv\n" " (FTP) Use PASV when transferring. PASV is the internal default\n" , stdout); fputs( " behavior, but using this option can be used to override a previ-\n" " ous --ftp-port option. (Added in 7.11.0)\n" "\n" " If this option is used several times, the following occurrences\n" " make no difference. Undoing an enforced PASV really isn't doable\n" " but you must then instead enforce the correct EPRT again.\n" "\n" " --ftp-alternative-to-user \n" " (FTP) If authenticating with the USER and PASS commands fails,\n" , stdout); fputs( " send this command. When connecting to Tumbleweed's Secure\n" " Transport server over FTPS using a client certificate, using\n" " \"SITE AUTH\" will tell the server to retrieve the username from\n" " the certificate. (Added in 7.15.5)\n" "\n" " --ftp-skip-pasv-ip\n" " (FTP) Tell curl to not use the IP address the server suggests in\n" " its response to curl's PASV command when curl connects the data\n" , stdout); fputs( " connection. Instead curl will re-use the same IP address it\n" " already uses for the control connection. (Added in 7.14.2)\n" "\n" " This option has no effect if PORT, EPRT or EPSV is used instead\n" " of PASV.\n" "\n" " --ftp-ssl\n" " (FTP) Try to use SSL/TLS for the FTP connection. Reverts to a\n" " non-secure connection if the server doesn't support SSL/TLS.\n" , stdout); fputs( " See also --ftp-ssl-control and --ftp-ssl-reqd for different lev-\n" " els of encryption required. (Added in 7.11.0)\n" "\n" " --ftp-ssl-control\n" " (FTP) Require SSL/TLS for the ftp login, clear for transfer.\n" " Allows secure authentication, but non-encrypted data transfers\n" " for efficiency. Fails the transfer if the server doesn't sup-\n" " port SSL/TLS. (Added in 7.16.0)\n" "\n" " --ftp-ssl-reqd\n" , stdout); fputs( " (FTP) Require SSL/TLS for the FTP connection. Terminates the\n" " connection if the server doesn't support SSL/TLS. (Added in\n" " 7.15.5)\n" "\n" " --ftp-ssl-ccc\n" " (FTP) Use CCC (Clear Command Channel) Shuts down the SSL/TLS\n" " layer after authenticating. The rest of the control channel com-\n" " munication will be unencrypted. This allows NAT routers to fol-\n" , stdout); fputs( " low the FTP transaction. The default mode is passive. See --ftp-\n" " ssl-ccc-mode for other modes. (Added in 7.16.1)\n" "\n" " --ftp-ssl-ccc-mode [active/passive]\n" " (FTP) Use CCC (Clear Command Channel) Sets the CCC mode. The\n" " passive mode will not initiate the shutdown, but instead wait\n" " for the server to do it, and will not reply to the shutdown from\n" , stdout); fputs( " the server. The active mode initiates the shutdown and waits for\n" " a reply from the server. (Added in 7.16.2)\n" "\n" " -F/--form \n" " (HTTP) This lets curl emulate a filled in form in which a user\n" " has pressed the submit button. This causes curl to POST data\n" " using the Content-Type multipart/form-data according to RFC1867.\n" " This enables uploading of binary files etc. To force the 'con-\n" , stdout); fputs( " tent' part to be a file, prefix the file name with an @ sign. To\n" " just get the content part from a file, prefix the file name with\n" " the letter <. The difference between @ and < is then that @\n" " makes a file get attached in the post as a file upload, while\n" " the < makes a text field and just get the contents for that text\n" " field from a file.\n" "\n" , stdout); fputs( " Example, to send your password file to the server, where 'pass-\n" " word' is the name of the form-field to which /etc/passwd will be\n" " the input:\n" "\n" " curl -F password=@/etc/passwd www.mypasswords.com\n" "\n" " To read the file's content from stdin instead of a file, use -\n" " where the file name should've been. This goes for both @ and <\n" " constructs.\n" "\n" , stdout); fputs( " You can also tell curl what Content-Type to use by using\n" " 'type=', in a manner similar to:\n" "\n" " curl -F \"web=@index.html;type=text/html\" url.com\n" "\n" " or\n" "\n" " curl -F \"name=daniel;type=text/foo\" url.com\n" "\n" " You can also explicitly change the name field of an file upload\n" " part by setting filename=, like this:\n" "\n" " curl -F \"file=@localfile;filename=nameinpost\" url.com\n" "\n" , stdout); fputs( " See further examples and details in the MANUAL.\n" "\n" " This option can be used multiple times.\n" "\n" " --form-string \n" " (HTTP) Similar to --form except that the value string for the\n" " named parameter is used literally. Leading '@' and '<' charac-\n" " ters, and the ';type=' string in the value have no special mean-\n" " ing. Use this in preference to --form if there's any possibility\n" , stdout); fputs( " that the string value may accidentally trigger the '@' or '<'\n" " features of --form.\n" "\n" " -g/--globoff\n" " This option switches off the \"URL globbing parser\". When you set\n" " this option, you can specify URLs that contain the letters {}[]\n" " without having them being interpreted by curl itself. Note that\n" " these letters are not normal legal URL contents but they should\n" , stdout); fputs( " be encoded according to the URI standard.\n" "\n" " -G/--get\n" " When used, this option will make all data specified with\n" " -d/--data or --data-binary to be used in a HTTP GET request\n" " instead of the POST request that otherwise would be used. The\n" " data will be appended to the URL with a '?' separator.\n" "\n" " If used in combination with -I, the POST data will instead be\n" , stdout); fputs( " appended to the URL with a HEAD request.\n" "\n" " If this option is used several times, the following occurrences\n" " make no difference. This is because undoing a GET doesn't make\n" " sense, but you should then instead enforce the alternative\n" " method you prefer.\n" "\n" " -h/--help\n" " Usage help.\n" "\n" " -H/--header
\n" " (HTTP) Extra header to use when getting a web page. You may\n" , stdout); fputs( " specify any number of extra headers. Note that if you should add\n" " a custom header that has the same name as one of the internal\n" " ones curl would use, your externally set header will be used\n" " instead of the internal one. This allows you to make even trick-\n" " ier stuff than curl would normally do. You should not replace\n" " internally set headers without knowing perfectly well what\n" , stdout); fputs( " you're doing. Remove an internal header by giving a replacement\n" " without content on the right side of the colon, as in: -H\n" " \"Host:\".\n" "\n" " curl will make sure that each header you add/replace get sent\n" " with the proper end of line marker, you should thus not add that\n" " as a part of the header content: do not add newlines or carriage\n" " returns they will only mess things up for you.\n" "\n" , stdout); fputs( " See also the -A/--user-agent and -e/--referer options.\n" "\n" " This option can be used multiple times to add/replace/remove\n" " multiple headers.\n" "\n" " --hostpubmd5 \n" " Pass a string containing 32 hexadecimal digits. The string\n" " should be the 128 bit MD5 checksum of the remote host's public\n" " key, curl will refuse the connection with the host unless the\n" , stdout); fputs( " md5sums match. This option is only for SCP and SFTP transfers.\n" " (Added in 7.17.1)\n" "\n" " --ignore-content-length\n" " (HTTP) Ignore the Content-Length header. This is particularly\n" " useful for servers running Apache 1.x, which will report incor-\n" " rect Content-Length for files larger than 2 gigabytes.\n" "\n" " -i/--include\n" " (HTTP) Include the HTTP-header in the output. The HTTP-header\n" , stdout); fputs( " includes things like server-name, date of the document, HTTP-\n" " version and more...\n" "\n" " --interface \n" " Perform an operation using a specified interface. You can enter\n" " interface name, IP address or host name. An example could look\n" " like:\n" "\n" " curl --interface eth0:1 http://www.netscape.com/\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " -I/--head\n" , stdout); fputs( " (HTTP/FTP/FILE) Fetch the HTTP-header only! HTTP-servers feature\n" " the command HEAD which this uses to get nothing but the header\n" " of a document. When used on a FTP or FILE file, curl displays\n" " the file size and last modification time only.\n" "\n" " -j/--junk-session-cookies\n" " (HTTP) When curl is told to read cookies from a given file, this\n" " option will make it discard all \"session cookies\". This will\n" , stdout); fputs( " basically have the same effect as if a new session is started.\n" " Typical browsers always discard session cookies when they're\n" " closed down.\n" "\n" " -k/--insecure\n" " (SSL) This option explicitly allows curl to perform \"insecure\"\n" " SSL connections and transfers. All SSL connections are attempted\n" " to be made secure by using the CA certificate bundle installed\n" , stdout); fputs( " by default. This makes all connections considered \"insecure\" to\n" " fail unless -k/--insecure is used.\n" "\n" " See this online resource for further details:\n" " http://curl.haxx.se/docs/sslcerts.html\n" "\n" " --keepalive-time \n" " This option sets the time a connection needs to remain idle\n" " before sending keepalive probes and the time between individual\n" , stdout); fputs( " keepalive probes. It is currently effective on operating systems\n" " offering the TCP_KEEPIDLE and TCP_KEEPINTVL socket options\n" " (meaning Linux, recent AIX, HP-UX and more). This option has no\n" " effect if --no-keepalive is used. (Added in 7.18.0)\n" "\n" " If this option is used multiple times, the last occurrence sets\n" " the amount.\n" " --key \n" , stdout); fputs( " (SSL/SSH) Private key file name. Allows you to provide your pri-\n" " vate key in this separate file.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --key-type \n" " (SSL) Private key file type. Specify which type your --key pro-\n" " vided private key is. DER, PEM and ENG are supported. If not\n" " specified, PEM is assumed.\n" "\n" , stdout); fputs( " If this option is used several times, the last one will be used.\n" "\n" " --krb \n" " (FTP) Enable Kerberos authentication and use. The level must be\n" " entered and should be one of 'clear', 'safe', 'confidential' or\n" " 'private'. Should you use a level that is not one of these,\n" " 'private' will instead be used.\n" "\n" " This option requires that the library was built with kerberos4\n" , stdout); fputs( " or GSSAPI (GSS-Negotiate) support. This is not very common. Use\n" " -V/--version to see if your curl supports it.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " -K/--config \n" " Specify which config file to read curl arguments from. The con-\n" " fig file is a text file in which command line arguments can be\n" " written which then will be used as if they were written on the\n" , stdout); fputs( " actual command line. Options and their parameters must be speci-\n" " fied on the same config file line, separated by white space,\n" " colon, the equals sign or any combination thereof (however, the\n" " preferred separator is the equals sign). If the parameter is to\n" " contain white spaces, the parameter must be enclosed within\n" " quotes. Within double quotes, the following escape sequences are\n" , stdout); fputs( " available: \\\\, \\\", \\t, \\n, \\r and \\v. A backlash preceding any\n" " other letter is ignored. If the first column of a config line\n" " is a '#' character, the rest of the line will be treated as a\n" " comment. Only write one option per physical line in the config\n" " file.\n" "\n" " Specify the filename to -K/--config as '-' to make curl read the\n" " file from stdin.\n" "\n" , stdout); fputs( " Note that to be able to specify a URL in the config file, you\n" " need to specify it using the --url option, and not by simply\n" " writing the URL on its own line. So, it could look similar to\n" " this:\n" "\n" " url = \"http://curl.haxx.se/docs/\"\n" "\n" " Long option names can optionally be given in the config file\n" " without the initial double dashes.\n" "\n" , stdout); fputs( " When curl is invoked, it always (unless -q is used) checks for a\n" " default config file and uses it if found. The default config\n" " file is checked for in the following places in this order:\n" "\n" " 1) curl tries to find the \"home dir\": It first checks for the\n" " CURL_HOME and then the HOME environment variables. Failing that,\n" " it uses getpwuid() on unix-like systems (which returns the home\n" , stdout); fputs( " dir given the current user in your system). On Windows, it then\n" " checks for the APPDATA variable, or as a last resort the '%USER-\n" " PROFILE%0lication Data'.\n" "\n" " 2) On windows, if there is no _curlrc file in the home dir, it\n" " checks for one in the same dir the executable curl is placed. On\n" " unix-like systems, it will simply try to load .curlrc from the\n" " determined home dir.\n" "\n" , stdout); fputs( " # --- Example file ---\n" " # this is a comment\n" " url = \"curl.haxx.se\"\n" " output = \"curlhere.html\"\n" " user-agent = \"superagent/1.0\"\n" "\n" " # and fetch another URL too\n" " url = \"curl.haxx.se/docs/manpage.html\"\n" " -O\n" " referer = \"http://nowhereatall.com/\"\n" " # --- End of example file ---\n" "\n" " This option can be used multiple times to load multiple config\n" " files.\n" "\n" , stdout); fputs( " --libcurl \n" " Append this option to any ordinary curl command line, and you\n" " will get a libcurl-using source code written to the file that\n" " does the equivalent operation of what your command line opera-\n" " tion does!\n" "\n" " NOTE: this does not properly support -F and the sending of mul-\n" " tipart formposts, so in those cases the output program will be\n" , stdout); fputs( " missing necessary calls to curl_formadd(3), and possibly more.\n" "\n" " If this option is used several times, the last given file name\n" " will be used. (Added in 7.16.1)\n" "\n" " --limit-rate \n" " Specify the maximum transfer rate you want curl to use. This\n" " feature is useful if you have a limited pipe and you'd like your\n" " transfer not use your entire bandwidth.\n" "\n" , stdout); fputs( " The given speed is measured in bytes/second, unless a suffix is\n" " appended. Appending 'k' or 'K' will count the number as kilo-\n" " bytes, 'm' or M' makes it megabytes while 'g' or 'G' makes it\n" " gigabytes. Examples: 200K, 3m and 1G.\n" "\n" " The given rate is the average speed, counted during the entire\n" " transfer. It means that curl might use higher transfer speeds in\n" , stdout); fputs( " short bursts, but over time it uses no more than the given rate.\n" " If you are also using the -Y/--speed-limit option, that option\n" " will take precedence and might cripple the rate-limiting\n" " slightly, to help keeping the speed-limit logic working.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " -l/--list-only\n" " (FTP) When listing an FTP directory, this switch forces a name-\n" , stdout); fputs( " only view. Especially useful if you want to machine-parse the\n" " contents of an FTP directory since the normal directory view\n" " doesn't use a standard look or format.\n" "\n" " This option causes an FTP NLST command to be sent. Some FTP\n" " servers list only files in their response to NLST; they do not\n" " include subdirectories and symbolic links.\n" "\n" " --local-port [-num]\n" , stdout); fputs( " Set a preferred number or range of local port numbers to use for\n" " the connection(s). Note that port numbers by nature is a scarce\n" " resource that will be busy at times so setting this range to\n" " something too narrow might cause unnecessary connection setup\n" " failures. (Added in 7.15.2)\n" "\n" " -L/--location\n" " (HTTP/HTTPS) If the server reports that the requested page has\n" , stdout); fputs( " moved to a different location (indicated with a Location: header\n" " and a 3XX response code) this option will make curl redo the\n" " request on the new place. If used together with -i/--include or\n" " -I/--head, headers from all requested pages will be shown. When\n" " authentication is used, curl only sends its credentials to the\n" " initial host. If a redirect takes curl to a different host, it\n" , stdout); fputs( " won't be able to intercept the user+password. See also --loca-\n" " tion-trusted on how to change this. You can limit the amount of\n" " redirects to follow by using the --max-redirs option.\n" "\n" " When curl follows a redirect and the request is not a plain GET\n" " (for example POST or PUT), it will do the following request with\n" " a GET if the HTTP response was 301, 302, or 303. If the response\n" , stdout); fputs( " code was any other 3xx code, curl will re-send the following\n" " request using the same unmodified method.\n" "\n" " --location-trusted\n" " (HTTP/HTTPS) Like -L/--location, but will allow sending the name\n" " + password to all hosts that the site may redirect to. This may\n" " or may not introduce a security breach if the site redirects you\n" " do a site to which you'll send your authentication info (which\n" , stdout); fputs( " is plaintext in the case of HTTP Basic authentication).\n" "\n" " --max-filesize \n" " Specify the maximum size (in bytes) of a file to download. If\n" " the file requested is larger than this value, the transfer will\n" " not start and curl will return with exit code 63.\n" "\n" " NOTE: The file size is not always known prior to download, and\n" " for such files this option has no effect even if the file trans-\n" , stdout); fputs( " fer ends up being larger than this given limit. This concerns\n" " both FTP and HTTP transfers.\n" "\n" " -m/--max-time \n" " Maximum time in seconds that you allow the whole operation to\n" " take. This is useful for preventing your batch jobs from hang-\n" " ing for hours due to slow networks or links going down. See\n" " also the --connect-timeout option.\n" "\n" , stdout); fputs( " If this option is used several times, the last one will be used.\n" "\n" " -M/--manual\n" " Manual. Display the huge help text.\n" "\n" " -n/--netrc\n" " Makes curl scan the .netrc (_netrc on Windows) file in the\n" " user's home directory for login name and password. This is typi-\n" " cally used for ftp on unix. If used with http, curl will enable\n" " user authentication. See netrc(4) or ftp(1) for details on the\n" , stdout); fputs( " file format. Curl will not complain if that file hasn't the\n" " right permissions (it should not be world nor group readable).\n" " The environment variable \"HOME\" is used to find the home direc-\n" " tory.\n" "\n" " A quick and very simple example of how to setup a .netrc to\n" " allow curl to ftp to the machine host.domain.com with user name\n" " 'myself' and password 'secret' should look similar to:\n" "\n" , stdout); fputs( " machine host.domain.com login myself password secret\n" "\n" " --netrc-optional\n" " Very similar to --netrc, but this option makes the .netrc usage\n" " optional and not mandatory as the --netrc does.\n" "\n" " --negotiate\n" " (HTTP) Enables GSS-Negotiate authentication. The GSS-Negotiate\n" " method was designed by Microsoft and is used in their web appli-\n" " cations. It is primarily meant as a support for Kerberos5\n" , stdout); fputs( " authentication but may be also used along with another authenti-\n" " cation methods. For more information see IETF draft draft-\n" " brezak-spnego-http-04.txt.\n" "\n" " If you want to enable Negotiate for your proxy authentication,\n" " then use --proxy-negotiate.\n" "\n" " This option requires that the library was built with GSSAPI sup-\n" " port. This is not very common. Use -V/--version to see if your\n" , stdout); fputs( " version supports GSS-Negotiate.\n" "\n" " When using this option, you must also provide a fake -u/--user\n" " option to activate the authentication code properly. Sending a\n" " '-u :' is enough as the user name and password from the -u\n" " option aren't actually used.\n" "\n" " If this option is used several times, the following occurrences\n" " make no difference.\n" "\n" " -N/--no-buffer\n" , stdout); fputs( " Disables the buffering of the output stream. In normal work sit-\n" " uations, curl will use a standard buffered output stream that\n" " will have the effect that it will output the data in chunks, not\n" " necessarily exactly when the data arrives. Using this option\n" " will disable that buffering.\n" "\n" " Note that this is the negated option name documented. You can\n" " thus use --buffer to enforce the buffering.\n" "\n" , stdout); fputs( " --no-keepalive\n" " Disables the use of keepalive messages on the TCP connection, as\n" " by default curl enables them.\n" "\n" " Note that this is the negated option name documented. You can\n" " thus use --keepalive to enforce keepalive.\n" "\n" " --no-sessionid\n" " (SSL) Disable curl's use of SSL session-ID caching. By default\n" " all transfers are done using the cache. Note that while nothing\n" , stdout); fputs( " ever should get hurt by attempting to reuse SSL session-IDs,\n" " there seem to be broken SSL implementations in the wild that may\n" " require you to disable this in order for you to succeed. (Added\n" " in 7.16.0)\n" "\n" " Note that this is the negated option name documented. You can\n" " thus use --sessionid to enforce session-ID caching.\n" "\n" " --ntlm (HTTP) Enables NTLM authentication. The NTLM authentication\n" , stdout); fputs( " method was designed by Microsoft and is used by IIS web servers.\n" " It is a proprietary protocol, reversed engineered by clever peo-\n" " ple and implemented in curl based on their efforts. This kind of\n" " behavior should not be endorsed, you should encourage everyone\n" " who uses NTLM to switch to a public and documented authentica-\n" " tion method instead. Such as Digest.\n" "\n" , stdout); fputs( " If you want to enable NTLM for your proxy authentication, then\n" " use --proxy-ntlm.\n" "\n" " This option requires that the library was built with SSL sup-\n" " port. Use -V/--version to see if your curl supports NTLM.\n" "\n" " If this option is used several times, the following occurrences\n" " make no difference.\n" "\n" " -o/--output \n" " Write output to instead of stdout. If you are using {} or\n" , stdout); fputs( " [] to fetch multiple documents, you can use '#' followed by a\n" " number in the specifier. That variable will be replaced\n" " with the current string for the URL being fetched. Like in:\n" "\n" " curl http://{one,two}.site.com -o \"file_#1.txt\"\n" "\n" " or use several variables like:\n" "\n" " curl http://{site,host}.host[1-5].com -o \"#1_#2\"\n" "\n" " You may use this option as many times as you have number of\n" , stdout); fputs( " URLs.\n" "\n" " See also the --create-dirs option to create the local directo-\n" " ries dynamically.\n" "\n" " -O/--remote-name\n" " Write output to a local file named like the remote file we get.\n" " (Only the file part of the remote file is used, the path is cut\n" " off.)\n" "\n" " The remote file name to use for saving is extracted from the\n" " given URL, nothing else.\n" "\n" , stdout); fputs( " You may use this option as many times as you have number of\n" " URLs.\n" "\n" " --remote-name-all\n" " This option changes the default action for all given URLs to be\n" " dealt with as if -O/--remote-name were used for each one. So if\n" " you want to disable that for a specific URL after --remote-name-\n" " all has been used, you must use \"-o -\" or --no-remote-name.\n" " (Added in 7.19.0)\n" "\n" " --pass \n" , stdout); fputs( " (SSL/SSH) Pass phrase for the private key\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --post301\n" " Tells curl to respect RFC 2616/10.3.2 and not convert POST\n" " requests into GET requests when following a 301 redirection. The\n" " non-RFC behaviour is ubiquitous in web browsers, so curl does\n" " the conversion by default to maintain consistency. However, a\n" , stdout); fputs( " server may requires a POST to remain a POST after such a redi-\n" " rection. This option is meaningful only when using -L/--location\n" " (Added in 7.17.1)\n" "\n" " --proxy-anyauth\n" " Tells curl to pick a suitable authentication method when commu-\n" " nicating with the given proxy. This might cause an extra\n" " request/response round-trip. (Added in 7.13.2)\n" "\n" " --proxy-basic\n" , stdout); fputs( " Tells curl to use HTTP Basic authentication when communicating\n" " with the given proxy. Use --basic for enabling HTTP Basic with a\n" " remote host. Basic is the default authentication method curl\n" " uses with proxies.\n" "\n" " --proxy-digest\n" " Tells curl to use HTTP Digest authentication when communicating\n" " with the given proxy. Use --digest for enabling HTTP Digest with\n" " a remote host.\n" "\n" , stdout); fputs( " --proxy-negotiate\n" " Tells curl to use HTTP Negotiate authentication when communicat-\n" " ing with the given proxy. Use --negotiate for enabling HTTP\n" " Negotiate with a remote host. (Added in 7.17.1)\n" "\n" " --proxy-ntlm\n" " Tells curl to use HTTP NTLM authentication when communicating\n" " with the given proxy. Use --ntlm for enabling NTLM with a remote\n" " host.\n" "\n" " -p/--proxytunnel\n" , stdout); fputs( " When an HTTP proxy is used (-x/--proxy), this option will cause\n" " non-HTTP protocols to attempt to tunnel through the proxy\n" " instead of merely using it to do HTTP-like operations. The tun-\n" " nel approach is made with the HTTP proxy CONNECT request and\n" " requires that the proxy allows direct connect to the remote port\n" " number curl wants to tunnel through to.\n" "\n" " --pubkey \n" , stdout); fputs( " (SSH) Public key file name. Allows you to provide your public\n" " key in this separate file.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " -P/--ftp-port
\n" " (FTP) Reverses the initiator/listener roles when connecting with\n" " ftp. This switch makes Curl use the PORT command instead of\n" " PASV. In practise, PORT tells the server to connect to the\n" , stdout); fputs( " client's specified address and port, while PASV asks the server\n" " for an ip address and port to connect to.
should be\n" " one of:\n" "\n" " interface\n" " i.e \"eth0\" to specify which interface's IP address you\n" " want to use (Unix only)\n" "\n" " IP address\n" " i.e \"192.168.10.1\" to specify exact IP number\n" "\n" " host name\n" , stdout); fputs( " i.e \"my.host.domain\" to specify machine\n" "\n" " - make curl pick the same IP address that is already used\n" " for the control connection\n" "\n" " If this option is used several times, the last one will be used. Dis-\n" " able the use of PORT with --ftp-pasv. Disable the attempt to use the\n" " EPRT command instead of PORT by using --disable-eprt. EPRT is really\n" " PORT++.\n" "\n" , stdout); fputs( " -q If used as the first parameter on the command line, the curlrc\n" " config file will not be read and used. See the -K/--config for\n" " details on the default config file search path.\n" "\n" " -Q/--quote \n" " (FTP/SFTP) Send an arbitrary command to the remote FTP or SFTP\n" " server. Quote commands are sent BEFORE the transfer is taking\n" " place (just after the initial PWD command in an FTP transfer, to\n" , stdout); fputs( " be exact). To make commands take place after a successful trans-\n" " fer, prefix them with a dash '-'. To make commands get sent\n" " after libcurl has changed working directory, just before the\n" " transfer command(s), prefix the command with '+' (this is only\n" " supported for FTP). You may specify any number of commands. If\n" " the server returns failure for one of the commands, the entire\n" , stdout); fputs( " operation will be aborted. You must send syntactically correct\n" " FTP commands as RFC959 defines to FTP servers, or one of the\n" " commands listed below to SFTP servers. This option can be used\n" " multiple times.\n" "\n" " SFTP is a binary protocol. Unlike for FTP, libcurl interprets\n" " SFTP quote commands before sending them to the server. Follow-\n" " ing is the list of all supported SFTP quote commands:\n" "\n" , stdout); fputs( " chgrp group file\n" " The chgrp command sets the group ID of the file named by\n" " the file operand to the group ID specified by the group\n" " operand. The group operand is a decimal integer group ID.\n" "\n" " chmod mode file\n" " The chmod command modifies the file mode bits of the\n" " specified file. The mode operand is an octal integer mode\n" " number.\n" "\n" , stdout); fputs( " chown user file\n" " The chown command sets the owner of the file named by the\n" " file operand to the user ID specified by the user\n" " operand. The user operand is a decimal integer user ID.\n" "\n" " ln source_file target_file\n" " The ln and symlink commands create a symbolic link at the\n" " target_file location pointing to the source_file loca-\n" " tion.\n" "\n" , stdout); fputs( " mkdir directory_name\n" " The mkdir command creates the directory named by the\n" " directory_name operand.\n" "\n" " pwd The pwd command returns the absolute pathname of the cur-\n" " rent working directory.\n" "\n" " rename source target\n" " The rename command renames the file or directory named by\n" " the source operand to the destination path named by the\n" , stdout); fputs( " target operand.\n" "\n" " rm file\n" " The rm command removes the file specified by the file\n" " operand.\n" "\n" " rmdir directory\n" " The rmdir command removes the directory entry specified\n" " by the directory operand, provided it is empty.\n" "\n" " symlink source_file target_file\n" " See ln.\n" "\n" " --random-file \n" , stdout); fputs( " (SSL) Specify the path name to file containing what will be con-\n" " sidered as random data. The data is used to seed the random\n" " engine for SSL connections. See also the --egd-file option.\n" "\n" " -r/--range \n" " (HTTP/FTP/FILE) Retrieve a byte range (i.e a partial document)\n" " from a HTTP/1.1, FTP server or a local FILE. Ranges can be spec-\n" " ified in a number of ways.\n" "\n" , stdout); fputs( " 0-499 specifies the first 500 bytes\n" "\n" " 500-999 specifies the second 500 bytes\n" "\n" " -500 specifies the last 500 bytes\n" "\n" " 9500- specifies the bytes from offset 9500 and forward\n" "\n" " 0-0,-1 specifies the first and last byte only(*)(H)\n" "\n" " 500-700,600-799\n" " specifies 300 bytes from offset 500(H)\n" "\n" " 100-199,500-599\n" , stdout); fputs( " specifies two separate 100 bytes ranges(*)(H)\n" "\n" " (*) = NOTE that this will cause the server to reply with a multipart\n" " response!\n" "\n" " Only digit characters (0-9) are valid in 'start' and 'stop' of range\n" " syntax 'start-stop'. If a non-digit character is given in the range,\n" " the server's response will be indeterminable, depending on different\n" " server's configuration.\n" "\n" , stdout); fputs( " You should also be aware that many HTTP/1.1 servers do not have this\n" " feature enabled, so that when you attempt to get a range, you'll\n" " instead get the whole document.\n" "\n" " FTP range downloads only support the simple syntax 'start-stop'\n" " (optionally with one of the numbers omitted). It depends on the non-RFC\n" " command SIZE.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" , stdout); fputs( " --raw When used, it disables all internal HTTP decoding of content or\n" " transfer encodings and instead makes them passed on unaltered,\n" " raw. (Added in 7.16.2)\n" "\n" " -R/--remote-time\n" " When used, this will make libcurl attempt to figure out the\n" " timestamp of the remote file, and if that is available make the\n" " local file get that same timestamp.\n" "\n" " --retry \n" , stdout); fputs( " If a transient error is returned when curl tries to perform a\n" " transfer, it will retry this number of times before giving up.\n" " Setting the number to 0 makes curl do no retries (which is the\n" " default). Transient error means either: a timeout, an FTP 5xx\n" " response code or an HTTP 5xx response code.\n" "\n" " When curl is about to retry a transfer, it will first wait one\n" , stdout); fputs( " second and then for all forthcoming retries it will double the\n" " waiting time until it reaches 10 minutes which then will be the\n" " delay between the rest of the retries. By using --retry-delay\n" " you disable this exponential backoff algorithm. See also\n" " --retry-max-time to limit the total time allowed for retries.\n" " (Added in 7.12.3)\n" "\n" , stdout); fputs( " If this option is used multiple times, the last occurrence\n" " decide the amount.\n" "\n" " --retry-delay \n" " Make curl sleep this amount of time between each retry when a\n" " transfer has failed with a transient error (it changes the\n" " default backoff time algorithm between retries). This option is\n" " only interesting if --retry is also used. Setting this delay to\n" , stdout); fputs( " zero will make curl use the default backoff time. (Added in\n" " 7.12.3)\n" "\n" " If this option is used multiple times, the last occurrence\n" " decide the amount.\n" "\n" " --retry-max-time \n" " The retry timer is reset before the first transfer attempt.\n" " Retries will be done as usual (see --retry) as long as the timer\n" " hasn't reached this given limit. Notice that if the timer hasn't\n" , stdout); fputs( " reached the limit, the request will be made and while perform-\n" " ing, it may take longer than this given time period. To limit a\n" " single request's maximum time, use -m/--max-time. Set this\n" " option to zero to not timeout retries. (Added in 7.12.3)\n" "\n" " If this option is used multiple times, the last occurrence\n" " decide the amount.\n" "\n" " -s/--silent\n" , stdout); fputs( " Silent mode. Don't show progress meter or error messages. Makes\n" " Curl mute.\n" "\n" " -S/--show-error\n" " When used with -s it makes curl show error message if it fails.\n" "\n" " --socks4 \n" " Use the specified SOCKS4 proxy. If the port number is not speci-\n" " fied, it is assumed at port 1080. (Added in 7.15.2)\n" "\n" " This option overrides any previous use of -x/--proxy, as they\n" , stdout); fputs( " are mutually exclusive.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --socks4a \n" " Use the specified SOCKS4a proxy. If the port number is not spec-\n" " ified, it is assumed at port 1080. (Added in 7.18.0)\n" "\n" " This option overrides any previous use of -x/--proxy, as they\n" " are mutually exclusive.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" , stdout); fputs( " --socks5-hostname \n" " Use the specified SOCKS5 proxy (and let the proxy resolve the\n" " host name). If the port number is not specified, it is assumed\n" " at port 1080. (Added in 7.18.0)\n" "\n" " This option overrides any previous use of -x/--proxy, as they\n" " are mutually exclusive.\n" "\n" " If this option is used several times, the last one will be used.\n" , stdout); fputs( " (This option was previously wrongly documented and used as\n" " --socks without the number appended.)\n" "\n" " --socks5 \n" " Use the specified SOCKS5 proxy - but resolve the host name\n" " locally. If the port number is not specified, it is assumed at\n" " port 1080.\n" "\n" " This option overrides any previous use of -x/--proxy, as they\n" " are mutually exclusive.\n" "\n" , stdout); fputs( " If this option is used several times, the last one will be used.\n" " (This option was previously wrongly documented and used as\n" " --socks without the number appended.)\n" "\n" " --stderr \n" " Redirect all writes to stderr to the specified file instead. If\n" " the file name is a plain '-', it is instead written to stdout.\n" " This option has no point when you're using a shell with decent\n" , stdout); fputs( " redirecting capabilities.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --tcp-nodelay\n" " Turn on the TCP_NODELAY option. See the curl_easy_setopt(3) man\n" " page for details about this option. (Added in 7.11.2)\n" "\n" " -t/--telnet-option \n" " Pass options to the telnet protocol. Supported options are:\n" "\n" " TTYPE= Sets the terminal type.\n" "\n" , stdout); fputs( " XDISPLOC= Sets the X display location.\n" "\n" " NEW_ENV= Sets an environment variable.\n" "\n" " -T/--upload-file \n" " This transfers the specified local file to the remote URL. If\n" " there is no file part in the specified URL, Curl will append the\n" " local file name. NOTE that you must use a trailing / on the last\n" " directory to really prove to Curl that there is no file name or\n" , stdout); fputs( " curl will think that your last directory name is the remote file\n" " name to use. That will most likely cause the upload operation to\n" " fail. If this is used on a http(s) server, the PUT command will\n" " be used.\n" "\n" " Use the file name \"-\" (a single dash) to use stdin instead of a\n" " given file.\n" "\n" " You can specify one -T for each URL on the command line. Each -T\n" , stdout); fputs( " + URL pair specifies what to upload and to where. curl also sup-\n" " ports \"globbing\" of the -T argument, meaning that you can upload\n" " multiple files to a single URL by using the same URL globbing\n" " style supported in the URL, like this:\n" "\n" " curl -T \"{file1,file2}\" http://www.uploadtothissite.com\n" "\n" " or even\n" "\n" " curl -T \"img[1-1000].png\" ftp://ftp.picturemania.com/upload/\n" "\n" " --trace \n" , stdout); fputs( " Enables a full trace dump of all incoming and outgoing data,\n" " including descriptive information, to the given output file. Use\n" " \"-\" as filename to have the output sent to stdout.\n" "\n" " This option overrides previous uses of -v/--verbose or --trace-\n" " ascii.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --trace-ascii \n" , stdout); fputs( " Enables a full trace dump of all incoming and outgoing data,\n" " including descriptive information, to the given output file. Use\n" " \"-\" as filename to have the output sent to stdout.\n" "\n" " This is very similar to --trace, but leaves out the hex part and\n" " only shows the ASCII part of the dump. It makes smaller output\n" " that might be easier to read for untrained humans.\n" "\n" , stdout); fputs( " This option overrides previous uses of -v/--verbose or --trace.\n" " If this option is used several times, the last one will be used.\n" "\n" " --trace-time\n" " Prepends a time stamp to each trace or verbose line that curl\n" " displays. (Added in 7.14.0)\n" "\n" " -u/--user \n" " Specify user and password to use for server authentication.\n" " Overrides -n/--netrc and --netrc-optional.\n" "\n" , stdout); fputs( " If you just give the user name (without entering a colon) curl\n" " will prompt for a password.\n" "\n" " If you use an SSPI-enabled curl binary and do NTLM authentica-\n" " tion, you can force curl to pick up the user name and password\n" " from your environment by simply specifying a single colon with\n" " this option: \"-u :\".\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" , stdout); fputs( " -U/--proxy-user \n" " Specify user and password to use for proxy authentication.\n" "\n" " If you use an SSPI-enabled curl binary and do NTLM authentica-\n" " tion, you can force curl to pick up the user name and password\n" " from your environment by simply specifying a single colon with\n" " this option: \"-U :\".\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " --url \n" , stdout); fputs( " Specify a URL to fetch. This option is mostly handy when you\n" " want to specify URL(s) in a config file.\n" "\n" " This option may be used any number of times. To control where\n" " this URL is written, use the -o/--output or the -O/--remote-name\n" " options.\n" "\n" " -v/--verbose\n" " Makes the fetching more verbose/talkative. Mostly usable for\n" " debugging. Lines starting with '>' means \"header data\" sent by\n" , stdout); fputs( " curl, '<' means \"header data\" received by curl that is hidden in\n" " normal cases and lines starting with '*' means additional info\n" " provided by curl.\n" "\n" " Note that if you only want HTTP headers in the output,\n" " -i/--include might be option you're looking for.\n" "\n" " If you think this option still doesn't give you enough details,\n" " consider using --trace or --trace-ascii instead.\n" "\n" , stdout); fputs( " This option overrides previous uses of --trace-ascii or --trace.\n" "\n" " -V/--version\n" " Displays information about curl and the libcurl version it uses.\n" " The first line includes the full version of curl, libcurl and\n" " other 3rd party libraries linked with the executable.\n" "\n" " The second line (starts with \"Protocols:\") shows all protocols\n" " that libcurl reports to support.\n" "\n" , stdout); fputs( " The third line (starts with \"Features:\") shows specific features\n" " libcurl reports to offer. Available features include:\n" "\n" " IPv6 You can use IPv6 with this.\n" "\n" " krb4 Krb4 for ftp is supported.\n" "\n" " SSL HTTPS and FTPS are supported.\n" "\n" " libz Automatic decompression of compressed files over HTTP is\n" " supported.\n" "\n" " NTLM NTLM authentication is supported.\n" "\n" " GSS-Negotiate\n" , stdout); fputs( " Negotiate authentication and krb5 for ftp is supported.\n" "\n" " Debug This curl uses a libcurl built with Debug. This enables\n" " more error-tracking and memory debugging etc. For curl-\n" " developers only!\n" "\n" " AsynchDNS\n" " This curl uses asynchronous name resolves.\n" "\n" " SPNEGO SPNEGO Negotiate authentication is supported.\n" "\n" " Largefile\n" , stdout); fputs( " This curl supports transfers of large files, files larger\n" " than 2GB.\n" "\n" " IDN This curl supports IDN - international domain names.\n" "\n" " SSPI SSPI is supported. If you use NTLM and set a blank user\n" " name, curl will authenticate with your current user and\n" " password.\n" "\n" " -w/--write-out \n" " Defines what to display on stdout after a completed and success-\n" , stdout); fputs( " ful operation. The format is a string that may contain plain\n" " text mixed with any number of variables. The string can be spec-\n" " ified as \"string\", to get read from a particular file you spec-\n" " ify it \"@filename\" and to tell curl to read the format from\n" " stdin you write \"@-\".\n" "\n" " The variables present in the output format will be substituted\n" , stdout); fputs( " by the value or text that curl thinks fit, as described below.\n" " All variables are specified like %{variable_name} and to output\n" " a normal % you just write them like %%. You can output a newline\n" " by using \\n, a carriage return with \\r and a tab space with \\t.\n" " NOTE: The %-letter is a special letter in the win32-environment,\n" " where all occurrences of % must be doubled when using this\n" " option.\n" "\n" , stdout); fputs( " Available variables are at this point:\n" "\n" " url_effective The URL that was fetched last. This is mostly\n" " meaningful if you've told curl to follow loca-\n" " tion: headers.\n" "\n" " http_code The numerical response code that was found in the\n" " last retrieved HTTP(S) or FTP(s) transfer. In\n" " 7.18.2 the alias response_code was added to show\n" , stdout); fputs( " the same info.\n" "\n" " http_connect The numerical code that was found in the last\n" " response (from a proxy) to a curl CONNECT\n" " request. (Added in 7.12.4)\n" "\n" " time_total The total time, in seconds, that the full opera-\n" " tion lasted. The time will be displayed with mil-\n" " lisecond resolution.\n" "\n" " time_namelookup\n" , stdout); fputs( " The time, in seconds, it took from the start\n" " until the name resolving was completed.\n" "\n" " time_connect The time, in seconds, it took from the start\n" " until the TCP connect to the remote host (or\n" " proxy) was completed.\n" "\n" " time_appconnect\n" " The time, in seconds, it took from the start\n" , stdout); fputs( " until the SSL/SSH/etc connect/handshake to the\n" " remote host was completed. (Added in 7.19.0)\n" "\n" " time_pretransfer\n" " The time, in seconds, it took from the start\n" " until the file transfer is just about to begin.\n" " This includes all pre-transfer commands and nego-\n" , stdout); fputs( " tiations that are specific to the particular pro-\n" " tocol(s) involved.\n" "\n" " time_redirect The time, in seconds, it took for all redirection\n" " steps include name lookup, connect, pretransfer\n" " and transfer before final transaction was\n" " started. time_redirect shows the complete execu-\n" , stdout); fputs( " tion time for multiple redirections. (Added in\n" " 7.12.3)\n" "\n" " time_starttransfer\n" " The time, in seconds, it took from the start\n" " until the first byte is just about to be trans-\n" " ferred. This includes time_pretransfer and also\n" " the time the server needs to calculate the\n" , stdout); fputs( " result.\n" "\n" " size_download The total amount of bytes that were downloaded.\n" "\n" " size_upload The total amount of bytes that were uploaded.\n" "\n" " size_header The total amount of bytes of the downloaded head-\n" " ers.\n" "\n" " size_request The total amount of bytes that were sent in the\n" " HTTP request.\n" "\n" , stdout); fputs( " speed_download The average download speed that curl measured for\n" " the complete download.\n" "\n" " speed_upload The average upload speed that curl measured for\n" " the complete upload.\n" "\n" " content_type The Content-Type of the requested document, if\n" " there was any.\n" "\n" " num_connects Number of new connects made in the recent trans-\n" , stdout); fputs( " fer. (Added in 7.12.3)\n" "\n" " num_redirects Number of redirects that were followed in the\n" " request. (Added in 7.12.3)\n" "\n" " redirect_url When a HTTP request was made without -L to follow\n" " redirects, this variable will show the actual URL\n" " a redirect would take you to. (Added in 7.18.2)\n" "\n" , stdout); fputs( " ftp_entry_path The initial path libcurl ended up in when logging\n" " on to the remote FTP server. (Added in 7.15.4)\n" "\n" " ssl_verify_result\n" " The result of the SSL peer certificate verifica-\n" " tion that was requested. 0 means the verification\n" " was successful. (Added in 7.19.0)\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" , stdout); fputs( " -x/--proxy \n" " Use specified HTTP proxy. If the port number is not specified,\n" " it is assumed at port 1080.\n" "\n" " This option overrides existing environment variables that sets\n" " proxy to use. If there's an environment variable setting a\n" " proxy, you can set proxy to \"\" to override it.\n" "\n" " Note that all operations that are performed over a HTTP proxy\n" , stdout); fputs( " will transparently be converted to HTTP. It means that certain\n" " protocol specific operations might not be available. This is not\n" " the case if you can tunnel through the proxy, as done with the\n" " -p/--proxytunnel option.\n" "\n" " Starting with 7.14.1, the proxy host can be specified the exact\n" " same way as the proxy environment variables, include protocol\n" " prefix (http://) and embedded user + password.\n" "\n" , stdout); fputs( " If this option is used several times, the last one will be used.\n" "\n" " -X/--request \n" " (HTTP) Specifies a custom request method to use when communicat-\n" " ing with the HTTP server. The specified request will be used\n" " instead of the method otherwise used (which defaults to GET).\n" " Read the HTTP 1.1 specification for details and explanations.\n" "\n" , stdout); fputs( " (FTP) Specifies a custom FTP command to use instead of LIST when\n" " doing file lists with ftp.\n" "\n" " If this option is used several times, the last one will be used.\n" "\n" " -y/--speed-time