Chip Salzenberg > perl5.004 > Sys::Syslog

Download:
perl5.004.tar.gz

Dependencies

Annotate this POD

Related Modules

Log::Log4perl
Win32::EventLog
Data::Dumper
Proc::Background
File::Copy
Net::Server
Unix::Syslog
Net::Syslog
Net::IMAP::Simple
Sys::Hostname
more...
By perlmonks.org
Source   Latest Release: perl5.005_04

NAME ^

Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl interface to the UNIX syslog(3) calls

SYNOPSIS ^

    use Sys::Syslog;

    openlog $ident, $logopt, $facility;
    syslog $priority, $format, @args;
    $oldmask = setlogmask $mask_priority;
    closelog;

DESCRIPTION ^

Sys::Syslog is an interface to the UNIX syslog(3) program. Call syslog() with a string priority and a list of printf() args just like syslog(3).

Syslog provides the functions:

openlog $ident, $logopt, $facility

$ident is prepended to every message. $logopt contains one or more of the words pid, ndelay, cons, nowait. $facility specifies the part of the system

syslog $priority, $format, @args

If $priority permits, logs ($format, @args) printed as by printf(3V), with the addition that %m is replaced with "$!" (the latest error message).

setlogmask $mask_priority

Sets log mask $mask_priority and returns the old mask.

closelog

Closes the log file.

Note that openlog now takes three arguments, just like openlog(3).

EXAMPLES ^

    openlog($program, 'cons,pid', 'user');
    syslog('info', 'this is another test');
    syslog('mail|warning', 'this is a better test: %d', time);
    closelog();

    syslog('debug', 'this is the last test');
    openlog("$program $$", 'ndelay', 'user');
    syslog('notice', 'fooprogram: this is really done');

    $! = 55;
    syslog('info', 'problem was %m'); # %m == $! in syslog(3)

DEPENDENCIES ^

Sys::Syslog needs syslog.ph, which can be created with h2ph.

SEE ALSO ^

syslog(3)

AUTHOR ^

Tom Christiansen <tchrist@perl.com> and Larry Wall <larry@wall.org>

syntax highlighting: