Sign In Sign Out Mailing Lists Unsubscribe or Change Settings Help

Majordomo2 list server

= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
configset listname bounce_rules <<TAG
[VALUE LINES]
TAG
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Default Value : no default
Data Type     : bounce_rules
Category      : bounce
Password Notes: Visible only with password. 
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

EXAMPLE:
configset listname bounce_rules <<ENDTAG
remove-noprobe-quiet
$consecutive > 40

ignore
ALL
ENDTAG

The bounce_rules setting determines how error messages due to delivery 
failures should be processed.  Each rule consists of at least two lines.  
On the first line are one or more actions, separated by commas.  On the 
second and succeeding lines are conditions under which the actions occur.  
Blank lines are used to separate rules.

When a bounce message is received, Majordomo first takes it apart and
extracts the address of the user who is bouncing messages.  Statistics are
then generated, and then the bounce_rules are consulted to see what action
should be taken.

Currently there are four basic actions (inform is the default):

  ignore - do nothing; do not send a bounce notice to the owners and
           perform no action on the list of subscribers.  (Statistics are
           still generated as appropriate.)
  inform - send a bounce notice to the owners, but leave the bouncing user
           on the list.
  remove - send a bounce notice to the owners, and remove the user from the
           list.
  reason - specify a reason that a particular action was taken.

There are several modes for the remove action.  By default, the list owners
are sent a notice of the bounce (as with the inform action) and the
bouncing user is sent one final, unique test message and if it bounces then
the user is removed.

The remove-consult action will, after the test message has bounced, send a
consultation token to the list owners instead of immediately removing the
user.  If this token is accepted, then the user is removed.

The remove-noprobe action will immediately remove the user, without sending
the probing test message to verify that the user is indeed bouncing.
This action will also cause the bouncehandler-unsubscribe shell hook to
be run.  See "help shell_hook" for more details.

The remove-noprobe-consult action is also valid; it causes the owners to be
consulted but no probing test message to be sent to the bouncing user.

Finally, "quiet" mode (i.e., remove-consult-quiet, remove-noprobe-quiet,
remove-noprobe-consult-quiet) will prevent the bounce notice from being
sent to the list owners.  The owners will still receive a consultation
token if "consult" mode is used.  If the bouncing user is unsubscribed,
the owners will still receive an "inform" notice, subject to the inform
configuration setting.

The bounce message is sent to the e-mail addresses in the bounce_recipients
configuration setting, or to the list owners if that setting is empty.  

The variables currently recognized are:

failure:
  This is true if the bounce indicates a failure.

warning:
  This is true if the bounce indicates a warning.  Warnings do not generate
  statistics (i.e. they don't count as bounced messages).  You generally
  want to ignore them (and the default is to do so) but you can inform the
  owner as well.

addr:
  The bouncing address, stripped of comments.

fulladdr:
  The bouncing address, with all comments left in.

host:
  The host portion of the bouncing address.

days_since_subscribe:
  The number of days since the user joined the list.  You can use this to
  perhaps set a lower threeshold for new subscribers, or a higher one for
  long-time subscribers.

digest:
  If the user is subscribed and receives messages in a digest, this
  variable will contain the name of the digest.  Otherwise, it will
  contain an empty string.

consecutive:
  The number of consecutive messages bounced.  This records the length of
  the most recent consecutive run of bounced messages.  So if messages
  1,2,3,5 and 6 bounce, $consecutive is 2.  Use this to detect when an
  address is bouncing a long run of messages.

consecutive_days:
  The length in days of the most recent consecutive run of bounced
  messages.  In the above example, if message 5 bounced at noon on
  Wednesday and message 6 bounced at noon on Friday, $consecutive_days
  would be 2.  Use this in conjunction with $consecutive on high traffic
  lists to detect when an address is bouncing every message sent to it and
  it has been doing so for some period of time.  (In high traffic lists, or
  lists where traffic is bursty, testing $consecutive alone might not give
  you much useful information.)  For example:

  # Remove users after they have bounced at least 50 consecutive messages
  # over five days
  remove
  $consecutive >= 50 && $consecutive_days >= 5

day:
  The number of bounces in the last 24 hours.

week:
  The number of bounces in the last 7 days.

month:
  The number of bounces in the last 30 days.  You can use $day, $week and
  $month if you want to set a threshold for the number of bounces in some
  time period without requiring that they be consecutive.

bouncedpct:
  The percentage of messages which have bounced.  This is calculated from
  the lowest and highest sequence numbers of bounced messages and the count
  of numbered bounced messages: (highest - lowest +1) / count.

diagnostic:
  The bounce diagnostic.  Majordomo tries to extract from each bounce a
  maningful error message.  You can match against it here if you want to do
  perform special handling.  This will contain the string "unknown" if no
  diagnostic could be extracted.

The use of these variables in comparisons is described in the
"help configset_access_rules" and "help access_variables" documents.


Here's an in-depth example.  (Please note that providers like AOL seem to
randomly change their bounce formats and error messages, so you should
always make sure that matches against $diagnostic are doing what you think
they are).

  # When AOL says a user doesn't exist, drop it immediately
  remove-noprobe
  $host =~ /aol.com/ && $diagnostic =~ /user unknown/i

  # Remove all users bouncing enough messages over three days, but not for
  # "mailbox full" errors, because we want to be more lenient with them
  remove, reason="Over 20 consecutive 'mailbox full' bounces"
  $consecutive > 20 &&
  $consecutive_days > 3 &&
  $diagnostic !~ /mailbox full/i

  # Now deal with long consecutive runs that the above rule didn't match
  remove, reason="Over 100 consecutive bounces"
  $consecutive > 100 &&
  $consecutive_days > 7

  # Digests are posted less often than individual messages, so make
  # the consecutive bounce limits for digest subscribers more
  # restrictive, except for the "hourly" digest.
  remove
  $consecutive > 15 && 
  $digest && 
  $digest != "hourly"

  # Deal with users bouncing lots of messages but not ever building up a
  # big consecutive run.  Consult the owner once the probe fails.
  remove-consult
  $month > 200

  # Inform the owner when we start seeing more than just a few bounces
  inform
  $day > 5

  # Don't bother the owner otherwise
  ignore
  ALL


                             Probe Messages

A bounce probe usually consists of two parts, the "bounceprobe" file and
an attachment containing the error message.  To send a probe without the
error message attached, use the "notify" action to disable attachments.
For example, the following rule would cause a probe without the
attachment to be sent for every bounce:

  remove, notify=(attach=0)
  ALL


                                Comments

It is possible to use comments before, between, and after the individual
rules, but not within rules.  Comments are lines that begin with a '#'.


See Also:
   help admin_subscribers
   help configset_access_rules
   help configset_bounce_max_age
   help configset_bounce_max_count
   help configset_bounce_probe_frequency
   help configset_bounce_probe_pattern
   help configset_bounce_recipients
   help configset_inform
   help shell_hook

This is the "configset_bounce_rules" help document for 
Majordomo 2, version 0.1200410180.

For a list of all help documents, send the following command:
   help topics
in the body of a message to majordomo@lists.mj2.org.

For assistance, please contact the lists.mj2.org administrators.
Sign In Sign Out Mailing Lists Unsubscribe or Change Settings Help