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.