fail domain
Name
fail domain — fail messages for a domain with a bounce message
Synopsis
fail domain [ --meta key value | --header header_name header_line ] { domain_name } [ note … ]
Description
The fail domain command allows the administrative failure of all messages bound for the specified domain. If political issues arise that cannot be resolved or if the domain has been discontinued, it may be necessary to fail all of the messages to that domain. All failed messages will be assigned the following administrative failure message: "554 Message manually purged."
For example, the following command could be used to fail all message for the domain unresolvableproblems.com.
10:47:35 /tmp/2025> fail domain unresolvableproblems.com unresolvableproblems.com purged. 62415 messages failed.
Usually, the command is immediately preceded or followed by "blackholing" the domain by issuing a command such as:
10:47:35 /tmp/2025> config set domain unresolvableproblems.com blackhole inline
Selective purge (optional filter)
Optional --meta / --header filtering uses the same rules as fail domain quiet. --header compares physical header lines only—see folded headers. With a filter, only matching messages are failed; without a filter, all messages for the domain are failed.