NAME

Mail::SPF::Mech::PTR - SPF record ptr mechanism class

DESCRIPTION

An object of class Mail::SPF::Mech::PTR represents an SPF record mechanism of type ptr.

Constructors

The following constructors are provided:

new(%options): returns Mail::SPF::Mech::PTR

Creates a new SPF record ptr mechanism object.

%options is a list of key/value pairs representing any of the following options:

qualifier
domain_spec
See Mail::SPF::Mech/new.
new_from_string($text): returns Mail::SPF::Mech::PTR; throws Mail::SPF::ENothingToParse, Mail::SPF::EInvalidMech
Creates a new SPF record ptr mechanism object by parsing the given string.

Class methods

The following class methods are provided:

default_qualifier
qualifier_pattern
See Mail::SPF::Mech/Class methods.
name: returns string
Returns 'ptr'.
name_pattern: returns Regexp
Returns a regular expression that matches a mechanism name of 'ptr'.

Instance methods

The following instance methods are provided:

text
qualifier
params
stringify
See Mail::SPF::Mech/Instance methods.
domain_spec: returns Mail::SPF::MacroString

Returns the domain-spec parameter of the mechanism.

match($server, $request): returns boolean

Checks whether the mechanism's target domain name, or a sub-domain thereof, is a "valid" domain name for the given request's IP address (see Mail::SPF::Request/ip_address), and returns true if it does, or false otherwise. See Mail::SPF::Util/valid_domain_for_ip_address for how domains are validated. See RFC 4408, 5.5, for the description of an equivalent algorithm.

SEE ALSO

Mail::SPF, Mail::SPF::Record, Mail::SPF::Term, Mail::SPF::Mech

http://www.ietf.org/rfc/rfc4408.txt

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

AUTHORS

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