|
Packit |
e6c8bb |
package Net::DNS::RR::CAA;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
#
|
|
Packit |
e6c8bb |
# $Id: CAA.pm 1597 2017-09-22 08:04:02Z willem $
|
|
Packit |
e6c8bb |
#
|
|
Packit |
e6c8bb |
our $VERSION = (qw$LastChangedRevision: 1597 $)[1];
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
use strict;
|
|
Packit |
e6c8bb |
use warnings;
|
|
Packit |
e6c8bb |
use base qw(Net::DNS::RR);
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head1 NAME
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
Net::DNS::RR::CAA - DNS CAA resource record
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=cut
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
use integer;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
use Net::DNS::Text;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
sub _decode_rdata { ## decode rdata from wire-format octet string
|
|
Packit |
e6c8bb |
my $self = shift;
|
|
Packit |
e6c8bb |
my ( $data, $offset ) = @_;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
my $limit = $offset + $self->{rdlength};
|
|
Packit |
e6c8bb |
$self->{flags} = unpack "\@$offset C", $$data;
|
|
Packit |
e6c8bb |
( $self->{tag}, $offset ) = decode Net::DNS::Text( $data, $offset + 1 );
|
|
Packit |
e6c8bb |
$self->{value} = decode Net::DNS::Text( $data, $offset, $limit - $offset );
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
sub _encode_rdata { ## encode rdata as wire-format octet string
|
|
Packit |
e6c8bb |
my $self = shift;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
my $tag = $self->{tag};
|
|
Packit |
e6c8bb |
pack 'C a* a*', $self->flags, $tag->encode, $self->{value}->raw;
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
sub _format_rdata { ## format rdata portion of RR string.
|
|
Packit |
e6c8bb |
my $self = shift;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
my $tag = $self->{tag};
|
|
Packit |
e6c8bb |
my @rdata = ( $self->flags, $tag->string, $self->{value}->string );
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
sub _parse_rdata { ## populate RR from rdata in argument list
|
|
Packit |
e6c8bb |
my $self = shift;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
$self->flags(shift);
|
|
Packit |
e6c8bb |
$self->tag(shift);
|
|
Packit |
e6c8bb |
$self->value(shift);
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
sub _defaults { ## specify RR attribute default values
|
|
Packit |
e6c8bb |
my $self = shift;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
$self->flags(0);
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
sub flags {
|
|
Packit |
e6c8bb |
my $self = shift;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
$self->{flags} = 0 + shift if scalar @_;
|
|
Packit |
e6c8bb |
$self->{flags} || 0;
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
sub critical {
|
|
Packit |
e6c8bb |
my $bit = 0x0080;
|
|
Packit |
e6c8bb |
for ( shift->{flags} ) {
|
|
Packit |
e6c8bb |
my $set = $bit | ( $_ ||= 0 );
|
|
Packit |
e6c8bb |
$_ = (shift) ? $set : ( $set ^ $bit ) if scalar @_;
|
|
Packit |
e6c8bb |
return $_ & $bit;
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
sub tag {
|
|
Packit |
e6c8bb |
my $self = shift;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
$self->{tag} = new Net::DNS::Text(shift) if scalar @_;
|
|
Packit |
e6c8bb |
$self->{tag}->value if $self->{tag};
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
sub value {
|
|
Packit |
e6c8bb |
my $self = shift;
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
$self->{value} = new Net::DNS::Text(shift) if scalar @_;
|
|
Packit |
e6c8bb |
$self->{value}->value if $self->{value};
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
1;
|
|
Packit |
e6c8bb |
__END__
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head1 SYNOPSIS
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
use Net::DNS;
|
|
Packit |
e6c8bb |
$rr = new Net::DNS::RR('name IN CAA flags tag value');
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head1 DESCRIPTION
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
Class for Certification Authority Authorization (CAA) DNS resource records.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head1 METHODS
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
The available methods are those inherited from the base class augmented
|
|
Packit |
e6c8bb |
by the type-specific methods defined in this package.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
Use of undocumented package features or direct access to internal data
|
|
Packit |
e6c8bb |
structures is discouraged and could result in program termination or
|
|
Packit |
e6c8bb |
other unpredictable behaviour.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head2 flags
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
$flags = $rr->flags;
|
|
Packit |
e6c8bb |
$rr->flags( $flags );
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
Unsigned 8-bit number representing Boolean flags.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=over 4
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=item critical
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
$rr->critical(1);
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
if ( $rr->critical ) {
|
|
Packit |
e6c8bb |
...
|
|
Packit |
e6c8bb |
}
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
Issuer critical flag.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=back
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head2 tag
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
$tag = $rr->tag;
|
|
Packit |
e6c8bb |
$rr->tag( $tag );
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
The property identifier, a sequence of ASCII characters.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
Tag values may contain ASCII characters a-z, A-Z, and 0-9.
|
|
Packit |
e6c8bb |
Tag values should not contain any other characters.
|
|
Packit |
e6c8bb |
Matching of tag values is not case sensitive.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head2 value
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
$value = $rr->value;
|
|
Packit |
e6c8bb |
$rr->value( $value );
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
A sequence of octets representing the property value.
|
|
Packit |
e6c8bb |
Property values are encoded as binary values and may employ
|
|
Packit |
e6c8bb |
sub-formats.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head1 COPYRIGHT
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
Copyright (c)2013,2015 Dick Franks
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
All rights reserved.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
Package template (c)2009,2012 O.M.Kolkman and R.W.Franks.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head1 LICENSE
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
Permission to use, copy, modify, and distribute this software and its
|
|
Packit |
e6c8bb |
documentation for any purpose and without fee is hereby granted, provided
|
|
Packit |
e6c8bb |
that the above copyright notice appear in all copies and that both that
|
|
Packit |
e6c8bb |
copyright notice and this permission notice appear in supporting
|
|
Packit |
e6c8bb |
documentation, and that the name of the author not be used in advertising
|
|
Packit |
e6c8bb |
or publicity pertaining to distribution of the software without specific
|
|
Packit |
e6c8bb |
prior written permission.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
Packit |
e6c8bb |
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
Packit |
e6c8bb |
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
Packit |
e6c8bb |
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
Packit |
e6c8bb |
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
Packit |
e6c8bb |
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
Packit |
e6c8bb |
DEALINGS IN THE SOFTWARE.
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=head1 SEE ALSO
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
L<perl>, L<Net::DNS>, L<Net::DNS::RR>, RFC6844
|
|
Packit |
e6c8bb |
|
|
Packit |
e6c8bb |
=cut
|