0x1949 Team - FAZEMRX - MANAGER

Edit File: Net::DNS::Domain.3pm

.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "Net::DNS::Domain 3pm" .TH Net::DNS::Domain 3pm "2024-09-18" "perl v5.34.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Net::DNS::Domain \- DNS domains .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& use Net::DNS::Domain; \& \& $domain = Net::DNS::Domain\->new(\*(Aqexample.com\*(Aq); \& $name = $domain\->name; .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" The Net::DNS::Domain module implements a class of abstract \s-1DNS\s0 domain objects with associated class and instance methods. .PP Each domain object instance represents a single \s-1DNS\s0 domain which has a fixed identity throughout its lifetime. .PP Internally, the primary representation is a (possibly empty) list of \s-1ASCII\s0 domain name labels, and optional link to an origin domain object topologically closer to the \s-1DNS\s0 root. .PP The computational expense of Unicode character-set conversion is partially mitigated by use of caches. .SH "METHODS" .IX Header "METHODS" .SS "new" .IX Subsection "new" .Vb 1 \& $object = Net::DNS::Domain\->new(\*(Aqexample.com\*(Aq); .Ve .PP Creates a domain object which represents the \s-1DNS\s0 domain specified by the character string argument. The argument consists of a sequence of labels delimited by dots. .PP A character preceded by \e represents itself, without any special interpretation. .PP Arbitrary 8\-bit codes can be represented by \e followed by exactly three decimal digits. Character code points are \s-1ASCII,\s0 irrespective of the character coding scheme employed by the underlying platform. .PP Argument string literals should be delimited by single quotes to avoid escape sequences being interpreted as octal character codes by the Perl compiler. .PP The character string presentation format follows the conventions for zone files described in \s-1RFC1035.\s0 .PP Users should be aware that non-ASCII domain names will be transcoded to \s-1NFC\s0 before encoding, which is an irreversible process. .SS "name" .IX Subsection "name" .Vb 1 \& $name = $domain\->name; .Ve .PP Returns the domain name as a character string corresponding to the \&\*(L"common interpretation\*(R" to which \s-1RFC1034, 3.1,\s0 paragraph 9 alludes. .PP Character escape sequences are used to represent a dot inside a domain name label and the escape character itself. .PP Any non-printable code point is represented using the appropriate numerical escape sequence. .SS "fqdn" .IX Subsection "fqdn" .Vb 1 \& $fqdn = $domain\->fqdn; .Ve .PP Returns a character string containing the fully qualified domain name, including the trailing dot. .SS "xname" .IX Subsection "xname" .Vb 1 \& $xname = $domain\->xname; .Ve .PP Interprets an extended name containing Unicode domain name labels encoded as Punycode A\-labels. .PP If decoding is not possible, the \s-1ACE\s0 encoded name is returned. .SS "label" .IX Subsection "label" .Vb 1 \& @label = $domain\->label; .Ve .PP Identifies the domain by means of a list of domain labels. .SS "string" .IX Subsection "string" .Vb 1 \& $string = $object\->string; .Ve .PP Returns a character string containing the fully qualified domain name as it appears in a zone file. .PP Characters which are recognised by \s-1RFC1035\s0 zone file syntax are represented by the appropriate escape sequence. .SS "origin" .IX Subsection "origin" .Vb 3 \& $create = Net::DNS::Domain\->origin( $ORIGIN ); \& $result = &$create( sub{ Net::DNS::RR\->new( \*(Aqmx MX 10 a\*(Aq ); } ); \& $expect = Net::DNS::RR\->new( "mx.$ORIGIN. MX 10 a.$ORIGIN." ); .Ve .PP Class method which returns a reference to a subroutine wrapper which executes a given constructor in a dynamically scoped context where relative names become descendents of the specified \f(CW$ORIGIN\fR. .SH "BUGS" .IX Header "BUGS" Coding strategy is intended to avoid creating unnecessary argument lists and stack frames. This improves efficiency at the expense of code readability. .PP Platform specific character coding features are conditionally compiled into the code. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c)2009\-2011,2017 Dick Franks. .PP All rights reserved. .SH "LICENSE" .IX Header "LICENSE" Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the original copyright notices appear in all copies and that both 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 prior written permission. .PP \&\s-1THE SOFTWARE IS PROVIDED \*(L"AS IS\*(R", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\s0 .SH "SEE ALSO" .IX Header "SEE ALSO" perl Net::DNS Net::LibIDN2 \&\s-1RFC1034\s0 <https://iana.org/go/rfc1034> \&\s-1RFC1035\s0 <https://iana.org/go/rfc1035> \&\s-1RFC5891\s0 <https://iana.org/go/rfc5891>