This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

Net::DNS::RR::OPT(3)                 User Contributed Perl Documentation                Net::DNS::RR::OPT(3)



NAME
       Net::DNS::RR::OPT - DNS OPT

SYNOPSIS
       "use Net::DNS::RR";

DESCRIPTION
       Class for EDNS pseudo resource record OPT.

METHODS
       This object should only be used inside the Net::DNS classes itself.

       new

       Since "OPT" is a pseudo record and should not be stored in masterfiles; Therefore we have not
       implemented a method to create this RR from string.

       One may create the object from a hash. See RFC 2671 for details for the meaning of the hash keys.

        $rr= new Net::DNS::RR {
           name => "",     # Ignored and set to ""
           type => "OPT",
           class => 1024,    # sets UDP payload size
           extendedrcode =>  0x00,    # sets the extended RCODE 1 octets
           ednsflags     =>  0x0000,  # sets the ednsflags (2octets)
           optioncode   =>   0x0      # 2 octets
           optiondata   =>   0x0      # optionlength octets
        }

       The ednsversion is set to 0 for now. The ttl value is determined from the extendedrcode, the
       ednsversion and the ednsflag.  The rdata is constructed from the optioncode and optiondata see
       section 4.4 of RFC 2671

       If optioncode is left undefined then we do not expect any RDATA.

       The defaults are no rdata.

       do, set_do, clear_do

           $opt->set_do;

       Reads, sets and clears the do flag. (first bit in the ednssflags);

       size

           $opt->size(1498);
           print "Packet size:". $opt->size() ;

       Sets or gets the packet size.

TODO
       - This class is tailored to use with dnssec.

       - Do some range checking on the input.

       - This class probably needs subclasses once OPTION codes start to be defined.

       - look at use of extended labels

COPYRIGHT
       Copyright (c) 2001, 2002  RIPE NCC.  Author Olaf M. Kolkman

       All Rights Reserved

       Permission to use, copy, modify, and distribute this software and its documentation for any purpose
       and without fee is hereby granted, provided that the above copyright notice appear in all copies and
       that both that 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, written prior permission.

       THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
       MERCHANTABILITY AND FITNESS; IN NO EVENT SHALL AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR
       CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
       IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH
       THE USE OR PERFORMANCE OF THIS SOFTWARE.

       Based on, and contains, code by Copyright (c) 1997-2002 Michael Fuhr.

SEE ALSO
       perl(1), Net::DNS, Net::DNS::Resolver, Net::DNS::Packet, Net::DNS::Header, Net::DNS::Question,
       Net::DNS::RR, RFC 2435 Section 3



perl v5.8.8                                      2007-06-21                             Net::DNS::RR::OPT(3)