NAME¶
Lire::Logger - Lire's logging interface.
SYNOPSIS¶
Any program:
use Lire::Logger qw/ lr_info lr_debug lr_warn /;
lr_info( "doing stuff " );
lr_debug( "debugging information" );
lr_warn( "encountered unexpected value: ", $value );
open( CFGFILE, "my.conf" ) or lr_err( "open error: ", $! );
DESCRIPTION¶
This module contains functions that should be used by everything in the Lire
framework which should need logging.
All logging functions take any number of parameters that will be joined together
to form the message (like
print(),
die(),
warn() and
friends).
lr_emerg()¶
This logs a message at the "emerg" level and aborts your program. This
probably shouldn't be used.
lr_crit()¶
This logs a message at the "crit" level and aborts your program. This
should only be used when something is really broken in the Lire program or the
environment. It is used a few places in Lire when assertion that should really
never fail (like a DLF file with the wrong number of fields).
lr_err()¶
This logs a message at the "err" level and usually aborts your
program. (It is the equivalent of a
die().) The program won't abort if
it's used in an eval block. Uses this for error condition.
lr_warn()¶
This logs a message at the "warning" level. Perl's builtin warn is
mapped to this function. Use this for non-fatal errors.
lr_notice()¶
This logs a message at the "notice" level. This should be used for
significant informational messages that the user should see. (By default, the
user will only see messages at level "notice" or higher.)
lr_info()¶
This logs a message at the "info" level. Use this for general
informational messages.
lr_debug()¶
This logs a message at the "debug" level. Use this for debugging
messages.
SEE ALSO¶
Lire::Program(3pm)
AUTHOR¶
Francis J. Lacoste <flacoste@logreport.org>
VERSION¶
$Id: Logger.pm,v 1.10 2006/07/23 13:16:29 vanbaal Exp $
COPYRIGHT¶
Copyright (C) 2001-2003 Stichting LogReport Foundation LogReport@LogReport.org
This file is part of Lire.
Lire is free software; you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program (see COPYING); if not, check with
http://www.gnu.org/copyleft/gpl.html.