1Net::DNS::SEC::Tools::TUrsuesrtACnocnhtorri(b3u)ted PerlNeDto:c:uDmNeSn:t:aStEiCo:n:Tools::TrustAnchor(3)
2
3
4

NAME

6       Net::DNS::SEC::Tools::TrustAnchor
7

SYNOPSIS

9       This is a base class for multiple types of trustanchor repositories
10       that know how to read, write, and modify trust anchor repositories.
11
12       This package serves as both a API wrapper around a set of trust anchors
13       as well as a base class for packages that need to read/write trust
14       anchor sets into different formats.
15
16       Trust Anchors may be either DNSKEY records or DS references.
17
18       XXX: more documentation needed
19

API

21       Usage API defined by this module or sub-modules.
22
23       Note that:
24
25         use Net::DNS::SEC::Tools::TrustAnchor;
26
27       is assumed to have imported some of the API routines mentioned below.
28
29           $tar = new Net::DNS::SEC::Tools::TrustAnchor();
30
31           Initializes a new collection of trust anchors.
32
33           $module = load_module("type");
34
35           Dynamically attemps to load a TrustAnchor reader/writer sub-class
36           of Net::DNS::SEC::Tools::TrustAnchor named "Type" and return an
37           instance of it.
38
39           All sub-classes are assumed to contain a single letter upper-case
40           class name followed by all lower case.  Any modules otherwise named
41           will fail to load using this routine.
42
43           $module = parse_component("type:file");
44
45           This parses a type and file specification consisting of type
46           separated by a colon (':') followed by a file-name path.  It will
47           then load the type module using the load_module() rotine and return
48           the type, the file and extra options.
49
50           XXX: option parsing support not yet complete and will likely change
51           the type:file format specification; I.E. the type:file formatting
52           specification will likely change in the future and should be
53           considered alpha-level support.
54
55           $tar = $module->read($location, $options);
56
57           Reads in a given TAR from a $location reference and returns a
58           blessed copy of the Net::DNS::SEC::Tools::TrustAnchor object
59           containing all the data.
60
61           This function may be over-ridden by a sub-class.
62
63           $tar = $module->read($location, $options);
64
65           Reads in a given TAR from a $location reference and returns an
66           unblessed hash the contents.  The read() function merely wraps
67           around this and blesses it after being returned.
68
69           Sub-modules must over-ride this function (and/or the read()
70           function) if they expect the module to support loading.
71
72           $tar->merge(@others)
73
74           Merges the @other array of trust anchors into the $tar object's own
75           trust anchor list.
76

AUTHOR

78       Wes Hardaker <hardaker ATTA users.sourceforge DOTTTY net>
79

SEE ALSO

81       convertar(1)
82

POD ERRORS

84       Hey! The above document had some coding errors, which are explained
85       below:
86
87       Around line 32:
88           You can't have =items (as at line 45) unless the first thing after
89           the =over is an =item
90
91
92
93perl v5.36.0                      2023-01-1N9et::DNS::SEC::Tools::TrustAnchor(3)
Impressum