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