test-filter-module(1p) [debian man page]

TEST-FILTER-MODULE(1p)					User Contributed Perl Documentation				    TEST-FILTER-MODULE(1p)

NAME

       test-filter-module - A tester for Courier::Filter modules

VERSION

       0.18

SYNOPSIS

       test-filter-module module [options] message [+control ...] [...]

DESCRIPTION

       This is a tester for Courier::Filter modules.  It sets up the specified Courier::Filter::Module::module filter module, using any supplied
       options, and then queries the filter module for consideration of the given message file and zero or more control files.	More than one
       message/control files tuple may also be specified, in which case the filter module is applied to each message and its respective control
       file(s).  Filter module options must be specified in the format -option=expr, where expr may be any valid Perl expression.

EXAMPLES

       test-filter-module DNSBL -zones='["bl.foo.org", "bl.bar.org"]' test.rfc2822 +test.control
	   Applies the Courier::Filter::Module::DNSBL filter module to the test.rfc2822/test.control message/control file tuple (taking the
	   sending machine's IP address from the control file), using the blacklist DNS zones "bl.foo.org" and "bl.bar.org".

SEE ALSO

       Courier::Filter::Overview, Courier::Filter

       For AVAILABILITY, SUPPORT, and LICENSE information, see Courier::Filter::Overview.

AUTHOR

       Julian Mehnle <julian@mehnle.net>

perl v5.14.2							    2011-12-27						    TEST-FILTER-MODULE(1p)

Courier::Filter::Module::DNSBL(3pm)			User Contributed Perl Documentation		       Courier::Filter::Module::DNSBL(3pm)

NAME

       Courier::Filter::Module::DNSBL - DNS black-list filter module for the Courier::Filter framework

SYNOPSIS

	   use Courier::Filter::Module::DNSBL;

	   my $module = Courier::Filter::Module::DNSBL->new(
	       zones	   => @dns_zones,

	       logger	   => $logger,
	       inverse	   => 0,
	       trusting    => 0,
	       testing	   => 0,
	       debugging   => 0
	   );

	   my $filter = Courier::Filter->new(
	       ...
	       modules	   => [ $module ],
	       ...
	   );

DESCRIPTION

       This class is a filter module class for use with Courier::Filter.  It matches a message if the sending machine's IP address (currently IPv4
       only) is listed by one of the configured DNS black-lists.

   Constructor
       The following constructor is provided:

       new(%options): returns Courier::Filter::Module::DNSBL
	   Creates a new DNSBL filter module.

	   %options is a list of key/value pairs representing any of the following options:

	   zones
	       Required.  A reference to an array containing the DNS zone names of the black-lists to be used.

	   All options of the Courier::Filter::Module constructor are also supported.  Please see "new()" in Courier::Filter::Module for their
	   descriptions.

   Instance methods
       See "Instance methods" in Courier::Filter::Module for a description of the provided instance methods.

SEE ALSO

       Courier::Filter::Module, Courier::Filter::Overview.

       For AVAILABILITY, SUPPORT, and LICENSE information, see Courier::Filter::Overview.

AUTHOR

       Julian Mehnle <julian@mehnle.net>

perl v5.14.2							    2011-12-27				       Courier::Filter::Module::DNSBL(3pm)