Mail::SPF::Mech::Exists (3)

Leading comments

Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Mail::SPF::Mech::Exists.3pm".)

NAME

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

DESCRIPTION

An object of class Mail::SPF::Mech::Exists represents an 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

<tools.ietf.org/html/rfc4408>

For availability, support, and license information, see the

file included with Mail::SPF.

AUTHORS

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