1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: mail-rcpt-allowfails
5Help: Allow RCPT TO command to fail
6Protocols: SMTP
7Added: 7.69.0
8Category: smtp
9Multi: boolean
10See-also:
11  - mail-rcpt
12Example:
13  - --mail-rcpt-allowfails --mail-rcpt dest@example.com smtp://example.com
14---
15
16# `--mail-rcpt-allowfails`
17
18When sending data to multiple recipients, by default curl aborts SMTP
19conversation if at least one of the recipients causes RCPT TO command to
20return an error.
21
22The default behavior can be changed by passing --mail-rcpt-allowfails
23command-line option which makes curl ignore errors and proceed with the
24remaining valid recipients.
25
26If all recipients trigger RCPT TO failures and this flag is specified, curl
27still aborts the SMTP conversation and returns the error received from to the
28last RCPT TO command.
29