NAME

Net::DNS::Codes - collection of C library DNS codes

SYNOPSIS


            
              
               use Net::DNS::Codes qw(
:header
:RRs
:constants
:all
   (or any individual item)
 );
 --------- :header -------
 $textval = RBitsTxt->{masked_bits};
 $textval = RcodeTxt->{numeric};
 $textval = OpcodeTxt->{numeric};
 $code = (one of text below)

QR AA TC RD RA MBZ Z AD CD

BITS_QUERY BITS_IQUERY BITS_STATUS BITS_NS_NOTIFY_OP BITS_NS_UPDATE_OP

QUERY IQUERY STATUS NS_NOTIFY_OP NS_UPDATE_OP

NOERROR FORMERR SERVFAIL NXDOMAIN NOTIMP REFUSED YXDOMAIN YXRRSET NXRRSET NOTAUTH NOTZONE BADSIG BADKEY BADTIME


            
              
              for flag manipulation

RCODE_MASK BITS_OPCODE_MASK


            
              
              ------- :RRs -------
$textval = ClassTxt->{numeric};  
$textval = TypeTxt->{numeric};
$code = (one of text below)

C_IN C_CHAOS C_HS C_NONE C_ANY


            
              
              ------- :constants -------
$code = (one of test below)

PACKETSZ NS_PACKETSZ MAXDNAME NS_MAXDNAME MAXCDNAME NS_MAXCDNAME MAXLABEL NS_MAXLABEL HFIXEDSZ NS_HFIXEDSZ QFIXEDSZ NS_QFIXEDSZ RRFIXEDSZ NS_RRFIXEDSZ INT32SZ NS_INT32SZ INT16SZ NS_INT16SZ NS_INT8SZ INADDRSZ NS_INADDRSZ IN6ADDRSZ NS_IN6ADDRSZ INDIR_MASK NS_CMPRSFLGS NAMESERVER_PORT NS_DEFAULTPORT


            
              
              $code = INT8SZ (not a DNS code, added for convenience)

DESCRIPTION

Net::DNS::Codes provides forward and reverse lookup for most common C library DNS codes as well as all the codes for the DNS HEADER field.

$bitmask = XX


            
              
              Return the bitmask for the code:
 15 14 13 12 11 10  9  8  7  6  5  4  3  2  1  0
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
|QR|   Opcode  |AA|TC|RD|RA| Z|AD|CD|   Rcode   |
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  0  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15
QR              =>   1000_0000_0000_0000
BitsOpcode      =>   Opcode binary value
        left shifted 11 bits
AA              =>   100_0000_0000
TC              =>   10_0000_0000
RD              =>   1_0000_0000
RA              =>   1000_0000
MBZ or Z        =>   100_0000
AD              =>   10_0000
CD              =>   1_0000
Rcode           =>   Rcode binary value
RCODE_MASK      =>   1111_1111_1111_0000
where BitsOpcode =
BITS_QUERY          =>      0, 
BITS_IQUERY         =>      1000_0000_0000 # 1 << 11
BITS_STATUS         =>    1_0000_0000_0000 # 2 << 11
BITS_NS_NOTIFY_OP =>   10_0000_0000_0000 # 4 << 11
BITS_NS_UPDATE_OP =>   10_1000_0000_0000 # 5 << 11
BITS_OPCODE_MASK  => 1000_0111_1111_1111

$textval = RBitsTxt->{masked_bits};

Returns the TEXT string for the bit fields above.


            
              
              NOTE: that MBZ and Z have the same value. 
The text string 'MBZ' is returned for 0x1 << 6

$textval = RcodeTxt->{numeric};


            
              
               Return the TEXT string for numeric code.
NOERROR         => 0,
FORMERR         => 1,
SERVFAIL        => 2,
NXDOMAIN        => 3,
NOTIMP          => 4,
REFUSED         => 5,
YXDOMAIN        => 6,
YXRRSET         => 7,
NXRRSET         => 8,
NOTAUTH         => 9,
NOTZONE         => 10,
BADSIG          => 16,
BADKEY          => 17,
BADTIME         => 18,

