mirror of
https://github.com/curl/curl.git
synced 2024-12-27 06:59:43 +08:00
ef305de95c
The keyword specifies how option works when specified multiple times: - single: the last provided value replaces the earlier ones - append: it supports being provided multiple times - boolean: on/off values - mutex: flag-like option that disable anoter flag The 'gen.pl' script then outputs the proper and unified language for each option's multi-use behavior in the generated man page. The multi: header is requires in each .d file and will cause build error if missing or set to an unknown value. Closes #9759
35 lines
1.7 KiB
Makefile
35 lines
1.7 KiB
Makefile
c: Copyright (C) 1998 - 2022, 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
|
|
Example: --retry 5 --retry-all-errors $URL
|
|
See-also: retry
|
|
Multi: boolean
|
|
---
|
|
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 (eg in 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 will not error on 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 will retry 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.
|