| 1 |
Long: fail-early |
| 2 |
Help: Fail on first transfer error, do not continue |
| 3 |
Added: 7.52.0 |
| 4 |
--- |
| 5 |
Fail and exit on the first detected transfer error. |
| 6 |
|
| 7 |
When curl is used to do multiple transfers on the command line, it will |
| 8 |
attempt to operate on each given URL, one by one. By default, it will ignore |
| 9 |
errors if there are more URLs given and the last URL's success will determine |
| 10 |
the error code curl returns. So early failures will be "hidden" by subsequent |
| 11 |
successful transfers. |
| 12 |
|
| 13 |
Using this option, curl will instead return an error on the first transfer |
| 14 |
that fails, independent of the amount of URLs that are given on the command |
| 15 |
line. This way, no transfer failures go undetected by scripts and similar. |
| 16 |
|
| 17 |
This option is global and does not need to be specified for each use of --next. |
| 18 |
|
| 19 |
This option does not imply --fail, which causes transfers to fail due to the |
| 20 |
server's HTTP status code. You can combine the two options, however note --fail |
| 21 |
is not global and is therefore contained by --next. |