8784a84d3afaf30676a801f67d82ef11524d69ce
[platform/upstream/curl.git] / docs / cmdline-opts / limit-rate.d
1 Long: limit-rate
2 Arg: <speed>
3 Help: Limit transfer speed to RATE
4 ---
5 Specify the maximum transfer rate you want curl to use - for both downloads
6 and uploads. This feature is useful if you have a limited pipe and you'd like
7 your transfer not to use your entire bandwidth. To make it slower than it
8 otherwise would be.
9
10 The given speed is measured in bytes/second, unless a suffix is appended.
11 Appending 'k' or 'K' will count the number as kilobytes, 'm' or M' makes it
12 megabytes, while 'g' or 'G' makes it gigabytes. Examples: 200K, 3m and 1G.
13
14 If you also use the --speed-limit option, that option will take precedence and
15 might cripple the rate-limiting slightly, to help keeping the speed-limit
16 logic working.
17
18 If this option is used several times, the last one will be used.