NAME
    spamd - daemonized version of spamassassin

SYNOPSIS
    spamd [options]

OPTIONS
    -a  Use auto-whitelists. These will automatically create a list of
        senders whose messages are to be considered non-spam by monitoring
        the total number of received messages which weren't tagged as spam
        from that sender. Once a threshold is exceeded, further messages
        from that sender will be given a non-spam bonus (in case you
        correspond with people who occasionally swear in their emails).

    -c  Create user preferences files if they don't exist (default: don't).

    -d  Detach from starting process and run in background (daemonize).

    -h  Print a brief help message, then exit without further action.

    -i *ipaddress*
        Tells spamd to listen on the specified IP address [defaults to
        127.0.0.1]. Use 0.0.0.0 to listen on all interfaces.

    -p *port*
        Optionally specifies the port number for the server to listen on.

    -q  Turn on SQL lookups even when per-user config files have been
        disabled with -x. this is useful for spamd hosts which don't have
        user's home directories but do want to load user preferences from an
        SQL database.

    -v  Enable vpopmail config (only useful with -u set to vpopmail user).
        This option is useful for vpopmail virtual users who do not have an
        entry in the system /etc/passwd file. This allows spamd to
        lookup/create user_prefs in the vpopmail users own maildir.

    -s *facility*
        Specify the syslog facility to use (default: mail).

    -u *username*
        Run as the named user. The alternative, default behaviour is to
        setuid() to the user running "spamc", if "spamd" is running as root.

    -x  Turn off per-user config files. All users will just get the default
        configuration.

    -A *host,...*
        Specify a list of authorized hosts which can connect to this spamd
        instance. The list is one of valid IP addresses, separated by
        commas. By default, connections are only accepted from localhost
        (127.0.0.1).

    -D  Print debugging messages

    -L  Perform only local tests on all mail. In other words, skip DNS and
        other network tests. Works the same as the "-L" flag to
        "spamassassin(1)".

    -S  Stop spam checking as soon as the spam threshold is reached, to
        increase performance. This option also turns off Razor reporting.

    -P  Die on user errors (for the user passed from spamc) instead of
        falling back to user *nobody* and using the default configuration.

    -F *0 | 1*
        Ensure that the output email message either always starts with a
        'From ' line (*1*) for UNIX mbox format, or ensure that this line is
        stripped from the output (*0*). (default: 1)

    -m *number*
        Specify a maximum number of children to spawn. Spamd will wait until
        another child finishes before forking again. Meanwhile, incoming
        connections will be queued. Please note that there is a OS specific
        maximum of connections that can be queued. (Try "perl -MSocket
        -e'print SOMAXCONN'" to find this maximum)

DESCRIPTION
    The purpose of this program is to provide a daemonized version of the
    spamassassin executable. The goal is improving throughput performance
    for automated mail checking.

    This is intended to be used alongside "spamc", a fast, low-overhead C
    client program.

    See the README file in the "spamd" directory of the SpamAssassin
    distribution for more details.

    Note: Although spamd will check per-user config files for every message,
    any changes to the system-wide config files will require restarting
    spamd for the changes to take effect.

SEE ALSO
    spamc(1) spamassassin(1) Mail::SpamAssassin(3)

AUTHOR
    Craig R Hughes <craig@hughes-family.org>

PREREQUISITES
    "Mail::SpamAssassin"

