41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
|
---
|
||
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||
|
|
SPDX-License-Identifier: curl
|
||
|
|
Long: retry-all-errors
|
||
|
|
Help: Retry all errors (use with --retry)
|
||
|
|
Added: 7.71.0
|
||
|
|
Category: curl
|
||
|
|
Multi: boolean
|
||
|
|
See-also:
|
||
|
|
- retry
|
||
|
|
Example:
|
||
|
|
- --retry 5 --retry-all-errors $URL
|
||
|
|
---
|
||
|
|
|
||
|
|
# `--retry-all-errors`
|
||
|
|
|
||
|
|
Retry on any error. This option is used together with --retry.
|
||
|
|
|
||
|
|
This option is the "sledgehammer" of retrying. Do not use this option by
|
||
|
|
default (for example in your **curlrc**), there may be unintended consequences
|
||
|
|
such as sending or receiving duplicate data. Do not use with redirected input
|
||
|
|
or output. You'd be much better off handling your unique problems in shell
|
||
|
|
script. Please read the example below.
|
||
|
|
|
||
|
|
**WARNING**: For server compatibility curl attempts to retry failed flaky
|
||
|
|
transfers as close as possible to how they were started, but this is not
|
||
|
|
possible with redirected input or output. For example, before retrying it
|
||
|
|
removes output data from a failed partial transfer that was written to an
|
||
|
|
output file. However this is not true of data redirected to a | pipe or >
|
||
|
|
file, which are not reset. We strongly suggest you do not parse or record
|
||
|
|
output via redirect in combination with this option, since you may receive
|
||
|
|
duplicate data.
|
||
|
|
|
||
|
|
By default curl does not return error for transfers with an HTTP response code
|
||
|
|
that indicates an HTTP error, if the transfer was successful. For example, if
|
||
|
|
a server replies 404 Not Found and the reply is fully received then that is
|
||
|
|
not an error. When --retry is used then curl retries on some HTTP response
|
||
|
|
codes that indicate transient HTTP errors, but that does not include most 4xx
|
||
|
|
response codes such as 404. If you want to retry on all response codes that
|
||
|
|
indicate HTTP errors (4xx and 5xx) then combine with --fail.
|