|o||"The Fourth Rule of Sys::Syslog is: One facility, one priority." (from Sys::Syslog man page).|
One of the default Sys::Syslog priorities available on your system. See Sys::Syslog man page for details. You can have different priorities for different filehandles.
You can redefine the priority for a given filehandle on the fly:
my $fho = tied *MYFH; $fho->priority(LOG_CRIT); # better: (tied *MYFH)->priority(LOG_CRIT);
o We set the most permissive mask for log levels, so that nothing should be filtered by Sys::Syslog itself, but some messages may still be filtered, according to your syslog daemon configuration. Consult your local syslog daemon documentation. o <B>We do not call B>closelog()<B>B> in case multiple facilities are in use
In general, openlog() is called automatically whenever syslog() is called on a new facility (although we call it explicitly on tie()). Since closelog() would work just once and on the last opened connetion to syslog, it could close a connection completely unrelated to the filehandle currently being closed/untied/destroyed. <B>In case you tied multiple filehandlesB> over multiple faiclities (you shouldnt, see Sys::Syslog for details), closelog() wont be called at all.
o ident and/or logopt should be set once, before tying handles.
If change these variables after tying handles, the behavior is undetermined. At best, nothing should change; or settings could change if another openlog() is called afterwards, but dont rely on this. Also, if settings change, they will affect all tied filehandles. For these reasons, either:
o Set them once at the beginning, or o if youre tying two or more handles <B>using old-style syntaxB>, use the same values for all of them. o Old method ExtendedSTDERR() is no-op by default.
It is still supported for backward compatibility, but warn() and die() print by default to STDERR so there should be no need to change them directly.
o We do not call setlogsock()
Log priorities, facilities and valid values for logopt are listed in Sys::Syslog man page.
Read syslog(3) for details on syslog.
Broc Seib, bseib at purdue.edu - up to 1.07
Giacomo Montagner, <kromg at entirelyunlike.net> - from 2.00 onward.
Please report any bugs or feature requests to bug-tie-syslog at rt.cpan.org, or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Tie-Syslog>. Iwill be notified, and then youll automatically be notified of progress on your bug as I make changes.
You can find documentation for this module with the perldoc command.
You can also look for information at:
o RT: CPANs request tracker (report bugs here)
o AnnoCPAN: Annotated CPAN documentation o CPAN Ratings o Search CPAN
Many thanks to Broc Seib, who wrote this module back in 1999.
Copyright (C) 1999-2001 Broc Seib
Copyright (C) 2012 Giacomo Montagner.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See http://dev.perl.org/licenses/ for more information.
|perl v5.20.3||TIE::SYSLOG (3)||2014-04-30|