Net::DNS::DomainName3pm

Usage

        use Net::DNS::DomainName;
        $object = Net::DNS::DomainName->new('example.com');
        $name = $object->name;
        $data = $object->encode;
        ( $object, $next ) = Net::DNS::DomainName->decode( \$data, $offset );

Overview

The Net::DNS::DomainName module implements the concrete representation of DNS domain names used within DNS packets.

Net::DNS::DomainName defines methods for encoding and decoding wire format octet strings. All other behaviour is inherited from Net::DNS::Domain.

The Net::DNS::DomainName1035 and Net::DNS::DomainName2535 packages implement disjoint domain name subtypes which provide the name compression and canonicalisation specified by RFC1035 and RFC2535. These are necessary to meet the backward compatibility requirements introduced by RFC3597.

Methods

        $object = Net::DNS::DomainName->new('example.com');

        $object = Net::DNS::DomainName->decode( \$buffer, $offset, $hash );
        ( $object, $next ) = Net::DNS::DomainName->decode( \$buffer, $offset, $hash );

        $data = $object->encode;

        $data = $object->canonical;

Net::DNS::DomainName1035

Net::DNS::DomainName1035 implements a subclass of domain name objects which are to be encoded using the compressed wire format defined in RFC1035.

        $data = $object->encode( $offset, $hash );

The arguments are the offset within the packet data where the domain name is to be stored and a reference to a hash table used to index compressed names within the packet.

Note that RFC3597 implies that only the RR types defined in RFC1035(3.3) are eligible for compression of domain names occuring in RDATA.

If the hash reference is undefined, encode() returns the lower case uncompressed canonical representation defined in RFC2535(8.1).

Net::DNS::DomainName2535

Net::DNS::DomainName2535 implements a subclass of domain name objects which are to be encoded using uncompressed wire format.

        $data = $object->encode( $offset, $hash );

The arguments are the offset within the packet data where the domain name is to be stored and a reference to a hash table used to index names already encoded within the packet.

If the hash reference is undefined, encode() returns the lower case uncompressed canonical representation defined in RFC2535(8.1).

Note that RFC3597, and latterly RFC4034, specifies that the lower case canonical form is to be used for RR types defined prior to RFC3597.