| 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 |