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

perl v5.36.0                                       2023-06-11                 Net::Server::Log::Sys::Syslog(3pm)