~ubuntu-branches/ubuntu/lucid/curl/lucid-security

<p class="level0"><a name="NAME"></a><h2 class="nroffsh">NAME</h2>

<p class="level0">curl - transfer a URL <a name="SYNOPSIS"></a><h2 class="nroffsh">SYNOPSIS</h2>

<p class="level0"><span Class="bold">curl [options]</span> <a class="emphasis" href="#URL">[URL...]</a> <a name="DESCRIPTION"></a><h2 class="nroffsh">DESCRIPTION</h2>

<p class="level0">curl offers a busload of useful tricks like proxy support, user authentication, ftp upload, HTTP post, SSL (https:) connections, cookies, file transfer resume and more. As you will see below, the amount of features will make your head spin! 

<p class="level0">curl is powered by libcurl for all transfer-related features. See <span Class="manpage">libcurl (3)</span> for details. <a name="URL"></a><h2 class="nroffsh">URL</h2>

<p class="level0">The URL syntax is protocol dependent. You'll find a detailed description in RFC 2396. 

<p class="level0">No nesting of the sequences is supported at the moment, but you can use several ones next to each other: 

<p class="level0">&nbsp;<a href="http://any.org/archive">http://any.org/archive</a>[1996-1999]/vol[1-4]/part{a,b,c}.html 

<p class="level0">You can specify any amount of URLs on the command line. They will be fetched in a sequential manner in the specified order. 

<p class="level0">Curl will attempt to re-use connections for multiple file transfers, so that getting many files from the same server will not do multiple connects / handshakes. This improves speed. Of course this is only done on files specified on a single command line and cannot be used between separate curl invokes. <a name="OPTIONS"></a><h2 class="nroffsh">OPTIONS</h2>

<p class="level0">

<p class="level0"><a name="-a--append"></a><span class="nroffip">-a/--append</span> 

<p class="level0"><a name="--ftp-pasv"></a><span class="nroffip">--ftp-pasv</span> 

<p class="level1">(FTP) Use PASV when transferring. PASV is the internal default behavior, but using this option can be used to override a previous --ftp-port option. (Added in 7.11.0) 

<p class="level1">If this option is used twice, the second will again disable silent failure. 

<p class="level0"><a name="--ftp-ssl"></a><span class="nroffip">--ftp-ssl</span> 

<p class="level1">(FTP) Make the FTP connection switch to use SSL/TLS. (Added in 7.11.0) 

<p class="level1">If this option is used twice, the second will again disable this. 

<p class="level1">Usage help. 

<p class="level0"><a name="-H--header"></a><span class="nroffip">-H/--header &lt;header&gt;</span> 

<p class="level1">(HTTP) Extra header to use when getting a web page. You may specify any number of extra headers. Note that if you should add a custom header that has the same name as one of the internal ones curl would use, your externally set header will be used instead of the internal one. This allows you to make even trickier stuff than curl would normally do. You should not replace internally set headers without knowing perfectly well what you're doing. Replacing an internal header with one without content on the right side of the colon will prevent that header from appearing. 

<p class="level1">See also the <a class="emphasis" href="#-A--user-agent">-A/--user-agent</a> and <a class="emphasis" href="#-e--referer">-e/--referer</a> options. 

<p class="level1">This option can be used multiple times to add/replace/remove multiple headers. 

<p class="level0"><a name="-i--include"></a><span class="nroffip">-i/--include</span> 

<p class="level1">(HTTP) Include the HTTP-header in the output. The HTTP-header includes things like server-name, date of the document, HTTP-version and more... 

<p class="level1">If this option is used twice, the second will again disable header include. 

<p class="level1">Specify the maximum size (in bytes) of a file to download. If the file requested is larger than this value, the transfer will not start and curl will return with exit code 63. 

<p class="level1">NOTE: The file size is not always known prior to download, and for such files this option has no effect even if the file transfer ends up being larger than this given limit. This concerns both FTP and HTTP transfers. 

<p class="level0"><a name="-m--max-time"></a><span class="nroffip">-m/--max-time &lt;seconds&gt;</span> 

<p class="level1">If this option is used several times, the last one will be used. 

<p class="level0"><a name="-M--manual"></a><span class="nroffip">-M/--manual</span> 

<p class="level1">Manual. Display the huge help text. 

<p class="level0"><a name="--negotiate"></a><span class="nroffip">--negotiate</span> 

<p class="level1">(HTTP) Enables GSS-Negotiate authentication. The GSS-Negotiate method was designed by Microsoft and is used in their web applications. It is primarily meant as a support for Kerberos5 authentication but may be also used along with another authentication methods. For more information see IETF draft draft-brezak-spnego-http-04.txt. (Added in 7.10.6) 

<p class="level1">This option requires that the library was built with GSSAPI support. This is not very common. Use <a class="emphasis" href="#-V--version">-V/--version</a> to see if your version supports GSS-Negotiate. 

