Mail::SpamAssassin::Logger

Section: User Contributed Perl Documentation (3)
Updated: 2006-09-29
Index Return to Main Contents
 

NAME

Mail::SpamAssassin::Logger - SpamAssassin logging module  

SYNOPSIS

  use Mail::SpamAssassin::Logger;

  $SIG{__WARN__} = sub {
    log_message("warn", $_[0]);
  };

  $SIG{__DIE__} = sub {
    log_message("error", $_[0]) if $_[0] !~ /\bin eval\b/;
  };

 

METHODS

add_facilities(facilities)
Enable debug logging for specific facilities. Each facility is the area of code to debug. Facilities can be specified as a hash reference (the key names are used), an array reference, an array, or a comma-separated scalar string.

If ``all'' is listed, then all debug facilities are enabled. Higher priority informational messages that are suitable for logging in normal circumstances are available with an area of ``info''. Some very verbose messages require the facility to be specifically enabled (see "would_log" below).

log_message($level, $message)
log_message($level, @message)
Log a message at a specific level. Levels are specified as strings: ``warn'', ``error'', ``info'', and ``dbg''. The first element of the message must be prefixed with a facility name followed directly by a colon.
dbg(facility: message)
This is used for all low priority debugging messages.
info(facility: message)
This is used for informational messages indicating a normal, but significant, condition. This should be infrequently called. These messages are typically logged when SpamAssassin is run as a daemon.
add(method => 'syslog', socket => $socket, facility => $facility)
"socket" is the type the syslog (``unix'' or ``inet''). "facility" is the syslog facility (typically ``mail'').
add(method => 'file', filename => $file)
"filename" is the name of the log file.
add(method => 'stderr')
No options are needed for stderr logging, just don't close stderr first.
remove(method)
Remove a logging method. Only the method name needs to be passed as a scalar.
would_log($level, $facility)
Returns 0 if a message at the given level and with the given facility would be logged. Returns 1 if a message at a given level and facility would be logged normally. Returns 2 if the facility was specifically enabled.

The facility argument is optional.

close_log()
Close all logs.


 

Index

NAME
SYNOPSIS
METHODS

linux.jgfs.net manual pages