fail domain quiet
Name
fail domain quiet — fail messages for a domain without generating bounces
Synopsis
fail domain quiet [ --meta key value | --header header_name header_line ] { domain_name } [ note … ]
Description
The fail domain quiet command allows the administrative failure of all messages bound for the specified domain without sending a bounce message, even if Generate_Bounces is set in the configuration file. Its usage is similar to fail domain:
10:47:35 /tmp/2025> fail domain quiet unresolvableproblems.com unresolvableproblems.com purged, 62415 messages failed.
Selective purge (optional filter)
You may restrict which messages are failed by adding at most one optional clause before the domain name:
| Clause | Meaning |
|---|---|
--meta key value | Fail only messages whose message or connection validation context has key with exactly value. Message context is checked first; connection context is used when the key is not set on the message (for example variables provided through XSETCONTEXT during injection). |
--header name line | Fail only messages where the first MIME part has header name and one physical line of that header’s value equals line (useful when a header is folded across lines). |
Folded headers / multi-line values: Matching uses physical RFC822 header lines only. Each continuation line created by folding is tested separately against the single line operand. There is no match against the unfolded header body as one multi-line string. The line you pass on the ec_console command is one token string; it must equal exactly one stored physical line of that header’s value (including typical leading whitespace on folded continuation lines). If your selection logic needs to treat the whole logical header value as one unit, prefer --meta or external tooling.
You cannot combine --meta and --header in the same command. With no filter, every queued message for the domain is failed (original behavior).
Any tokens after the domain name are joined into an optional administrative failure note (same as without a filter).
10:47:35 /tmp/2025> fail domain quiet --meta mo_campaign_id summer-sale unresolvableproblems.com unresolvableproblems.com purged. 12 messages failed.