NAME

       Mail::Milter::Module::AccessDB - emulator for Sendmail "access_db" in a milter

SYNOPSIS

           use Mail::Milter::Module::AccessDB;

           my $milter = new Mail::Milter::Module::AccessDB(\%hashref);

           my $milter2 = &AccessDB(\%hashref); # convenience

DESCRIPTION

       Sendmail's "access_db" is a powerful access restriction database tool, but it is limited
       only to data explicitly available through the SMTP session.  This milter module allows
       rewriting to take place (such as through Mail::Milter::Wrapper::DecodeSRS) before applying
       the access rules.

       Not all access_db functionality is duplicated here; some is unimplemented, while some is
       Sendmail-internal only.  See DATABASE FORMAT, below, for a list of supported tags and
       result codes in this module.

       NOTE:  As of this version, this module might not be thread-safe.  A future version of this
       module will share the hashref between threads and lock it properly.

       ESPECIALLY NOTE:  This module is highly experimental, does not support all accessdb data
       types yet, and is not guaranteed to work at all.  Feel free to try it out and to send
       comments to the author, but it is not yet recommended to use this module in a production
       setup.

DATABASE FORMAT

       [XXX: TBD]

METHODS

           new(HASHREF)

           Create this milter using a provided hash reference.  This may be a tied hash, such as
           to an already opened Sendmail-style database.

           Currently there is no support for automatically reopening databases, hence this one-
           shot constructor.  (Sendmail does not support automatic reopening either, for that
           matter.)

           ignore_tempfail(FLAG)

           If FLAG is 0 (the default), a DNS lookup which fails the underlying DNS query will
           cause the milter to return a temporary failure result (SMFIS_TEMPFAIL).

           If FLAG is 1, a temporary DNS failure will be treated as if the lookup resulted in an
           empty record set (SMFIS_CONTINUE).

           This method returns a reference to the object itself, allowing this method call to be
           chained.

           set_message(MESSAGE)

           Sets the message used when rejecting messages.  This string may contain the substring
           %0, which will be replaced by the matching lookup key (not including type tag).

           This method returns a reference to the object itself, allowing this method call to be
           chained.

AUTHOR

       Todd Vierling, <tv@duh.org> <tv@pobox.com>

SEE ALSO

       Mail::Milter::Object

POD ERRORS

       Hey! The above document had some coding errors, which are explained below:

       Around line 90:
           You can't have =items (as at line 102) unless the first thing after the =over is an
           =item