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

POD ERRORS

       Hey! The above document had some coding errors, which are explained below:

       Around line 104:
	   You forgot a '=back' before '=head1'

       Around line 114:
	   '=item' outside of any '=over'

perl v5.16.2							    2012-06-05					  Net::Server::Log::Sys::Syslog(3)