milter-dnsbl(8) 					       milter-dnsbl(8)



NAME
       milter-dnsbl - A milter that replaces FEATURE(dnsbl)

SYNOPSIS
       milter-dnsbl  [-h] [-d] <-u user> <-s socket> [-W domain] [-w list] <-l
       DNSBL>

DESCRIPTION
       Sendmail includes a facility  for  plugging  in	custom	mail  filters,
       called	milters.   Its	documented  here:  http://www.milter.org/milter_api/

       This milter's purpose is to be used instead of FEATURE(dnsbl).

       For this milter to run properly lwresd(8) must be installed.

OPTIONS
       -h     Prints milter usage

       -d     Run milter as daemon

       -u     Run milter as the specified user

       -s     All milters take a standardized socket argument, which specifies
	      how  they  communicate  with sendmail.  This will look something
	      like "unix:/var/run/milter-dnsbl.sock" for a unix-domain socket,
	      or  "inet:2525@localhost"  for  an  internet-domain socket.  The
	      same string gets used in the INPUT_MAIL_FILTER  macro  in  send
	      mail.mc.

       -W     Whitelist  hosts	under  this domain.  This can be a hostname, a
	      domain name or part of a domain name.  For  example  -W  ple.com
	      matches  both  example.com  and  exam.ple.com, while -W .ple.com
	      matches only exam.ple.com.

       -w     Whitelist IP addresses published in this DNS list

       -l     Blacklist IP addresses published in this DNS list

       Multiple -W, -w and -l options may be specified.

INSTALLATION
       This is very abbreviated, intended mainly as a reminder for  those  who
       have  worked  with milters before.  If its your first time, you should
       look on the web for more thorough documentation.

       0)     Make sure you have lwresd(8) installed and running.

       1)     Make sure your sendmail is compiled with the MILTER option.  You
	      can use this command to check:
		  sendmail -d0.1 -bt < /dev/null | grep MILTER
	      If  you  dont  see  MILTER in the compilation options, you will
	      have to re-build sendmail.

       2)     Build and install the milter-dnsbl executable, by doing a  make
	      install.

       3)     Edit your sendmail.mc and add a mail filter macro, for example:
		  INPUT_MAIL_FILTER(milter-dnsbl,S=unix:/var/run/milter-dnsbl.sock, F=T, T=S:4m;R:4m)
	      Rebuild and install sendmail.cf.

       4)     Run  milter-dnsbl,  with	the  same  socket argument you used in
	      sendmail.mc:
		  # milter-dnsbl -u nobody -s unix:/var/run/milter-dnsbl.sock -l sbl-xbl.spamhaus.org

       5)     Stop and re-start sendmail.

       6)     Look in /var/log/maillog for messages from milter-dnsbl.

BUGS
       This milter is tested only on an Ubuntu 6.06 i386 server.

AUTHOR
       Copyright (c) 2007 Yiorgos Adamopoulos <adamo@dblab.ece.ntua.gr>.   All
       rights reserved.

       This manpage is based on sample_milter(8) by Jef Poskanzer.



				 26 July 2007		       milter-dnsbl(8)