NAME

       NetSDS::Logger - syslog wrapper for applications and classes

SYNOPSIS

               use NetSDS::Logger;

               my $logger = NetSDS::Logger->new(
                       name => 'NetSDS-SuperDaemon',
               );
               $logger->log("info", "Syslog message here");

DESCRIPTION

       This module contains implementation of logging functionality for NetSDS components.

       By default, messages are logged with "local0" facility and "pid,ndelay,nowait" options.

       NOTE: "NetSDS::Logger" module is for internal use mostly from application frameworks like
       "NetSDS::App", "NetSDS::App::FCGI", etc.

CLASS API

       new(%parameters) - constructor
           Constructor new() creates new logger object and opens socket with default NetSDS
           logging parameters.

           Arguments allowed (as hash):

           name - application name for identification

                   Use only ASCII characters in "name" to avoid possible errors.
                   Default value is "NetSDS".

           facility - logging facility

                   Available facility values:

                           * local0..local7
                           * user
                           * daemon

                   If not set 'local0' is used as default value

       log($level, $message) - write record to log
           Wrapper to "syslog()" method of Unix::Syslog module.

           Level is passed as string and may be one of the following:

                   alert   - LOG_ALERT
                   crit    - LOG_CRIT
                   debug   - LOG_DEBUG
                   emerg   - LOG_EMERG
                   error   - LOG_ERR
                   info    - LOG_INFO
                   notice  - LOG_NOTICE
                   warning - LOG_WARNING

       DESTROY - class destructor
           Destructor (DESTROY method) calls "closelog()" function. That's all.

EXAMPLES

       See NetSDS::App for example.

SEE ALSO

       Sys::Syslog

TODO

       1. Implement logging via UDP socket.

AUTHOR

       Michael Bochkaryov <misha@rattler.kiev.ua>

LICENSE

       Copyright (C) 2008-2009 Net Style Ltd.

       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License as published by the Free Software Foundation; either
       version 2 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
       See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program;
       if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
       MA  02111-1307  USA