README

perdition
Mail retrieval proxy server
Copyright (C) 1999-2005  Horms <horms@verge.net.au>

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.

----------------------------------------------------------------------


Perdition is a fully featured POP3 and IMAP4 proxy server. It is able to
handle both SSL and non-SSL connections and redirect users to a
real-server based on a database lookup. Perdition supports modular based
database access. ODBC, MySQL, PostgreSQL, GDBM, POSIX Regular Expression
and NIS modules ship with the distribution. The API for modules is open
allowing abitary modules to be written to allow access to any data store.

Perdition can be used to: Create large mail systems where a users mailbox
may be stored on one of several hosts.  Integrate different mail systems
together. Migrate between different email infastructure. And in firewall
applications.

The primary source of documentation for Perdition is its man
pages.

perdition(8) perditiondb(7) perditiondb_mysql_makedb(8)
perditiondb_ldap_makedb(8) perditiondb_postgresql_makedb(8)
perditiondb_odbc_makedb(8)

Other useful information, including suplementry documentation 
can be found on the web site, http://horms.net/projects/perdition/


LIBRARY REQUIREMENTS

perdition requires the popt options parsing library available from
ftp://ftp.rpm.org/pub/rpm/ and mirrors.

popt requires gettext, the GNU internationalisation library available
ftp://ftp.gnu.org/pub/gnu/gettext/ and mirrors.
    
perdition requires the vanessa_logger generic logging library
available from
http://horms.net/projects/vanessa/download/vanessa_logger/ and mirrors.
    
perdition requires the vanessa_adt abstract data type library
available from
http://horms.net/projects/vanessa/download/vanessa_adt/ and mirrors.
    
perdition requires the vanessa_socket TCP socket interface library
available from
http://horms.net/projects/vanessa/download/vanessa_socket/ and mirrors.