1Net::DNS::SEC::Tools::TUrsuesrtACnocnhtorri(b3u)ted PerlNeDto:c:uDmNeSn:t:aStEiCo:n:Tools::TrustAnchor(3)
2
3
4
6 Net::DNS::SEC::Tools::TrustAnchor
7
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
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
78 Wes Hardaker <hardaker ATTA users.sourceforge DOTTTY net>
79
81 convertar(1)
82
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.30.1 2020-01-2N8et::DNS::SEC::Tools::TrustAnchor(3)