NAME

Mail::SPF - An object-oriented implementation of Sender Policy Framework

VERSION

version 3.20240923

SYNOPSIS

use Mail::SPF;

my $spf_server  = Mail::SPF::Server->new();

my $request     = Mail::SPF::Request->new(
    versions        => [1, 2],              # optional
    scope           => 'mfrom',             # or 'helo', 'pra'
    identity        => 'fred@example.com',
    ip_address      => '192.168.0.1',
    helo_identity   => 'mta.example.com'    # optional,
                                            #   for %{h} macro expansion
);

my $result      = $spf_server->process($request);

print("$result\n");
my $result_code     = $result->code;        # 'pass', 'fail', etc.
my $local_exp       = $result->local_explanation;
my $authority_exp   = $result->authority_explanation
    if $result->is_code('fail');
my $spf_header      = $result->received_spf_header;

DESCRIPTION

Mail::SPF is an object-oriented implementation of Sender Policy Framework (SPF). See http://www.openspf.org for more information about SPF.

This class collection aims to fully conform to the SPF specification (RFC 4408) so as to serve both as a production quality SPF implementation and as a reference for other developers of SPF implementations.

SEE ALSO

Mail::SPF::Server, Mail::SPF::Request, Mail::SPF::Result

For availability, support, and license information, see the README file included with Mail::SPF.

REFERENCES

The SPF project

http://www.openspf.org

The SPFv1 specification (RFC 4408)

http://www.openspf.org/Specifications, http://tools.ietf.org/html/rfc4408

AUTHORS

Julian Mehnle <julian@mehnle.net>, Shevek <cpan@anarres.org>