DNS/Update.pm

filter: Statementstmt 100% 41 / 41 Branchbran 100% 4 / 4 Conditioncond 66.6% 2 / 3 MC/DCmcdc 50.0% 1 / 2 Subroutinesub 100% 9 / 9 Podpod 100% 3 / 3 totaltotal 96.7% 60 / 62 CC 6 SCAR 6.9
CC
6
Cov
98%
push
3.0
unique_push
3.0
new
2.0
CRAP 2.0
« DNS/Resolver/UNIX.pm ↑ Summary DNS.pm »
1 package Net::DNS::Update;
2  
3 86 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 86 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
5  
6 86 our $VERSION = (qw$Id: Update.pm 2017 2025-06-27 13:48:03Z willem $)[2];
7  
8  
9 =head1 NAME
10  
11 Net::DNS::Update - DNS dynamic update packet
12  
13 =head1 SYNOPSIS
14  
15 use Net::DNS;
16  
17 $update = Net::DNS::Update->new( 'example.com', 'IN' );
18  
19 $update->push( prereq => nxrrset('host.example.com. AAAA') );
20 $update->push( update => rr_add('host.example.com. 86400 AAAA 2001::DB8::F00') );
21  
22 =head1 DESCRIPTION
23  
24 Net::DNS::Update is a subclass of Net::DNS::Packet, to be used for
25 making DNS dynamic updates.
26  
27 Programmers should refer to RFC2136 for dynamic update semantics.
28  
29 =cut
30  
31  
32 86 ▶use integer;
Subroutine BEGIN: called CC=1 SCAR=0.0
33 86 ▶use Carp;
Subroutine BEGIN: called CC=1 SCAR=0.0
34  
35 86 ▶use base qw(Net::DNS::Packet);
Subroutine BEGIN: called CC=1 SCAR=0.0
36  
37 86 ▶use Net::DNS::Resolver;
Subroutine BEGIN: called CC=1 SCAR=0.0
38  
39  
40 =head1 METHODS
41  
42 =head2 new
43  
44 $update = Net::DNS::Update->new;
45 $update = Net::DNS::Update->new( 'example.com' );
46 $update = Net::DNS::Update->new( 'example.com', 'IN' );
47  
48 Returns a Net::DNS::Update object suitable for performing a DNS
49 dynamic update. Specifically, it creates a packet with the header
50 opcode set to UPDATE and the zone record type to SOA (per RFC 2136,
51 Section 2.3).
52  
53 Programs must use the push() method to add RRs to the prerequisite
54 and update sections before performing the update.
55  
56 Arguments are the zone name and the class. The zone and class may
57 be undefined or omitted and default to the default domain from the
58 resolver configuration and IN respectively.
59  
60 =cut
61  
62 47 ▶sub new {
Subroutine new: called CC=2 SCAR=6.9
Pod documented
63 47 my ( $class, $zone, @rrclass ) = @_;
64  
65 47 ▶ my ($domain) = grep { defined && length } ( $zone, Net::DNS::Resolver->searchlist );
Condition66%2/3
defined $_ && length $_
!ll&&!rl&&r
1050
MC/DC50%1/2
defined $_ && length $_
defined $_ length $_
Truth table66%2/3
A && B
A= defined $_B= length $_
ABresult
0X0
100
111
66  
67 47 my $self = __PACKAGE__->SUPER::new( $domain, 'SOA', @rrclass );
68  
69 47 my $header = $self->header;
70 47 $header->opcode('UPDATE');
71 47 $header->qr(0);
72 47 $header->rd(0);
73  
74 47 return $self;
75 }
76  
77  
78 =head2 push
79  
80 $ancount = $update->push( prereq => $rr );
81 $nscount = $update->push( update => $rr );
82 $arcount = $update->push( additional => $rr );
83  
84 $nscount = $update->push( update => $rr1, $rr2, $rr3 );
85 $nscount = $update->push( update => @rr );
86  
87 Adds RRs to the specified section of the update packet.
88  
89 Returns the number of resource records in the specified section.
90  
91 Section names may be abbreviated to the first three characters.
92  
93 =cut
94  
95 4 ▶sub push {
Subroutine push: called CC=3 SCAR=11.0
Pod documented
96 4 my ( $self, $section, @rr ) = @_;
97 4 my ($zone) = $self->zone;
98 4 my $zclass = $zone->zclass;
99 4 ▶ for (@rr) { $_->class( $_->class =~ /ANY|NONE/ ? () : $zclass ) }
Branch: 1 branch
BranchTrueFalseTotal
$_->class =~ /ANY|NONE/ ? : 2 2 4
100 4 return $self->SUPER::push( $section, @rr );
101 }
102  
103  
104 =head2 unique_push
105  
106 $ancount = $update->unique_push( prereq => $rr );
107 $nscount = $update->unique_push( update => $rr );
108 $arcount = $update->unique_push( additional => $rr );
109  
110 $nscount = $update->unique_push( update => $rr1, $rr2, $rr3 );
111 $nscount = $update->unique_push( update => @rr );
112  
113 Adds RRs to the specified section of the update packet provided
114 that the RRs are not already present in the same section.
115  
116 Returns the number of resource records in the specified section.
117  
118 Section names may be abbreviated to the first three characters.
119  
120 =cut
121  
122 91 ▶sub unique_push {
Subroutine unique_push: called CC=3 SCAR=11.0
Pod documented
123 91 my ( $self, $section, @rr ) = @_;
124 91 my ($zone) = $self->zone;
125 91 my $zclass = $zone->zclass;
126 91 ▶ for (@rr) { $_->class( $_->class =~ /ANY|NONE/ ? () : $zclass ) }
Branch: 1 branch
BranchTrueFalseTotal
$_->class =~ /ANY|NONE/ ? : 12 124 136
127 91 return $self->SUPER::unique_push( $section, @rr );
128 }
129  
130  
131 86 1;
132  
133 __END__
« DNS/Resolver/UNIX.pm ↑ Summary DNS.pm »