Mail/SPF/Query version 1.2
===========================

The SPF protocol relies on sender domains to publish a DNS
whitelist of their designated outbound mailers.  Given an
envelope sender, Mail::SPF::Query determines the legitimacy
of an SMTP client IP.

SEE ALSO

   http://spf.pobox.com/

USAGE

  perl -MMail::SPF::Query -le 'print for Mail::SPF::Query->new(ipv4=>shift, sender=>shift)->result' 1.2.3.4 myname@myhost.mydomain.com
      
   pass     (client localhost[1.2.3.4] is designated mailer for domain of sender myname@myhost.mydomain.com)
   error    (temporary failure while resolving designated mailer status for domain of sender myname@myhost.mydomain.com)
   unknown  (domain of sender myname@myhost.mydomain.com does not designate mailers)
   fail     (client localhost[1.2.3.4] is not a designated mailer for domain of sender myname@myhost.mydomain.com)
   softfail (client localhost[1.2.3.4] is not a designated mailer for transitioning domain of sender myname@myhost.mydomain.com)

FEATURES

  Mail::SPF::Query supports the following features:

  1) SPFinclude responses trigger an aliasing mechanism
  2) spf=softdeny responses change the response to softfail
  3) due to wildcard occlusion, also query _default._smtp_client

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

  Net::DNS

COPYRIGHT AND LICENCE

  Released under the same terms as Perl.

Copyright (C) 2003 Meng Weng Wong <mengwong+spf@pobox.com>