Mail::SPF::Mech::Exists.3pm

Langue: en

Version: 2010-05-03 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

Mail::SPF::Mech::Exists - SPF record "exists" mechanism class

DESCRIPTION

An object of class Mail::SPF::Mech::Exists represents an SPF record mechanism of type "exists".

Constructors

The following constructors are provided:
new(%options): returns Mail::SPF::Mech::Exists
Creates a new SPF record "exists" mechanism object.

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

qualifier
domain_spec
See ``new'' in Mail::SPF::Mech.
new_from_string($text, %options): returns Mail::SPF::Mech::Exists; throws Mail::SPF::ENothingToParse, Mail::SPF::EInvalidMech
Creates a new SPF record "exists" mechanism object by parsing the string and any options given.

Class methods

The following class methods are provided:
default_qualifier
qualifier_pattern
See ``Class methods'' in Mail::SPF::Mech.
name: returns string
Returns 'exists'.
name_pattern: returns Regexp
Returns a regular expression that matches a mechanism name of 'exists'.

Instance methods

The following instance methods are provided:
text
qualifier
params
stringify
See ``Instance methods'' in Mail::SPF::Mech.
domain_spec: returns Mail::SPF::MacroString
Returns the "domain-spec" parameter of the mechanism.
match($server, $request): returns boolean
Checks whether a DNS "A" record exists for the mechanism's target domain name, and returns true if one does, or false otherwise. See RFC 4408, 5.7, for details.

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>