event::rpc::logger(3pm) [debian man page]

Event::RPC::Logger(3pm) 				User Contributed Perl Documentation				   Event::RPC::Logger(3pm)

NAME

       Event::RPC::Logger - Logging facility for Event::RPC

SYNOPSIS

	 use Event::RPC::Server;
	 use Event::RPC::Logger;

	 my $server = Event::RPC::Server->new (
	     ...
	     logger => Event::RPC::Logger->new(
		 filename  => "/var/log/myserver.log",
		 fh_lref   => [ $fh, $sock ],
		 min_level => 2,
	     ),
	     ...
	 );

	 $server->start;

DESCRIPTION

       This modules implements a simple logging facility for the Event::RPC framework. Log messages may be written to a specific file and/or a
       bunch of filehandles, which may be sockets as well.

CONFIGURATION OPTIONS

       This is a list of options you can pass to the new() constructor:

       filename
	   All log messages are appended to this file.

       fh_lref
	   All log messages are printed into this list of filehandles.

       min_level
	   This is the minimum log level. Output of messages with a lower level is suppressed. This option may be altered using set_min_level()
	   even in a running server.

METHODS

       $logger->log ( [$level, ] $msg )
	   The log() method does the actual logging. Called with one argument the messages gets the default level of 1. With two argumens the
	   first is the level for the message.

       $logger->add_fh ( $fh )
	   This adds a filehandle to the internal list of filhandles all log messages are written to.

       $logger->remove_fh ( $fh )
	   Removes a filehandle.

AUTHORS

	 Joern Reder <joern at zyn dot de>

COPYRIGHT AND LICENSE

       Copyright (C) 2002-2006 by Joern Reder, All Rights Reserved.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2006-04-23						   Event::RPC::Logger(3pm)

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

NAME

       Courier::Filter::Logger::File - File logger for the Courier::Filter framework

SYNOPSIS

	   use Courier::Filter::Logger::File;

	   my $logger = Courier::Filter::Logger::File->new(
	       file_name => $file_name
	   );

	   # 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,
	       ...
	   );

DESCRIPTION

       This class is a file logger class for use with Courier::Filter and its filter modules.  It is derived from
       Courier::Filter::Logger::IOHandle.

   Constructor
       The following constructor is provided:

       new(%options): returns Courier::Filter::Logger::File; throws Courier::Error
	   Creates a new logger that logs messages as lines to a file.	Opens the file for writing, creating it if necessary.

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

	   file_name
	       Required.  The name of the file to which log messages should be written.

	   timestamp
	       A boolean value controlling whether every log message line should be prefixed with a timestamp (in local time, in ISO format).
	       Defaults to false.

   Instance methods
       The following instance methods are provided, as inherited from Courier::Filter::Logger::IOHandle:

       log_error($text): throws Perl exceptions
	   Logs the error message given as $text (a string which may contain newlines).  Prefixes each line with a timestamp if the "timestamp"
	   option has been set through the constructor.

       log_rejected_message($message, $reason): throws Perl exceptions
	   Logs the Courier::Message given as $message as having been rejected due to $reason (a string which may contain newlines).

SEE ALSO

       Courier::Filter::Logger::IOHandle, Courier::Filter::Logger, 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::File(3pm)