Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Apropos / Subsearch:
optional field

Net::Daemon::Log(3pm) User Contributed Perl DocumentationNet::Daemon::Log(3pm)

       Net::Daemon::Log - Utility functions for logging

         # Choose logging method: syslog or Win32::EventLog
         $self->{'facility'} = 'mail'; # Default: Daemon
         $self->{'logfile'} = undef;   # Default

         # Choose logging method: stderr
         $self->{'logfile'} = 1;

         # Choose logging method: IO handle
         my $file = IO::File->new("my.log", "a");
         $self->{'logfile'} = $file;

         # Debugging messages (equivalent):
         $self->Log('debug', "This is a debugging message");
         $self->Debug("This is a debugging message");

         # Error messages (equivalent):
         $self->Log('err', "This is an error message");
         $self->Error("This is an error message");

         # Fatal error messages (implies 'die')
         $self->Fatal("This is a fatal error message");

       THIS IS ALPHA SOFTWARE. It is *only* 'Alpha' because the interface
       (API) is not finalised. The Alpha status does not reflect code quality
       or stability.

       Net::Daemon::Log is a utility class for portable logging messages.  By
       default it uses syslog (Unix) or Win32::EventLog (Windows), but logging
       messages can also be redirected to stderr or a log file.

       Generic Logging

           $self->Log($level, $msg, @args);

       This is the generic interface. The logging level is in syslog style,
       thus one of the words 'debug', 'info', 'notice', 'err' or 'crit'.
       You'll rarely need info and notice and I can hardly imagine a reason
       for crit (critical). In 95% of all cases debug and err will be suffi-

       The logging string $msg is a format string similar to printf.

       Utility methods

           $self->Debug($msg, @args);
           $self->Error($msg, @args);
           $self->Fatal($msg, @args);

       These are replacements for logging with levels debug and err. The dif-
       ference between the latter two is that Fatal includes throwing a Perl

       Chossing a logging target

       By default logging will happen to syslog (Unix) or EventLog (Windows).
       However you may choose logging to stderr by setting

           $self->{'logfile'} = 1;

       This is required if neither of syslog and EventLog is available. An
       alternative option is setting

           $self->{'logfile'} = $handle;

       where $handle is any object supporting a print method, for example an
       IO::Handle object. Usually the logging target is choosen as soon as you
       call $self->Log() the first time. However, you may force choosing the
       target by doing a


       before calling Log the first time.

       The Multithreading capabitities of this class are depending heavily on
       the underlying classes Sys::Syslog, Win32::EventLog or IO::Handle.  If
       they are thread safe, you can well assume that this package is too.
       (The exception being that you should better call $self->OpenLog()
       before threading.)

         Net::Daemon is Copyright (C) 1998, Jochen Wiedmann
                                            Am Eisteich 9
                                            72555 Metzingen

                                            Phone: +49 7123 14887
                                            Email: joeATispsoft.de

         All rights reserved.

         You may distribute this package under the terms of either the GNU
         General Public License or the Artistic License, as specified in the
         Perl README file.

       Net::Daemon(3), Sys::Syslog(3), Win32::EventLog(3), IO::Handle(3)

perl v5.8.8                       2003-11-10             Net::Daemon::Log(3pm)