---
name: "Net::Server::Log::Log::Log4perl"
section: "3pm"
platform: "linux"
package: "perl-net-server"
version: "2.018-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Net::Server::Log::Log::Log4perl"
---

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

log via Log4perl

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