Mail::SPF::Mech::MX - SPF record "mx" mechanism class

Authors

Julian Mehnle <julian@mehnle.net>, Shevek <cpan@anarres.org> perl v5.40.1 2025-05-10 Mail::SPF::Mech::MX(3pm)

Description

An object of class Mail::SPF::Mech::MX represents an SPF record mechanism of type "mx". Constructors The following constructors are provided: new(%options): returns Mail::SPF::Mech::MX Creates a new SPF record "mx" mechanism object. %options is a list of key/value pairs representing any of the following options: qualifierdomain_specipv4_prefix_lengthipv6_prefix_length See "new" in Mail::SPF::Mech. new_from_string($text,%options): returns Mail::SPF::Mech::MX; throws Mail::SPF::ENothingToParse, Mail::SPF::EInvalidMech Creates a new SPF record "mx" mechanism object by parsing the string and any options given. Classmethods The following class methods are provided: default_qualifierdefault_ipv4_prefix_lengthdefault_ipv6_prefix_lengthqualifier_pattern See "Class methods" in Mail::SPF::Mech. name: returns string Returns 'mx'. name_pattern: returns Regexp Returns a regular expression that matches a mechanism name of 'mx'. Instancemethods The following instance methods are provided: textqualifierparamsstringifydomainmatch_in_domain See "Instance methods" in Mail::SPF::Mech. domain_spec: returns Mail::SPF::MacroString Returns the "domain-spec" parameter of the mechanism. ipv4_prefix_length: returns integer Returns the IPv4 network prefix length of the mechanism. ipv6_prefix_length: returns integer Returns the IPv6 network prefix length of the mechanism. match($server,$request): returns boolean Checks whether any MX hosts of the mechanism's target domain name (that is, any of the host addresses of its DNS "MX" records) matches the given request's IP address (see "ip_address" in Mail::SPF::Request), and returns true if it does, or false otherwise. The mechanism's IP network prefix lengths are respected when matching address records against the request's IP address. See RFC 4408, 5 and 5.4, for the exact algorithm used.