$textval = OpcodeTxt->{numeric};


            
              
               Return the TEXT string for numeric code.
QUERY           => 0,
IQUERY          => 1,
STATUS          => 2, 
NS_NOTIFY_OP    => 4, 
NS_UPDATE_OP    => 5,

$textval = ClassTxt->{numeric};


            
              
               Return the TEXT string for numeric code.
C_IN        => 1,
C_CHAOS  => 3,
C_HS        => 4,
C_NONE    => 254,
C_ANY      => 255,

$textval = TypeTxt->{numeric};


            
              
               Return the TEXT string for numeric code.
 T_A            => 1,        # rfc1035.txt
 T_NS           => 2,        # rfc1035.txt
 T_MD           => 3,        # rfc1035.txt
 T_MF           => 4,        # rfc1035.txt
 T_CNAME        => 5,        # rfc1035.txt
 T_SOA          => 6,        # rfc1035.txt
 T_MB           => 7,        # rfc1035.txt
 T_MG           => 8,        # rfc1035.txt
 T_MR           => 9,        # rfc1035.txt
 T_NULL => 10,       # rfc1035.txt
 T_WKS          => 11,       # rfc1035.txt
 T_PTR          => 12,       # rfc1035.txt
 T_HINFO        => 13,       # rfc1035.txt
 T_MINFO        => 14,       # rfc1035.txt
 T_MX           => 15,       # rfc1035.txt
 T_TXT          => 16,       # rfc1035.txt
 T_RP           => 17,       # rfc1183.txt
 T_AFSDB        => 18,       # rfc1183.txt
 T_X25          => 19,       # rfc1183.txt
 T_ISDN => 20,       # rfc1183.txt
 T_RT           => 21,       # rfc1183.txt
 T_NSAP => 22,       # rfc1706.txt
 T_NSAP_PTR     => 23,       # rfc1348.txt
 T_SIG          => 24,       # rfc2535.txt
 T_KEY          => 25,       # rfc2535.txt
 T_PX           => 26,       # rfc2163.txt
 T_GPOS => 27,       # rfc1712.txt
 T_AAAA => 28,       # rfc1886.txt
 T_LOC          => 29,       # rfc1876.txt
 T_NXT          => 30,       # rfc2535.txt
 T_EID          => 31,       # draft-ietf-nimrod-dns-02.txt
 T_NIMLOC       => 32,       # draft-ietf-nimrod-dns-02.txt
 T_SRV          => 33,       # rfc2052.txt
 T_ATMA => 34,       # af-saa-0069.000.txt
 T_NAPTR        => 35,       # rfc2168.txt
 T_KX           => 36,       # rfc2230.txt
 T_CERT => 37,       # rfc2538.txt
 T_A6           => 38,       # rfc2874.txt
 T_DNAME        => 39,       # rfc2672.txt
 T_SINK => 40,       # draft-ietf-dnsind-kitchen-sink-01.txt
 T_OPT          => 41,       # rfc2671.txt
 T_APL          => 42,       # rfc3123.txt
 T_DS           => 43,       # draft-ietf-dnsext-delegation-signer-15.txt
 T_SSHFP        => 44,       # rfc4255.txt
 T_IPSECKEY     => 45,       # rfc4025.txt
 T_RRSIG        => 46,       # rfc4034.txt
 T_NSEC => 47,       # rfc4034.txt
 T_DNSKEY       => 48,       # rfc4034.txt
 T_DHCID        => 49,       # rfc4701.txt
 T_NSEC3        => 50,       # rfc5155.txt
 T_NSEC3PARAM   => 51,       # rfc5155.txt
