NAME

Net::DNS::ToolKit::Question - Resource Handler

SYNOPSIS

  DO NOT use Net::DNS::ToolKit::Question
  DO NOT require Net::DNS::ToolKit::Question

  Net::DNS::ToolKit::Question is autoloaded by
  class Net::DNS::ToolKit::RR and its methods
  are instantiated in a 'special' manner.

DESCRIPTION

• ($newoff,$name,$type,$class) = $get->Question(\$buffer,$offset);

  Get question from $buffer. Returns the expanded name, type and class.

    input:        pointer to buffer,
                  offset into buffer
    returns:      new offset,
                  expanded name,
                  type,
                  class

• ($newoff,@dnptrs) = $put->Question(\$buffer,$offset, $name,$type,$class,\@dnptrs);

  Append a question to the $buffer. Returns a new pointer array for compressed names and the offset to the next RR.

  NOTE: it is up to the user to update the question count. See: put_qdcount

  Since the question usually is the first record to be appended to the buffer, @dnptrs may be ommitted. See the details at dn_comp.

  Usage: ($newoff,@dnptrs)=$put->Question(\$buffer,$offset, $name,$type,$class);

    input:        pointer to buffer,
                  offset into buffer,
                  domain name,
                  question type,
                  question class,
                  pointer to array of
                    previously compressed names,
    returns:      offset to next record,
                  updated array of offsets to
                    previous compressed names

• ($name,$typeTXT,$classTXT) = $parse->Question($name,$type,$class);

  Convert non-printable and numeric data into ascii text.

    input:        domain name,
                  question type (numeric)
                  question class (numeric)
    returns:      domain name,
                  type TEXT,
                  class TEXT

DEPENDENCIES

        Net::DNS::ToolKit

EXPORT

        none

AUTHOR

Michael Robinton <michael@bizsystems.com>

COPYRIGHT

    Copyright 2003 - 2011, Michael Robinton <michael@bizsystems.com>
   

Michael Robinton <michael@bizsystems.com>

All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of either:

  a) the GNU General Public License as published by the Free
  Software Foundation; either version 2, or (at your option) any
  later version, or

  b) the "Artistic License" which comes with this distribution.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See either the GNU General Public License or the Artistic License for more details.

You should have received a copy of the Artistic License with this distribution, in the file named "Artistic". If not, I'll be glad to provide one.

You should also have received a copy of the GNU General Public License along with this program in the file named "Copying". If not, write to the

        Free Software Foundation, Inc.                        
        59 Temple Place, Suite 330
        Boston, MA  02111-1307, USA                                     

or visit their web page on the internet at:

        http://www.gnu.org/copyleft/gpl.html.

See also:

Net::DNS::ToolKit(3)