Skip to main content

Name

binding fail domain quiet — fail messages for a domain on a binding without generating bounces

Synopsis

binding fail domain quiet [ --dry-run ] [ --meta key value | --header header_name header_line ] { binding_name } { domain_name | all } [ note … ]

Description

The binding fail domain quiet command allows the administrative failure of all messages bound for the specified domain on the specified binding in such a way that no bounce is sent, even if Generate_Bounces is set in the server configuration. Its usage is similar to binding fail domain :

ecelerity> binding fail domain quiet BINDING1 unresolvableproblems.com
unresolvableproblems.com purged, 62415 messages failed.

You may substitute all for the domain name to apply to all domains.

ecelerity> binding fail domain quiet BINDING1 all
All domains purged.  62415 messages failed.

Selective purge (optional filter)

Optional --meta / --header clauses use the same matching rules as fail domain quiet. --header uses physical-line matching. Place at most one clause immediately after binding fail domain quiet and before the binding name. Only messages on that binding that match the filter (and domain / all) are failed.

For a binding-agnostic global purge by filter only, see fail all quiet.

ecelerity> binding fail domain quiet --header X-Priority high BINDING1 unresolvableproblems.com
unresolvableproblems.com purged. 3 messages failed.

Preview without failing (--dry-run)

Add --dry-run to preview the command without failing any messages. The queue is left untouched; the messages that would be failed are listed (capped) and followed by a summary count:

ecelerity> binding fail domain quiet --dry-run BINDING1 unresolvableproblems.com
  3A/0F-04217-1A3F9C2B  domain=unresolvableproblems.com from=<news@sender.com> to=<user@unresolvableproblems.com>
  7C/1B-04217-2B4E0D8A  domain=unresolvableproblems.com from=<promo@sender.com> to=<admin@unresolvableproblems.com>
  ...
[dry-run] unresolvableproblems.com: 62415 messages would be failed. (Showing first 25; 62390 more not listed.)

When the domain is all, the summary reports [dry-run] all domains: …. See fail domain quiet → preview for the full description of the listing, the 25-message cap, and placement. --dry-run combines with the optional --meta / --header filter and is never consumed as part of the note.

See Also

Was this page helpful?