NAME

Mail::Abuse::Processor::Mailer - Handle the email response to a Mail::Abuse::Report

SYNOPSIS

  use Mail::Abuse::Processor::Mailer;

  use Mail::Abuse::Report;
  my $p = new Mail::Abuse::Processor::Mailer;
  my $report = new Mail::Abuse::Report (processors => [ $p ]);

  # ... other pieces of code that configure the report ...

DESCRIPTION

This class handles automatic email responses sent to the originator of the Mail::Abuse::Report. Mail loops are avoided and detected by inserting a special header, X-Mail-Abuse-Loop. If this header is present, no messages will be sent.

The following configuration keys control the behavior of this module.

debug mailer

If set to a true value, causes this module to emit debugging info using warn().

mailer type

The type of mailer to use, as described in Mail::Mailer. Defaults to mail.

mailer smtp server

Some types of mailers require the specification of an SMTP server. This option allows for it.

mailer from

The complete RFC-2822 address to be used in the From: header placed in the message header. It must be specified.

mailer reply to

The Reply-To: header to use in the message header of the reply. The header will not be included if left unspecified.

mailer errors to

The Errors-To: header to use in the message header of the reply. The header will not be included if left unspecified.

mailer forced to

If this value is set, the response message is directed to the given address.

mailer subject

The subject to use in the responses.

mailer precedence

The precedence to use. Defaults to 'bulk'.

mailer fail message

The name of the file containing the message template that will be used to compose a message whenever no incidents can be parsed or pass the filters from the abuse report. This distribution includes an example message in the etc/ subdirectory.

mailer success message

The name of the file containing the message template that will be used to compose a message when one or more incidents are parsed and filtered from the abuse report.. This distribution includes an example message in the etc/ subdirectory.

mailer charset

The charset used to encode the response. Defaults to 'US-ASCII'. This is placed in the charset= part of the MIME headers.

The following functions are implemented.

process($report)

Takes a Mail::Abuse::Report object as an argument and performs the processing action required. MIME headers inserted by this module, force encoding to 8bit.

EXPORT

None by default.

HISTORY

0.01

Original version; created by h2xs 1.2 with options

  -ACOXcfkn
        Mail::Abuse
        -v
        0.01

LICENSE AND WARRANTY

This code and all accompanying software comes with NO WARRANTY. You use it at your own risk.

This code and all accompanying software can be used freely under the same terms as Perl itself.

AUTHOR

Luis E. Muñoz <luismunoz@cpan.org>

SEE ALSO

perl(1).