mimedefang.pl(8) [debian man page]

MIMEDEFANG.PL(8)					      System Manager's Manual						  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 /etc/mimedefang-filter is used.

OPERATION

       mimedefang.pl evaluates the file /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/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 -prettyprint < mime_message

       parses a message on stdin and prints it in a "nice" format (depending on your definition of "nice".)

	    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 David F. Skoll <dfs@roaringpenguin.com>.  The mimedefang home page is http://www.mimedefang.org/.

SEE ALSO

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

4th Berkeley Distribution					  8 February 2005						  MIMEDEFANG.PL(8)

WATCH-MULTIPLE-MIMDEFANGS(8)				      System Manager's Manual				      WATCH-MULTIPLE-MIMDEFANGS(8)

NAME

       watch-multiple-mimdefangs.tcl - Keep an eye on a cluster of MIMEDefang machines

SYNOPSIS

       watch-multiple-mimdefangs.tcl [-archive] machine-1 machine-2 ... machine-N

DESCRIPTION

       watch-multiple-mimdefangs.tcl  is  a  Tk script that graphically displays the status of mimedefang-multiplexor(8) on a cluster of machines.
       Note that Tcl/Tk 8.4 or higher is required to run watch-multiple-mimdefangs.tcl.

       If you supply the -archive command-line option, then watch-multiple-mimdefangs.tcl logs the output of md-mx-ctrl rawload for each  machine.
       The output for machine_name is logged in:

       $HOME/.watch-multiple-mimedefangs/machine_name/data.

PREREQUISITES

       To use watch-multiple-mimdefangs.tcl to monitor a cluster of machines, you need the following prerequisites:

       o      A UNIX-like machine with Tcl/Tk 8.4, the X window system and an SSH client.  You also need "xterm" to use some of the features.

       o      The  ability  to SSH as root to all of the machines you want to monitor.	Ideally, you should be using the SSH agent so that you can
	      SSH to the monitored machines as root without being prompted for a password or pass phrase.

       o      The program md-mx-ctrl on root's path on all the machines you want to monitor.

DISPLAY

       For each machine specified on the command line, watch-multiple-mimdefangs.tcl creates a chart with five columns.  The columns are:

       o      A button with the name of the machine.  Clicking the button pops up a menu that lets you take various actions, as  described  later.
	      If all slaves on the machine are busy, the button turns yellow.

       o      A label showing the number of busy slaves in the form "busy/total", where total is the total number of slaves.

       o      A label showing the average number of messages per second over the last 10 seconds.

       o      A label showing the average number of milliseconds per scan over the last 10 seconds.

       o      A  chart	that graphs the average number of busy slaves, the average number of messages per second and the average scan time in mil-
	      liseconds, all averaged over the last 10 seconds.

MACHINE MENU

       If you click on a machine name, a menu with three options pops up:

       SSH    Open an xterm session and ssh as root to the machine.

       Busy Slaves
	      Monitor the busy slaves on the machine.  If you click on the process-ID of a slave, an xterm will open up and the command "strace -s
	      100  -t  -p  pid" will be executed on the remote machine.  This is Linux-specific, but you can edit watch-multiple-mimdefangs.tcl to
	      replace the command with your particular system's command for tracing system calls.

       Delete Remove the machine from the list of machines being monitored.

ADDING A MACHINE

       If you need to add a machine to the display, simply type the name of the machine in the "Add Machine:" box and press Enter.

AUTHOR

       watch-multiple-mimdefangs.tcl was written by David F. Skoll.

SEE ALSO

       mimedefang.pl(8), mimedefang-filter(5), mimedefang(8), mimedefang-protocol(7), md-mx-ctrl(8), watch-mimedefang(8)

4th Berkeley Distribution					  12 January 2007				      WATCH-MULTIPLE-MIMDEFANGS(8)