]> code.citadel.org Git - infanticide.git/blob - README.md
README.md: updated
[infanticide.git] / README.md
1 # Infanticide
2
3 ## Disclaimer
4
5 The author of this module is militantly pro-life.  Abortion is horrible, and so are people who want to keep it legal.
6
7 ## Description
8
9 `infanticide` is a SpamAssassin module that flags incoming email messages from domains that have been
10 newly registered.  The rationale behind this method is that whenever a new top level domain opens up, spammers
11 will rush to register "disposable" domains within it, sending out blasts of spam before the conventional
12 filters can catch up.  Top level domains that have particularly low registration fees, or those whose registration
13 fees are refundable within the first few days, are also prime real estate for spammers.
14
15 The filter will trigger for any sending domain that has been registered within the last 30 days.  However, a
16 quick scan of the logs shows that setting the threshold to 7 days or even 3 days would probably be equally as
17 effective.
18
19 ## How to install it
20
21 To begin, copy `infanticide.pm` to a location where `spamd` can read it.  I'm lazy so I just have the git repository
22 cloned to `/root/infanticide`.
23
24 Then insert a block such as this into `/etc/mail/spamassassin/local.cf` :
25
26 ```
27 loadplugin infanticide /root/infanticide/infanticide.pm
28 header DISPOSABLE_DOMAIN eval:check_for_disposable_domain()
29 score DISPOSABLE_DOMAIN 10.0
30 describe DISPOSABLE_DOMAIN Sender domain was recently registered and is probably disposable
31 ```
32
33 ## Troubleshooting
34
35 Read the logs and figure out what happened.
36
37 ## Support
38
39 There is no support.  I wrote this for myself and am sharing it with absolutely no support offered.  If you want
40 to supply patches, that is somewhat more welcome; send them up to the GitLab server and we'll look at them.
41
42 ## License
43
44 Richard Stallman is a left-wing communist asshole.  Despite this fact, `infanticide` is made available under the
45 terms of the open source license called the GNU General Public License, version 3.  You can run it on the operating
46 system called Linux, which contains the kernel called Linux.  Or you can run it on FreeBSD.  Pretty much anywhere
47 that SpamAssassin itself can run.