# unassigned 52 - 54
 T_HIP          => 55,       # rfc5205.txt
 T_NINFO        => 56,       # unknown
 T_RKEY => 57,       # draft-reid-dnsext-rkey-00.txt
 T_ALINK        => 58,       # draft-ietf-dnsop-dnssec-trust-history-02.txt
 T_CDS          => 59,       # draft-barwood-dnsop-ds-publish-02.txt
# unassigned 60 - 98
 T_UINFO        => 100,      # reserved
 T_UID          => 101,      # reserved
 T_GID          => 102,      # reserved
 T_UNSPEC       => 103,      # reserved
# unassigned 104 - 248
 T_TKEY => 249,      # rfc2930.txt
 T_TSIG => 250,      # rfc2931.txt
 T_IXFR => 251,      # rfc1995.txt
 T_AXFR => 252,      # rfc1035.txt
 T_MAILB        => 253,      # rfc973.txt
 T_MAILA        => 254,      # rfc973.txt
 T_ANY          => 255,      # rfc1886.txt

(various constants)


            
              
              PACKETSZ        NS_PACKETSZ     512
MAXDNAME        NS_MAXDNAME     1025
MAXCDNAME       NS_MAXCDNAME    255 
MAXLABEL        NS_MAXLABEL     63  
HFIXEDSZ        NS_HFIXEDSZ     12  
QFIXEDSZ        NS_QFIXEDSZ     4   
RRFIXEDSZ       NS_RRFIXEDSZ    10  
INT32SZ         NS_INT32SZ      4   
INT16SZ         NS_INT16SZ      2   
INT8SZ          NS_INT8SZ       1   
INADDRSZ        NS_INADDRSZ     4   
IN6ADDRSZ       NS_IN6ADDRSZ    16  
INDIR_MASK      NS_CMPRSFLGS    0xc0
NAMESERVER_PORT NS_DEFAULTPORT  53

INSTALLATION

To install this module, type:


            
              
              perl Makfile.PL
make
make test
make install

EXPORT_OK


            
              
              ------- for tag :header -------

RBitsTxt RcodeTxt OpcodeTxt

QR AA TC RD RA MBZ Z AD CD

BITS_QUERY BITS_IQUERY BITS_STATUS BITS_NS_NOTIFY_OP BITS_NS_UPDATE_OP

QUERY IQUERY STATUS NS_NOTIFY_OP NS_UPDATE_OP

NOERROR FORMERR SERVFAIL NXDOMAIN NOTIMP REFUSED YXDOMAIN YXRRSET NXRRSET NOTAUTH NOTZONE BADSIG BADKEY BADTIME

BITS_OPCODE_MASK RCODE_MASK


            
              
              ------- for tag :RRs -------
$textval = ClassTxt->{numeric};  
$textval = TypeTxt->{numeric};
$code = (one of text below)

C_IN C_CHAOS C_HS C_NONE C_ANY

T_A T_NS T_MD T_MF T_CNAME T_SOA T_MB T_MG T_MR T_NULL T_WKS T_PTR T_HINFO T_MINFO T_MX T_TXT T_RP T_AFSDB T_X25 T_ISDN T_RT T_NSAP T_NSAP_PTR T_SIG T_KEY T_PX T_GPOS T_AAAA T_LOC T_NXT T_EID T_NIMLOC T_SRV T_ATMA T_NAPTR T_KX T_CERT T_A6 T_DNAME T_SINK T_OPT T_APL T_DS T_SSHFP T_IPSECKEY T_RRSIG T_NSEC T_DNSKEY T_DHCID T_NSEC3 T_NSEC3PARAM T_HIP T_NINFO T_RKEY T_ALINK T_CDS T_UINFO T_UID T_GID T_UNSPEC T_TKEY T_TSIG T_IXFR T_AXFR T_MAILB T_MAILA T_ANY


            
              
              ------- for tag :constants -------

EXPORT_TAGS


            
              
              :header
:RRs
:constants
:all

AUTHOR

Michael Robinton, michael@bizsystems.com

COPYRIGHT

Copyright 2003 - 2014, Michael Robinton & BizSystems This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

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 the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)