Artifactspublic-v0

curl

master
ply4 git calls37 ms288 KiB3 cachedprotocol v2
43 lines1.7 KiBRaw

--retry

If a transient error is returned when curl tries to perform a transfer, it retries this number of times before giving up. Setting the number to 0 makes curl do no retries (which is the default). Transient error means either: a timeout, an FTP 4xx response code or an HTTP 408, 429, 500, 502, 503, 504, 522 or 524 response code.

When curl is about to retry a transfer, it first waits one second and then for all forthcoming retries it doubles the waiting time until it reaches 10 minutes, which then remains the set fixed delay time between the rest of the retries. By using --retry-delay you disable this exponential backoff algorithm. See also --retry-max-time to limit the total time allowed for retries.

curl complies with the Retry-After: response header if one was present to know when to issue the next retry (added in 7.66.0). That means the server can override the retry delay. To handle server retry delays that may be longer than expected, you can use --retry-max-time to limit the total retry time.

Before retrying, curl removes data that the failed attempt wrote to an output file set with --output or --remote-name. It cannot do that for data written to stdout, a pipe or a shell redirect, so a retry after a partially received transfer, such as a timeout in the middle of the body, may produce duplicate data there. Write to an output file instead, or avoid --retry when the output is redirected.

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: retry
5Arg: <num>
6Added: 7.12.3
7Help: Retry request if transient problems occur
8Category: curl
9Multi: single
10See-also:
11 - retry-max-time
12 - retry-connrefused
13 - retry-delay
14Example:
15 - --retry 7 $URL
16---
18# `--retry`
20If a transient error is returned when curl tries to perform a transfer, it
21retries this number of times before giving up. Setting the number to 0 makes
22curl do no retries (which is the default). Transient error means either: a
23timeout, an FTP 4xx response code or an HTTP 408, 429, 500, 502, 503, 504, 522
24or 524 response code.
26When curl is about to retry a transfer, it first waits one second and then for
27all forthcoming retries it doubles the waiting time until it reaches 10
28minutes, which then remains the set fixed delay time between the rest of the
29retries. By using --retry-delay you disable this exponential backoff
30algorithm. See also --retry-max-time to limit the total time allowed for
31retries.
33curl complies with the Retry-After: response header if one was present to know
34when to issue the next retry (added in 7.66.0). That means the server can
35override the retry delay. To handle server retry delays that may be longer
36than expected, you can use --retry-max-time to limit the total retry time.
38Before retrying, curl removes data that the failed attempt wrote to an output
39file set with --output or --remote-name. It cannot do that for data written to
40stdout, a pipe or a shell redirect, so a retry after a partially received
41transfer, such as a timeout in the middle of the body, may produce duplicate
42data there. Write to an output file instead, or avoid --retry when the output
43is redirected.
Diagnostics4 git calls · 37 ms
CallStatusSizeTime037 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
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 · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=3
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
fetch200995 B · hit31 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=31
git.response.bytes=995
git.response.cache=HIT
git.response.duration_ms=31
git.fetch.wants=75bab1c1f2b48c11d43551ebca7c4d0e5cb245b4
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=995
git.pkt.payload.max=974
git.sideband.band1.bytes=973
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
a5e3196288353e6e
Request
fd3dc8e0…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format