README
1ABOUT SURBLHOST
2
3Surblhost is a small commandline program that looks up hostnames
4in the Spam URI Realtime Blocklist (SURBL). If a hostname is
5blacklisted, then it means that it has been reported that spam email
6contains web links to this hostname.
7
8Many spam filtering programs use the SURBL to aid in the filtering
9process, but this program can serve many other needs. For instance,
10it is being actively used to deny URL redirection to blacklisted hosts
11on sites like http://memurl.com
12
13This program is useful because:
14
15- It's easy to use, quick and portable (written in C).
16- It comes with a predefined whitelist, which you can add to or change
17 at runtime.
18- It recognizes two-level top-level-domains (TLDs) such as co.uk, and
19 will therefore correctly look up hostnames like foo.co.uk
20- It automatically strips off subdomains for correct lookups, which is
21 very handy in automated environments.
22- It can read hostnames from the commandline or standard input.
23- It can operate in quiet mode, indicating lookup results by the shell
24 return value.
25- You'll sleep better at night knowing your systems use surblhost to
26 help fight spam. :)
27
28I'd be very glad to hear from what you are using surblhost for.
29Drop me a line to the email address given below.
30
31
32BUILDING
33
34./configure
35make
36make check # optional
37make install
38
39
40COMPILATION PROBLEMS
41
42I've encountered some strange problems when using the GNU
43C compiler on FreeBSD 4.xx, with gcc --version giving 2.95.4.
44If that is the case, then you could always try using g++ instead:
45
46CC=g++ ./configure --prefix=$HOME
47make
48make check
49make install
50
51
52MISSING LIBRESOLV
53
54If you have problems finding libresolv on your system, you can compile
55without DNS TXT lookups:
56
57./configure --disable-resolv
58make
59make check
60make install
61
62
63SOURCE CODE SUBVERSION REPOSITORY
64
65You can check out the bleeding edge source code with svn:
66
67$ svn co https://svn.sourceforge.net/svnroot/surblhost
68
69You have to run the following to generate the configure script:
70
71$ autoreconf -v -i
72
73
74PATCHES AND BUGREPORTS
75
76Please send any patches, suggestions or bugreports to:
77Christian Stigen Larsen <csl@sublevel3.org>
78
79
80COPYRIGHT AND LICENSE
81
82Surblhost is Copyright (C) 2006, 2007 Christian Stigen Larsen
83Surblhost is distributed under the GNU General Public License v2.
84
85
86LINKS
87
88- The official homepage is on http://surblhost.sourceforge.net
89- The author's homepage is on http://csl.sublevel3.org
90- You can read more about SURBL at http://www.surbl.org
91
92
93$Id: README 154 2007-04-09 15:10:13Z cslsublevel3org $
94