table of contents
other versions
- wheezy 2.0.7-3
- wheezy-backports 2.0.11-1~bpo70+2
- jessie 2.0.11-1
- testing 2.0.12t-3
- unstable 2.0.12t-3
python-spf(1) | General Commands Manual | python-spf(1) |
NAME¶
pyspf - pure-Python SPF libraryVERSION¶
2.0.7DESCRIPTION¶
SPF does email sender validation. For more information about SPF, please see http://www.openspf.org/USAGE¶
There are multiple ways to use this package:To check an incoming mail request:
% pyspf [-v] {ip} {sender} {helo}
% pyspf 69.55.226.139 tway@optsw.com mx1.wayforward.net
To test an SPF record:
% pyspf [-v] "v=spf1..." {ip} {sender} {helo}
% pyspf "v=spf1 +mx +ip4:10.0.0.1 -all" 10.0.0.1 tway@foo.com a
To fetch an SPF record:
% pyspf {domain}
% pyspf wayforward.net
To test this script (and to output this usage message):
% pyspf
S: 220 mail.example.com ESMTP Postfix
C: EHLO mx1.wayforward.net
S: 250-mail.example.com
S: ...
S: 250 8BITMIME
C: MAIL FROM:<terry@wayforward.net>
% pyspf 69.55.226.139 terry@wayforward.net mx1.wayforward.net
('pass', 250, 'sender SPF authorized')
RFC 4408 TEST SUITE¶
The package also installs the python-spf test driver and the current (as of the release date) YAML (Yet Another Markup Language) RFC 4408 test definitions. As errors or improvements in the test definitions are approved, they are available from:WARN: invalid-domain-long in rfc4408-tests.yml, ['8.1/2', '5/10']: fail
preferred to temperror
WARN: txttimeout in rfc4408-tests.yml, 4.4/1: fail preferred to temperror
WARN: spfoverride in rfc4408-tests.yml, 4.5/5: pass preferred to fail
WARN: multitxt1 in rfc4408-tests.yml, 4.5/5: pass preferred to permerror
WARN: multispf2 in rfc4408-tests.yml, 4.5/6: permerror preferred to pass
OTHER PROGRAMS¶
This package also provides two additional helper scripts; type99.py and spfquery.py. The type99.py script will convert DNS TXT strings to a binary equivalent suitable for use in a BIND zone file. The spfquery.py script is a Python reimplementination of Wayne Schlitt's spfquery command line tool. These scripts are described in pyspf-type99(1) and spfquery.pyspf(1) man pages.SEE ALSO¶
RFC 4408, <http://www.openspf.org>AUTHORS¶
This version of pyspf was written by Terence Way <terry-spf@wayforward.net> and updated by Stuart Gathman <stuart@bmsi.com> and Scott Kitterman <scott@kitterman.com>. This man-page was created by Scott Kitterman <scott@kitterman.com>.2012-02-05 |