Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
July 25, 2001()						       July 25,	2001()

NAME
       spamass-milter  - sendmail milter for passing emails through SpamAssas-
       sin

SYNOPSIS
       spamass-milter -p socket	[-a] [-b|-B spamaddress] [-C  rejectcode]  [-d
       debugflags]  [-D	 host] [-e defaultdomain] [-f] [-i networks] [-m] [-M]
       [-P  pidfile]  [-r  nn]	[-r  rejectmsg]	 [-u  defaultuser]  [-x]   [-S
       /path/to/sendmail] [-- spamc flags ...]

DESCRIPTION
       The  spamass-milter  utility is a sendmail milter that checks and modi-
       fies incoming email messages with SpamAssassin.

       The following options are available:

       -p socket
	      Specifies	the pathname of	a socket to create  for	 communication
	      with  sendmail.	If it is removed, sendmail will	not be able to
	      access the milter.  This may cause messages to bounce, queue, or
	      be  passed  through  unmiltered,	depending on the parameters in
	      sendmail's .cf file.

       -a     Skips messages received on an authenticated connection.

       -b spamaddress
	      Redirects	tagged spam to the specified email address.  All enve-
	      lope  recipients	are  removed, and inserted into	the message as
	      `X-Spam-Orig-To:'	headers.

       -B spamaddress
	      Same as -b, except the original recipients are  retained.	  Only
	      one of -b	and -B may be used.

       -C rejectcode
	      Mail  that is rejected is	rejected by default with a 5.7.1 code.
	      This option allows that to be overridden.	 See also, -R  -S  op-
	      tion.

       -d debugflags
	      Enables  logging.	  debugflags  is a comma-separated list	of to-
	      kens:

       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	as func,misc.

       2      (historical) Same	as func,misc,poll.

       3      (historical) Same	as func,misc,poll,str,uori.

       -D host
	      Connects to a remote spamd server	on host, instead of using  one
	      on  localhost.   This  option  is	deprecated; use	-- -d host in-
	      stead.

       -e defaultdomain
	      Pass the full user@domain	address	to spamc.  The default	is  to
	      pass only	the username part on the assumption that all users are
	      local.  This flag	is useful if you are using an  SQL  (or	 other
	      username)	backend	with spamassassin and have listed the full ad-
	      dress there.  If the recipient name has no domain	part  (if  the
	      recipient	is on the local	machine	for example), defaultdomain is
	      added.  Requires the -u flag.

       -f     Causes spamass-milter to fork into the background.

       -i networks
	      Ignores messages if the originating  IP  is  in  the  network(s)
	      listed.  The message will	be passed through without calling Spa-
	      mAssassin	at all.	 networks is  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/netmask  pair
	      (nnn.nnn.nnn.nnn/nnn.nnn.nnn.nnn).   Multiple  -i	flags will ap-
	      pend to the list.	 For example, if you list  all	your  internal
	      networks,	no outgoing emails will	be filtered.

       -m     Disables	modification  of  the  `Subject:'  and `Content-Type:'
	      headers and message 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
	      large messages.

       -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	-B flags.  If -b is used, the `X-Spam-
	      Orig-To:'	headers	will still be added.

       -P pidfile
	      Create the file pidfile, containing the processid	of the milter.

       -r nn  Reject scanned email if it greater than or equal to nn.  If  -1,
	      reject  scanned email if SpamAssassin tags it as spam (useful if
	      you are also using the -u	flag, and users	have changed their re-
	      quired_hits value).

	      For  example,  if	 you  usually  use procmail to redirect	tagged
	      email into a separate folder just	in case	 of  false  positives,
	      you  can use -r 15 and reject flagrant spam outright while still
	      receiving	low-scoring messages.

       -R rejecttext
	      Mail that	is rejected is rejected	with the message  "Blocked  by
	      SpamAssassin".   This option allows the user to call with	a dif-
	      ferent message, instead.	 See also, the -C option

       -S /path/to/sendmail
	      This option is used in conjunction with the -x option to specify
	      a	path to	sendmail if the	default	compiled in choice is not sat-
	      isfactory.

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

	      Note  that  spamass-milter does not know whether an email	is in-
	      coming or	outgoing, so a message from <user1@localdomain.com> to
	      <user2@yahoo.com>	 will  make  spamass-milter  pass  -u user2 to
	      spamc.

       -x     Pass the recipient address through sendmail -bv, which will per-
	      form  virtusertable and alias expansion.	The resulting username
	      is then passed to	spamc.	Requires the -u	 flag.	 The  spamass-
	      milter configuration process does	its best to find sendmail, but
	      it is possible to	override this compiled-in setting via the

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

FILES
       /usr/local/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>

							       July 25,	2001()

NAME | SYNOPSIS | DESCRIPTION | FILES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=spamass-milter&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help