NAME

Log::Fine::Utils - Functional wrapper around Log::Fine

SYNOPSIS

Provides a functional wrapper around Log::Fine.

use Log::Fine::Handle;
use Log::Fine::Handle::File;
use Log::Fine::Handle::Syslog;
use Log::Fine::Utils;

# set up some handles as you normally would.  First, a handler for
# file logging:
my $handle1 = Log::Fine::Handle::File
    ->new( name      => "file0",
           mask      => Log::Fine::Handler->LOGMASK_ALL,
           formatter => Log::Fine::Formatter::Basic->new() );

# and now a handle for syslog
my $handle2 = Log::Fine::Handle::Syslog
    ->new( name      => "syslog0",
           mask      => LOGMASK_EMERG | LOGMASK_CRIT | LOGMASK_ERR,
           ident     => $0,
           logopts   => 'pid',
           facility  => LOG_LEVEL0 );

# open the logging subsystem
OpenLog( handles  => [ $handle1, [$handle2], ... ],
         levelmap => "Syslog");

# Log a message
Log(INFO, "The angels have my blue box");

DESCRIPTION

The Utils class provides a functional wrapper for Log::Fine and friends, thus saving the developer the tedious task of mucking about in object-oriented land.

FUNCTIONS

The following functions are automatically exported by Log::Fine::Utils:

Log

Logs the message at the given log level

Parameters

  • level

    Level at which to log

  • message

    Message to log

Returns

1 on success

OpenLog

Opens the logging subsystem.

Parameters

A hash containing the following keys:

Returns

1 on success

CAVEATS

Log::Fine::Utils defines one and only one generic logger. Multiple loggers via Utils are not currently supported.

SEE ALSO

perl, Log::Fine, Log::Fine::Handle, Log::Fine::Logger

AUTHOR

Christopher M. Fuhrman, <cfuhrman at panix.com>

BUGS

Please report any bugs or feature requests to bug-log-fine-utils at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Log-Fine. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Log::Fine

You can also look for information at:

REVISION INFORMATION

$Id: Utils.pm 205 2010-01-03 21:06:25Z cfuhrman $

COPYRIGHT & LICENSE

Copyright (c) 2008, 2010 Christopher M. Fuhrman, All rights reserved

This program is free software licensed under the...

The BSD License

The full text of the license can be found in the LICENSE file included with this module.