debian man page for courier::filter::logger

Query: courier::filter::logger

OS: debian

Section: 3pm

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

Courier::Filter::Logger(3pm)				User Contributed Perl Documentation			      Courier::Filter::Logger(3pm)

NAME
Courier::Filter::Logger - Abstract base class for loggers used by the Courier::Filter framework
SYNOPSIS
Courier::Filter logging use Courier::Filter::Logger::My; # Need to use a non-abstract sub-class. my $logger = Courier::Filter::Logger::My->new(%options); # For use in an individual filter module: my $module = Courier::Filter::Module::My->new( ... logger => $logger, ... ); # For use as a global Courier::Filter logger object: my $filter = Courier::Filter->new( ... logger => $logger, ... ); Deriving new logger classes package Courier::Filter::Logger::My; use base qw(Courier::Filter::Logger);
DESCRIPTION
Sub-classes of Courier::Filter::Logger are used by the Courier::Filter mail filtering framework and its filter modules for the logging of errors and message rejections to arbitrary targets, like file handles or databases. When overriding a method in a derived class, do not forget calling the inherited method from your overridden method. Constructor The following constructor is provided and may be overridden: new(%options): returns Courier::Filter::Logger Creates a new logger using the %options given as a list of key/value pairs. Initializes the logger, by creating/opening I/O handles, connecting to databases, etc.. "Courier::Filter::Logger::new()" creates a hash-ref as an object of the invoked class, and stores the %options in it, but does nothing else. Destructor The following destructor is provided and may be overridden: destroy Uninitializes the logger, by closing I/O handles, disconnecting from databases, etc.. "Courier::Filter::Logger::destroy()" does nothing. Sub-classes may override this method and define clean-up behavior. Instance methods The following instance methods are provided and may be overridden: log_error($text) Logs the error message given as $text (a string which may contain newlines). "Courier::Filter::Logger::log_error()" does nothing and should be overridden. log_rejected_message($message, $reason) Logs the Courier::Message given as $message as having been rejected due to $reason (a string which may contain newlines). "Courier::Filter::Logger::log_rejected_message()" does nothing and should be overridden.
SEE ALSO
Courier::Filter, Courier::Filter::Module. For a list of prepared loggers that come with Courier::Filter, see "Bundled Courier::Filter loggers" in 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::Logger(3pm)
Related Man Pages
courier::filter::logger::file(3pm) - debian
courier::filter::module::parts(3pm) - debian
courier::filter::module::sendcopy(3pm) - debian
courier::filter::module::spamassassin(3pm) - debian
courier::filter::overview(3pm) - debian
Similar Topics in the Unix Linux Community
Logger 07360.0349 (Default branch)
Logger 07362.1605 (Default branch)
Logger 08029.1447 (Default branch)
Filter the file list greater then the size specified by user
Combine 2 line with space issue