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 /etc/etc/mimedefang-filter is used.

OPERATION

       mimedefang.pl  evaluates the file /etc/etc/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 /etc/etc/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 -features

       prints a list of detected optional Perl modules.  The output looks something like this:

            SpamAssassin: yes

            mimedefang.pl -validate

       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.

AUTHOR

       mimedefang.pl  was  written  by  Dianne  Skoll  <dfs@roaringpenguin.com>.   The  mimedefang  home page is
       https://www.mimedefang.org/.

SEE ALSO

       mimedefang(8), mimedefang-filter(5), mimedefang-protocol(7), mimedefang-release(8)