Net::Server::Log::Sys::Syslog(3) | User Contributed Perl Documentation | Net::Server::Log::Sys::Syslog(3) |
NAME
Net::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
2024-09-01 | perl v5.40.0 |