mirror of
https://github.com/curl/curl.git
synced 2026-07-27 15:19:10 +03:00
2abfc759b9
Option cleanups: --get is not upload --form* are post - added several options into ldap, smtp, imap and pop3 - shortened the category descriptions in the list category curl fixes: --create-dirs removed from 'curl' --ftp-create-dirs removed from 'curl' --netrc moved to 'auth' from 'curl' --netrc-file moved to 'auth' from 'curl' --netrc-optional moved to 'auth' from 'curl' --no-buffer moved to 'output' from 'curl' --no-clobber removed from 'curl' --output removed from 'curl' --output-dir removed from 'curl' --remove-on-error removed from 'curl' Add a "global" category: - Made all "global" options set this category Add a "deprecated" category: - Moved the deprecated options to it (maybe they should not be in any category long term) Add a 'timeout' category - Put a number of appropriate options in it Add an 'ldap' category - Put the LDAP related option in there Remove categories "ECH" and "ipfs" - They should not be categories. Had only one single option each. Remove category "misc" - It should not be a category as it is impossible to know when to browse it. --use-ascii moved to ftp and output --xattr moved to output --service-name moved to auth Managen fixes: - errors if an option is given a category name that is not already setup for in code - verifies that options set `scope: global` also is put in category `global´ Closes #14101
42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Long: rate
|
|
Arg: <max request rate>
|
|
Help: Request rate for serial transfers
|
|
Category: connection global
|
|
Added: 7.84.0
|
|
Multi: single
|
|
Scope: global
|
|
See-also:
|
|
- limit-rate
|
|
- retry-delay
|
|
Example:
|
|
- --rate 2/s $URL ...
|
|
- --rate 3/h $URL ...
|
|
- --rate 14/m $URL ...
|
|
---
|
|
|
|
# `--rate`
|
|
|
|
Specify the maximum transfer frequency you allow curl to use - in number of
|
|
transfer starts per time unit (sometimes called request rate). Without this
|
|
option, curl starts the next transfer as fast as possible.
|
|
|
|
If given several URLs and a transfer completes faster than the allowed rate,
|
|
curl waits until the next transfer is started to maintain the requested
|
|
rate. This option has no effect when --parallel is used.
|
|
|
|
The request rate is provided as "N/U" where N is an integer number and U is a
|
|
time unit. Supported units are 's' (second), 'm' (minute), 'h' (hour) and 'd'
|
|
/(day, as in a 24 hour unit). The default time unit, if no "/U" is provided,
|
|
is number of transfers per hour.
|
|
|
|
If curl is told to allow 10 requests per minute, it does not start the next
|
|
request until 6 seconds have elapsed since the previous transfer was started.
|
|
|
|
This function uses millisecond resolution. If the allowed frequency is set
|
|
more than 1000 per second, it instead runs unrestricted.
|
|
|
|
When retrying transfers, enabled with --retry, the separate retry delay logic
|
|
is used and not this setting.
|