The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Mail::Toaster

SYNOPSIS

A collection of Perl programs and modules with oodles of code snippets that make working with mail systems much less work. Everything you need to build a industrial strength mail system.

DESCRIPTION

A collection of perl scripts and modules that are terribly useful for building and maintaining a mail system. Written for FreeBSD and Mac OS X. It's become quite useful on other platforms and will grow to support other MTA's (think postfix) in the future.

METHODS

new

    use Mail::Toaster;
        my $toaster = Mail::Toaster->new;

email_send

Email test routines for testing a mail toaster installation.

   $toaster->email_send($conf, "clean");
   $toaster->email_send($conf, "spam");
   $toaster->email_send($conf, "attach");
   $toaster->email_send($conf, "virus");

This sends 4 test emails of various types to the email address configured in toaster-watcher.conf.

toaster_check

    $toaster->toaster_check($conf);

Runs a series of tests to keep your toaster ship shape:

  make sure watcher.log is less than 1MB
  make sure ~alias/.qmail-* exist and are not empty
  verify multilog down files are removed if maillogs is used

clean_mailboxes

This sub does all sorts of fun things. The most important function is to trawl through a mail system cleaning out old mail messages that exceed some pre-configured threshhold as defined in toaster-watcher.conf.

Peter Brezny suggests adding another option which is good. Set a window during which the cleaning script can run so that it's not running during the highest load times.

AUTHOR

Matt Simerson <matt@tnpi.biz>

BUGS

None known. Report any to matt@tnpi.biz.

TODO

 Add support for Darwin (MacOS X) and Linux
 Update openssl & courier ssl .cnf files
 Install an optional stub DNS resolver (dnscache)

SEE ALSO

Mail::Toaster::CGI, Mail::Toaster::DNS, Mail::Toaster::Logs, Mail::Toaster::Qmail, Mail::Toaster::Setup, Mail::Toaster::Watcher, Mail::Toaster::Utility, toaster-watcher.conf, toaster.conf

COPYRIGHT

Copyright (c) 2004, The Network People, Inc. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

Neither the name of the The Network People, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.