Net::Server::Log::Log::Log4perl (3)

Leading comments

Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Net::Server::Log::Log::Log4perl.3pm".)

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 initialize 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