aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/FEATURES2
-rw-r--r--docs/MANUAL44
2 files changed, 39 insertions, 7 deletions
diff --git a/docs/FEATURES b/docs/FEATURES
index e64ccbb71..46d4328b1 100644
--- a/docs/FEATURES
+++ b/docs/FEATURES
@@ -21,6 +21,7 @@ Misc
- redirectable stderr
- use selected network interface for outgoing traffic
- IPv6 support
+ - persistant connections
HTTP
- GET
@@ -72,6 +73,7 @@ FTP
TELNET
- connection negotiation
+ - custom telnet options
- stdin/stdout I/O
LDAP (*2)
diff --git a/docs/MANUAL b/docs/MANUAL
index 63f5d2616..843b0bd2d 100644
--- a/docs/MANUAL
+++ b/docs/MANUAL
@@ -25,12 +25,16 @@ SIMPLE USAGE
Get a list of the root directory of an FTP site:
- curl ftp://ftp.fts.frontec.se/
+ curl ftp://cool.haxx.se/
Get the definition of curl from a dictionary:
curl dict://dict.org/m:curl
+ Fetch two documents at once:
+
+ curl ftp://cool.haxx.se/ http://www.weirdserver.com:8000/
+
DOWNLOAD TO A FILE
Get a web page and store in a local file:
@@ -43,6 +47,10 @@ DOWNLOAD TO A FILE
curl -O http://www.netscape.com/index.html
+ Fetch two files and store them with their remote names:
+
+ curl -O www.haxx.se/index.html -O curl.haxx.se/download.html
+
USING PASSWORDS
FTP
@@ -455,9 +463,13 @@ EXTRA HEADERS
curl -H "X-you-and-me: yes" www.love.com
- This can also be useful in case you want curl to send a different text in
- a header than it normally does. The -H header you specify then replaces the
- header curl would normally send.
+ This can also be useful in case you want curl to send a different text in a
+ header than it normally does. The -H header you specify then replaces the
+ header curl would normally send. If you replace an internal header with an
+ empty one, you prevent that header from being sent. To prevent the Host:
+ header from being used:
+
+ curl -H "Host:" www.server.com
FTP and PATH NAMES
@@ -745,6 +757,24 @@ TELNET
to track when the login prompt is received and send the username and
password accordingly.
+PERSISTANT CONNECTIONS
+
+ Specifying multiple files on a single command line will make curl transfer
+ all of them, one after the other in the specified order.
+
+ libcurl will attempt to use persistant connections for the transfers so that
+ the second transfer to the same host can use the same connection that was
+ already initiated and was left open in the previous transfer. This greatly
+ decreases connection time for all but the first transfer and it makes a far
+ better use of the network.
+
+ Note that curl cannot use persistant connections for transfers that are used
+ in subsequence curl invokes. Try to stuff as many URLs as possible on the
+ same command line if they are using the same host, as that'll make the
+ transfers faster.
+
+ Persistant connections were introduced in curl 7.7.
+
MAILING LISTS
For your convenience, we have several open mailing lists to discuss curl,
@@ -753,10 +783,10 @@ MAILING LISTS
To subscribe to the main curl list, mail curl-request@contactor.se with
"subscribe <fill in your email address>" in the body.
- To subscribe to the libcurl users list, follow the instructions at
- http://curl.haxx.se/mail/
+ To subscribe to the curl-library users/deverlopers list, follow the
+ instructions at http://curl.haxx.se/mail/
- To subscribe to the curl announce list, to only get information about new
+ To subscribe to the curl-announce list, to only get information about new
releases, follow the instructions at http://curl.haxx.se/mail/
To subscribe to the curl-and-PHP list in which curl using with PHP is