Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

log::log4perl::level(3pm) [debian man page]

Level(3pm)						User Contributed Perl Documentation						Level(3pm)

NAME

       Log::Log4perl::Level - Predefined log levels

SYNOPSIS

	 use Log::Log4perl::Level;
	 print $ERROR, "
";

	 # -- or --

	 use Log::Log4perl qw(:levels);
	 print $ERROR, "
";

DESCRIPTION

       "Log::Log4perl::Level" simply exports a predefined set of Log4perl log levels into the caller's name space. It is used internally by
       "Log::Log4perl". The following scalars are defined:

	   $OFF
	   $FATAL
	   $ERROR
	   $WARN
	   $INFO
	   $DEBUG
	   $TRACE
	   $ALL

       "Log::Log4perl" also exports these constants into the caller's namespace if you pull it in providing the ":levels" tag:

	   use Log::Log4perl qw(:levels);

       This is the preferred way, there's usually no need to call "Log::Log4perl::Level" explicitely.

       The numerical values assigned to these constants are purely virtual, only used by Log::Log4perl internally and can change at any time, so
       please don't make any assumptions.

       If the caller wants to import these constants into a different namespace, it can be provided with the "use" command:

	   use Log::Log4perl::Level qw(MyNameSpace);

       After this $MyNameSpace::ERROR, $MyNameSpace::INFO etc.	will be defined accordingly.

   Numeric levels and Strings
       Level variables like $DEBUG or $WARN have numeric values that are internal to Log4perl. Transform them to strings that can be used in a
       Log4perl configuration file, use the c<to_level()> function provided by Log::Log4perl::Level:

	   use Log::Log4perl qw(:easy);
	   use Log::Log4perl::Level;

	       # prints "DEBUG"
	   print Log::Log4perl::Level::to_level( $DEBUG ), "
";

       To perform the reverse transformation, which takes a string like "DEBUG" and converts it into a constant like $DEBUG, use the to_priority()
       function:

	   use Log::Log4perl qw(:easy);
	   use Log::Log4perl::Level;

	   my $numval = Log::Log4perl::Level::to_priority( "DEBUG" );

       after which $numval could be used where a numerical value is required:

	   Log::Log4perl->easy_init( $numval );

COPYRIGHT AND LICENSE

       Copyright 2002-2009 by Mike Schilli <m@perlmeister.com> and Kevin Goess <cpan@goess.org>.

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

perl v5.10.1							    2010-07-21								Level(3pm)

Check Out this Related Man Page

Net::Server::Log::Log::Log4perl(3)			User Contributed Perl Documentation			Net::Server::Log::Log::Log4perl(3)

NAME

       Net::Server::Log::Log::Log4perl - log via Log4perl

SYNOPSIS

	   use base qw(Net::Server::PreFork);

	   __PACKAGE__->run(
	       log_file => 'Log::Log4perl',
	       log4perl_conf => '/path/to/my/log4perl.conf',
	       log4perl_logger => 'myapp',
	   );

DESCRIPTION

       This module provides Log::Log4perl style logging to the Net::Server system.

CONFIGURATION

       log_file
	   To begin using Log::Log4perl logging, simply set the Net::Server log_file configuration parameter to "Log::Log4perl".

	   If the magic name "Log::Log4perl" is used, all logging will be directed to the Log4perl system.  If used, the "log4perl_conf",
	   "log4perl_poll", "log4perl_logger" may also be defined.

       log4perl_conf
	   Only available if "log_file" is equal to "Log::Log4perl".  This is the filename of the log4perl configuration file - see Log::Log4perl.
	   If this is not set, will die on startup. If the file is not readable, will die.

       log4perl_poll
	   If set to a value, will initialise with Log::Log4perl::init_and_watch with this polling value. This can also be the string "HUP" to re-
	   read the log4perl_conf when a HUP signal is received. If set to 0, no polling is done. See Log::Log4perl for more details.

       log4perl_logger
	   This is the facility name. Defaults to "Net::Server".

DEFAULT ARGUMENTS FOR Net::Server
       The following arguments are available in the default "Net::Server" or "Net::Server::Single" modules.  (Other personalities may use
       additional parameters and may optionally not use parameters from the base class.)

	   Key		     Value		      Default

	   ## log4perl parameters (if log_file eq Log::Log4perl)
	   log4perl_conf     "filename" 	      will die if not set
	   log4perl_poll     number or HUP	      0 (no polling)
	   log4perl_logger   "name"		      "Net::Server"

METHODS

       "initialize"
	   This method is called during the initilize_logging method of Net::Server.  It returns a single code ref that will be stored under the
	   log_function property of the Net::Server object.  That code ref takes log_level and message as arguments and calls the initialized
	   log4perl system.

LICENCE

       Distributed under the same terms as Net::Server

perl v5.18.2							    2013-01-09					Net::Server::Log::Log::Log4perl(3)
Man Page