Sys_Syslog

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, $mask, $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, $mask, $format, @args: If $priority and $mask permit, 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.

AUTHOR