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.