
			Installing batv-filter

COMPILING
=========

Requires sendmail v8.14.0 or later, for required milter protocol enhancements.

To build this package you must first have installed or at least have
available the OpenSSL package and libmilter.  The former is available
from http://www.openssl.org or in package form from your vendor; the
latter is part of the sendmail Open Source distribution and can be built
and installed from there.

Steps to compiling the library and the filter:

(1) Download the source from Sourceforge (project name "batv-milter").
(2) Unpack the tarball.
(3) Change to the release directory (batv-milter-<version>).
(4) Edit batv-filter/Makefile.m4 and follow instructions in there for
    adjusting compile-time feature and path settings.
(5) Type "sh Build".


INSTALLING
==========

(1) Configure sendmail:
  (a) Choose a socket at which the MTA and the filter will rendezvous
      (see the documentation in libmilter for details)
  (b) Add a line like this example to your sendmail.mc using your desired
      socket specification:
	INPUT_MAIL_FILTER(`batv-filter', `S=inet:8893@localhost')
  (c) Rebuild your sendmail.cf in the usual way

(2) Start batv-filter.  You will need at least the "-p" option.  The current
    recommended set of command line options is:

	-l -p SOCKETSPEC -d DOMAIN -a ALLOWLIST -k KEYFILE

    ...where SOCKETSPEC is the socket you told sendmail to use above,
    DOMAIN is the domain or set of domains for which you want to verify
    mail, ALLOWLIST is a file containing envelope senders or patterns
    that should be ignored by the filter, and KEYFILE is a file containing
    the key to use when signing envelope senders.

(3) Restart sendmail.


TESTING
=======

[testing procedure TBD]


$Id: INSTALL,v 1.2 2007/03/10 03:52:22 msk Exp $
