happyDomain/postfix-policyd-spf-perl
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

postfix-policyd-spf-perl/trunk/postfix-policyd-spf -> postfix-policyd-spf-perl

Browse source 
* Renamed file.
* Moved documentation from executable into separate README and INSTALL files.
* Minor and purely cosmetic code clean-up.

postfix-policyd-spf-perl/trunk/README
* Added, adopting non-installation documentation from postfix-policyd-spf and
  improving it.

postfix-policyd-spf-perl/trunk/INSTALL
* Added, adopting installation documentation from postfix-policyd-spf and
  improving it.

postfix-policyd-spf-perl/trunk/CHANGES
* Added, describing changes for 1.08 release.

postfix-policyd-spf-perl/trunk/debian
postfix-policyd-spf-perl/trunk/debian/*
* Added.
This commit is contained in:
Julian Mehnle 2006-06-17 18:42:33 +00:00
commit 711623e5c9
9 changed files with 211 additions and 88 deletions
Download patch file Download diff file Expand all files Collapse all files

66
README Normal file
View file

@ -0,0 +1,66 @@
postfix-policyd-spf-perl 1.08
A Postfix SMTPd policy server for SPF checking
(C) 2003-2004 Meng Weng Wong <mengwong@pobox.com>
Contributions by various members of the SPF project
<http://new.openspf.org/Implementations>
==============================================================================
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 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
-------
Thingy is free software. You may use, modify, and distribute it under the
GNU GPL (version 2 or later).
# $Id$
# vim:tw=79