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.
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).
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 doesnt make sure your filter does something sensible.)
There are a few other ways to invoke mimedefang.pl:
prints a list of detected optional Perl modules. The output looks something like this:
calls the function filter_validate, if it is defined in your filter. filter_validate should return an integer; this becomes the exit code. If filter_validate does not exist, an error message is printed and mimedefang.pl exits with an exit code of 1.
mimedefang.pl was written by Dianne Skoll <firstname.lastname@example.org>. The mimedefang home page is http://www.mimedefang.org/.
|-->||MIMEDEFANG.PL (8)||8 February 2005|