dwww Home | Manual pages | Find package

Net::D...::NSEC3(3pm) User Contributed Perl Documentation Net::D...::NSEC3(3pm)

NAME
       Net::DNS::RR::NSEC3 - DNS NSEC3 resource record

SYNOPSIS
               use Net::DNS;
               $rr = Net::DNS::RR->new('name NSEC3 algorithm flags iterations salt hnxtname');

DESCRIPTION
       Class for DNSSEC NSEC3 resource records.

       The NSEC3 Resource Record (RR) provides authenticated denial of
       existence for DNS Resource Record Sets.

       The NSEC3 RR lists RR types present at the original owner name of the
       NSEC3 RR.  It includes the next hashed owner name in the hash order of
       the zone.  The complete set of NSEC3 RRs in a zone indicates which
       RRSets exist for the original owner name of the RR and form a chain of
       hashed owner names in the zone.

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.

   algorithm
               $algorithm = $rr->algorithm;
               $rr->algorithm( $algorithm );

       The 8-bit algorithm field is represented as an unsigned decimal integer,
       but may be specified using the algorithm mnemonic.

       algorithm() may also be invoked as a class method or simple function to
       perform mnemonic and numeric code translation.

   flags
               $flags = $rr->flags;
               $rr->flags( $flags );

       The Flags field is an unsigned decimal integer interpreted as eight
       concatenated Boolean values.

       optout
                   $rr->optout(1);

                   if ( $rr->optout ) {
                           ...
                   }

           Boolean Opt Out flag.

   iterations
               $iterations = $rr->iterations;
               $rr->iterations( $iterations );

       The Iterations field is represented as an unsigned decimal integer.  The
       value is between 0 and 65535, inclusive.

   salt
               $salt = $rr->salt;
               $rr->salt( $salt );

       The  Salt  field  is represented as a contiguous sequence of hexadecimal
       digits. A "-" (unquoted) is used in string format to indicate  that  the
       salt field is absent.

   saltbin
               $saltbin = $rr->saltbin;
               $rr->saltbin( $saltbin );

       The Salt field as a sequence of octets.

   hnxtname
               $hnxtname = $rr->hnxtname;
               $rr->hnxtname( $hnxtname );

       The  Next  Hashed  Owner  Name  field  points  to the next node that has
       authoritative data or contains a delegation point NS RRset.

   typelist
               @typelist = $rr->typelist;
               $typelist = $rr->typelist;
               $rr->typelist( @typelist );

       typelist() identifies the RRset types that  exist  at  the  domain  name
       matched  by  the  NSEC3  RR.  When called in scalar context, the list is
       interpolated into a string.

   typemap
               $exists = $rr->typemap($rrtype);

       typemap() returns a Boolean true value if the specified RRtype occurs in
       the type bitmap of the NSEC3 record.

   match
               $matched = $rr->match( 'example.foo' );

       match() returns a Boolean true value if the  hash  of  the  domain  name
       argument matches the hashed owner name of the NSEC3 RR.

   covers
               $covered = $rr->covers( 'example.foo' );

       covers()  returns  a  Boolean  true value if the hash of the domain name
       argument, or ancestor of that name, falls between the owner name and the
       next hashed owner name of the NSEC3 RR.

   encloser, nextcloser, wildcard
               $encloser = $rr->encloser( 'example.foo' );
               print "encloser: $encloser\n" if $encloser;

       encloser() returns the name of a provable encloser  of  the  query  name
       argument obtained from the NSEC3 RR.

       nextcloser()  returns  the  next  closer name, which is one label longer
       than the closest encloser.  This is  only  valid  after  encloser()  has
       returned a valid domain name.

       wildcard()  returns  the  unexpanded  wildcard  name from which the next
       closer  name  was  possibly  synthesised.   This  is  only  valid  after
       encloser() has returned a valid domain name.

COPYRIGHT
       Copyright (c)2017,2018 Dick Franks

       Portions Copyright (c)2007,2008 NLnet Labs.  Author Olaf M. Kolkman

       All rights reserved.

       Package template (c)2009,2012 O.M.Kolkman and R.W.Franks.

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.

SEE ALSO
       perl            Net::DNS             Net::DNS::RR             RFC5155(3)
       <https://iana.org/go/rfc5155#section-3>                          RFC9077
       <https://iana.org/go/rfc9077>

       Hash Algorithms <https://iana.org/assignments/dnssec-nsec3-parameters>

perl v5.40.1                       2026-08-21             Net::D...::NSEC3(3pm)

Generated by dwww version 1.16 on Fri Oct 30 06:34:51 CET 2026.