NAME
    toaster_setup.pl - Everything you need to build a mail toaster except a
    computer

SYNOPSIS
    To build a great mail system, install FreeBSD (latest stable), and
    follow the directions on the toaster page (see URL below).

DESCRIPTION
    A complete set of instructions for building a mail toaster are on the
    toaster install page. There is actually quite a bit of documenation
    available for the "Matt Style" toaster. Much of it is readable via
    "perldoc Mail::Toaster", and all the subsequent pages. Don't forget to
    read the Install, Configure, and FAQ pages on the web site. If you still
    have questions, the mailing list archives are browseable and searchable
    for your convenience.

            http://www.tnpi.biz/internet/mail/toaster/

  command line flags
    toaster_setup.pl can be passed several flags. -s [ section ] - run
    without a parameter to see the available options -d [ debug ] - enabled
    (very) verbose debugging output -a [ action ] - default action is
    "install".

    An -a upgrade option is planned.

USAGE
      toaster_setup.pl -s [ section ] [-debug]

               pre - installs a list of programs and libraries other toaster components need
             ports - updates your ports tree, installs the pkg_* tools
           sources - update your FreeBSD sources (/usr/src)
             mysql - installs MySQL
        phpmyadmin - installs phpMyAdmin
            apache - installs Apache 
         apachessl - installs self signed SSL certs for Apache
        apacheconf - patches httpd.conf for use with Mail::Toaster
             ucspi - install ucspi w/MySQL patch
             ezmlm - install EzMLM idx
          vpopmail - installs vpopmail
         vpeconfig - configure ~vpopmail/etc/tcp.smtp
         vpopmysql - run the vpopmail MySQL grant and db create commands
             qmail - installs qmail with toaster patches
         qmailconf - configure various /var/qmail/control/* files
          netqmail - installs netqmail 
        qmailadmin - installs qmailadmin
         sqwebmail - installs sqwebmail (webmail app)
           courier - installs courier imap & pop3 daemons
      squirrelmail - installs squirrelmail (webmail app)
            filter - installs SpamAssassin, ClamAV, DCC, razor, and more
            clamav - installs just ClamAV
      qmailscanner - installs Qmail-Scanner & qmailscanner stats
               qss - installs qmailscanner stats
         supervise - creates the directories to be used by svscan
          maillogs - creates the mail logging directories
           rrdutil - installs rrdutil
        mattbundle - install MATT::Bundle
           toaster - install Mail::Toaster
           socklog - installs socklog
               all - installs everything shown on the toaster INSTALL page

AUTHOR
            Matt Simerson <matt@tnpi.biz>

BUGS
            None known. Report any to author.

TODO
            Check if daemons are running before installs.
            Turn entire process into a ./install_it_all script
            Add -s dnscache section to install a DNS stub resolver

SEE ALSO
    Mail::Toaster::CGI, Mail::Toaster::DNS, Mail::Toaster::Logs,
    Mail::Toaster::Qmail, toaster.conf Mail::Toaster::Setup,
    Mail::Toaster::Conf, toaster-watcher.conf

     http://matt.simerson.net/computing/mail/toaster/
     http://matt.simerson.net/computing/mail/toaster/faq.shtml
     http://matt.simerson.net/computing/mail/toaster/changelog.shtml

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.