54
54
<p class="level0"> <a href="http://site">http://site</a>.{one,two,three}.com
55
55
<p class="level0">or you can get sequences of alphanumeric series by using [] as in:
56
56
<p class="level0"> <a href="ftp://ftp.numericals.com/file">ftp://ftp.numericals.com/file</a>[1-100].txt <a href="ftp://ftp.numericals.com/file">ftp://ftp.numericals.com/file</a>[001-100].txt (with leading zeros) <a href="ftp://ftp.letters.com/file">ftp://ftp.letters.com/file</a>[a-z].txt
57
<p class="level0">No nesting of the sequences is supported at the moment:
58
<p class="level0"> <a href="http://www.any.org/archive">http://www.any.org/archive</a>[1996-1999]/volume[1-4]part{a,b,c,index}.html
57
<p class="level0">No nesting of the sequences is supported at the moment, but you can use several ones next to each other:
58
<p class="level0"> <a href="http://any.org/archive">http://any.org/archive</a>[1996-1999]/vol[1-4]/part{a,b,c}.html
59
59
<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.
60
60
<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>
67
67
<p class="level1">If this option is set more than once, the last one will be the one that's used.
68
68
<p class="level0"><a name="--anyauth"></a><span class="nroffip">--anyauth</span>
69
69
<p class="level1">(HTTP) Tells curl to figure out authentication method by itself, and use the most secure one the remote site claims it supports. This is done by first doing a request and checking the response-headers, thus inducing an extra network round-trip. This is used instead of setting a specific authentication method, which you can do with <a class="emphasis" href="#--basic">--basic</a>, <a class="emphasis" href="#--digest">--digest</a>, <a class="emphasis" href="#--ntlm">--ntlm</a>, and <a class="emphasis" href="#--negotiate">--negotiate</a>. (Added in 7.10.6)
70
<p class="level1">Note that using --anyauth is not recommended if you do uploads from stdin, since it may require data to be sent twice and then the client must be able to rewind. If the need should arise when uploading from stdin, the upload operation will fail.
70
71
<p class="level1">If this option is used several times, the following occurrences make no difference.
71
72
<p class="level0"><a name="-b--cookie"></a><span class="nroffip">-b/--cookie <name=data></span>
72
73
<p class="level1">(HTTP) Pass the data to the HTTP server as a cookie. It is supposedly the data previously received from the server in a "Set-Cookie:" line. The data should be in the format "NAME1=VALUE1; NAME2=VALUE2".
86
87
<p class="level1">(HTTP) Request a compressed response using one of the algorithms libcurl supports, and return the uncompressed document. If this option is used and the server sends an unsupported encoding, Curl will report an error.
87
88
<p class="level1">If this option is used several times, each occurrence will toggle it on/off.
88
89
<p class="level0"><a name="--connect-timeout"></a><span class="nroffip">--connect-timeout <seconds></span>
89
<p class="level1">Maximum time in seconds that you allow the connection to the server to take. This only limits the connection phase, once curl has connected this option is of no more use. See also the <span Class="emphasis">--max-time</span> option.
90
<p class="level1">Maximum time in seconds that you allow the connection to the server to take. This only limits the connection phase, once curl has connected this option is of no more use. See also the <a class="emphasis" href="#-m--max-time">-m/--max-time</a> option.
90
91
<p class="level1">If this option is used several times, the last one will be used.
91
92
<p class="level0"><a name="-c--cookie-jar"></a><span class="nroffip">-c/--cookie-jar <file name></span>
92
93
<p class="level1">Specify to which file you want curl to write all cookies after a completed operation. Curl writes all cookies previously read from a specified file as well as all cookies received from remote server(s). If no cookies are known, no file will be written. The file will be written using the Netscape cookie file format. If you set the file name to a single dash, "-", the cookies will be written to stdout.
93
94
<p class="level1"><span Class="bold">NOTE</span> If the cookie jar can't be created or written to, the whole curl operation won't fail or even report an error clearly. Using -v will get a warning displayed, but that is the only visible feedback you get about this possibly lethal situation.
94
<p class="level1">If this option is used several times, the last specfied file name will be used.
95
<p class="level1">If this option is used several times, the last specified file name will be used.
95
96
<p class="level0"><a name="-C--continue-at"></a><span class="nroffip">-C/--continue-at <offset></span>
96
<p class="level1">Continue/Resume a previous file transfer at the given offset. The given offset is the exact number of bytes that will be skipped counted from the beginning of the source file before it is transfered to the destination. If used with uploads, the ftp server command SIZE will not be used by curl.
97
<p class="level1">Continue/Resume a previous file transfer at the given offset. The given offset is the exact number of bytes that will be skipped counted from the beginning of the source file before it is transferred to the destination. If used with uploads, the ftp server command SIZE will not be used by curl.
97
98
<p class="level1">Use "-C -" to tell curl to automatically find out where/how to resume the transfer. It then uses the given output/input files to figure that out.
98
99
<p class="level1">If this option is used several times, the last one will be used.
99
100
<p class="level0"><a name="--create-dirs"></a><span class="nroffip">--create-dirs</span>
100
<p class="level1">When used in conjunction with the -o option, curl will create the necessary local directory hierarchy as needed.
101
<p class="level1">When used in conjunction with the -o option, curl will create the necessary local directory hierarchy as needed. This option creates the dirs mentioned with the -o option, nothing else. If the -o file name uses no dir or if the dirs it mentions already exist, no dir will be created.
102
<p class="level1">To create remote directories when using FTP, try <a class="emphasis" href="#--ftp-create-dirs">--ftp-create-dirs</a>.
101
103
<p class="level0"><a name="--crlf"></a><span class="nroffip">--crlf</span>
102
104
<p class="level1">(FTP) Convert LF to CRLF in upload. Useful for MVS (OS/390).
103
105
<p class="level1">If this option is used twice, the second will again disable crlf converting.
117
119
<p class="level1">(HTTP) Enables HTTP Digest authentication. This is a authentication that prevents the password from being sent over the wire in clear text. Use this in combination with the normal <a class="emphasis" href="#-u--user">-u/--user</a> option to set user name and password. See also <a class="emphasis" href="#--ntlm">--ntlm</a>, <a class="emphasis" href="#--negotiate">--negotiate</a> and <a class="emphasis" href="#--anyauth">--anyauth</a> for related options. (Added in curl 7.10.6)
118
120
<p class="level1">If this option is used several times, the following occurrences make no difference.
119
121
<p class="level0"><a name="--disable-eprt"></a><span class="nroffip">--disable-eprt</span>
120
<p class="level1">(FTP) Tell curl to disable the use of the EPRT and LPRT commands when doing active FTP transfers. Curl will normally always first attempt to use EPRT, then LPRT before using PORT, but with this option, it will use PORT right away. EPRT and LPRT are extensions to the original FTP protocol, may not work on all servers but enable more functionality in a better way than the traditional PORT command. (Aded in 7.10.5)
122
<p class="level1">(FTP) Tell curl to disable the use of the EPRT and LPRT commands when doing active FTP transfers. Curl will normally always first attempt to use EPRT, then LPRT before using PORT, but with this option, it will use PORT right away. EPRT and LPRT are extensions to the original FTP protocol, may not work on all servers but enable more functionality in a better way than the traditional PORT command. (Added in 7.10.5)
121
123
<p class="level1">If this option is used several times, each occurrence will toggle this on/off.
122
124
<p class="level0"><a name="--disable-epsv"></a><span class="nroffip">--disable-epsv</span>
123
125
<p class="level1">(FTP) Tell curl to disable the use of the EPSV command when doing passive FTP transfers. Curl will normally always first attempt to use EPSV before PASV, but with this option, it will not try using EPSV.
130
132
<p class="level0"><a name="-e--referer"></a><span class="nroffip">-e/--referer <URL></span>
131
133
<p class="level1">(HTTP) Sends the "Referer Page" information to the HTTP server. This can also be set with the <a class="emphasis" href="#-H--header">-H/--header</a> flag of course. When used with <a class="emphasis" href="#-L--location">-L/--location</a> you can append ";auto" to the referer URL to make curl automatically set the previous URL when it follows a Location: header. The ";auto" string can be used alone, even if you don't set an initial referer.
132
134
<p class="level1">If this option is used several times, the last one will be used.
135
<p class="level0"><a name="--engine"></a><span class="nroffip">--engine <name></span>
136
<p class="level1">Select the OpenSSL crypto engine to use for cipher operations. Use <a class="emphasis" href="#--engine">--engine list</a> to print a list of build-time supported engines. Note that not all (or none) of the engines may be available at run-time.
133
137
<p class="level0"><a name="--environment"></a><span class="nroffip">--environment</span>
134
138
<p class="level1">(RISC OS ONLY) Sets a range of environment variables, using the names the -w option supports, to easier allow extraction of useful information after having run curl.
135
139
<p class="level1">If this option is used several times, each occurrence will toggle this on/off.
156
160
<p class="level1">(FTP) When an FTP URL/operation uses a path that doesn't currently exist on the server, the standard behavior of curl is to fail. Using this option, curl will instead attempt to create missing directories. (Added in 7.10.7)
157
161
<p class="level1">If this option is used twice, the second will again disable silent failure.
158
162
<p class="level0"><a name="--ftp-pasv"></a><span class="nroffip">--ftp-pasv</span>
159
<p class="level1">(FTP) Use PASV when transfering. PASV is the internal default behavior, but using this option can be used to override a previos --ftp-port option. (Added in 7.11.0)
163
<p class="level1">(FTP) Use PASV when transfering. 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)
160
164
<p class="level1">If this option is used twice, the second will again disable silent failure.
161
165
<p class="level0"><a name="--ftp-ssl"></a><span class="nroffip">--ftp-ssl</span>
162
166
<p class="level1">(FTP) Make the FTP connection switch to use SSL/TLS. (Added in 7.11.0)
163
<p class="level1">If this option is used twice, the second will again disable silent failure.
167
<p class="level1">If this option is used twice, the second will again disable this.
164
168
<p class="level0"><a name="-F--form"></a><span class="nroffip">-F/--form <name=content></span>
165
<p class="level1">(HTTP) This lets curl emulate a filled in form in which a user has pressed the submit button. This causes curl to POST data using the content-type multipart/form-data according to RFC1867. This enables uploading of binary files etc. To force the 'content' part to be be a file, prefix the file name with an @ sign. To just get the content part from a file, prefix the file name with the letter <. The difference between @ and < is then that @ makes a file get attached in the post as a file upload, while the < makes a text field and just get the contents for that text field from a file.
169
<p class="level1">(HTTP) This lets curl emulate a filled in form in which a user has pressed the submit button. This causes curl to POST data using the Content-Type multipart/form-data according to RFC1867. This enables uploading of binary files etc. To force the 'content' part to be a file, prefix the file name with an @ sign. To just get the content part from a file, prefix the file name with the letter <. The difference between @ and < is then that @ makes a file get attached in the post as a file upload, while the < makes a text field and just get the contents for that text field from a file.
166
170
<p class="level1">Example, to send your password file to the server, where 'password' is the name of the form-field to which /etc/passwd will be the input:
167
171
<p class="level1"><span Class="bold">curl</span> -F password=@/etc/passwd www.mypasswords.com
168
<p class="level1">To read the file's content from stdin insted of a file, use - where the file name should've been. This goes for both @ and < constructs.
169
<p class="level1">You can also tell curl what Content-Type to use for the file upload part, by using 'type=', in a manner similar to:
172
<p class="level1">To read the file's content from stdin instead of a file, use - where the file name should've been. This goes for both @ and < constructs.
173
<p class="level1">You can also tell curl what Content-Type to use by using 'type=', in a manner similar to:
170
174
<p class="level1"><span Class="bold">curl</span> -F "web=@index.html;type=text/html" url.com
176
<p class="level1"><span Class="bold">curl</span> -F "name=daniel;type=text/foo" url.com
171
177
<p class="level1">See further examples and details in the MANUAL.
172
178
<p class="level1">This option can be used multiple times.
173
179
<p class="level0"><a name="-g--globoff"></a><span class="nroffip">-g/--globoff</span>
193
199
<p class="level1">(HTTP/FTP/FILE) Fetch the HTTP-header only! HTTP-servers feature the command HEAD which this uses to get nothing but the header of a document. When used on a FTP or FILE file, curl displays the file size and last modification time only.
194
200
<p class="level1">If this option is used twice, the second will again disable header only.
195
201
<p class="level0"><a name="-j--junk-session-cookies"></a><span class="nroffip">-j/--junk-session-cookies</span>
196
<p class="level1">(HTTP) When curl is told to read cookies from a given file, this option will make it discard all "session cookies". This will basicly have the same effect as if a new session is started. Typical browsers always discard session cookies when they're closed down. (Added in 7.9.7)
202
<p class="level1">(HTTP) When curl is told to read cookies from a given file, this option will make it discard all "session cookies". This will basically have the same effect as if a new session is started. Typical browsers always discard session cookies when they're closed down. (Added in 7.9.7)
197
203
<p class="level1">If this option is used several times, each occurrence will toggle this on/off.
198
204
<p class="level0"><a name="-k--insecure"></a><span class="nroffip">-k/--insecure</span>
199
205
<p class="level1">(SSL) This option explicitly allows curl to perform "insecure" SSL connections and transfers. Starting with curl 7.10, all SSL connections will be attempted to be made secure by using the CA certificate bundle installed by default. This makes all connections considered "insecure" to fail unless <a class="emphasis" href="#-k--insecure">-k/--insecure</a> is used.
206
212
<p class="level1">If this option is used several times, the last one will be used.
207
213
<p class="level0"><a name="--krb4"></a><span class="nroffip">--krb4 <level></span>
208
214
<p class="level1">(FTP) Enable kerberos4 authentication and use. The level must be entered and should be one of 'clear', 'safe', 'confidential' or 'private'. Should you use a level that is not one of these, 'private' will instead be used.
209
<p class="level1">This option requiures that the library was built with kerberos4 support. This is not very common. Use <a class="emphasis" href="#-V--version">-V/--version</a> to see if your curl supports it.
215
<p class="level1">This option requires that the library was built with kerberos4 support. This is not very common. Use <a class="emphasis" href="#-V--version">-V/--version</a> to see if your curl supports it.
210
216
<p class="level1">If this option is used several times, the last one will be used.
211
217
<p class="level0"><a name="-K--config"></a><span class="nroffip">-K/--config <config file></span>
212
218
<p class="level1">Specify which config file to read curl arguments from. The config file is a text file in which command line arguments can be written which then will be used as if they were written on the actual command line. Options and their parameters must be specified on the same config file line. If the parameter is to contain white spaces, the parameter must be inclosed within quotes. If the first column of a config line is a '#' character, the rest of the line will be treated as a comment.
246
252
<p class="level0"><a name="--netrc-optional"></a><span class="nroffip">--netrc-optional</span>
247
253
<p class="level1">Very similar to <span Class="emphasis">--netrc</span>, but this option makes the .netrc usage <span Class="bold">optional</span> and not mandatory as the <span Class="emphasis">--netrc</span> does.
248
254
<p class="level0"><a name="--negotiate"></a><span class="nroffip">--negotiate</span>
249
<p class="level1">(HTTP) Enables GSS-Negotiate authentication. The GSS-Negotiate method was designed by Microsoft and is used in their web aplications. 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)
250
<p class="level1">This option requiures 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.
255
<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)
256
<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.
251
257
<p class="level1">If this option is used several times, the following occurrences make no difference.
252
258
<p class="level0"><a name="-N--no-buffer"></a><span class="nroffip">-N/--no-buffer</span>
253
259
<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.
255
261
<p class="level0"><a name="--ntlm"></a><span class="nroffip">--ntlm</span>
256
262
<p class="level1">(HTTP) Enables NTLM authentication. The NTLM authentication method was designed by Microsoft and is used by IIS web servers. It is a proprietary protocol, reversed engineered by clever people and implemented in curl based on their efforts. This kind of behavior should not be endorsed, you should encourage everyone who uses NTLM to switch to a public and documented authentication method instead. Such as Digest. (Added in 7.10.6)
257
263
<p class="level1">If you want to enable NTLM for your proxy authentication, then use <a class="emphasis" href="#--proxy-ntlm">--proxy-ntlm</a>.
258
<p class="level1">This option requiures that the library was built with SSL support. Use <a class="emphasis" href="#-V--version">-V/--version</a> to see if your curl supports NTLM.
264
<p class="level1">This option requires that the library was built with SSL support. Use <a class="emphasis" href="#-V--version">-V/--version</a> to see if your curl supports NTLM.
259
265
<p class="level1">If this option is used several times, the following occurrences make no difference.
260
266
<p class="level0"><a name="-o--output"></a><span class="nroffip">-o/--output <file></span>
261
267
<p class="level1">Write output to <file> instead of stdout. If you are using {} or [] to fetch multiple documents, you can use '#' followed by a number in the <file> specifier. That variable will be replaced with the current string for the URL being fetched. Like in:
270
276
<p class="level0"><a name="--pass"></a><span class="nroffip">--pass <phrase></span>
271
277
<p class="level1">(SSL) Pass phrase for the private key
272
278
<p class="level1">If this option is used several times, the last one will be used.
279
<p class="level0"><a name="--proxy-basic"></a><span class="nroffip">--proxy-basic</span>
280
<p class="level1">Tells curl to use HTTP Basic authentication when communicating with the given proxy. Use <a class="emphasis" href="#--basic">--basic</a> for enabling HTTP Basic with a remote host. Basic is the default authentication method curl uses with proxies.
281
<p class="level1">If this option is used twice, the second will again disable proxy HTTP Basic authentication.
282
<p class="level0"><a name="--proxy-digest"></a><span class="nroffip">--proxy-digest</span>
283
<p class="level1">Tells curl to use HTTP Digest authentication when communicating with the given proxy. Use <a class="emphasis" href="#--digest">--digest</a> for enabling HTTP Digest with a remote host.
284
<p class="level1">If this option is used twice, the second will again disable proxy HTTP Digest.
273
285
<p class="level0"><a name="--proxy-ntlm"></a><span class="nroffip">--proxy-ntlm</span>
274
<p class="level1">Tells curl to use NTLM authentication when communicating with the given proxy. Use <a class="emphasis" href="#--ntlm">--ntlm</a> for enabling NTLM with a remote host.
275
<p class="level1">If this option is used twice, the second will again disable proxy NTLM.
286
<p class="level1">Tells curl to use HTTP NTLM authentication when communicating with the given proxy. Use <a class="emphasis" href="#--ntlm">--ntlm</a> for enabling NTLM with a remote host.
287
<p class="level1">If this option is used twice, the second will again disable proxy HTTP NTLM.
276
288
<p class="level0"><a name="-p--proxytunnel"></a><span class="nroffip">-p/--proxytunnel</span>
277
289
<p class="level1">When an HTTP proxy is used (<a class="emphasis" href="#-x--proxy">-x/--proxy</a>), this option will cause non-HTTP protocols to attempt to tunnel through the proxy instead of merely using it to do HTTP-like operations. The tunnel approach is made with the HTTP proxy CONNECT request and requires that the proxy allows direct connect to the remote port number curl wants to tunnel through to.
278
290
<p class="level1">If this option is used twice, the second will again disable proxy tunnel.
292
304
<p class="level0"><a name="-q"></a><span class="nroffip">-q</span>
293
305
<p class="level1">If used as the first parameter on the command line, the <span Class="emphasis">$HOME/.curlrc</span> file will not be read and used as a config file.
294
306
<p class="level0"><a name="-Q--quote"></a><span class="nroffip">-Q/--quote <comand></span>
295
<p class="level1">(FTP) Send an arbitrary command to the remote FTP server, by using the QUOTE command of the server. Not all servers support this command, and the set of QUOTE commands are server specific! Quote commands are sent BEFORE the transfer is taking place. To make commands take place after a successful transfer, prefix them with a dash '-'. You may specify any amount of commands to be run before and after the transfer. If the server returns failure for one of the commands, the entire operation will be aborted.
307
<p class="level1">(FTP) Send an arbitrary command to the remote FTP server. Quote commands are sent BEFORE the transfer is taking place. To make commands take place after a successful transfer, prefix them with a dash '-'. You may specify any amount of commands to be run before and after the transfer. If the server returns failure for one of the commands, the entire operation will be aborted. You must send syntactically correct FTP commands as RFC959 defines.
296
308
<p class="level1">This option can be used multiple times.
297
309
<p class="level0"><a name="--random-file"></a><span class="nroffip">--random-file <file></span>
298
310
<p class="level1">(HTTPS) Specify the path name to file containing what will be considered as random data. The data is used to seed the random engine for SSL connections. See also the <a class="emphasis" href="#--egd-file">--egd-file</a> option.
314
326
<p class="level0"><a name="-R--remote-time"></a><span class="nroffip">-R/--remote-time</span>
315
327
<p class="level1">When used, this will make libcurl attempt to figure out the timestamp of the remote file, and if that is available make the local file get that same timestamp.
316
328
<p class="level1">If this option is used twice, the second time disables this again.
329
<p class="level0"><a name="--retry"></a><span class="nroffip">--retry <num></span>
330
<p class="level1">If a transient error is returned when curl tries to perform a transfer, it will retry this number of times before giving up. Setting the number to 0 makes curl do no retries (which is the default). Transient error means either: a timeout, an FTP 5xx response code or an HTTP 5xx response code.
331
<p class="level1">When curl is about to retry a transfer, it will first wait one second and then for all forthcoming retries it will double the waiting time until it reaches 10 minutes which then will be the delay between the rest of the retries. By using <a class="emphasis" href="#--retry-delay">--retry-delay</a> you disable this exponential backoff algorithm. See also <a class="emphasis" href="#--retry-max-time">--retry-max-time</a> to limit the total time allowed for retries. (Option added in 7.12.3)
332
<p class="level1">If this option is used multiple times, the last occurrence decide the amount.
333
<p class="level0"><a name="--retry-delay"></a><span class="nroffip">--retry-delay <seconds></span>
334
<p class="level1">Make curl sleep this amount of time between each retry when a transfer has failed with a transient error (it changes the default backoff time algorithm between retries). This option is only interesting if <a class="emphasis" href="#--retry">--retry</a> is also used. Setting this delay to zero will make curl use the default backoff time. (Option added in 7.12.3)
335
<p class="level1">If this option is used multiple times, the last occurrence decide the amount.
336
<p class="level0"><a name="--retry-max-time"></a><span class="nroffip">--retry-max-time <seconds></span>
337
<p class="level1">The retry timer is reset before the first transfer attempt. Retries will be done as usual (see <a class="emphasis" href="#--retry">--retry</a>) as long as the timer hasn't reached this given limit. Notice that if the timer hasn't reached the limit, the request will be made and while performing, it may take longer than this given time period. To limit a single request´s maximum time, use <a class="emphasis" href="#-m--max-time">-m/--max-time</a>. Set this option to zero to not timeout retries. (Option added in 7.12.3)
338
<p class="level1">If this option is used multiple times, the last occurrence decide the amount.
317
339
<p class="level0"><a name="-s--silent"></a><span class="nroffip">-s/--silent</span>
318
340
<p class="level1">Silent mode. Don't show progress meter or error messages. Makes Curl mute.
319
341
<p class="level1">If this option is used twice, the second will again disable mute.
329
351
<p class="level1">If this option is used several times, the last one will be used.
330
352
<p class="level0"><a name="--tcp-nodelay"></a><span class="nroffip">--tcp-nodelay</span>
331
353
<p class="level1">Turn on the TCP_NODELAY option. See the <span Class="emphasis">curl_easy_setopt(3)</span> man page for details about this option. (Added in 7.11.2)
332
<p class="level1">If this option is used several times, each occurance toggles this on/off.
354
<p class="level1">If this option is used several times, each occurrence toggles this on/off.
333
355
<p class="level0"><a name="-t--telnet-option"></a><span class="nroffip">-t/--telnet-option <OPT=val></span>
334
356
<p class="level1">Pass options to the telnet protocol. Supported options are:
335
357
<p class="level1">TTYPE=<term> Sets the terminal type.
361
383
<p class="level1">This option may be used any number of times. To control where this URL is written, use the <a class="emphasis" href="#-o--output">-o/--output</a> or the <a class="emphasis" href="#-O--remote-name">-O/--remote-name</a> options.
362
384
<p class="level0"><a name="-v--verbose"></a><span class="nroffip">-v/--verbose</span>
363
385
<p class="level1">Makes the fetching more verbose/talkative. Mostly usable for debugging. Lines starting with '>' means data sent by curl, '<' means data received by curl that is hidden in normal cases and lines starting with '*' means additional info provided by curl.
364
<p class="level1">Note that if you want to see HTTP headers in the output, <a class="emphasis" href="#-i--include">-i/--include</a> might be option you're looking for.
386
<p class="level1">Note that if you only want HTTP headers in the output, <a class="emphasis" href="#-i--include">-i/--include</a> might be option you're looking for.
365
387
<p class="level1">If you think this option still doesn't give you enough details, consider using <a class="emphasis" href="#--trace">--trace</a> or <a class="emphasis" href="#--trace-ascii">--trace-ascii</a> instead.
366
388
<p class="level1">If this option is used twice, the second will again disable verbose.
367
389
<p class="level0"><a name="-V--version"></a><span class="nroffip">-V/--version</span>
379
401
<p class="level1"><a name="libz"></a><span class="nroffip">libz</span>
380
402
<p class="level2">Automatic decompression of compressed files over HTTP is supported.
381
403
<p class="level1"><a name="NTLM"></a><span class="nroffip">NTLM</span>
382
<p class="level2">NTLM authenticaion is supported.
404
<p class="level2">NTLM authentication is supported.
383
405
<p class="level1"><a name="GSS-Negotiate"></a><span class="nroffip">GSS-Negotiate</span>
384
<p class="level2">Negotiate authenticaion is supported.
406
<p class="level2">Negotiate authentication is supported.
385
407
<p class="level1"><a name="Debug"></a><span class="nroffip">Debug</span>
386
408
<p class="level2">This curl uses a libcurl built with Debug. This enables more error-tracking and memory debugging etc. For curl-developers only!
387
409
<p class="level1"><a name="AsynchDNS"></a><span class="nroffip">AsynchDNS</span>
388
410
<p class="level2">This curl uses asynchronous name resolves.
389
411
<p class="level1"><a name="SPNEGO"></a><span class="nroffip">SPNEGO</span>
390
<p class="level2">SPNEGO Negotiate authenticaion is supported.
412
<p class="level2">SPNEGO Negotiate authentication is supported.
391
413
<p class="level1"><a name="Largefile"></a><span class="nroffip">Largefile</span>
392
414
<p class="level2">This curl supports transfers of large files, files larger than 2GB.
415
<p class="level1"><a name="IDN"></a><span class="nroffip">IDN</span>
416
<p class="level2">This curl supports IDN - international domain names.
393
417
<p class="level1">
394
418
<p class="level0"><a name="-w--write-out"></a><span class="nroffip">-w/--write-out <format></span>
395
419
<p class="level1">Defines what to display after a completed and successful operation. The format is a string that may contain plain text mixed with any number of variables. The string can be specified as "string", to get read from a particular file you specify it "@filename" and to tell curl to read the format from stdin you write "@-".
403
427
<p class="level2"><span Class="bold">time_namelookup</span> The time, in seconds, it took from the start until the name resolving was completed.
404
428
<p class="level2"><span Class="bold">time_connect</span> The time, in seconds, it took from the start until the connect to the remote host (or proxy) was completed.
405
429
<p class="level2"><span Class="bold">time_pretransfer</span> The time, in seconds, it took from the start until the file transfer is just about to begin. This includes all pre-transfer commands and negotiations that are specific to the particular protocol(s) involved.
406
<p class="level2"><span Class="bold">time_starttransfer</span> The time, in seconds, it took from the start until the first byte is just about to be transfered. This includes time_pretransfer and also the time the server needs to calculate the result.
430
<p class="level2"><span Class="bold">time_redirect</span> The time, in seconds, it took for all redirection steps include name lookup, connect, pretransfer and transfer before final transaction was started. time_redirect shows the complete execution time for multiple redirections. (Added in 7.12.3)
431
<p class="level2"><span Class="bold">time_starttransfer</span> The time, in seconds, it took from the start until the first byte is just about to be transferred. This includes time_pretransfer and also the time the server needs to calculate the result.
407
432
<p class="level2"><span Class="bold">size_download</span> The total amount of bytes that were downloaded.
408
433
<p class="level2"><span Class="bold">size_upload</span> The total amount of bytes that were uploaded.
409
434
<p class="level2"><span Class="bold">size_header</span> The total amount of bytes of the downloaded headers.
411
436
<p class="level2"><span Class="bold">speed_download</span> The average download speed that curl measured for the complete download.
412
437
<p class="level2"><span Class="bold">speed_upload</span> The average upload speed that curl measured for the complete upload.
413
438
<p class="level2"><span Class="bold">content_type</span> The Content-Type of the requested document, if there was any. (Added in 7.9.5)
439
<p class="level2"><span Class="bold">num_connects</span> Number of new connects made in the recent transfer. (Added in 7.12.3)
440
<p class="level2"><span Class="bold">num_redirects</span> Number of redirects that were followed in the request. (Added in 7.12.3)
414
441
<p class="level1">
415
442
<p class="level1">If this option is used several times, the last one will be used.
416
443
<p class="level0"><a name="-x--proxy"></a><span class="nroffip">-x/--proxy <proxyhost[:port]></span>
417
444
<p class="level1">Use specified HTTP proxy. If the port number is not specified, it is assumed at port 1080.
418
445
<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.
419
<p class="level1"><span Class="bold">Note</span> that all operations that are performed over a HTTP proxy will transparantly 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.
446
<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.
420
447
<p class="level1">If this option is used several times, the last one will be used.
421
448
<p class="level0"><a name="-X--request"></a><span class="nroffip">-X/--request <command></span>
422
449
<p class="level1">(HTTP) Specifies a custom request to use when communicating with the HTTP server. The specified request will be used instead of the standard GET. Read the HTTP 1.1 specification for details and explanations.
430
457
<p class="level1">If a download is slower than this given speed, in bytes per second, for speed-time seconds it gets aborted. speed-time is set with -Y and is 30 if not set.
431
458
<p class="level1">If this option is used several times, the last one will be used.
432
459
<p class="level0"><a name="-z--time-cond"></a><span class="nroffip">-z/--time-cond <date expression></span>
433
<p class="level1">(HTTP) Request to get a file that has been modified later than the given time and date, or one that has been modified before that time. The date expression can be all sorts of date strings or if it doesn't match any internal ones, it tries to get the time from a given file name instead! See the <span Class="manpage">GNU date(1)</span> or <span Class="manpage">curl_getdate(3)</span> man pages for date expression details.
460
<p class="level1">(HTTP) Request a file that has been modified later than the given time and date, or one that has been modified before that time. The date expression can be all sorts of date strings or if it doesn't match any internal ones, it tries to get the time from a given file name instead! See the <span Class="emphasis">curl_getdate(3)</span> man pages for date expression details.
434
461
<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.
435
462
<p class="level1">If this option is used several times, the last one will be used.
436
<p class="level0"><a name="-Z--max-redirs"></a><span class="nroffip">-Z/--max-redirs <num></span>
463
<p class="level0"><a name="--max-redirs"></a><span class="nroffip">--max-redirs <num></span>
437
464
<p class="level1">Set maximum number of redirection-followings allowed. If <a class="emphasis" href="#-L--location">-L/--location</a> is used, this option can be used to prevent curl from following redirections "in absurdum".
438
465
<p class="level1">If this option is used several times, the last one will be used.
439
466
<p class="level0"><a name="-0--http10"></a><span class="nroffip">-0/--http1.0</span>
503
530
<p class="level0"><a name="17"></a><span class="nroffip">17</span>
504
531
<p class="level1">FTP couldn't set binary. Couldn't change transfer method to binary.
505
532
<p class="level0"><a name="18"></a><span class="nroffip">18</span>
506
<p class="level1">Partial file. Only a part of the file was transfered.
533
<p class="level1">Partial file. Only a part of the file was transferred.
507
534
<p class="level0"><a name="19"></a><span class="nroffip">19</span>
508
535
<p class="level1">FTP couldn't download/access the given file, the RETR (or similar) command failed.
509
536
<p class="level0"><a name="20"></a><span class="nroffip">20</span>
597
624
<p class="level0">Daniel Stenberg is the main author, but the whole list of contributors is found in the separate THANKS file. <a name="WWW"></a><h2 class="nroffsh">WWW</h2>
598
625
<p class="level0"><a href="http://curl.haxx.se">http://curl.haxx.se</a> <a name="FTP"></a><h2 class="nroffsh">FTP</h2>
599
626
<p class="level0"><a href="ftp://ftp.sunet.se/pub/www/utilities/curl/">ftp://ftp.sunet.se/pub/www/utilities/curl/</a> <a name="SEE"></a><h2 class="nroffsh">SEE ALSO</h2>
600
<p class="level0"><span Class="manpage">ftp (1)</span> <span Class="manpage">wget (1)</span> <span Class="manpage">snarf (1)</span> <p class="roffit">
627
<p class="level0"><span Class="manpage">ftp (1)</span> <span Class="manpage">wget (1)</span>
628
<p class="level0"><p class="roffit">
601
629
This HTML page was made with <a href="http://daniel.haxx.se/projects/roffit/">roffit</a>.
added
removed
docs/curl.html
