dgrey
=====

dgrey is a greylisting policy server that allows greylist information to be
synchronized between multiple mail servers. All information is shared
between the nodes and the nodes are equal - there is no master. The nodes
may lose communication for a while, and still be able to correctly
resynchronize later. This works because all nodes keep a log of changes to
the database. All communication is done across TCP connections, which can
optionally be password protected.

dgrey works with mail transfer agents such as Postfix and Exim.

dgrey is written in Perl by Oskar Liljeblad. It is partially based on and
heavily inspired by Postgrey by David Schweikert.

Copyright and License
=====================

dgrey is copyright (C) 2008 Oskar Liljeblad.

The source code of this program may contain code from Postgrey, which is
copyright (C) 2004-2007 ETH Zurich
copyright (C) 2007 Open Systems AG, Switzerland

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 3 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, see <http://www.gnu.org/licenses/>.

See each file of the source code package for license and copyright
information.

Permission is granted to copy, distribute and/or modify the
documentation under the terms of either:

a) the GNU General Public License (@ref{GNU General Public License}) as
published by the Free Software Foundation; either version 2 of the License,
or (at your option) any later version, or

b) the GNU Free Documentation License (@ref{GNU Free Documentation License}),
version 1.2 or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts.

Current Status
==============

This information was last updated for release 0.1.0:

I have done extensive testing of dgrey prior to releasing it. It has been
run in a production environment receiving a little more than thousand
delivery attempts an hour. (In this particular environment dgrey handles a
few hundred mails an hour.) This however does not mean that dgrey is bug
free.  It can-technically speaking-contain bugs which prevent you from
receiving mail at all. I find this very unlikely but you have been warned...

As this is the first release you should consider dgrey beta quality.

Nevertheless, if you have tested dgrey and decided to use it or not, I would
very much like to hear from you. It would be particulary interesting to hear
if you had any problems or issues with it. Not only would it encourage me to
continue the development and improve dgrey, but it may also give some hint
on how stable it is. See Feedback below on how to contact the author.

Requirements
============

The following programs are required to run dgrey:

 * Perl 5.8.0 or later

   Site: http://www.perl.org/
   Debian package: perl

 * BerkeleyDB for Perl

   Site: http://www.cpan.org/
   Debian package: libberkeleydb-perl

Building and Installation
=========================

Run `configure' and then `make'. This should generate and update the
necessary files. You can then install dgrey by running `make install'.

Please see the manual of dgrey for further details. The manual is available
in various formats - you can view the included Info version of the manual
this way:

  info doc/dgrey.info

Usage and Documentation
=======================

dgrey is usually started through the included init script. Please see the
manual of dgrey for further details.

Web site
========

The latest version of dgrey can be downloaded from

  http://www.nongnu.org/dgrey/

Feedback
========

The author of dgrey and this document, Oskar Liljeblad, can be reached
via email:

  oskar@osk.mine.nu

Please send bug reports, suggestions, ideas or comments in general to me.

-
