The Net_DNS_RR class provides methods of parsing resource records returned by a nameserver, creation of resource record objects to be sent to a nameserver, and the ability to access each component of an RR as an object property.
Each resource record object MUST contain the following properties:
name
- The DNS name of the RR
type
- The RR type
class
- The RR class (normally IN)
ttl
- The RR time to live
rdlength
- The amount of data (in bytes) of the rdata section
rdata
- The data (uncompressed) of the right hand side of the RR
If type
is a supported RR type,
it will automatically be decompressed and/or decoded
into its appropriate property values. The values inside
of an RR object will vary based on the type of RR.
Supported RR types:
A
string address
- IPv4 style address
AAAA
string address
- IPv6 style address
CNAME
string cname
- The canonical name of the queried host
HINFO
string cpu
- The host CPU type
string os
- Type host operating system
MX
integer preference
- The MX preference (lower takes priority
string exchange
- The name of the mail exchange host
NAPTR
unknown order
- unknown
unknown preference
- unknown
unknown flags
- unknown
unknown services
- unknown
unknown regex
- unknown
unknown replacement
- unknown
NS
string nsdname
- The name of the NS record nameserver
PTR
string ptrdname
- The name for the queried IP address
SOA
string mname
- Master nameserver hostname as
specified in the SOA record - not neccessarily accurate
string rname
- Email address of the person
responsible for the zone - not neccessarily accurate
string serial
- The serial number (version
number) of the retrieved zone
string refresh
- The length of time before
the zone should be refresed
string retry
- The length of time between
retries for slave servers to refresh the zone
string expire
- The length of time before
slave servers should consider the data invalid without refreshing
the zone data.
string minimum
- The default TTL for RRs
inside of the zone that are not otherwise specified.
SRV
unknown preference
- unknown
unknown weight
- unknown
unknown port
- unknown
unknown target
- unknown
TSIG
integer time_signed
- The time the signature
has was created
integer fudge
- The time offset that is
acceptable between the client and the server
integer mac_size
- The size of the following
signature data
string/binary mac
- The data containing the
has sent by the client/server
integer original_id
- The ID sent to or
received from the server identifying this query.
integer error
- The value of the error
calculating or verifying the signature.
integer other_len
- The amount of data (in
bytes) additional to the signature
string other_data
- Additional data required
by the nameserver for the signature.
string key
- The key shared by the client and
the server to validate authorization.
TXT
string text
- The text defined in the record