aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2003-02-26 13:01:29 +0000
committerDaniel Stenberg <daniel@haxx.se>2003-02-26 13:01:29 +0000
commit6589579850b09ff6bd3d987dc7172a5eef6f96e5 (patch)
tree2158ba98bdea459219b29646ab94ebe83d758cdd
parent5ddc260fc276ed76e52297b95e57b8385e0a3941 (diff)
random updates
-rw-r--r--docs/MANUAL37
1 files changed, 31 insertions, 6 deletions
diff --git a/docs/MANUAL b/docs/MANUAL
index 7894bcd54..87cd8aafe 100644
--- a/docs/MANUAL
+++ b/docs/MANUAL
@@ -166,13 +166,21 @@ UPLOADING
VERBOSE / DEBUG
- If curl fails where it isn't supposed to, if the servers don't let you
- in, if you can't understand the responses: use the -v flag to get VERBOSE
- fetching. Curl will output lots of info and all data it sends and
- receives in order to let the user see all client-server interaction.
+ If curl fails where it isn't supposed to, if the servers don't let you in,
+ if you can't understand the responses: use the -v flag to get verbose
+ fetching. Curl will output lots of info and what it sends and receives in
+ order to let the user see all client-server interaction (but it won't show
+ you the actual data).
curl -v ftp://ftp.upload.com/
+ To get even more details and information on what curl does, try using the
+ --trace or --trace-ascii options with a given file name to log to, like
+ this:
+
+ curl --trace trace.txt www.haxx.se
+
+
DETAILED INFORMATION
Different protocols provide different ways of getting detailed information
@@ -350,6 +358,13 @@ COOKIES
curl -b headers www.example.com
+ While saving headers to a file is a working way to store cookies, it is
+ however error-prone and not the prefered way to do this. Instead, make curl
+ save the incoming cookies using the well-known netscape cookie format like
+ this:
+
+ curl -c cookies.txt www.example.com
+
Note that by specifying -b you enable the "cookie awareness" and with -L
you can make curl follow a location: (which often is used in combination
with cookies). So that if a site sends cookies and a location, you can
@@ -363,7 +378,11 @@ COOKIES
the cookies received from www.example.com. curl will send to the server the
stored cookies which match the request as it follows the location. The
file "empty.txt" may be a non-existant file.
-
+
+ Alas, to both read and write cookies from a netscape cookie file, you can
+ set both -b and -c to use the same file:
+
+ curl -b cookies.txt -c cookies.txt www.example.com
PROGRESS METER
@@ -413,7 +432,8 @@ SPEED LIMIT
Forcing curl not to transfer data faster than a given rate is also possible,
which might be useful if you're using a limited bandwidth connection and you
- don't want your transfer to use all of it.
+ don't want your transfer to use all of it (sometimes referred to as
+ "bandwith throttle").
Make curl transfer data no faster than 10 kilobytes per second:
@@ -427,6 +447,11 @@ SPEED LIMIT
curl -T upload --limit-rate 1M ftp://uploadshereplease.com
+ When using the --limit-rate option, the transfer rate is regulated on a
+ per-second basis, which will cause the total transfer speed to become lower
+ than the given number. Sometimes of course substantially lower, if your
+ transfer stalls during periods.
+
CONFIG FILE
Curl automatically tries to read the .curlrc file (or _curlrc file on win32