| 1 | package Net::DNS::RR::DS; | ||||||||||||
| 2 | |||||||||||||
| 3 | 5 | ▶ | use strict; | ||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||
| 4 | 5 | ▶ | use warnings; | ||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||
| 5 | 5 | our $VERSION = (qw$Id: DS.pm 2059 2026-08-28 10:04:18Z willem $)[2]; | |||||||||||
| 6 | |||||||||||||
| 7 | 5 | ▶ | use base qw(Net::DNS::RR); | ||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||
| 8 | |||||||||||||
| 9 | |||||||||||||
| 10 | =head1 NAME | ||||||||||||
| 11 | |||||||||||||
| 12 | Net::DNS::RR::DS - DNS DS resource record | ||||||||||||
| 13 | |||||||||||||
| 14 | =cut | ||||||||||||
| 15 | |||||||||||||
| 16 | 5 | ▶ | use integer; | ||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||
| 17 | |||||||||||||
| 18 | 5 | ▶ | use Carp; | ||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||
| 19 | |||||||||||||
| 20 | 5 | ▶ | use constant BABBLE => defined eval { require Digest::BubbleBabble }; | ||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||
| 21 | |||||||||||||
| 22 | 5 | eval { require Digest::SHA }; ## optional for simple Net::DNS RR | |||||||||||
| 23 | |||||||||||||
| 24 | 5 | my %digest = ( | |||||||||||
| 25 | '1' => ['Digest::SHA', 1], | ||||||||||||
| 26 | '2' => ['Digest::SHA', 256], | ||||||||||||
| 27 | '4' => ['Digest::SHA', 384], | ||||||||||||
| 28 | '6' => ['Net::DNS::SEC::Digest::SM3'], | ||||||||||||
| 29 | ); | ||||||||||||
| 30 | |||||||||||||
| 31 | |||||||||||||
| 32 | 2 | ▶ | sub _decode_rdata { ## decode rdata from wire-format octet string | ||||||||||
|
Subroutine
_decode_rdata: called CC=1 SCAR=0.0
| |||||||||||||
| 33 | 2 | my ( $self, $data, $offset ) = @_; | |||||||||||
| 34 | |||||||||||||
| 35 | 2 | my $rdata = substr $$data, $offset, $self->{rdlength}; | |||||||||||
| 36 | 2 | @{$self}{qw(keytag algorithm digtype digestbin)} = unpack 'n C2 a*', $rdata; | |||||||||||
| 37 | 2 | return; | |||||||||||
| 38 | } | ||||||||||||
| 39 | |||||||||||||
| 40 | |||||||||||||
| 41 | 11 | ▶ | sub _encode_rdata { ## encode rdata as wire-format octet string | ||||||||||
|
Subroutine
_encode_rdata: called CC=1 SCAR=0.0
| |||||||||||||
| 42 | 11 | my $self = shift; | |||||||||||
| 43 | |||||||||||||
| 44 | 11 | return pack 'n C2 a*', @{$self}{qw(keytag algorithm digtype digestbin)}; | |||||||||||
| 45 | } | ||||||||||||
| 46 | |||||||||||||
| 47 | |||||||||||||
| 48 | 18 | ▶ | sub _format_rdata { ## format rdata portion of RR string. | ||||||||||
|
Subroutine
_format_rdata: called CC=2 SCAR=6.9
| |||||||||||||
| 49 | 18 | my $self = shift; | |||||||||||
| 50 | |||||||||||||
| 51 | 18 | my @rdata = @{$self}{qw(keytag algorithm digtype)}; | |||||||||||
| 52 | 18 | ▶ | if ( my $digest = $self->digest ) { | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 53 | 17 | $self->_annotation( $self->babble ) if BABBLE; | |||||||||||
| 54 | 17 | push @rdata, split /(\S{64})/, $digest; | |||||||||||
| 55 | } else { | ||||||||||||
| 56 | 1 | push @rdata, '""'; | |||||||||||
| 57 | } | ||||||||||||
| 58 | 18 | return @rdata; | |||||||||||
| 59 | } | ||||||||||||
| 60 | |||||||||||||
| 61 | |||||||||||||
| 62 | 9 | ▶ | sub _parse_rdata { ## populate RR from rdata in argument list | ||||||||||
|
Subroutine
_parse_rdata: called CC=1 SCAR=0.0
| |||||||||||||
| 63 | 9 | my ( $self, @argument ) = @_; | |||||||||||
| 64 | |||||||||||||
| 65 | 9 | $self->keytag( shift @argument ); | |||||||||||
| 66 | 9 | my $algorithm = shift @argument; | |||||||||||
| 67 | 9 | $self->digtype( shift @argument ); | |||||||||||
| 68 | 9 | $self->digest(@argument); | |||||||||||
| 69 | 9 | $self->algorithm($algorithm); | |||||||||||
| 70 | 9 | return; | |||||||||||
| 71 | } | ||||||||||||
| 72 | |||||||||||||
| 73 | |||||||||||||
| 74 | 25 | ▶ | sub keytag { | ||||||||||
|
Subroutine
keytag: called CC=3 SCAR=11.0
Pod
documented
| |||||||||||||
| 75 | 25 | my ( $self, @value ) = @_; | |||||||||||
| 76 | 25 | for (@value) { $self->{keytag} = 0 + $_ } | |||||||||||
| 77 | 25 | ▶ | return $self->{keytag} || 0; | ||||||||||
|
Condition100%2/2
$self->{'keytag'} || 0
MC/DC100%1/1
$self->{'keytag'} || 0
$self->{'keytag'}
Truth table100%2/2
A
A= $self->{'keytag'}
| |||||||||||||
| 78 | } | ||||||||||||
| 79 | |||||||||||||
| 80 | |||||||||||||
| 81 | 41 | ▶ | sub algorithm { | ||||||||||
|
Subroutine
algorithm: called CC=6 SCAR=17.9
Pod
documented
| |||||||||||||
| 82 | 41 | my ( $self, $arg ) = @_; | |||||||||||
| 83 | |||||||||||||
| 84 | 41 | ▶ | unless ( ref($self) ) { ## class method or simple function | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 85 | 3 | my $argn = pop; | |||||||||||
| 86 | 3 | ▶ | return $argn =~ /[^0-9]/ ? _algbyname($argn) : _algbyval($argn); | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 87 | } | ||||||||||||
| 88 | |||||||||||||
| 89 | 38 | ▶ | return $self->{algorithm} unless defined $arg; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 90 | 27 | ▶ | return _algbyval( $self->{algorithm} ) if uc($arg) eq 'MNEMONIC'; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 91 | 25 | ▶ | return $self->{algorithm} = _algbyname($arg) || die _algbyname('') # disallow algorithm(0) | ||||||||||
|
Condition100%2/2
_algbyname($arg) || die(_algbyname(''))
MC/DC100%1/1
_algbyname($arg) || die(_algbyname(''))
_algbyname($arg)
Truth table100%2/2
A
A= _algbyname($arg)
| |||||||||||||
| 92 | } | ||||||||||||
| 93 | |||||||||||||
| 94 | |||||||||||||
| 95 | 68 | ▶ | sub digtype { | ||||||||||
|
Subroutine
digtype: called CC=6 SCAR=17.9
Pod
documented
| |||||||||||||
| 96 | 68 | my ( $self, $arg ) = @_; | |||||||||||
| 97 | |||||||||||||
| 98 | 68 | ▶ | unless ( ref($self) ) { ## class method or simple function | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 99 | 3 | my $argn = pop; | |||||||||||
| 100 | 3 | ▶ | return $argn =~ /[^0-9]/ ? _digestbyname($argn) : _digestbyval($argn); | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 101 | } | ||||||||||||
| 102 | |||||||||||||
| 103 | 65 | ▶ | return $self->{digtype} unless defined $arg; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 104 | 35 | ▶ | return _digestbyval( $self->{digtype} ) if uc($arg) eq 'MNEMONIC'; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 105 | 32 | ▶ | return $self->{digtype} = _digestbyname($arg) || die _digestbyname('') # disallow digtype(0) | ||||||||||
|
Condition100%2/2
_digestbyname($arg) || die(_digestbyname(''))
MC/DC100%1/1
_digestbyname($arg) || die(_digestbyname(''))
_digestbyname($arg)
Truth table100%2/2
A
A= _digestbyname($arg)
| |||||||||||||
| 106 | } | ||||||||||||
| 107 | |||||||||||||
| 108 | |||||||||||||
| 109 | 35 | ▶ | sub digest { | ||||||||||
|
Subroutine
digest: called CC=3 SCAR=11.0
Pod
documented
| |||||||||||||
| 110 | 35 | my ( $self, @value ) = @_; | |||||||||||
| 111 | 35 | ▶ | return unpack "H*", $self->digestbin() unless scalar @value; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 112 | 13 | ▶ | my @hex = map { /^"*([\dA-Fa-f]*)"*$/ || croak("corrupt hex"); $1 } @value; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 113 | 12 | return $self->digestbin( pack "H*", join "", @hex ); | |||||||||||
| 114 | } | ||||||||||||
| 115 | |||||||||||||
| 116 | |||||||||||||
| 117 | 80 | ▶ | sub digestbin { | ||||||||||
|
Subroutine
digestbin: called CC=3 SCAR=11.0
Pod
documented
| |||||||||||||
| 118 | 80 | my ( $self, @value ) = @_; | |||||||||||
| 119 | 80 | for (@value) { $self->{digestbin} = $_ } | |||||||||||
| 120 | 80 | ▶ | return $self->{digestbin} || ""; | ||||||||||
|
Condition100%2/2
$self->{'digestbin'} || ''
MC/DC100%1/1
$self->{'digestbin'} || ''
$self->{'digestbin'}
Truth table100%2/2
A
A= $self->{'digestbin'}
| |||||||||||||
| 121 | } | ||||||||||||
| 122 | |||||||||||||
| 123 | |||||||||||||
| 124 | 21 | ▶ | sub babble { | ||||||||||
|
Subroutine
babble: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||
| 125 | 21 | return BABBLE ? Digest::BubbleBabble::bubblebabble( Digest => shift->digestbin ) : ''; | |||||||||||
| 126 | } | ||||||||||||
| 127 | |||||||||||||
| 128 | |||||||||||||
| 129 | 13 | ▶ | sub create { | ||||||||||
|
Subroutine
create: called CC=5 SCAR=16.1
Pod
documented
| |||||||||||||
| 130 | 13 | my ( $class, $keyrr, %args ) = @_; | |||||||||||
| 131 | 13 | my ($type) = reverse split '::', $class; | |||||||||||
| 132 | |||||||||||||
| 133 | 13 | ▶ | croak "Unable to create $type record for invalid key" unless $keyrr->protocol == 3; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 134 | 12 | ▶ | croak "Unable to create $type record for revoked key" if $keyrr->revoke; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 135 | 11 | ▶ | croak "Unable to create $type record for non-zone key" unless $keyrr->zone; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 136 | |||||||||||||
| 137 | my $self = Net::DNS::RR->new( | ||||||||||||
| 138 | owner => $keyrr->owner, # per definition, same as keyrr | ||||||||||||
| 139 | type => $type, | ||||||||||||
| 140 | class => $keyrr->class, | ||||||||||||
| 141 | ttl => $keyrr->{ttl}, | ||||||||||||
| 142 | 10 | digtype => 1, # SHA1 by default | |||||||||||
| 143 | %args, | ||||||||||||
| 144 | algorithm => $keyrr->algorithm, | ||||||||||||
| 145 | keytag => $keyrr->keytag | ||||||||||||
| 146 | ); | ||||||||||||
| 147 | |||||||||||||
| 148 | 10 | my $spec = $digest{$self->digtype}; | |||||||||||
| 149 | 10 | my $hash = eval { | |||||||||||
| 150 | 10 | my ( $object, @param ) = @$spec; | |||||||||||
| 151 | 9 | $object->new(@param); | |||||||||||
| 152 | }; | ||||||||||||
| 153 | 10 | ▶ | croak join ' ', 'digtype', $self->digtype('MNEMONIC'), 'not supported' unless $hash; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 154 | 9 | $hash->add( $keyrr->{owner}->canonical ); | |||||||||||
| 155 | 9 | $hash->add( $keyrr->_encode_rdata ); | |||||||||||
| 156 | 9 | $self->digestbin( $hash->digest ); | |||||||||||
| 157 | |||||||||||||
| 158 | 9 | return $self; | |||||||||||
| 159 | } | ||||||||||||
| 160 | |||||||||||||
| 161 | |||||||||||||
| 162 | 6 | ▶ | sub verify { | ||||||||||
|
Subroutine
verify: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||
| 163 | 6 | my ( $self, $key ) = @_; | |||||||||||
| 164 | 6 | my $verify = Net::DNS::RR::DS->create( $key, ( digtype => $self->digtype ) ); | |||||||||||
| 165 | 6 | return $verify->digestbin eq $self->digestbin; | |||||||||||
| 166 | } | ||||||||||||
| 167 | |||||||||||||
| 168 | |||||||||||||
| 169 | ######################################## | ||||||||||||
| 170 | |||||||||||||
| 171 | { | ||||||||||||
| 172 | 5 | my @digestbyname = ( | |||||||||||
| 173 | 'SHA-1' => 1, # [RFC3658] | ||||||||||||
| 174 | 'SHA-256' => 2, # [RFC4509] | ||||||||||||
| 175 | 'GOST-R-34.11-94' => 3, # [RFC5933] | ||||||||||||
| 176 | 'SHA-384' => 4, # [RFC6605] | ||||||||||||
| 177 | 'GOST-R-34.11-2012' => 5, # [RFC9558] | ||||||||||||
| 178 | 'SM3' => 6, # [RFC9563] | ||||||||||||
| 179 | ); | ||||||||||||
| 180 | |||||||||||||
| 181 | 5 | my @digestalias = ( 'SHA' => 1 ); | |||||||||||
| 182 | |||||||||||||
| 183 | 5 | my %digestbyval = reverse @digestbyname; | |||||||||||
| 184 | |||||||||||||
| 185 | 5 | foreach (@digestbyname) { s/[\W_]//g; } # strip non-alphanumerics | |||||||||||
| 186 | 5 | ▶ | my @digestrehash = map { /^\d/ ? ($_) x 3 : uc($_) } @digestbyname; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 187 | 5 | my %digestbyname = ( @digestalias, @digestrehash ); # work around broken cperl | |||||||||||
| 188 | |||||||||||||
| 189 | 34 | ▶ | sub _digestbyname { | ||||||||||
|
Subroutine
_digestbyname: called CC=3 SCAR=11.0
| |||||||||||||
| 190 | 34 | my $arg = shift; | |||||||||||
| 191 | 34 | my $key = uc $arg; # synthetic key | |||||||||||
| 192 | 34 | $key =~ s/[\W_]//g; # strip non-alphanumerics | |||||||||||
| 193 | 34 | my $val = $digestbyname{$key}; | |||||||||||
| 194 | 34 | ▶ | return $val if defined $val; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 195 | 4 | ▶ | return $key =~ /^\d/ ? $arg : croak qq[unknown algorithm $arg]; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 196 | } | ||||||||||||
| 197 | |||||||||||||
| 198 | 5 | ▶ | sub _digestbyval { | ||||||||||
|
Subroutine
_digestbyval: called CC=2 SCAR=6.9
| |||||||||||||
| 199 | 5 | my $value = shift; | |||||||||||
| 200 | 5 | ▶ | return $digestbyval{$value} || return $value; | ||||||||||
|
Condition100%2/2
$digestbyval{$value} || (return $value)
MC/DC100%1/1
$digestbyval{$value} || (return $value)
$digestbyval{$value}
Truth table100%2/2
A
A= $digestbyval{$value}
| |||||||||||||
| 201 | } | ||||||||||||
| 202 | } | ||||||||||||
| 203 | |||||||||||||
| 204 | |||||||||||||
| 205 | { | ||||||||||||
| 206 | 5 | my @algbyname = ( | |||||||||||
| 207 | 'DELETE' => 0, # [RFC4034][RFC4398][RFC8078] | ||||||||||||
| 208 | 'RSAMD5' => 1, # [RFC3110][RFC4034] | ||||||||||||
| 209 | 'DH' => 2, # [RFC2539] | ||||||||||||
| 210 | 'DSA' => 3, # [RFC3755][RFC2536] | ||||||||||||
| 211 | ## Reserved => 4, # [RFC6725] | ||||||||||||
| 212 | 'RSASHA1' => 5, # [RFC3110][RFC4034] | ||||||||||||
| 213 | 'DSA-NSEC3-SHA1' => 6, # [RFC5155] | ||||||||||||
| 214 | 'RSASHA1-NSEC3-SHA1' => 7, # [RFC5155] | ||||||||||||
| 215 | 'RSASHA256' => 8, # [RFC5702] | ||||||||||||
| 216 | ## Reserved => 9, # [RFC6725] | ||||||||||||
| 217 | 'RSASHA512' => 10, # [RFC5702] | ||||||||||||
| 218 | ## Reserved => 11, # [RFC6725] | ||||||||||||
| 219 | 'ECC-GOST' => 12, # [RFC5933] | ||||||||||||
| 220 | 'ECDSAP256SHA256' => 13, # [RFC6605] | ||||||||||||
| 221 | 'ECDSAP384SHA384' => 14, # [RFC6605] | ||||||||||||
| 222 | 'ED25519' => 15, # [RFC8080] | ||||||||||||
| 223 | 'ED448' => 16, # [RFC8080] | ||||||||||||
| 224 | 'SM2SM3' => 17, # [RFC9563] | ||||||||||||
| 225 | 'MLDSA44' => 18, # [draft-westerbaan-dnssec-mldsa] | ||||||||||||
| 226 | 'ECC-GOST12' => 23, # [RFC9558] | ||||||||||||
| 227 | |||||||||||||
| 228 | 'INDIRECT' => 252, # [RFC4034] | ||||||||||||
| 229 | 'PRIVATEDNS' => 253, # [RFC4034] | ||||||||||||
| 230 | 'PRIVATEOID' => 254, # [RFC4034] | ||||||||||||
| 231 | ## Reserved => 255, # [RFC4034] | ||||||||||||
| 232 | ); | ||||||||||||
| 233 | |||||||||||||
| 234 | 5 | my %algbyval = reverse @algbyname; | |||||||||||
| 235 | |||||||||||||
| 236 | 5 | foreach (@algbyname) { s/[\W_]//g; } # strip non-alphanumerics | |||||||||||
| 237 | 5 | ▶ | my @algrehash = map { /^\d/ ? ($_) x 3 : uc($_) } @algbyname; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 238 | 5 | my %algbyname = @algrehash; # work around broken cperl | |||||||||||
| 239 | |||||||||||||
| 240 | 27 | ▶ | sub _algbyname { | ||||||||||
|
Subroutine
_algbyname: called CC=3 SCAR=11.0
| |||||||||||||
| 241 | 27 | my $arg = shift; | |||||||||||
| 242 | 27 | my $key = uc $arg; # synthetic key | |||||||||||
| 243 | 27 | $key =~ s/[\W_]//g; # strip non-alphanumerics | |||||||||||
| 244 | 27 | my $val = $algbyname{$key}; | |||||||||||
| 245 | 27 | ▶ | return $val if defined $val; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 246 | 4 | ▶ | return $key =~ /^\d/ ? $arg : croak qq[unknown algorithm $arg]; | ||||||||||
|
Branch: 1 branch
| |||||||||||||
| 247 | } | ||||||||||||
| 248 | |||||||||||||
| 249 | 4 | ▶ | sub _algbyval { | ||||||||||
|
Subroutine
_algbyval: called CC=2 SCAR=6.9
| |||||||||||||
| 250 | 4 | my $value = shift; | |||||||||||
| 251 | 4 | ▶ | return $algbyval{$value} || return $value; | ||||||||||
|
Condition100%2/2
$algbyval{$value} || (return $value)
MC/DC100%1/1
$algbyval{$value} || (return $value)
$algbyval{$value}
Truth table100%2/2
A
A= $algbyval{$value}
| |||||||||||||
| 252 | } | ||||||||||||
| 253 | } | ||||||||||||
| 254 | |||||||||||||
| 255 | ######################################## | ||||||||||||
| 256 | |||||||||||||
| 257 | |||||||||||||
| 258 | 5 | 1; | |||||||||||
| 259 | __END__ | ||||||||||||