---
name: "Mail::SPF::Mech::PTR"
section: "3pm"
platform: "linux"
package: "perl-mail-spf"
version: "3.20260331-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Mail::SPF::Mech::PTR"
---

# Mail::SPF::Mech::PTR(3pm)

SPF record "ptr" mechanism class

## NAME

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

## VERSION

version 3.20260331

## 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 "new" in Mail::SPF::Mech.

- **new\_from\_string($text, %options)**: returns *Mail::SPF::Mech::PTR*; throws *Mail::SPF::ENothingToParse*, *Mail::SPF::EInvalidMech*

  Creates a new SPF record `"ptr"` 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 **'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 "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 the mechanism's target domain name, or a sub-domain thereof, is a "valid" domain name for the given request's IP address (see "ip\_address" in Mail::SPF::Request), and returns **true** if it does, or **false** otherwise.  See "valid\_domain\_for\_ip\_address" in Mail::SPF::Util 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://tools.ietf.org/html/rfc4408\>

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

## AUTHORS

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