← Back to branch summary

~ubuntu-branches/ubuntu/natty/curl/natty-proposed

« back to all changes in this revision

Viewing changes to docs/curl.1

  • Committer: Bazaar Package Importer
  • Author(s): Robert Ancell
  • Date: 2010-11-29 17:26:37 UTC
  • mfrom: (3.4.9 sid)
  • Revision ID: james.westby@ubuntu.com-20101129172637-7wwnlut14uxp2kfx
Tags: 7.21.2-1ubuntu1
https://launchpad.net/bugs/682286
* Merge with Debian unstable, remaining Ubuntu changes: (LP: #682286)
* debian/control:
  - (Keep build deps in main)
  - Drop build dependencies: stunnel, libssh2-1-dev
  - Add build-dependency on openssh-server
  - Drop libssh2-1-dev from libcurl4-openssl-dev's Depends.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/curl.1
29
29
.SH DESCRIPTION
30
30
.B curl
31
31
is a tool to transfer data from or to a server, using one of the supported
32
 
protocols (HTTP, HTTPS, FTP, FTPS, SCP, SFTP, TFTP, DICT, TELNET, LDAP or
33
 
FILE).  The command is designed to work without user interaction.
 
32
protocols (DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP,
 
33
LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMTP, SMTPS, TELNET and TFTP).  The
 
34
command is designed to work without user interaction.
34
35
 
35
36
curl offers a busload of useful tricks like proxy support, user
36
37
authentication, FTP upload, HTTP post, SSL connections, cookies, file transfer
55
56
 ftp://ftp.numericals.com/file[001-100].txt    (with leading zeros)
56
57
 ftp://ftp.letters.com/file[a-z].txt
57
58
 
58
 
No nesting of the sequences is supported at the moment, but you can use
59
 
several ones next to each other:
 
59
Nested sequences are not supported, but you can use several ones next to each
 
60
other:
60
61
 
61
62
 http://any.org/archive[1996-1999]/vol[1-4]/part{a,b,c}.html
62
63
 
63
64
You can specify any amount of URLs on the command line. They will be fetched
64
65
in a sequential manner in the specified order.
65
66
 
66
 
Since curl 7.15.1 you can also specify a step counter for the ranges, so that
67
 
you can get every Nth number or letter:
 
67
You can specify a step counter for the ranges to get every Nth number or
 
68
letter:
68
69
 
69
70
 http://www.numericals.com/file[1-100:10].txt
70
71
 http://www.letters.com/file[a-z:2].txt
87
88
curl normally displays a progress meter during operations, indicating the amount
88
89
of transferred data, transfer speeds and estimated time left, etc.
89
90
 
90
 
However, since curl displays this data to the terminal by default, if you invoke
91
 
curl to do an operation and it is about to write data to the terminal, it
 
91
curl displays this data to the terminal by default, so if you invoke curl to
 
92
do an operation and it is about to write data to the terminal, it
92
93
\fIdisables\fP the progress meter as otherwise it would mess up the output
93
94
mixing progress meter and response data.
94
95
 
300
301
on all servers, but they enable more functionality in a better way than the
301
302
traditional PORT command.
302
303
 
303
 
Since curl 7.19.0, \fB--eprt\fP can be used to explicitly enable EPRT again
304
 
and \fB--no-eprt\fP is an alias for \fB--disable-eprt\fP.
 
304
\fB--eprt\fP can be used to explicitly enable EPRT again and \fB--no-eprt\fP
 
305
is an alias for \fB--disable-eprt\fP.
305
306
 
306
307
Disabling EPRT only changes the active behavior. If you want to switch to
307
308
passive mode you need to not use \fI-P/--ftp-port\fP or force it with
311
312
transfers. Curl will normally always first attempt to use EPSV before PASV,
312
313
but with this option, it will not try using EPSV.
313
314
 
314
 
Since curl 7.19.0, \fB--epsv\fP can be used to explicitly enable EPRT again
315
 
and \fB--no-epsv\fP is an alias for \fB--disable-epsv\fP.
 
315
\fB--epsv\fP can be used to explicitly enable EPRT again and \fB--no-epsv\fP
 
316
is an alias for \fB--disable-epsv\fP.
316
317
 
317
318
Disabling EPSV only changes the passive behavior. If you want to switch to
318
319
active mode you need to use \fI-P/--ftp-port\fP.