Server IP : 85.214.239.14 / Your IP : 18.118.144.50 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /proc/2/cwd/usr/share/perl5/Net/DNS/RR/ |
Upload File : |
package Net::DNS::RR::OPT; use strict; use warnings; our $VERSION = (qw$Id: OPT.pm 1891 2022-12-28 13:09:27Z willem $)[2]; use base qw(Net::DNS::RR); =head1 NAME Net::DNS::RR::OPT - DNS OPT resource record =cut use integer; use Carp; use Net::DNS::Parameters qw(:rcode :ednsoption); use constant UTIL => scalar eval { require Scalar::Util; Scalar::Util->can('isdual') }; use constant CLASS_TTL_RDLENGTH => length pack 'n N n', (0) x 3; use constant OPT => Net::DNS::Parameters::typebyname qw(OPT); require Net::DNS::DomainName; require Net::DNS::RR::A; require Net::DNS::RR::AAAA; require Net::DNS::Text; sub _decode_rdata { ## decode rdata from wire-format octet string my $self = shift; my ( $data, $offset ) = @_; my $index = $offset - CLASS_TTL_RDLENGTH; # OPT redefines class and TTL fields @{$self}{qw(size rcode version flags)} = unpack "\@$index n C2 n", $$data; @{$self}{rcode} = @{$self}{rcode} << 4; delete @{$self}{qw(class ttl)}; my $limit = $offset + $self->{rdlength} - 4; my @index; while ( $offset <= $limit ) { my ( $code, $length ) = unpack "\@$offset nn", $$data; my $value = unpack "\@$offset x4 a$length", $$data; push @index, $code; $self->{option}{$code} = $value; $offset += $length + 4; } @{$self->{index}} = @index; return; } sub _encode_rdata { ## encode rdata as wire-format octet string my $self = shift; my $option = $self->{option} || {}; return join '', map { pack( 'nna*', $_, length $option->{$_}, $option->{$_} ) } $self->options; } sub encode { ## overide RR method my $self = shift; my $data = $self->_encode_rdata; my $size = $self->UDPsize; my @xttl = ( $self->rcode >> 4, $self->version, $self->flags ); return pack 'C n n C2n n a*', 0, OPT, $size, @xttl, length($data), $data; } sub string { ## overide RR method my $self = shift; my $edns = $self->version; unless ( $edns == 0 ) { my $content = unpack 'H*', eval { $self->encode }; return <<"QQ"; ;; { "EDNS-VERSION": $edns, ;; "BASE16": "$content" ;; } QQ } my $flags = sprintf '%04x', $self->flags; my $rcode = $self->rcode; my $size = $self->UDPsize; my @format = map { join( "\n;;\t\t\t\t", $self->_format_option($_) ) } $self->options; my @indent = scalar(@format) ? "\n;;\t\t" : (); my @option = join ",\n;;\t\t", @format; return <<"QQ"; ;; { "EDNS-VERSION": $edns, ;; "FLAGS": "$flags", ;; "RCODE": $rcode, ;; "UDPSIZE": $size, ;; "OPTIONS": [@indent@option ] ;; } QQ } sub class { ## overide RR method my $self = shift; $self->_deprecate(qq[please use "UDPsize()"]); return $self->UDPsize(@_); } sub ttl { ## overide RR method my $self = shift; $self->_deprecate(qq[please use "flags()" or "rcode()"]); for (@_) { @{$self}{qw(rcode version flags)} = unpack 'C2n', pack 'N', $_; @{$self}{rcode} = @{$self}{rcode} << 4; } return pack 'C2n', $self->rcode >> 4, $self->version, $self->flags; } sub version { my $self = shift; $self->{version} = 0 + shift if scalar @_; return $self->{version} || 0; } sub UDPsize { my $self = shift; $self->{size} = shift if scalar @_; return ( $self->{size} || 0 ) > 512 ? $self->{size} : 0; } sub size { return &UDPsize; } # uncoverable pod sub rcode { my $self = shift; return $self->{rcode} || 0 unless scalar @_; my $val = shift || 0; return $self->{rcode} = $val < 16 ? 0 : $val; # discard non-EDNS rcodes 1 .. 15 } sub flags { my $self = shift; $self->{flags} = shift if scalar @_; return $self->{flags} || 0; } sub options { my ($self) = @_; my $option = $self->{option} || {}; my @option = defined( $self->{index} ) ? @{$self->{index}} : sort { $a <=> $b } keys %$option; return @option; } sub option { my $self = shift; my $number = ednsoptionbyname(shift); return $self->_get_option($number) unless scalar @_; return $self->_set_option( $number, @_ ); } ######################################## sub _get_option { my ( $self, $number ) = @_; my $options = $self->{option} || {}; my $payload = $options->{$number}; return $payload unless wantarray; my $package = join '::', __PACKAGE__, ednsoptionbyval($number); $package =~ s/-/_/g; my @structure = $package->can('_decompose') ? eval { $package->_decompose($payload) } : (); return @structure if scalar(@structure); return length($payload) ? {BASE16 => unpack 'H*', $payload} : ''; } sub _set_option { my ( $self, $number, @value ) = @_; my $options = $self->{option} ||= {}; delete $options->{$number}; my ($arg) = @value; return unless defined $arg; if ( ref($arg) eq 'HASH' ) { my $octets = $$arg{'OPTION-DATA'}; my $length = $$arg{'OPTION-LENGTH'}; $octets = pack 'H*', $$arg{'BASE16'} if defined $$arg{'BASE16'}; $octets = '' if defined($length) && $length == 0; return $options->{$number} = $octets if defined $octets; } my $option = ednsoptionbyval($number); my $package = join '::', __PACKAGE__, $option; $package =~ s/-/_/g; return eval { $options->{$number} = $package->_compose(@value) } if $package->can('_compose'); croak "unable to compose option $number" if ref($arg); return $options->{$number} = $arg; } sub _format_option { my ( $self, $number ) = @_; my $option = ednsoptionbyval($number); my ($content) = $self->_get_option($number); return Net::DNS::RR::_wrap( _JSONify( {$option => $content} ) ); } sub _JSONify { my $value = shift; if ( ref($value) eq 'HASH' ) { my @tags = keys %$value; my $tail = pop @tags; my @body = map { my ( $a, @z ) = _JSONify( $$value{$_} ); unshift @z, qq("$_": $a); $z[-1] .= ','; @z; } @tags; my ( $a, @tail ) = _JSONify( $$value{$tail} ); unshift @tail, qq("$tail": $a); return ( '{', @body, @tail, '}' ); } if ( ref($value) eq 'ARRAY' ) { my @array = @$value; return qq([ ]) unless scalar @array; my @tail = _JSONify( pop @array ); my @body = map { my @x = _JSONify($_); $x[-1] .= ','; @x } @array; return ( '[', @body, @tail, ']' ); } my $string = qq("$value"); ## stringify, then use isdual() as discriminant return $value if UTIL && Scalar::Util::isdual($value); # native integer return $value if !UTIL && $string =~ /^"\d{1,10}"$/; # best-effort workaround return $string; } sub _specified { my $self = shift; return scalar grep { $self->{$_} } qw(size flags rcode option); } ## no critic ProhibitMultiplePackages package Net::DNS::RR::OPT::NSID; # RFC5001 sub _compose { my @argument = map { ref($_) ? %$_ : $_ } @_; return pack 'H*', pop @argument; } sub _decompose { return unpack 'H*', pop @_ } package Net::DNS::RR::OPT::DAU; # RFC6975 sub _compose { shift @_; return pack 'C*', map { ref($_) ? @$_ : $_ } @_; } sub _decompose { return [unpack 'C*', pop @_] } package Net::DNS::RR::OPT::DHU; # RFC6975 our @ISA = qw(Net::DNS::RR::OPT::DAU); package Net::DNS::RR::OPT::N3U; # RFC6975 our @ISA = qw(Net::DNS::RR::OPT::DAU); package Net::DNS::RR::OPT::CLIENT_SUBNET; # RFC7871 my %family = qw(1 Net::DNS::RR::A 2 Net::DNS::RR::AAAA); my @field8 = qw(FAMILY SOURCE-PREFIX SCOPE-PREFIX ADDRESS); sub _compose { shift @_; my %argument = ( map( ( $_ => 0 ), @field8 ), map { ref($_) ? %$_ : $_ } @_ ); my $family = $family{$argument{FAMILY}} || die 'unrecognised address family'; my $bitmask = $argument{'SOURCE-PREFIX'}; my $address = bless( {}, $family )->address( $argument{ADDRESS} ); return pack 'a* B*', pack( 'nC2', @argument{@field8} ), unpack "B$bitmask", $address; } sub _decompose { my %object; @object{@field8} = unpack 'nC2a*', pop @_; my ($family) = grep defined($_), $family{$object{FAMILY}}, 2; $object{ADDRESS} = bless( {address => $object{ADDRESS}}, $family )->address; return \%object; } package Net::DNS::RR::OPT::EXPIRE; # RFC7314 sub _compose { my @argument = map { ref($_) ? %$_ : $_ } @_; return pack 'N', pop @argument; } sub _decompose { my $argument = pop @_; return length($argument) ? unpack( 'N', $argument ) : {'OPTION-LENGTH' => 0}; } package Net::DNS::RR::OPT::COOKIE; # RFC7873 sub _compose { shift @_; my @argument = map { ref($_) ? @$_ : $_ } @_; return pack 'a8a*', map pack( 'H*', $_ ), grep defined($_), @argument; } sub _decompose { return [unpack 'H16H*', pop @_] } package Net::DNS::RR::OPT::TCP_KEEPALIVE; # RFC7828 sub _compose { my @argument = map { ref($_) ? %$_ : $_ } @_; return pack 'n', pop @argument; } sub _decompose { my $argument = pop @_; return length($argument) ? unpack( 'n', $argument ) : {'OPTION-LENGTH' => 0}; } package Net::DNS::RR::OPT::PADDING; # RFC7830 sub _compose { my @argument = map { ref($_) ? %$_ : $_ } @_; my $length = pop @argument; return pack "x$length"; } sub _decompose { my $argument = pop @_; return {'OPTION-LENGTH' => length $argument} if $argument =~ /^\000*$/; return {'BASE16' => unpack 'H*', $argument}; } package Net::DNS::RR::OPT::CHAIN; # RFC7901 sub _compose { my @argument = map { ref($_) ? %$_ : $_ } @_; return Net::DNS::DomainName->new( pop @argument )->encode; } sub _decompose { my $argument = pop @_; return {'CLOSEST-TRUST-POINT' => Net::DNS::DomainName->decode( \$argument )->string}; } package Net::DNS::RR::OPT::KEY_TAG; # RFC8145 sub _compose { shift @_; return pack 'n*', map { ref($_) ? @$_ : $_ } @_; } sub _decompose { return [unpack 'n*', pop @_] } package Net::DNS::RR::OPT::EXTENDED_ERROR; # RFC8914 my @field15 = qw(INFO-CODE EXTRA-TEXT); sub _compose { shift @_; my %argument = map { ref($_) ? %$_ : $_ } @_; my ( $code, $extra ) = map { defined($_) ? $_ : '' } @argument{@field15}; return pack 'na*', 0 + $code, Net::DNS::Text->new($extra)->raw; } sub _decompose { my ( $code, $extra ) = unpack 'na*', pop @_; my @error = grep { defined($_) } $Net::DNS::Parameters::dnserrorbyval{$code}; return {'INFO-CODE' => $code, 'EXTRA-TEXT' => Net::DNS::Text->decode( \$extra, 0, length $extra )->value, map( ( 'DNS-ERROR' => "$_" ), @error )}; } package Net::DNS::RR::OPT::REPORT_CHANNEL; # draft-ietf-dnsop-dns-error-reporting $Net::DNS::Parameters::ednsoptionbyval{65023} = 'REPORT-CHANNEL'; # experimental/private use sub _compose { my @argument = map { ref($_) ? %$_ : $_ } @_; return Net::DNS::DomainName->new( pop @argument )->encode; } sub _decompose { my $argument = pop @_; return {'AGENT-DOMAIN' => Net::DNS::DomainName->decode( \$argument )->string}; } ######################################## 1; __END__ =head1 SYNOPSIS use Net::DNS; my $packet = Net::DNS::Packet->new( ... ); $packet->header->do(1); # extended header flag $packet->edns->UDPsize(1232); # UDP payload size $packet->edns->option( 'NSID' => '7261776279746573' ); $packet->edns->option( 'TCP-KEEPALIVE' => 200 ); $packet->edns->option( 'DAU' => [8, 10, 13, 14, 15, 16] ); $packet->edns->option( 'EXTENDED-ERROR' => {'INFO-CODE' => 123} ); $packet->edns->option( '65023' => {'BASE16' => '076578616d706c6500'} ); $packet->edns->print; ;; { "EDNS-VERSION": 0, ;; "FLAGS": "8000", ;; "RCODE": 0, ;; "UDPSIZE": 1232, ;; "OPTIONS" : [ ;; { "NSID": "7261776279746573" }, ;; { "TCP-KEEPALIVE": 200 }, ;; { "DAU": [ 8, 10, 13, 14, 15, 16 ] }, ;; { "EXTENDED-ERROR": { "INFO-CODE": 123, "EXTRA-TEXT": "" } }, ;; { "65023": { "BASE16": "076578616d706c6500" } } ] ;; } =head1 DESCRIPTION EDNS OPT pseudo resource record. The OPT record supports EDNS protocol extensions and is not intended to be created, accessed or modified directly by user applications. All EDNS features are performed indirectly by operations on the objects returned by the $packet->header and $packet->edns creator methods. The underlying mechanisms are, or should be, entirely hidden from the user. =head1 METHODS The available methods are those inherited from the base class augmented by the type-specific methods defined in this package. Use of undocumented package features or direct access to internal data structures is discouraged and could result in program termination or other unpredictable behaviour. =head2 version $version = $packet->edns->version; The version of EDNS supported by this OPT record. =head2 UDPsize $size = $packet->edns->UDPsize; $packet->edns->UDPsize($size); UDPsize() advertises the maximum size (octets) of UDP packet that can be reassembled in the network stack of the originating host. =head2 rcode $extended_rcode = $packet->header->rcode; The 12 bit extended RCODE. The most significant 8 bits are obtained from the OPT record. The least significant 4 bits reside in the packet header. =head2 flags $do = $packet->header->do; $packet->header->do(1); $edns_flags = $packet->edns->flags; 16 bit field containing EDNS extended header flags. =head2 options, option my @option = $packet->edns->options; When called in a list context, options() returns a list of option codes found in the OPT record. my $octets = $packet->edns->option('COOKIE'); my $base16 = unpack 'H*', $octets; $packet->edns->option( 'COOKIE' => {'OPTION-DATA' => $octets} ); $packet->edns->option( '10' => {'BASE16' => $base16} ); When called in a scalar context with a single argument, option() returns the uninterpreted octet string corresponding to the specified option. The method returns undef if the option is absent. Options can be added or replaced by providing the (name => value) pair. The option is deleted if the value is undefined. When called in a list context with a single argument, option() returns a structured representation of the option value. For example: my ($structure) = $packet->edns->option('DAU'); my @algorithms = @$structure; my ($structure) = $packet->edns->option(15); my $info_code = $$structure{'INFO-CODE'}; my $extra_text = $$structure{'EXTRA-TEXT'}; Similar forms of array or hash syntax may be used to construct the option value: $packet->edns->option( 'DAU' => [8, 10, 13, 14, 15, 16] ); $packet->edns->option( 'EXTENDED-ERROR' => {'INFO-CODE' => 123, 'EXTRA-TEXT' => ""} ); =head1 COPYRIGHT Copyright (c)2001,2002 RIPE NCC. Author Olaf M. Kolkman. Portions Copyright (c)2012,2017-2022 Dick Franks. All rights reserved. Package template (c)2009,2012 O.M.Kolkman and R.W.Franks. =head1 LICENSE Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the original copyright notices appear in all copies and that both copyright notice and this permission notice appear in supporting documentation, and that the name of the author not be used in advertising or publicity pertaining to distribution of the software without specific prior written permission. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. =head1 SEE ALSO L<perl>, L<Net::DNS>, L<Net::DNS::RR>, L<RFC6891|https://tools.ietf.org/html/rfc6891>, L<RFC3225|https://tools.ietf.org/html/rfc3225> =cut