Net::Server::Log::Sys:UserlContributed Perl DoNet::Server::Log::Sys::Syslog(3)NAMENet::Server::Log::Sys::Syslog - log via Syslog
SYNOPSIS
use base qw(Net::Server::PreFork);
__PACKAGE__->run(
log_file => 'Sys::Syslog',
syslog_ident => 'myapp',
);
DESCRIPTION
This module provides Sys::Syslog logging to the Net::Server system.
CONFIGURATION
log_file
To begin using Sys::Syslog logging, simply set the Net::Server
log_file configuration parameter to "Sys::Syslog".
If the magic name "Sys::Syslog" is used, all logging will take
place via the Sys::Syslog module. If syslog is used the parameters
"syslog_logsock", "syslog_ident", and "syslog_logopt",and
"syslog_facility" may also be defined.
syslog_logsock
Only available if "log_file" is equal to "Sys::Syslog". May be
either unix, inet, native, console, stream, udp, or tcp, or an
arrayref of the types to try. Default is "unix" if the version of
Sys::Syslog < 0.15 - otherwise the default is to not call
setlogsock.
See Sys::Syslog.
syslog_ident
Only available if "log_file" is equal to "Sys::Syslog". Id to
prepend on syslog entries. Default is "net_server". See
Sys::Syslog.
syslog_logopt
Only available if "log_file" is equal to "Sys::Syslog". May be
either zero or more of "pid","cons","ndelay","nowait". Default is
"pid". See Sys::Syslog.
syslog_facility
Only available if "log_file" is equal to "Sys::Syslog". See
Sys::Syslog and syslog. Default is "daemon".
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
## syslog parameters (if log_file eq Sys::Syslog)
syslog_logsock (native|unix|inet|udp
|tcp|stream|console) unix (on Sys::Syslog < 0.15)
syslog_ident "identity" "net_server"
syslog_logopt (cons|ndelay|nowait|pid) pid
syslog_facility \w+ daemon
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.
"handle_log_error"
This method is called if the log_function fails for some reason.
It is passed the Net::Server object, the error that occurred while
logging and an arrayref containing the log level and the message.
In turn, this calls the legacy Net::Server::handle_syslog_error
method.
LICENCE
Distributed under the same terms as Net::Server
perl v5.18.2 2013-01-10 Net::Server::Log::Sys::Syslog(3)