=pod

=head1 NAME

B<ungrey-robins.ptrn> - ungrey-robins mandatory domains pattern file

=head1 SYNOPSIS

F</etc/mail/ungrey-robins.ptrn>

=head1 DESCRIPTION

This manual page describes the format of the ungrey-robins(8) mandatory domains
pattern F<ungrey-robins.ptrn> file as following:

B<NOTE:> whitespace, empty lines, and lines beginning with the C<#> character
must NOT be present. Refer to B<-f> F<file> in fgrep(1).

To whitelist spamdb(8) greylisted round robin servers which SMTP HELO from below
a DNS domain, the line format is a dot, followed by the DNS domain name.
For example:

	.example.com
	.outbound-pool.mail.example.net

If the mailing organisation deploys multiple hosts, which all SMTP HELO to
spamd(8) with the same DNS multi-homed hostname, explicitly list that hostname.
For example:

	mxout.example.org

In all cases, the B<SMTP HELO> hostname is used, not the SMTP FROM address's
domain name. (An ISP or email provider may send mail on behalf of many domains.)
Once realised (via checking spamd(8)'s syslog entries), this feature greatly
reduces the number of entries required.

=head1 FILES

F</etc/mail/ungrey-robins.ptrn> mandatory domains pattern file.

=head1 SECURITY

For unprivileged, non-root usage, F</etc/mail/ungrey-robins.ptrn> needs to be
(world) readable by the ungrey-robins(8) user, such as C<_spamd>.

=head1 SEE ALSO

ungrey-robins(8), fgrep(1), spamdb(8), spamd(8),
The sample F<logs/> in the source distribution.

=head1 HISTORY

Craig Skinner developed B<ungrey-robins>, mostly in 2016.
The F<ChangeLog> file in the source distribution contains more information.

=cut