MIMEDEFANG.PL(8)

NAME
mimedefang.pl - Perl script to scan MIME messages.

SYNOPSIS
mimedefang.pl [-f filter] dir

DESCRIPTION
mimedefang.pl is a Perl script designed to work with mimedefang(8). It takes a single argument which is a directory which should contain files laid out as described in mimedefang(8).

OPTIONS

-f filter
    Specifies the name of the file containing the filter. If this option is omitted, the default filter /usr/local/etc/mimedefang/mimedefang-filter is used.

OPERATION
mimedefang.pl evaluates the file /usr/local/etc/mimedefang/mimedefang-filter as a Perl fragment. This file should define the filter procedure. For each part of a MIME message, mimedefang.pl calls filter and disposes of the part as instructed by the filter. The various modes of disposition are described in mimedefang-filter(5).

TESTING FILTERS
You are strongly recommended to test your filter before installing it in /usr/local/etc/mimedefang/mimedefang-filter. To test the filter, save it in a file (e.g. test-filter) and run this command:
	mimedefang.pl -f test-filter -test
This tests the filter for syntactic correctness. If it passes, you can install it as a production filter. (Note that the test tests only for correct Perl syntax; it doesn't make sure your filter does something sensible.)

MISCELLANEOUS OPTIONS
There are a few other ways to invoke mimedefang.pl:
	mimedefang.pl -structure < mime_message
parses a message on stdin and prints lots of debugging information.

	mimedefang.pl -features
prints a list of detected optional Perl modules. The output looks something like this:
	File::Scan: no
	HTMLCleaner: no
	SpamAssassin: yes

AUTHOR
mimedefang.pl was written by David F. Skoll <dfs@roaringpenguin.com>. The mimedefang home page is http://www.roaringpenguin.com/mimedefang/.

SEE ALSO
mimedefang(8), mimedefang-filter(5), mimedefang-protocol(7)