NAME

Log::Fine::Handle::File - Output log messages to a file

SYNOPSIS

Provides logging to a file

use Log::Fine;
use Log::Fine::Handle::File;

# Get a new logger
my $log = Log::Fine->getLogger("foo");

# register a file handle (default values shown)
my $handle = Log::Fine::Handle::File
    ->new( name => 'file0',
           mask => LOGMASK_EMERG | LOGMASK_ALERT | LOGMASK_CRIT | LOGMASK_ERR | LOGMASK_WARNING | LOGMASK_NOTICE | LOGMASK_INFO,
           dir  => "/var/log",
           file => "myapp.log" );

# register the handle
$log->registerHandle($handle);

# log something
$log->(INFO, "Opened new log handle");

DESCRIPTION

Log::Fine::Handle::File provides logging to a file. Note that this module will log messages to a specific file. Support for dynamic time-stamps in file names (e.g., myapp-080523.log) is provided by Log::Fine::Handle::File::Timestamp. Further features, such as log file rotation a la syslog can be added by sub-classing this class.

METHODS

getFileHandle()

Retrives the filehandle to write to. Override this method if you wish to support features such as time-stamped and/or rotating files.

msgWrite($lvl, $msg, $skip)

See Log::Fine::Handle

SEE ALSO

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

AUTHOR

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

BUGS

Please report any bugs or feature requests to bug-log-fine-handle-file 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: File.pm 51 2008-05-23 16:05:16Z cfuhrman $

COPYRIGHT & LICENSE

Copyright (c) 2008 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.