moparisthebest/wget
1
0
Fork 0
mirror of https://github.com/moparisthebest/wget synced 2024-07-03 16:38:41 -04:00
Code Issues Releases Wiki Activity

[svn] Document `--limit-rate'.

Browse Source 
Published in <sxszo07w76u.fsf@florida.arsdigita.de>.
This commit is contained in:
hniksic 2002-04-13 15:44:16 -07:00
parent f3d3a50a56
commit f0c20666da
2 changed files with 32 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/ChangeLog
View File

@ -1,3 +1,7 @@
2002-04-14 Hrvoje Niksic <hniksic@arsdigita.com>
* wget.texi (Wgetrc Commands): Document `--limit-rate'.
2002-04-10 Hrvoje Niksic <hniksic@arsdigita.com>
* wget.texi: Warn about the dangers of specifying passwords on the

31
doc/wget.texi
View File

@ -672,15 +672,36 @@ functionality of real @sc{www} spiders.
@cindex timeout
@item -T seconds
@itemx --timeout=@var{seconds}
Set the read timeout to @var{seconds} seconds. Whenever a network read
is issued, the file descriptor is checked for a timeout, which could
otherwise leave a pending connection (uninterrupted read). The default
Set the network timeout to @var{seconds} seconds. Whenever Wget
connects to or reads from a remote host, it checks for a timeout and
aborts the operation if the time expires. This prevents anomalous
occurrences such as hanging reads or infinite connects. The default
timeout is 900 seconds (fifteen minutes). Setting timeout to 0 will
disable checking for timeouts.
Please do not lower the default timeout value with this option unless
you know what you are doing.
@cindex bandwidth, limit
@cindex rate, limit
@cindex limit bandwidth
@item --limit-rate=@var{amount}
Limit the download speed to @var{amount} bytes per second. Amount may
be expressed in bytes, kilobytes with the @samp{k} suffix, or megabytes
with the @samp{m} suffix. For example, @samp{--limit-rate=20k} will
limit the retrieval rate to 20KB/s. This kind of thing is useful when,
for whatever reason, you don't want Wget to consume the entire evailable
bandwidth.
Note that Wget implementeds the limiting by sleeping the appropriate
amount of time after a network read that took less time than specified
by the rate. Eventually this strategy causes the TCP transfer to slow
down to approximately the specified rate. However, it takes some time
for this balance to be achieved, so don't be surprised if limiting the
rate doesn't work with very small files. Also, the "sleeping" strategy
will misfire when an extremely small bandwidth, say less than 1.5KB/s,
is specified.
@cindex pause
@cindex wait
@item -w @var{seconds}
@ -2102,6 +2123,10 @@ Consider data longer than specified in content-length header as invalid
as there is, provided there is more than or equal to the value in
@code{Content-Length}.
@item limit_rate = @var{rate}
Limit the download speed to no more than @var{rate} bytes per second.
The same as @samp{--limit-rate}.
@item logfile = @var{string}
Set logfile---the same as @samp{-o}.