Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

net::dns::domain(3) [osx man page]

Net::DNS::Domain(3)					User Contributed Perl Documentation				       Net::DNS::Domain(3)

NAME

       Net::DNS::Domain - Domain Name System domains

SYNOPSIS

	   use Net::DNS::Domain;

	   $domain = new Net::DNS::Domain('example.com');
	   $name   = $domain->name;

DESCRIPTION

       The Net::DNS::Domain module implements a class of abstract DNS domain objects with associated class and instance methods.

       Each domain object instance represents a single DNS domain which has a fixed identity throughout its lifetime.

       Internally, the primary representation is a (possibly empty) list of ASCII domain name labels, and optional link to an arbitrary origin
       domain object topologically closer to the DNS root.

       The presentation form of the domain name is generated on demand and the result cached within the object.

METHODS

   new
	   $object = new Net::DNS::Domain('example.com');

       Creates a domain object which represents the DNS domain specified by the character string argument. The argument consists of a sequence of
       labels delimited by dots.

       A character preceded by  represents itself, without any special interpretation.

       Arbitrary 8-bit codes can be represented by  followed by exactly three decimal digits.	Character code points are ASCII, irrespective of
       the character coding scheme employed by the underlying platform.

       Argument string literals should be delimited by single quotes to avoid escape sequences being interpreted as octal character codes by the
       Perl compiler.

       The character string presentation format follows the conventions for zone files described in RFC1035.

   name
	   $name = $domain->name;

       Returns the domain name as a character string corresponding to the "common interpretation" to which RFC1034, 3.1, paragraph 9 alludes.

       Character escape sequences are used to represent a dot inside a domain name label and the escape character itself.

       Domain names containing Unicode characters are supported if the Net::LibIDN module is installed.

       Any non-printable code point is represented using the appropriate numerical escape sequence.

   fqdn
	   @fqdn = $domain->fqdn;

       Returns a character string containing the fully qualified domain name, including the trailing dot.

   identifier
	   $identifier = $domain->identifier;

       Identifies the domain by means of its uninterpreted A-label form of domain name.

   label
	   @label = $domain->label;

       Identifies the domain by means of a list of domain labels.

   string
	   $string = $object->string;

       Returns a character string containing the fully qualified domain name as it appears in a zone file.

       Characters which are recognised by RFC1035 zone file syntax are represented by the appropriate escape sequence.

   origin
	   $create = origin Net::DNS::Domain( $ORIGIN );
	   $result = &$create( sub{ new Net::DNS::RR( 'mx MX 10 a' ); } );
	   $expect = new Net::DNS::RR( "mx.$ORIGIN. MX 10 a.$ORIGIN." );

       Class method which returns a reference to a subroutine wrapper which will execute a given constructor in a context within which $ORIGIN is
       defined.

BUGS

       Coding strategy is intended to avoid creating unnecessary argument lists and stack frames. This improves efficiency at the expense of code
       readability.

       Platform specific character coding features are conditionally compiled into the code.

COPYRIGHT

       Copyright (c)2009-2011 Dick Franks.

       All rights reserved.

       This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       perl, Net::LibIDN, Net::DNS, RFC1034, RFC1035, RFC5891, Unicode Technical Report #16

perl v5.16.2							    2012-01-27						       Net::DNS::Domain(3)

Check Out this Related Man Page

Net::DNS::Text(3)					User Contributed Perl Documentation					 Net::DNS::Text(3)

NAME

       Net::DNS::Text - Domain Name System text representation

SYNOPSIS

	   use Net::DNS::Text;

	   $object = new Net::DNS::Text('example');
	   $string = $object->string;

	   $object = decode Net::DNS::Text( $data, $offset );
	   ( $object, $next ) = decode Net::DNS::Text( $data, $offset );

	   $data = $object->encode;
	   $text = $object->value;

DESCRIPTION

       The "Net::DNS::Text" module implements a class of text objects with associated class and instance methods.

       Each text object instance has a fixed identity throughout its lifetime.

METHODS

   new
	   $object = new Net::DNS::Text('example');

       Creates a text object which encapsulates a single character string component of a resource record.

       Arbitrary single-byte characters can be represented by  followed by exactly three decimal digits. Such characters are devoid of any
       special meaning.

       A character preceded by  represents itself, without any special interpretation.

   decode
	   $object = decode Net::DNS::Text( $buffer, $offset );

	   ( $object, $next ) = decode Net::DNS::Text( $buffer, $offset );

       Creates a text object which represents the decoded data at the indicated offset within the data buffer.

       The argument list consists of a reference to a scalar containing the wire-format data and offset of the text data.

       The returned offset value indicates the start of the next item in the data buffer.

   encode
	   $data = $object->encode;

       Returns the wire-format encoded representation of the text object suitable for inclusion in a DNS packet buffer.

   value
	   $value = $text->value;

       Returns the character representation of the text object.

   string
	   $string = $text->string;

       Returns the escaped string representation of the text object.

BUGS

       Coding strategy is intended to avoid creating unnecessary argument lists and stack frames. This improves efficiency at the expense of code
       readability.

       Platform specific character coding features are conditionally compiled into the code.

COPYRIGHT

       Copyright (c)2009-2011 Dick Franks.

       All rights reserved.

       This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       perl, Net::DNS, RFC1035, RFC3629, Unicode Technical Report #16

perl v5.16.2							    2012-01-27							 Net::DNS::Text(3)
Man Page