cURL cURL > Mailing List > Monthly Index > Single Mail

curl-tracker Archives

[curl:bugs] #1414 [manpage] terribly unclear documentation of --limit-rate

From: Daniel Stenberg <bagder_at_users.sf.net>
Date: Fri, 22 Aug 2014 21:40:51 +0000

It affects the transfer in both directions equally. I supposed I should make that more explicit. What do you think about something like this:

~~~~~
--- a/docs/curl.1
+++ b/docs/curl.1
@@ -871,13 +871,14 @@ libcurl-using C source code written to the file that does the equivalent
 of what your command-line operation does!
 
 If this option is used several times, the last given file name will be
 used. (Added in 7.16.1)
 .IP "--limit-rate <speed>"
-Specify the maximum transfer rate you want curl to use. This feature is useful
-if you have a limited pipe and you'd like your transfer not to use your entire
-bandwidth.
+Specify the maximum transfer rate you want curl to use - for both downloads
+and uploads. This feature is useful if you have a limited pipe and you'd like
+your transfer not to use your entire bandwidth. To make it slower than it
+otherwise would be.
 
 The given speed is measured in bytes/second, unless a suffix is appended.
 Appending 'k' or 'K' will count the number as kilobytes, 'm' or M' makes it
 megabytes, while 'g' or 'G' makes it gigabytes. Examples: 200K, 3m and 1G.
 
~~~~

---
** [bugs:#1414] [manpage] terribly unclear documentation of --limit-rate**
**Status:** open
**Created:** Fri Aug 22, 2014 08:28 PM UTC by teo8976
**Last Updated:** Fri Aug 22, 2014 08:28 PM UTC
**Owner:** nobody
>From the documentation it's not clear whether --limit-rate applies to upload (i.e. sending the request) or download (i.e. receiving the response) or both.
Intuitively, I'd be inclined to guess it applies to upload, as i can hardly even imagine how a rate limit could be applied to download (given that it depends on the other side). However, there's this note:
> If you also use the -Y, --speed-limit option, that  option  will take precedence and might cripple the rate-limiting slightly, to help keeping the speed-limit logic working.
and since speed-limit _is_ related to download speed, that is confusing. 
---
Sent from sourceforge.net because curl-tracker@cool.haxx.se is subscribed to https://sourceforge.net/p/curl/bugs/
To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/curl/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.
Received on 2014-08-22

These mail archives are generated by hypermail.