Debian Codegraph @

lib/Zonemaster/LDNS/RR.pm

raw ◀ ▶
Source reconstructed at patch state 0 of 1 — not the installed (fully patched) source.
1 Debian patch touch this file
1 package Zonemaster::LDNS::RR;
2
3 use strict;
4 use warnings;
5
6 use Zonemaster::LDNS::RR::A;
7 use Zonemaster::LDNS::RR::A6;
8 use Zonemaster::LDNS::RR::AAAA;
9 use Zonemaster::LDNS::RR::AFSDB;
10 use Zonemaster::LDNS::RR::APL;
11 use Zonemaster::LDNS::RR::ATMA;
12 use Zonemaster::LDNS::RR::CAA;
13 use Zonemaster::LDNS::RR::CDNSKEY;
14 use Zonemaster::LDNS::RR::CDS;
15 use Zonemaster::LDNS::RR::CERT;
16 use Zonemaster::LDNS::RR::CNAME;
17 use Zonemaster::LDNS::RR::DHCID;
18 use Zonemaster::LDNS::RR::DLV;
19 use Zonemaster::LDNS::RR::DNAME;
20 use Zonemaster::LDNS::RR::DNSKEY;
21 use Zonemaster::LDNS::RR::DS;
22 use Zonemaster::LDNS::RR::EID;
23 use Zonemaster::LDNS::RR::EUI48;
24 use Zonemaster::LDNS::RR::EUI64;
25 use Zonemaster::LDNS::RR::GID;
26 use Zonemaster::LDNS::RR::GPOS;
27 use Zonemaster::LDNS::RR::HINFO;
28 use Zonemaster::LDNS::RR::HIP;
29 use Zonemaster::LDNS::RR::HTTPS;
30 use Zonemaster::LDNS::RR::IPSECKEY;
31 use Zonemaster::LDNS::RR::ISDN;
32 use Zonemaster::LDNS::RR::KEY;
33 use Zonemaster::LDNS::RR::KX;
34 use Zonemaster::LDNS::RR::L32;
35 use Zonemaster::LDNS::RR::L64;
36 use Zonemaster::LDNS::RR::LOC;
37 use Zonemaster::LDNS::RR::LP;
38 use Zonemaster::LDNS::RR::MAILA;
39 use Zonemaster::LDNS::RR::MAILB;
40 use Zonemaster::LDNS::RR::MB;
41 use Zonemaster::LDNS::RR::MD;
42 use Zonemaster::LDNS::RR::MF;
43 use Zonemaster::LDNS::RR::MG;
44 use Zonemaster::LDNS::RR::MINFO;
45 use Zonemaster::LDNS::RR::MR;
46 use Zonemaster::LDNS::RR::MX;
47 use Zonemaster::LDNS::RR::NAPTR;
48 use Zonemaster::LDNS::RR::NID;
49 use Zonemaster::LDNS::RR::NIMLOC;
50 use Zonemaster::LDNS::RR::NINFO;
51 use Zonemaster::LDNS::RR::NS;
52 use Zonemaster::LDNS::RR::NSAP;
53 use Zonemaster::LDNS::RR::NSEC;
54 use Zonemaster::LDNS::RR::NSEC3;
55 use Zonemaster::LDNS::RR::NSEC3PARAM;
56 use Zonemaster::LDNS::RR::NULL;
57 use Zonemaster::LDNS::RR::NXT;
58 use Zonemaster::LDNS::RR::PTR;
59 use Zonemaster::LDNS::RR::PX;
60 use Zonemaster::LDNS::RR::RKEY;
61 use Zonemaster::LDNS::RR::RP;
62 use Zonemaster::LDNS::RR::RRSIG;
63 use Zonemaster::LDNS::RR::RT;
64 use Zonemaster::LDNS::RR::SIG;
65 use Zonemaster::LDNS::RR::SINK;
66 use Zonemaster::LDNS::RR::SOA;
67 use Zonemaster::LDNS::RR::SPF;
68 use Zonemaster::LDNS::RR::SRV;
69 use Zonemaster::LDNS::RR::SSHFP;
70 use Zonemaster::LDNS::RR::SVCB;
71 use Zonemaster::LDNS::RR::TA;
72 use Zonemaster::LDNS::RR::TALINK;
73 use Zonemaster::LDNS::RR::TKEY;
74 use Zonemaster::LDNS::RR::TLSA;
75 use Zonemaster::LDNS::RR::TXT;
76 use Zonemaster::LDNS::RR::TYPE;
77 use Zonemaster::LDNS::RR::UID;
78 use Zonemaster::LDNS::RR::UINFO;
79 use Zonemaster::LDNS::RR::UNSPEC;
80 use Zonemaster::LDNS::RR::URI;
81 use Zonemaster::LDNS::RR::WKS;
82 use Zonemaster::LDNS::RR::X25;
83
84 use Carp;
85
86 use overload '<=>' => \&do_compare, 'cmp' => \&do_compare, '""' => \&to_string;
87
88 sub new {
89 my ( $class, $string ) = @_;
90
91 if ( $string ) {
92 return $class->new_from_string( $string );
93 }
94 else {
95 croak "Must provide string to create RR";
96 }
97 }
98
99 sub name {
100 my ( $self ) = @_;
101
102 return $self->owner;
103 }
104
105 sub do_compare {
106 my ( $self, $other, $swapped ) = @_;
107
108 return $self->compare( $other );
109 }
110
111 sub to_string {
112 my ( $self ) = @_;
113
114 return $self->string;
115 }
116
117 1;
118
119 =head1 NAME
120
121 Zonemaster::LDNS::RR - common baseclass for all classes representing resource records.
122
123 =head1 SYNOPSIS
124
125 my $rr = Zonemaster::LDNS::RR->new('www.iis.se IN A 91.226.36.46');
126
127 =head1 OVERLOADS
128
129 This class overloads stringify and comparisons ('""', '<=>' and 'cmp').
130
131 =head1 CLASS METHOD
132
133 =over
134
135 =item new($string)
136
137 Creates a new RR object, which is an instance of a suitable subclass of
138 L<Zonemaster::LDNS::RR>, given a string representing an RR in common
139 presentation format.
140
141 If a subclass of L<Zonemaster::LDNS::RR> exists that is suitable for the
142 resource record’s type (e.g. L<Zonemaster::LDNS::RR::AAAA>,
143 L<Zonemaster::LDNS::RR::TXT>, etc.), then the resulting object is an instance
144 of that subclass.
145
146 If no such subclass exists (e.g. when passed a resource record of an unknown
147 type or a type not yet supported by Zonemaster-LDNS), the resulting object is
148 an instance of L<Zonemaster::LDNS::RR>. The instance methods defined in this
149 class will still work, but there is no support for structured access to the
150 resource record’s RDATA.
151
152 =back
153
154 =head1 INSTANCE METHODS
155
156 =over
157
158 =item owner()
159
160 Returns the owner name of the RR.
161
162 =item name()
163
164 An alias of L<owner()>.
165
166 =item ttl()
167
168 Returns the ttl of the RR.
169
170 =item type()
171
172 Return the type of the RR.
173
174 =item class()
175
176 Returns the class of the RR.
177
178 =item string()
179
180 Returns a string with the RR in presentation format.
181
182 =item compare($other)
183
184 Compares two L<Zonemaster::LDNS::RR>. The TTL field is ignored, and the comparison of domain names is case insensitive.
185
186 Returns an integer, where 0 indicates equality.
187
188 =item do_compare($other)
189
190 Calls the XS C<compare> method with the arguments it needs, rather than the ones overloading gives.
191
192 =item to_string
193
194 Calls the XS C<string> method with the arguments it needs, rather than the ones overloading gives. Functionally identical to L<string()> from the
195 Perl level, except for being a tiny little bit slower.
196
197 =item rd_count()
198
199 The number of RDATA objects in this RR.
200
201 =item rdf($postion)
202
203 The raw data of the RDATA object in the given position. The first item is in
204 position 0. If an attempt is made to fetch RDATA from a position that doesn't
205 have any, an exception will be thrown.
206
207 =back