NAME¶

spamass-milter—sendmail milter for passing emails through SpamAssassin

SYNOPSIS¶

DESCRIPTION¶

Thespamass-milterutility is a sendmail milter that checks and modifies incoming emailmessages with SpamAssassin.

The following options are available:

-psocket

Specifies the pathname of a socket to create for communication withsendmail.If it is removed,sendmailwill not be able to access the milter.This may cause messages to bounce, queue, or be passed throughunmiltered, depending on the parameters insendmail's .cf file.

-bspamaddress

Redirects tagged spam to the specified email address.All envelope recipients are removed, and inserted into the message as‘X-Spam-Orig-To:’headers.

-Bspamaddress

Same as-b,except the original recipients are retained.Only one of-band-Bmay be used.

-Crejectcode

Mail that is rejected is rejected by default with a 5.7.1 code. This optionallows that to be overridden. See also, -R-Soption.

-ddebugflags

Enables logging.debugflagsis a comma-separated list of tokens:

func

Entry and exit of internal functions.

misc

Other non-verbose logging.

net

Lookups of the ignored netblocks list.

poll

Low-level I/O to the child spamc process.

rcpt

Recipient processing.

spamc

High-level I/O to the child spamc process.

str

Calls to field lookup and string comparison functions.

uori

Calls to the update_or_insert function.

1

(historical) Same asfunc,misc.

2

(historical) Same asfunc,misc,poll.

3

(historical) Same asfunc,misc,poll,str,uori.

-Dhost

Connects to a remote spamd server onhost,instead of using one on localhost.This option is deprecated; use---dhostinstead.

-edefaultdomain

Pass the full user@domain address to spamc.The default is to pass only the username part on the assumption thatall users are local.This flag is useful if you are using an SQL (or other username) backendwith spamassassin and have listed the full address there.If the recipient name has no domain part (if the recipient is on thelocal machine for example),defaultdomainis added.Requires the-uflag.

-f

Causesspamass-milterto fork into the background.

-inetworks

Ignores messages if the originating IP is in the network(s) listed.The message will be passed through without calling SpamAssassin at all.networksis a comma-separated list, where each element can be either an IP address(nnn.nnn.nnn.nnn), a CIDR network (nnn.nnn.nnn.nnn/nn), or a network/netmaskpair (nnn.nnn.nnn.nnn/nnn.nnn.nnn.nnn).Multiple-iflags will append to the list.For example, if you list all your internal networks, no outgoing emailswill be filtered.

-I

Ignores messages if the sender has authenticated via SMTP AUTH.

-m

Disables modification of the‘Subject:’and‘Content-Type:’headers andmessage body.This is useful when SpamAssassin is configured with‘defang_mime 0’and‘report_header 1’,or when SA is simply used to add headers for postprocessing later.Updating the body through the milter interface can be slow for largemessages.

-M

Like-m,but also disables creation of any SpamAssassin‘X-Spam-*’headers as well.Both tagged and untagged mail gets passed through unchanged.To be useful, this option should be used with the-r,-b,or-Bflags.If-bis used, the‘X-Spam-Orig-To:’headers will still be added.

-Ppidfile

Create the filepidfile,containing the processid of the milter.

-rnn

Reject scanned email if it greater than or equal tonn.If-1,reject scanned email if SpamAssassin tags it as spam (useful if youare also using the-uflag, and users have changed their required_hits value).

For example, if you usually use procmail to redirect tagged email intoa separate folder just in case of false positives, you can use-r15and reject flagrant spam outright while still receiving low-scoringmessages.

-Rrejecttext

Mail that is rejected is rejected with the message "Blocked by SpamAssassin".This option allows the user to call with a different message, instead. Seealso, the-Coption

-S/path/to/sendmail

This option is used in conjunction with the -x option to specify a pathto sendmail if the default compiled in choice is not satisfactory.

-udefaultuser

Pass the username part of the first recipient to spamc with the-uflag.This allows user preferences files to be used.If the message is addressed to multiple recipients, the usernamedefaultuseris passed instead.

Note thatspamass-milterdoes not know whether an email is incoming or outgoing, so a messagefrom⟨user1@localdomain.com⟩to⟨user2@yahoo.com⟩will makespamass-milterpass-uuser2to spamc.

-x

Pass the recipient address throughsendmail-bv,which will perform virtusertable and alias expansion.The resulting username is then passed to spamc.Requires the-uflag. The spamass-milter configuration process does itsbest to find sendmail, but it is possible to override this compiled-insetting via the

--spamcflags...

Pass all remaining options to spamc.This allows you to connect to a remote spamd with-dor-p.

FILES¶

/usr/bin/spamc

client interface to SpamAssassin

SEE ALSO¶

spamassassin(1),spamd(1)

AUTHORS¶

Georg C. F. Greve⟨greve@gnu.org⟩
Dan Nelson⟨dnelson@allantgroup.com⟩
Todd Kover⟨kovert@omniscient.com⟩