postfix-policyd-spf-perl/README
Julian Mehnle 01e939ac3d trunk/postfix-policyd-spf-perl
* use version;
* Bumped version number to 1.08.1.
* Purely cosmetic code clean-up.
* Added svn properties:
  svn:mime-type = text/x-perl
  svn:keywords  = "Author Date Id Rev URL"
  svn:eol-style = native

trunk/README
* Bumped version number to 1.08.1.
* Added Scott Kitterman to copyright statement.
* Updated website URL.

trunk/INSTALL
* Added version Perl module to list of run-time requirements.

trunk/INSTALL
trunk/LICENSE
* Added svn properties:
  svn:mime-type = text/plain
  svn:keywords  = "Author Date Id Rev URL"
  svn:eol-style = native

trunk/CHANGES
trunk/debian/changelog
* Described changes for 1.08.1 release.

trunk/debian/control
* New maintainer: Scott Kitterman <scott@kitterman.com>
* Priority: extra (was: optional)
* Removed Build-Depends-Indep: perl, as there really is no need for it.
* Depends: libversion-perl

trunk/debian/copyright
* Updated for 1.08.1 release.
2007-01-10 20:00:57 +00:00

67 lines
2.1 KiB
Text
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

postfix-policyd-spf-perl 1.08.1
A Postfix SMTPd policy server for SPF checking
(C) 2007 Scott Kitterman <scott@kitterman.com>
2003-2004 Meng Weng Wong <mengwong@pobox.com>
Contributions by various members of the SPF project
<http://www.openspf.org/Software#postfix-policyd-spf-perl>
==============================================================================
postfix-policyd-spf-perl is a Postfix SMTPd policy daemon for SPF checking.
It is implemented in pure Perl and uses the Mail::SPF::Query CPAN module.
See INSTALL or README.Debian for installation instructions.
Usage:
policyd-spf-perl [-v]
This documentation assumes you have read Postfix's README_FILES/
SMTPD_POLICY_README.
Logging is sent to syslogd.
Each time a Postfix SMTP server process is started it connects to the policy
service socket, and Postfix runs one instance of this Perl script. By
default, a Postfix SMTP server process terminates after 100 seconds of idle
time, or after serving 100 clients. Thus, the cost of starting this Perl
script is smoothed out over time.
The default policy_time_limit is 1000 seconds.  This may be to short for some
SMTP transactions to complete.  As recommended in SMTPD_POLICY_README, this
should be extended to 3600 seconds.  To do so, set "policy_time_limit = 3600"
in /etc/postfix/main.cf.
Testing the policy daemon
-------------------------
To test the policy daemon by hand, execute:
% perl /usr/lib/postfix/policyd-spf-perl
Each query is a bunch of attributes. Order does not matter, and the daemon
uses only a few of all the attributes shown below:
request=smtpd_access_policy
protocol_state=RCPT
protocol_name=SMTP
helo_name=some.domain.tld
queue_id=8045F2AB23
sender=foo@bar.tld
recipient=bar@foo.tld
client_address=1.2.3.4
client_name=another.domain.tld
[empty line]
The policy daemon will answer in the same style, with an attribute list
followed by a empty line:
action=dunno
[empty line]
License
-------
postfix-policyd-spf-perl is free software. You may use, modify, and distribute
it under the GNU GPL (version 2 or later); see the LICENSE file.
# $Id$
# vim:tw=79