SMAILRTRY(5)

NAME
/usr/local/etc/smail/retry - smail retry configuration

THE RETRY FILE
This section details the format and use of the retry control file.

The retry file defines, by target domain, the minimum interval between delivery attempts and/or the maximum duration over which to continue attempting delivery.

Each retry entry should have the form:

    domain[:domain...]  [interval]/[duration]
stating that, for the given domain(s), delivery will be attempted no more frequently than interval, and that delivery attempts will cease after duration.

The domain can be either a simple hostname, a fully qualified domain name, or just the proper suffix of a domain name. Although a leading dot (`.') is just ignored you can use it to document when you really mean a domain suffix in a way similar to the pathalias router driver.

Values for interval and duration are in seconds if no units suffix is given. However, they can be written as a sequence of numbers with suffixes of `s' for seconds, `m' for minutes, `h' for hours, `d' for days, `w' for weeks and `y' for years. For example, ``10m/2d'' specifies an interval of ten minutes and a duration of two days; and ``1h10m30s/1w3d12h'' would represent an interval of one hour, ten minutes and 30 seconds and a duration of exactly one and one half weeks.

Invalid specifications (attempts to set a negative number, use of invalid units suffixes, etc.) will be logged as configuration errors. Take care not to use a setting that can not be represented internally as a number of seconds greater than the maximum value of an unsigned C integer.

Explicitly setting the interval to zero (``0'') will cause it to always be treated as twice whatever is given as the queue run interval with the ``-q'' parameter. This will prevent messages to one or more domains with many dead/broken MX targets from blocking the queue with every queue run attempt and will allow other messages in the queue to be processed more quickly. In extreme circumstances this may help avoid accumulating too many queue run processes that are doing nothing useful.

If the duration is set to zero then any message in the queue will only be retried once more before being bounced (i.e. a delivery attempt is made for every message in the queue before it is bounced even if the duration has long since expired or is set to zero).

Either or both of interval and duration may be omitted, in which case they are taken to be the default value specified with the respective global configuration parameter, either retry_interval or retry_duration. Note that the ``/'' separator must be present.

As a special case, if a retry file entry has a domain list equal to the special string ``*'', that entry matches any domain. This feature is a catch-all which should only be used in the last entry in a retry file. If a retry file contains no ``*'' catch-all entry, then the configuration parameters retry_interval and retry_duration will be used to control retries to domains without specific retry entries.

FILES

/usr/local/etc/smail/retry
    - smail retry configuration

SEE ALSO
smailconf(5), smaildrct(5), smailqual(5), smailrtrs(5), smailtrns(5), smail(8).

Smail Administration and Installation Guide.

DARPA Internet Requests for Comments: RFC 821, RFC 822, RFC 974, RFC 976, and RFC 1123.

BUGS
Database files cannot contain ``#'' in the left-hand field.

COPYRIGHT
Copyright (C) 1987, 1988 Ronald S. Karr and Landon Curt Noll
Copyright (C) 1992 Ronald S. Karr

See a file COPYING, distributed with the source code, or type smail -bc, to view distribution rights and restrictions associated with this software.