Artifactspublic-v0

curl

master
ply4 git calls25 ms288 KiB3 cachedprotocol v2
46 lines1.7 KiBRaw

--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.

Starting in version 8.10.0, you can specify the number of time units in the rate expression. Make curl do no more than 5 transfers per 15 seconds with "5/15s" or limit it to 3 transfers per 4 hours with "3/4h". No spaces allowed.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: rate
5Arg: <max request rate>
6Help: Request rate for serial transfers
7Category: connection global
8Added: 7.84.0
9Multi: single
10Scope: global
11See-also:
12 - limit-rate
13 - retry-delay
14Example:
15 - --rate 2/s $URL ...
16 - --rate 3/h $URL ...
17 - --rate 14/m $URL ...
18---
20# `--rate`
22Specify the maximum transfer frequency you allow curl to use - in number of
23transfer starts per time unit (sometimes called request rate). Without this
24option, curl starts the next transfer as fast as possible.
26If given several URLs and a transfer completes faster than the allowed rate,
27curl waits until the next transfer is started to maintain the requested
28rate. This option has no effect when --parallel is used.
30The request rate is provided as "N/U" where N is an integer number and U is a
31time unit. Supported units are 's' (second), 'm' (minute), 'h' (hour) and 'd'
32/(day, as in a 24 hour unit). The default time unit, if no "/U" is provided,
33is number of transfers per hour.
35If curl is told to allow 10 requests per minute, it does not start the next
36request until 6 seconds have elapsed since the previous transfer was started.
38This function uses millisecond resolution. If the allowed frequency is set
39more than 1000 per second, it instead runs unrestricted.
41When retrying transfers, enabled with --retry, the separate retry delay logic
42is used and not this setting.
44Starting in version 8.10.0, you can specify the number of time units in the rate
45expression. Make curl do no more than 5 transfers per 15 seconds with "5/15s"
46or limit it to 3 transfers per 4 hours with "3/4h". No spaces allowed.
Diagnostics4 git calls · 25 ms
CallStatusSizeTime025 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200149 B · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=3
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=149
git.pkt.payload.max=78
git.ls_refs.count=2
git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=20
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=10
git.pkt.data=8
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=293470
git.pkt.payload.max=65516
git.sideband.band1.bytes=293354
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=87
git.pack.bytes=293354
git.pack.ofs_delta=0
git.pack.ref_delta=1
git.pack.chain.max=1
git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0
git.pack.full=86
Open pack map
fetch200948 B · hit20 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=948
git.response.cache=HIT
git.response.duration_ms=20
git.fetch.wants=d389da574765c5e300426938871833611824ac06
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=948
git.pkt.payload.max=927
git.sideband.band1.bytes=926
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
Ref
refs/heads/master
Commit
31c911efe5652725e930f4d2e60c9060e5f6646d
cf-ray
a5e309b43f41ee28
Request
5e555231…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format