| 1 |
Log::Agent::Logger 0.2.00 |
| 2 |
Copyright (c) 2000, Raphael Manfredi |
| 3 |
Copyright (c) 2015, Mark Rogaski |
| 4 |
|
| 5 |
------------------------------------------------------------------------ |
| 6 |
This program is free software; you can redistribute it and/or modify |
| 7 |
it under the terms of the Artistic License, a copy of which can be |
| 8 |
found with perl. |
| 9 |
|
| 10 |
This program is distributed in the hope that it will be useful, |
| 11 |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 12 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 13 |
Artistic License for more details. |
| 14 |
------------------------------------------------------------------------ |
| 15 |
|
| 16 |
*** This is alpha software -- use at your own risks *** |
| 17 |
|
| 18 |
Name DSLI Description Info |
| 19 |
----------- ---- -------------------------------------------- ----- |
| 20 |
Log::Agent ---- A general logging framework RAM |
| 21 |
::Logger adpO Application-level logging interface RAM |
| 22 |
|
| 23 |
|
| 24 |
The Log::Agent::Logger module is an extension of Log::Agent that brings |
| 25 |
an application-level logging API. |
| 26 |
|
| 27 |
It is separated from Log::Agent itself because it has dependencies |
| 28 |
on other CPAN modules that Log::Agent cannot afford to have: |
| 29 |
everyone with a plain stock Perl distribution must be able to simply |
| 30 |
install Log::Agent and start using it. |
| 31 |
|
| 32 |
SYNOPSIS |
| 33 |
require Log::Agent::Logger; |
| 34 |
|
| 35 |
my $log = Log::Agent::Logger->make( |
| 36 |
-channel => $chan, |
| 37 |
-max_prio => 'info', |
| 38 |
-min_prio => 'emerg', |
| 39 |
); |
| 40 |
$log->error("can't open file %s: $!", $file); |
| 41 |
$log->warning("can't open file $file: $!"); |
| 42 |
|
| 43 |
DESCRIPTION |
| 44 |
The `Log::Agent::Logger' class defines a generic interface for |
| 45 |
application logging. It must not be confused with the interface |
| 46 |
provided by Log::Agent, which is meant to be used by re-usable |
| 47 |
modules that do not wish to commit on a particular logging method, |
| 48 |
so that they remain true building blocks. |
| 49 |
|
| 50 |
By contrast, `Log::Agent::Logger' explicitely requests an object to |
| 51 |
be used, and that object must commit upon the logging channel to be |
| 52 |
used, at creation time. |
| 53 |
|
| 54 |
Optionally, minimum and maximum priority levels may be defined |
| 55 |
(and changed dynamically) to limit the messages to effectively |
| 56 |
log, depending on the advertised priority. The standard syslog(3) |
| 57 |
priorities are used. |
| 58 |
|
| 59 |
-- Raphael Manfredi <[email protected]> |