| xf.li | 6c8fc1e | 2023-08-12 00:11:09 -0700 | [diff] [blame] | 1 | c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al. |
| 2 | SPDX-License-Identifier: curl |
| 3 | Long: fail-early |
| 4 | Help: Fail on first transfer error, do not continue |
| 5 | Added: 7.52.0 |
| 6 | Category: curl |
| 7 | Example: --fail-early $URL https://two.example |
| 8 | See-also: fail fail-with-body |
| 9 | Multi: boolean |
| 10 | --- |
| 11 | Fail and exit on the first detected transfer error. |
| 12 | |
| 13 | When curl is used to do multiple transfers on the command line, it will |
| 14 | attempt to operate on each given URL, one by one. By default, it will ignore |
| 15 | errors if there are more URLs given and the last URL's success will determine |
| 16 | the error code curl returns. So early failures will be "hidden" by subsequent |
| 17 | successful transfers. |
| 18 | |
| 19 | Using this option, curl will instead return an error on the first transfer |
| 20 | that fails, independent of the amount of URLs that are given on the command |
| 21 | line. This way, no transfer failures go undetected by scripts and similar. |
| 22 | |
| 23 | This option is global and does not need to be specified for each use of --next. |
| 24 | |
| 25 | This option does not imply --fail, which causes transfers to fail due to the |
| 26 | server's HTTP status code. You can combine the two options, however note --fail |
| 27 | is not global and is therefore contained by --next. |