Unix/Linux Go Back    

RedHat 9 (Linux i386) - man page for net::dns::rr (redhat section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

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

       Net::DNS::RR - DNS Resource Record class

       "use Net::DNS::RR"

       "Net::DNS::RR" is the base class for DNS Resource Record (RR) objects.  See also the man-
       ual pages for each RR type.

       WARNING!!!  Don't assume the RR objects you receive from a query are of a particular type
       -- always check an object's type before calling any of its methods.  If you call an
       unknown method, you'll get a nasty warning message and "Net::DNS::RR" will return "undef"
       to the caller.

       new (from string)

	   $a = Net::DNS::RR->new("foo.example.com. 86400 A");
	   $mx = Net::DNS::RR->new("example.com. 7200 MX 10 mailhost.example.com.");
	   $cname = Net::DNS::RR->new("www.example.com 300 IN CNAME www1.example.com");
	   $txt = Net::DNS::RR->new("baz.example.com 3600 HS TXT 'text record'");

       Returns a "Net::DNS::RR" object of the appropriate type and initialized from the string
       passed by the user.  The format of the string is that used in zone files, and is compati-
       ble with the string returned by "Net::DNS::RR"->"string".

       The name and RR type are required; all other information is optional.  If omitted, the TTL
       defaults to 0 and the RR class defaults to IN.  Omitting the optional fields is useful for
       creating the empty RDATA sections required for certain dynamic update operations.  See the
       "Net::DNS::Update" manual page for additional examples.

       All names must be fully qualified.  The trailing dot (.) is optional.

       new (from hash)

	   $rr = Net::DNS::RR->new(
	       Name    => "foo.example.com",
	       TTL     => 86400,
	       Class   => "IN",
	       Type    => "A",
	       Address => "",

	   $rr = Net::DNS::RR->new(
	       Name    => "foo.example.com",
	       Type    => "A",

       Returns an RR object of the appropriate type, or a "Net::DNS::RR" object if the type isn't
       implemented.  See the manual pages for each RR type to see what fields the type requires.

       The "Name" and "Type" fields are required; all others are optional.  If omitted, "TTL"
       defaults to 0 and "Class" defaults to IN.  Omitting the optional fields is useful for cre-
       ating the empty RDATA sections required for certain dynamic update operations.

       The fields are case-insensitive, but starting each with uppercase is recommended.



       Prints the record to the standard output.  Calls the string method to get the RR's string


	   print $rr->string, "\n";

       Returns a string representation of the RR.  Calls the rdatastr method to get the RR-spe-
       cific data.


	   $s = $rr->rdatastr;

       Returns a string containing RR-specific data.  Subclasses will need to implement this


	   $name = $rr->name;

       Returns the record's domain name.


	   $type = $rr->type;

       Returns the record's type.


	   $class = $rr->class;

       Returns the record's class.


	   $ttl = $rr->ttl;

       Returns the record's time-to-live (TTL).


	   $rdlength = $rr->rdlength;

       Returns the length of the record's data section.


	   $rdata = $rr->rdata

       Returns the record's data section as binary data.

       This version of "Net::DNS::RR" does little sanity checking on user-created RR objects.

       Copyright (c) 1997-2002 Michael Fuhr.  All rights reserved.  This program is free soft-
       ware; you can redistribute it and/or modify it under the same terms as Perl itself.

       EDNS0 extensions by Olaf Kolkman.

       perl(1), Net::DNS, Net::DNS::Resolver, Net::DNS::Packet, Net::DNS::Update,
       Net::DNS::Header, Net::DNS::Question, RFC 1035 Section 4.1.3

perl v5.8.0				    2002-10-14				  Net::DNS::RR(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 10:15 AM.