NAME

Log::Dispatch::Handle - Object for logging to IO::Handle objects (and subclasses thereof)

SYNOPSIS

  use Log::Dispatch::Handle;

  my $handle = Log::Dispatch::Handle->new( name      => 'a handle',
                                           min_level => 'emerg',
                                           handle    => $io_socket_object );

  $handle->log( level => 'emerg', message => 'I am the Lizard King!' );

DESCRIPTION

This module supplies a very simple object for logging to some sort of handle object. Basically, anything that implements a print() method can be passed the object constructor and it should work.

METHODS

• new(%PARAMS)

  This method takes a hash of parameters. The following options are valid:

• -- name ($)

  The name of the object (not the filename!). Required.

• -- min_level ($)

  The minimum logging level this object will accept. See the Log::Dispatch documentation for more information. Required.

• -- max_level ($)

  The maximum logging level this obejct will accept. See the Log::Dispatch documentation for more information. This is not required. By default the maximum is the highest possible level (which means functionally that the object has no maximum).

• -- handle ($)

  The handle object. This object must implement a print() method.

• log( level => $, message => $ )

  Sends a message if the level is greater than or equal to the object's minimum level.

AUTHOR

Dave Rolsky, <autarch@urth.org>

SEE ALSO

Log::Dispatch, Log::Dispatch::Email, Log::Dispatch::Email::MailSend, Log::Dispatch::Email::MailSendmail, Log::Dispatch::Email::MIMELite, Log::Dispatch::File, Log::Dispatch::Output, Log::Dispatch::Screen, Log::Dispatch::Syslog