Net::Server::Log::Sys::Syslog - phpMan

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