From 97e67a0b93fbbd6e3f7da401c157a8266d131e9c Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Thu, 8 Aug 2024 14:25:32 +0200 Subject: [PATCH] usingcurl/transfers/request-rate.md: document the 8.10 --rate extension --- usingcurl/transfers/request-rate.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/usingcurl/transfers/request-rate.md b/usingcurl/transfers/request-rate.md index 339e1dd224..b87a5b2c47 100644 --- a/usingcurl/transfers/request-rate.md +++ b/usingcurl/transfers/request-rate.md @@ -42,3 +42,16 @@ Make curl download 10 images but doing it no faster than 3 transfers per hour: Make curl download 200 images but not faster than 14 transfers per minute: curl --rate 14/m -O https://example.com/[1-200].jpg + +## Number of units + +Starting in curl 8.10.0 this option accepts an optional *number of units*. The +request rate is then provided as **N/ZU** where **N** is an integer number, +**Z** is an integer number of time units and **U** is a time unit. + +The number and the units are the same as mentioned above, but now you can also +specify a number of time units. + +For example, make no more than eight transfers every five seconds: + + curl --rate 8/5s -O https://example.com/[1-100].jpg