<p class="level1">If this option is used several times, the following occurrences make no difference. 

<p class="level0"><a name="-N--no-buffer"></a><span class="nroffip">-N/--no-buffer</span> 

<p class="level1">Disables the buffering of the output stream. In normal work situations, curl will use a standard buffered output stream that will have the effect that it will output the data in chunks, not necessarily exactly when the data arrives. Using this option will disable that buffering. 

<p class="level2"><span Class="bold">0-499</span> specifies the first 500 bytes 

<p class="level2"><span Class="bold">500-999</span> specifies the second 500 bytes 

<p class="level2"><span Class="bold">-500</span> specifies the last 500 bytes 

<p class="level2"><span Class="bold">0-0,-1</span> specifies the first and last byte only(*)(H) 

<p class="level2"><span Class="bold">500-700,600-799</span> specifies 300 bytes from offset 500(H) 

<p class="level2"><span Class="bold">100-199,500-599</span> specifies two separate 100 bytes ranges(*)(H) 

<p class="level1">If this option is used several times, each occurrence will toggle it on/off. (Added in 7.14.0        ) 

<p class="level0"><a name="-u--user"></a><span class="nroffip">-u/--user &lt;user:password&gt;</span> 

<p class="level1">Specify user and password to use for server authentication. Overrides <a class="emphasis" href="#-n--netrc">-n/--netrc</a> and <a class="emphasis" href="#--netrc-optional">--netrc-optional</a>. 

<p class="level1">If this option is used several times, the last one will be used. 

<p class="level0"><a name="-U--proxy-user"></a><span class="nroffip">-U/--proxy-user &lt;user:password&gt;</span> 

<p class="level1">Specify user and password to use for proxy authentication. 

<p class="level1">If this option is used several times, the last one will be used. 

<p class="level0"><a name="--url"></a><span class="nroffip">--url &lt;URL&gt;</span> 

<p class="level1">Specify a URL to fetch. This option is mostly handy when you want to specify URL(s) in a config file. 

<p class="level2">SSPI is supported. If you use NTLM and set a blank user name, curl will authenticate with your current user and password. 

<p class="level1">

<p class="level0"><a name="-w--write-out"></a><span class="nroffip">-w/--write-out &lt;format&gt;</span> 

<p class="level1">The variables present in the output format will be substituted by the value or text that curl thinks fit, as described below. All variables are specified like %{variable_name} and to output a normal % you just write them like %%. You can output a newline by using n, a carriage return with r and a tab space with t. 

<p class="level1"><span Class="bold">NOTE:</span> The %-letter is a special letter in the win32-environment, where all occurrences of % must be doubled when using this option. 

<p class="level1">Available variables are at this point: 

<p class="level1">Use specified HTTP proxy. If the port number is not specified, it is assumed at port 1080. 

<p class="level1">This option overrides existing environment variables that sets proxy to use. If there's an environment variable setting a proxy, you can set proxy to "" to override it. 

<p class="level1"><span Class="bold">Note</span> that all operations that are performed over a HTTP proxy will transparently be converted to HTTP. It means that certain protocol specific operations might not be available. This is not the case if you can tunnel through the proxy, as done with the <a class="emphasis" href="#-p--proxytunnel">-p/--proxytunnel</a> option. 

<p class="level1">If this option is used several times, the last one will be used. 

<p class="level0"><a name="-X--request"></a><span class="nroffip">-X/--request &lt;command&gt;</span> 

<p class="level1">(FTP) Specifies a custom FTP command to use instead of LIST when doing file lists with ftp. 

<p class="level1">If this option is used several times, the last one will be used. 

<p class="level0"><a name="-y--speed-time"></a><span class="nroffip">-y/--speed-time &lt;time&gt;</span> 

<p class="level1">Start the date expression with a dash (-) to make it request for a document that is older than the given date/time, default is a document that is newer than the specified date/time. 

<p class="level1">If this option is used several times, the last one will be used. 

<p class="level0"><a name="--max-redirs"></a><span class="nroffip">--max-redirs &lt;num&gt;</span> 

<p class="level1">If this option is used several times, the last one will be used. 

<p class="level0"><a name="-0--http10"></a><span class="nroffip">-0/--http1.0</span> 

<p class="level1">(HTTP) Forces curl to issue its requests using HTTP 1.0 instead of using its internally preferred: HTTP 1.1. 

<p class="level0"><a name="8"></a><span class="nroffip">8</span> 

<p class="level1">FTP weird server reply. The server sent data curl couldn't parse. 

<p class="level0"><a name="9"></a><span class="nroffip">9</span> 

<p class="level0"><a name="10"></a><span class="nroffip">10</span> 

<p class="level1">FTP user/password incorrect. Either one or both were not accepted by the server. 

<p class="level0"><a name="11"></a><span class="nroffip">11</span>