1 --------------------------------------------------------------
2 Integrating spamass-milter into your sendmail installation
3 --------------------------------------------------------------
5 You will need to edit /etc/mail/sendmail.mc and add an
6 INPUT_MAIL_FILTER line that connects to the spamass-milter socket.
8 By default the spamass-milter socket is
9 /var/run/sendmail/spamass.sock; so your INPUT_MAIL_FILTER should look
12 # spamassassin settings
13 INPUT_MAIL_FILTER(`spamassassin',
14 `S=local:/var/run/sendmail/spamass.sock, F=,
15 T=S:4m;R:4m;E:10m')dnl
17 Briefly, the F=, tells sendmail to just pass the connection through if
18 the milter fails. This is most likely the setting you want. If you
19 want to temporarily fail a connection, you can set F=T. You almost
20 definitely don't want to reject connections, but if necessary, you can
21 do that by setting F=R.
23 You may also need to adjust these timeout settings, as spamd can be
24 sluggish on a slow machine. S is the timeout for sending information
25 from the MTA to a filter. R is the timeout for reading a reply from
26 the filter. E is the overall timeout between sending end-of-message to
27 filter and waiting for the final acknowledgment.
29 The settings above seem to work well on a Celeron 466 that receives
30 around 1000 emails an hour. You may wish to adjust them according to
33 See http://www.sendmail.com/partner/resources/development/milter_api/installation.html
34 and http://www.sendmail.org/m4/adding_mailfilters.html#INPUT_MAIL_FILTER
35 for more information on milters.
37 --------------------------------------------------------------
38 Integrating spamass-milter into your postfix installation
39 --------------------------------------------------------------
41 You need to edit /etc/postfix/main.cf and configure smptpd_milters so
42 that postfix connects to the spamass-milter socket. Something like:
44 # spamass-milter configuration
45 smtpd_milters = unix:/var/run/sendmail/spamass.sock
47 should work. See http://www.postfix.org/MILTER_README.html or
48 /usr/share/doc/postfix/MILTER_README.gz (in postfix-doc) for
49 information on how to set tempfail and the various timeouts that the
50 sendmail configuration above uses.
52 -------------------------------------------------------------
53 Adjusting how spamass-milter is started
54 -------------------------------------------------------------
56 You can adjust how spamass-milter starts, and the options it calls
57 spamc with by adjusting /etc/default/spamass-milter. OPTIONS is passed
58 directly to spamass-milter by /etc/init.d/spamass-milter.
60 -------------------------------------------------------------
61 Debugging spamass-milter
62 -------------------------------------------------------------
64 As spamass-milter is still undergoing development, you may see bugs
67 If spamass-milter is segfaulting (SEGV or SIG 11) please build a
68 debugging version of the spamass-milter package and install it:
72 apt-get source spamass-milter;
73 apt-get build-dep spamass-milter;
75 DEB_BUILD_OPTIONS='nostrip' CXXFLAGS='-O0 -g' fakeroot debian/rules clean binary;
76 dpkg -i spamass-milter*.deb;
78 Then turn on coredumps (ulimit -c unlimited), and start spamass-milter
79 as usual (/etc/init.d/spamass-milter start).
81 When spamass-milter cores, run gdb on the core, ala:
82 gdb /usr/sbin/spamass-milter /foo/corefile.pid
83 thread apply all where
87 and send the results along with your bug report using reportbug.
89 -- Don Armstrong <don@donarmstrong.com>, Tuesday, September 12, 2006 20:24:40 PDT