xref: /aosp_15_r20/external/curl/docs/cmdline-opts/mail-rcpt-allowfails.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: mail-rcpt-allowfails
5*6236dae4SAndroid Build Coastguard WorkerHelp: Allow RCPT TO command to fail
6*6236dae4SAndroid Build Coastguard WorkerProtocols: SMTP
7*6236dae4SAndroid Build Coastguard WorkerAdded: 7.69.0
8*6236dae4SAndroid Build Coastguard WorkerCategory: smtp
9*6236dae4SAndroid Build Coastguard WorkerMulti: boolean
10*6236dae4SAndroid Build Coastguard WorkerSee-also:
11*6236dae4SAndroid Build Coastguard Worker  - mail-rcpt
12*6236dae4SAndroid Build Coastguard WorkerExample:
13*6236dae4SAndroid Build Coastguard Worker  - --mail-rcpt-allowfails --mail-rcpt [email protected] smtp://example.com
14*6236dae4SAndroid Build Coastguard Worker---
15*6236dae4SAndroid Build Coastguard Worker
16*6236dae4SAndroid Build Coastguard Worker# `--mail-rcpt-allowfails`
17*6236dae4SAndroid Build Coastguard Worker
18*6236dae4SAndroid Build Coastguard WorkerWhen sending data to multiple recipients, by default curl aborts SMTP
19*6236dae4SAndroid Build Coastguard Workerconversation if at least one of the recipients causes RCPT TO command to
20*6236dae4SAndroid Build Coastguard Workerreturn an error.
21*6236dae4SAndroid Build Coastguard Worker
22*6236dae4SAndroid Build Coastguard WorkerThe default behavior can be changed by passing --mail-rcpt-allowfails
23*6236dae4SAndroid Build Coastguard Workercommand-line option which makes curl ignore errors and proceed with the
24*6236dae4SAndroid Build Coastguard Workerremaining valid recipients.
25*6236dae4SAndroid Build Coastguard Worker
26*6236dae4SAndroid Build Coastguard WorkerIf all recipients trigger RCPT TO failures and this flag is specified, curl
27*6236dae4SAndroid Build Coastguard Workerstill aborts the SMTP conversation and returns the error received from to the
28*6236dae4SAndroid Build Coastguard Workerlast RCPT TO command.
29