| lh | 9ed821d | 2023-04-07 01:36:19 -0700 | [diff] [blame^] | 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. |