DNS/RR/DS.pm

filter: Statementstmt 100% 127 / 127 Branchbran 100% 42 / 42 Conditioncond 100% 12 / 12 MC/DCmcdc 100% 6 / 6 Subroutinesub 100% 22 / 22 Podpod 100% 8 / 8 totaltotal 100% 217 / 217 CC 28 SCAR 12.1
CC
28
Cov
100%
algorithm
6.0
digtype
6.0
create
5.0
CRAP 3.4
« DNS/RR/SOA.pm ↑ Summary DNS/RR/DNSKEY.pm »
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
BranchTrueFalseTotal
if (my $digest = $self->digest) { } 17 1 18
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
l!l
205
MC/DC100%1/1
$self->{'keytag'} || 0
$self->{'keytag'}
Truth table100%2/2
A
A= $self->{'keytag'}
Aresult
11
00
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
BranchTrueFalseTotal
unless (ref $self) 3 38 41
85 3 my $argn = pop;
86 3 ▶ return $argn =~ /[^0-9]/ ? _algbyname($argn) : _algbyval($argn);
Branch: 1 branch
BranchTrueFalseTotal
$argn =~ /[^0-9]/ ? : 1 2 3
87 }
88  
89 38 ▶ return $self->{algorithm} unless defined $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $arg 11 27 38
90 27 ▶ return _algbyval( $self->{algorithm} ) if uc($arg) eq 'MNEMONIC';
Branch: 1 branch
BranchTrueFalseTotal
if uc $arg eq "MNEMONIC" 2 25 27
91 25 ▶ return $self->{algorithm} = _algbyname($arg) || die _algbyname('') # disallow algorithm(0)
Condition100%2/2
_algbyname($arg) || die(_algbyname(''))
l!l
231
MC/DC100%1/1
_algbyname($arg) || die(_algbyname(''))
_algbyname($arg)
Truth table100%2/2
A
A= _algbyname($arg)
Aresult
11
00
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
BranchTrueFalseTotal
unless (ref $self) 3 65 68
99 3 my $argn = pop;
100 3 ▶ return $argn =~ /[^0-9]/ ? _digestbyname($argn) : _digestbyval($argn);
Branch: 1 branch
BranchTrueFalseTotal
$argn =~ /[^0-9]/ ? : 1 2 3
101 }
102  
103 65 ▶ return $self->{digtype} unless defined $arg;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $arg 30 35 65
104 35 ▶ return _digestbyval( $self->{digtype} ) if uc($arg) eq 'MNEMONIC';
Branch: 1 branch
BranchTrueFalseTotal
if uc $arg eq "MNEMONIC" 3 32 35
105 32 ▶ return $self->{digtype} = _digestbyname($arg) || die _digestbyname('') # disallow digtype(0)
Condition100%2/2
_digestbyname($arg) || die(_digestbyname(''))
l!l
311
MC/DC100%1/1
_digestbyname($arg) || die(_digestbyname(''))
_digestbyname($arg)
Truth table100%2/2
A
A= _digestbyname($arg)
Aresult
11
00
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
BranchTrueFalseTotal
unless scalar @value 22 13 35
112 13 ▶ my @hex = map { /^"*([\dA-Fa-f]*)"*$/ || croak("corrupt hex"); $1 } @value;
Branch: 1 branch
BranchTrueFalseTotal
/^"*([\dA-Fa-f]*)"*$/ or croak("corrupt hex") 13 1 14
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'} || ''
l!l
764
MC/DC100%1/1
$self->{'digestbin'} || ''
$self->{'digestbin'}
Truth table100%2/2
A
A= $self->{'digestbin'}
Aresult
11
00
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
BranchTrueFalseTotal
unless $keyrr->protocol == 3 1 12 13
134 12 ▶ croak "Unable to create $type record for revoked key" if $keyrr->revoke;
Branch: 1 branch
BranchTrueFalseTotal
if $keyrr->revoke 1 11 12
135 11 ▶ croak "Unable to create $type record for non-zone key" unless $keyrr->zone;
Branch: 1 branch
BranchTrueFalseTotal
unless $keyrr->zone 1 10 11
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
BranchTrueFalseTotal
unless $hash 1 9 10
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
BranchTrueFalseTotal
/^\d/ ? : 30 30 60
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
BranchTrueFalseTotal
if defined $val 30 4 34
195 4 ▶ return $key =~ /^\d/ ? $arg : croak qq[unknown algorithm $arg];
Branch: 1 branch
BranchTrueFalseTotal
$key =~ /^\d/ ? : 3 1 4
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)
l!l
32
MC/DC100%1/1
$digestbyval{$value} || (return $value)
$digestbyval{$value}
Truth table100%2/2
A
A= $digestbyval{$value}
Aresult
11
00
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
BranchTrueFalseTotal
/^\d/ ? : 100 100 200
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
BranchTrueFalseTotal
if defined $val 23 4 27
246 4 ▶ return $key =~ /^\d/ ? $arg : croak qq[unknown algorithm $arg];
Branch: 1 branch
BranchTrueFalseTotal
$key =~ /^\d/ ? : 2 2 4
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)
l!l
31
MC/DC100%1/1
$algbyval{$value} || (return $value)
$algbyval{$value}
Truth table100%2/2
A
A= $algbyval{$value}
Aresult
11
00
252 }
253 }
254  
255 ########################################
256  
257  
258 5 1;
259 __END__
« DNS/RR/SOA.pm ↑ Summary DNS/RR/DNSKEY.pm »