---
name: "Net::DNS::SEC::Tools::TrustAnchor"
section: "3pm"
platform: "linux"
package: "dnssec-tools"
version: "2.2.3-16"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Net::DNS::SEC::Tools::TrustAnchor"
---

# Net::DNS::SEC::Tools::TrustAnchor(3pm)

## NAME

Net::DNS::SEC::Tools::TrustAnchor

## SYNOPSIS

This is a base class for multiple types of trustanchor repositories that know how to read, write, and modify trust anchor repositories.

This package serves as both a API wrapper around a set of trust anchors as well as a base class for packages that need to read/write trust anchor sets into different formats.

Trust Anchors may be either DNSKEY records or DS references.

XXX: more documentation needed

## API

Usage API defined by this module or sub-modules.

Note that:

```
  use Net::DNS::SEC::Tools::TrustAnchor;
```

is assumed to have imported some of the API routines mentioned below.

`$tar` = new **Net::DNS::SEC::Tools::TrustAnchor()**;

Initializes a new collection of trust anchors.

`$module` = load\_module("type");

Dynamically attemps to load a TrustAnchor reader/writer sub-class of Net::DNS::SEC::Tools::TrustAnchor named "Type" and return an instance of it.

All sub-classes are assumed to contain a single letter upper-case class name followed by all lower case.  Any modules otherwise named will fail to load using this routine.

`$module` = parse\_component("type:file");

This parses a type and file specification consisting of type separated by a colon (':') followed by a file-name path.  It will then load the type module using the ***load\_module()*** rotine and return the type, the file and extra options.

XXX: option parsing support not yet complete and will likely change the type:file format specification; I.E. the type:file formatting specification will likely change in the future and should be considered alpha-level support.

`$tar` = `$module`-\>read($location, `$options`);

Reads in a given TAR from a `$location` reference and returns a blessed copy of the Net::DNS::SEC::Tools::TrustAnchor object containing all the data.

This function may be over-ridden by a sub-class.

`$tar` = `$module`-\>read($location, `$options`);

Reads in a given TAR from a `$location` reference and returns an unblessed hash the contents.  The **read()** function merely wraps around this and blesses it after being returned.

Sub-modules must over-ride this function (and/or the **read()** function) if they expect the module to support loading.

`$tar`-\>merge(@others)

Merges the *@other* array of trust anchors into the `$tar` object's own trust anchor list.

## AUTHOR

Wes Hardaker \<hardaker ATTA users.sourceforge DOTTTY net\>

## SEE ALSO

**convertar**(1)

## POD ERRORS

Hey! **The above document had some coding errors, which are explained below:**

- Around line 32:

  You can't have =items (as at line 45) unless the first thing after the =over is an =item