xf.li | bfc6e71 | 2025-02-07 01:54:34 -0800 | [diff] [blame] | 1 | c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al. |
| 2 | SPDX-License-Identifier: curl |
| 3 | Long: retry-all-errors |
| 4 | Help: Retry all errors (use with --retry) |
| 5 | Added: 7.71.0 |
| 6 | Category: curl |
| 7 | Example: --retry 5 --retry-all-errors $URL |
| 8 | See-also: retry |
| 9 | Multi: boolean |
| 10 | --- |
| 11 | Retry on any error. This option is used together with --retry. |
| 12 | |
| 13 | This option is the "sledgehammer" of retrying. Do not use this option by |
| 14 | default (eg in curlrc), there may be unintended consequences such as sending or |
| 15 | receiving duplicate data. Do not use with redirected input or output. You'd be |
| 16 | much better off handling your unique problems in shell script. Please read the |
| 17 | example below. |
| 18 | |
| 19 | **WARNING**: For server compatibility curl attempts to retry failed flaky |
| 20 | transfers as close as possible to how they were started, but this is not |
| 21 | possible with redirected input or output. For example, before retrying it |
| 22 | removes output data from a failed partial transfer that was written to an |
| 23 | output file. However this is not true of data redirected to a | pipe or > |
| 24 | file, which are not reset. We strongly suggest you do not parse or record |
| 25 | output via redirect in combination with this option, since you may receive |
| 26 | duplicate data. |
| 27 | |
| 28 | By default curl will not error on an HTTP response code that indicates an HTTP |
| 29 | error, if the transfer was successful. For example, if a server replies 404 |
| 30 | Not Found and the reply is fully received then that is not an error. When |
| 31 | --retry is used then curl will retry on some HTTP response codes that indicate |
| 32 | transient HTTP errors, but that does not include most 4xx response codes such |
| 33 | as 404. If you want to retry on all response codes that indicate HTTP errors |
| 34 | (4xx and 5xx) then combine with --fail. |